【巨杉数据库SequoiaDB】SequoiaDB 独立模式部署

本文主要介绍如何在本地主机部署 SequoiaDB 巨杉数据库的独立模式。

独立模式是 SequoiaDB 部署的最简模式，该模式仅包含数据库存储引擎，支持基于JSON API的数据操作指令，而对于高可用、容灾和数据分区等能力需要使用集群模式进行部署。

安装数据库
在部署独立模式之前，需要先在本地主机安装 SequoiaDB 巨杉数据库软件。下面介绍如何通过命令行安装的方式将其库安装到本地主机。

下载 SequoiaDB 安装包
请到 SequoiaDB 巨杉数据库的官方网站下载相应版本的安装包。

下载地址：SequoiaDB 巨杉数据库

安装 SequoiaDB 巨杉数据库步骤
下述安装过程，使用名称为sequoiadb-3.0.1-linux_x86_64-installer.tar.gz的 SequoiaDB 产品包为示例。
Note:

使用 root 用户进行 SequoiaDB 数据库安装

确保本地主机满足硬件和软件要求（可参考软硬件配置要求）

参看操作系统设置中关于 NUMA 的说明，建议关闭 NUMA 或者使用numactl --interleave=all启动数据库服务
参照操作系统设置调整 Linux 系统的环境配置

以root 用户登陆目标主机，解压 SequoiaDB 巨杉数据库产品包，并为解压得到的 sequoiadb-3.0.1-linux_x86_64-installer.run 安装包赋可执行权限

tar -zxvf sequoiadb-3.0.1-linux_x86_64-installer.tar.gz

 chmod u+x sequoiadb-3.0.1-linux_x86_64-installer.run

使用 root 用户运行 sequoiadb-3.0.1-linux_x86_64-installer.run 包

./sequoiadb-3.0.1-linux_x86_64-installer.run --mode text --SMS false

提示选择向导语言，可根据需要输入 1 选择英文，或者输入 2 选择中文

Language Selection
Please select the installation language
[1] English - English
[2] Simplified Chinese - 简体中文
Please choose an option [1] :2
显示安装协议，输入 1 表示忽略阅读并同意协议，输入 2 表示读取完整协议内容------------------------------------------------------------
由 BitRockInstallBuilder 评估本所建立

欢迎来到 SequoiaDB Server 安装程序

重要信息：请仔细阅读

下面提供了两个许可协议。

1. SequoiaDB 评估程序的最终用户许可协议
2. SequoiaDB 最终用户许可协议

如果被许可方为了生产性使用目的（而不是为了评估、测试、试用“先试后买”或演示）获得本程序，单击下面的“接受”按钮即表示被许可方接受 SequoiaDB 最终用户许可协议，且不作任何修改。

如果被许可方为了评估、测试、试用“先试后买”或演示（统称为“评估”）目的获得本程序：单击下面的“接受”按钮即表示被许可方同时接受（i）SequoiaDB 评估程序的最终用户许可协议（“评估许可”），且不作任何修改；和（ii）SequoiaDB 最终用户程序许可协议（SELA），且不作任何修改。

在被许可方的评估期间将适用“评估许可”。

如果被许可方通过签署采购协议在评估之后选择保留本程序（或者获得附加的本程序副本供评估之后使用），SequoiaDB 评估程序的最终用户许可协议将自动适用。

“评估许可”和 SequoiaDB 最终用户许可协议不能同时有效；两者之间不能互相修改，并且彼此独立。

这两个许可协议中每个协议的完整文本如下。

评估程序的最终用户许可协议

[1] 同意以上协议: 了解更多的协议内容，可以在安装后查看协议文件
[2] 查看详细的协议内容
请选择选项 [1] :
指定 SequoiaDB 安装路径，输入完毕后按回车。若没有输入直接回车，将使用默认的安装路径（/opt/sequoiadb）

---

请指定 SequoiaDB Server 将会被安装到的目录
安装目录 [/opt/sequoiadb]:
询问是否强制安装，y 表示强制安装，安装时发现有相关进程存在则会尝试停止进程，N 表示非强制安装，安装时发现有相关进程存在，就会报错退出。默认为非强制安装

---

是否强制安装？强制安装时可能会强杀残留进程
是否强制安装 [y/N]:
提示配置 Linux 用户名和用户组，输入完毕后按回车。若没有输入直接回车，将会创建默认的用户名（sdbadmin）和用户组（sdbadmin_group）。该用户名用于运行 SequoiaDB 服务

---

数据库管理用户配置
配置用于启动 SequoiaDB 的用户名、用户组和密码
用户名 [sdbadmin]:
用户组 [sdbadmin_group]:
提示配置刚才创建的 Linux 用户的密码，输入完毕后按回车。若没有输入直接回车，将会使用默认密码（sdbadmin）

密码 [] : 确认密码 [] :
提示配置服务端口，输入完毕后按回车。若没有输入直接回车，将使用默认的服务端口号（11790）

------------------------------------------------------------ 集群管理服务端口配置 配置 SequoiaDB 集群管理服务端口，集群管理用于远程启动添加和启停数据库节点 端口 [11790]:
询问是否允许 SequoiaDB 巨杉数据库相关进程开机自启动，Y 表示允许，n 表示不允许。默认为允许

------------------------------------------------------------ 是否允许 SequoiaDB 相关进程开机自启动 Sequoiadb相关进程开机自启动 [Y/n]:
询问是否继续安装，Y 表示继续，n 表示不继续。默认为继续

------------------------------------------------------------ 设定现在已经准备将 SequoiaDB Server 安装到您的电脑. 您确定要继续? [Y/n]:
当屏幕上显示以下信息，表示 SequoiaDB 已经安装完成

正在安装 SequoiaDB Server 于您的电脑中，请稍候。 安装中 0% ______________ 50% ______________ 100% ######################################### ------------------------------------------------------------ 安装程序已经完成安装 SequoiaDB Server 于你的电脑中.
切换到 sdbadmin 用户，进行安装检查。使用如下命令如能正常查到 SequoiaDB 的版本信息，说明 SequoiaDB 安装成功。

$ sequoiadb --version SequoiaDB shell version: 3.0.1 Release: 37126 2018-10-14-13.15.29
部署独立模式
下面介绍如何通过 SequoiaDB Shell 进行独立模式的部署。

独立模式说明
独立模式是启动 SequoiaDB 的最精简模式，只需要启动一个的数据节点即可提供数据服务

在独立模式中，所有数据均存放在一个数据节点内，数据库不可进行分区，也不可进行数据复制。因此，在对数据安全性要求较高的环境下建议使用集群模式

独立模式的数据库中不存在编目信息

一般只推荐在开发环境中使用独立模式，以减少对硬件资源的需求

部署步骤
下述操作步骤假设 SequoiaDB 程序安装在 /opt/sequoiadb 目录下。

Note：

SequoiaDB 服务进程全部以 sdbadmin 用户运行，用户应确保数据库目录都赋予 sdbadmin 读写权限

切换到 sdbadmin 用户$ su - sdbadmin
进入 SequoiaDB Shell 控制台

$ /opt/sequoiadb/bin/sdb

连接本地集群管理服务进程

> var oma = new Oma("localhost", 11790)

创建数据节点

> oma.createData(11810, "/opt/sequoiadb/database/standalone/11810")

Note:

其中 11810 为数据库服务端口名，为避免端口冲突，可将数据库端口配置在随机端口范围之外。如：多数 Linux 默认随机端口范围为 32768～61000，可将数据库端口配置在 32767 以下。

启动该节点

oma.startNode(11810)
SequoiaDB 的独立模式已经部署完成，用户可以连接 SequoiaDB Shell 进行数据操作。

部署SQL引擎
SequoiaSQL 是 SequoiaDB 的一种 SQL 引擎，SequoiaSQL-MySQL 以存储引擎的方式与 MySQL 对接，使得用户可以通过 MySQL 的 SQL 接口访问 SequoiaDB 中的数据，并进行增删改查等操作。

下面介绍如何通过命令行安装的方式将 SequoiaSQL-MySQL 安装到本地主机。

下载 SequoiaSQL-MySQL 安装包
请到 SequoiaDB 巨杉数据库官方网站下载相应版本的 SequoiaSQL-MySQL 安装包。

下载地址：SequoiaSQL-MySQL 数据库

安装SequoiaSQL-MySQL数据库步骤
下述安装过程，使用名称为 sequoiasql-mysql-3.0.1-linux_x86_64-installer.tar.gz 的 SequoiaSQL-MySQL 产品包为示例。

Note:

使用 root 用户进行 SequoiaSQL-MySQL 数据库安装

确保 SequoiaSQL-MySQL 产品安装包与 SequoiaDB 巨杉数据库版本一致

以root 用户登陆目标主机，解压 SequoiaSQL-MySQL 产品包，并为解压得到的 sequoiasql-mysql-3.0.1-linux_x86_64-installer.run 安装包赋可执行权限

tar -zxvf sequoiasql-mysql-3.0.1-linux_x86_64-installer.tar.gz # chmod a+x sequoiasql-mysql-3.0.1-linux_x86_64-installer.run

使用 root 用户执行 sequoiasql-mysql-3.0.1-linux_x86_64-installer.run 包

./sequoiasql-mysql-3.0.1-linux_x86_64-installer.run --mode text

提示选择向导语言，可根据需要输入 1 选择英文，或者输入 2 选择中文

Language Selection Please select the installation language [1] English - English [2] Simplified Chinese - 简体中文 Please choose an option [1] : 2

显示安装协议，输入 1 表示忽略阅读并同意协议，输入 2 表示读取完整协议内容

由BitRock InstallBuilder评估本所建立 欢迎来到 SequoiaSQL MySQL Server 安装程序 ---------------------------------------------------------------------------- GNU 通用公共授权 第二版, 1991年6月 著作权所有 © 1989，1991 Free Software Foundation, Inc. 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA. 允许每个人复制和发布本授权文件的完整副本，但不允许对它进行任何修改。 [1] 同意以上协议: 了解更多的协议内容，可以在安装后查看协议文件 [2] 查看详细的协议内容 请选择一个选项 [1] : 1
指定安装路径，输入完毕后按回车。若没有输入直接回车，将使用默认的安装路径（/opt/sequoiasql/mysql）

请指定 SequoiaSQL MySQL Server 将会被安装到的目录 安装目录 [/opt/sequoiasql/mysql]:
提示配置 Linux 用户名和用户组，输入完毕后按回车。若没有输入直接回车，将会创建默认的用户名（sdbadmin）和用户组（sdbadmin_group）。该用户名用于运行 SequoiaSQL-MySQL 服务

数据库管理用户配置 配置用于启动SequoiaSQL-MySql的用户名、用户组和密码 用户名 [sdbadmin]: 用户组 [sdbadmin_group]:
提示配置刚才创建的 Linux 用户的密码，输入完毕后按回车。若没有输入直接回车，将会使用默认密码（sdbadmin）

密码 [] : 确认密码 [] :
询问是否添加默认实例，Y 表示添加，n 表示不添加，默认为添加

---------------------------------------------------------------------------- 是否添加默认实例？ 添加默认实例。 [Y/n]:
提示配置默认实例的端口号，输入完毕按回车。若没有输入直接回车，将使用默认端口号（3306）

---------------------------------------------------------------------------- 设置实例端口号 实例端口号 [3306]:
指定 SequoiaSQL-MySQL 安装路径，输入完毕后按回车。若没有输入直接回车，将使用默认的安装路径（/opt/sequoiasql/mysql/data3306）

---------------------------------------------------------------------------- 设置实例数据目录 实例数据目录 [/opt/sequoiasql/mysql/data3306]:
询问是否继续安装，Y 表示继续，n 表示不继续。默认为继续

设定现在已经准备将 SequoiaSQL MySQL Server 安装到您的电脑. 您确定要继续? [Y/n]:
当屏幕上显示以下信息，表示 SequoiaSQL-MySQL 已经安装完成

正在安装 SequoiaSQL MySQL Server 于您的电脑中，请稍候. 安装中 0% ______________ 50% ______________ 100% ######################################### ---------------------------------------------------------------------------- 安装程序已经完成安装 SequoiaSQL MySQL Server 于你的电脑中.
切换 sdbadmin 用户，检查实例状态。显示如下信息说明SequoiaSQL-MySQL 数据库安装成功，用户可以来连接 MySQL Shell 进行数据操作。

$ /opt/sequoiasql/mysql/bin/sdb_mysql_ctl status 3306 mysqld3306 is running

Note:

安装完成后实例已经自动启动，无需执行启动步骤

启动 SequoiaSQL-MySQL 实例的命令：/opt/sequoiasql/mysql/bin/sdb_mysql_ctl start 3306

停止 SequoiaSQL-MySQL 实例的命令：/opt/sequoiasql/mysql/bin/sdb_mysql_ctl stop 3306

查看实例状态的命令： /opt/sequoiasql/mysql/bin/sdb_mysql_ctl status 3306