独立模式部署

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

Note:

独立模式部署推荐用于业务的调测开发中，不建议在生产环境使用。

独立模式是 SequoiaDB 部署的最简模式，仅需要启动一个独立模式的数据节点，即可提供数据服务。该模式中所有信息都存放在数据节点，不存在编目信息。

独立模式支持基于 JSON API 的数据操作指令，而对于高可用与容灾、数据分区、数据复制及 SequoiaSQL-MySQL 实例下的自增字段等能力需要使用集群模式进行部署。

部署独立模式分为四步，其中数据库安装与部署为必选，SQL 引擎安装与部署为可选：

安装数据库

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

下载 SequoiaDB 安装包

用户可前往 SequoiaDB 巨杉数据库官网下载中心中下载相应版本的安装包。

下载地址：SequoiaDB 巨杉数据库

安装 SequoiaDB 巨杉数据库步骤

下述安装过程，使用名称为 sequoiadb-5.0-linux_x86_64.tar.gz 的 SequoiaDB 产品包为示例。

Note:

  • 使用 root 用户进行 SequoiaDB 数据库安装
  • 确保本地主机满足硬件和软件要求（可参考软硬件配置要求）
  • 参看操作系统设置中关于 NUMA 的说明，建议关闭 NUMA 或者使用 numactl --interleave=all 启动数据库服务

  1. 用户可以参照操作系统设置调整 Linux 系统的环境配置。

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

    1. # tar -zxvf sequoiadb-5.0-linux_x86_64-installer.tar.gz
    2. # chmod u+x sequoiadb-5.0-linux_x86_64-installer.run

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

    1. # ./sequoiadb-5.0-linux_x86_64-installer.run --mode text --SMS false

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

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

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

    1. ------------------------------------------------------------
    2. 由 BitRockInstallBuilder 评估本所建立
    3. ------------------------------------------------------------
    5. 欢迎来到 SequoiaDB Server 安装程序
    7. 重要信息：请仔细阅读
    9. 下面提供了两个许可协议。
    11. 1. SequoiaDB 评估程序的最终用户许可协议
    12. 2. SequoiaDB 最终用户许可协议
    14. 如果被许可方为了生产性使用目的（而不是为了评估、测试、试用“先试后买”或演示）获得本程序，单击下面的“接受”按钮即表示被许可方接受 SequoiaDB 最终用户许可协议，且不作任何修改。
    16. 如果被许可方为了评估、测试、试用“先试后买”或演示（统称为“评估”）目的获得本程序：单击下面的“接受”按钮即表示被许可方同时接受（i）SequoiaDB 评估程序的最终用户许可协议（“评估许可”），且不作任何修改；和（ii）SequoiaDB 最终用户程序许可协议（SELA），且不作任何修改。
    18. 在被许可方的评估期间将适用“评估许可”。
    20. 如果被许可方通过签署采购协议在评估之后选择保留本程序（或者获得附加的本程序副本供评估之后使用），SequoiaDB 评估程序的最终用户许可协议将自动适用。
    22. “评估许可”和 SequoiaDB 最终用户许可协议不能同时有效；两者之间不能互相修改，并且彼此独立。
    24. 这两个许可协议中每个协议的完整文本如下。
    26. 评估程序的最终用户许可协议
    28. [1] 同意以上协议: 了解更多的协议内容，可以在安装后查看协议文件
    29. [2] 查看详细的协议内容
    30. 请选择选项 [1] :

  6. 指定 SequoiaDB 安装路径，输入完毕后按回车。若没有输入直接回车，将使用默认的安装路径 /opt/sequoiadb

    1. ------------------------------------------------------------
    2. 请指定 SequoiaDB Server 将会被安装到的目录
    3. 安装目录 [/opt/sequoiadb]:

  7. 询问是否强制安装，y 表示强制安装，安装时发现有相关进程存在则会尝试停止进程，N 表示非强制安装，安装时发现有相关进程存在，就会报错退出，默认为非强制安装

    1. ------------------------------------------------------------
    2. 是否强制安装？强制安装时可能会强杀残留进程
    3. 是否强制安装 [y/N]:

  8. 提示配置 Linux 用户名和用户组，输入完毕后按回车，若没有输入直接回车，将会创建默认的用户名（sdbadmin）和用户组（sdbadmin_group）；该用户名用于运行 SequoiaDB 服务：

    1. ------------------------------------------------------------
    2. 数据库管理用户配置
    3. 配置用于启动 SequoiaDB 的用户名、用户组和密码
    4. 用户名 [sdbadmin]:
    5. 用户组 [sdbadmin_group]:

  9. 提示配置刚才创建的 Linux 用户的密码，输入完毕后按回车；若没有输入直接回车，将会使用默认密码（sdbadmin）

    1. 密码 [********] :
    2. 确认密码 [********] :

  10. 提示配置服务端口，输入完毕后按回车；若没有输入直接回车，将使用默认的服务端口号（11790）

    1. ------------------------------------------------------------
    2. 集群管理服务端口配置
    3. 配置 SequoiaDB 集群管理服务端口，集群管理用于远程启动添加和启停数据库节点
    4. 端口 [11790]:

  11. 询问是否允许 SequoiaDB 巨杉数据库相关进程开机自启动，Y 表示允许，n 表示不允许，默认为允许

    1. ------------------------------------------------------------
    2. 是否允许 SequoiaDB 相关进程开机自启动
    3. Sequoiadb相关进程开机自启动 [Y/n]:

  12. 询问是否继续安装，Y 表示继续，n 表示不继续，默认为继续

    1. ------------------------------------------------------------
    2. 设定现在已经准备将 SequoiaDB Server 安装到您的电脑.
    3. 您确定要继续? [Y/n]:

  13. 当屏幕上显示以下信息，表示 SequoiaDB 已经安装完成

    1. 正在安装 SequoiaDB Server 于您的电脑中，请稍候。
    2. 安装中
    3. 0% ______________ 50% ______________ 100%
    4. #########################################
    5. ------------------------------------------------------------
    6. 安装程序已经完成安装 SequoiaDB Server 于你的电脑中.

  14. 使用如下命令查看 SequoiaDB 的安装信息，其中 SDBADMIN_USER 表示 SequoiaDB 相关进程所属用户的用户名，INSTALL_DIR 表示 SequoiaDB 的安装目录：

    1. # cat /etc/default/sequoiadb
    2. NAME=sdbcm
    3. SDBADMIN_USER=sdbadmin
    4. INSTALL_DIR=/opt/sequoiadb

  15. 切换到 SDBADMIN_USER 指定的用户

    1. # su - sdbadmin

  16. 进入 SequoiaDB 安装目录，使用如下命令进行安装检查，如能正常查到 SequoiaDB 的版本信息，说明 SequoiaDB 安装成功

    1. $ cd /opt/sequoiadb
    2. $ ./bin/sequoiadb  --version
    3. SequoiaDB version: 5.0
    4. Release: 40774
    5. 2019-12-31-00.55.13

安装SQL引擎

安装 MySQL 实例组件

SequoiaDB 支持创建 MySQL 实例，完全兼容 MySQL 语法和协议，用户可以使用 SQL 语句访问 SequoiaDB 数据库，完成对数据的增、删、查、改操作以及其他 MySQL 语法操作。

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

下载 MySQL 实例组件安装包

用户可前往 SequoiaDB 巨杉数据库官方网站下载相应版本的 MySQL 实例组件安装包。

下载地址：MySQL 实例组件安装包

安装 MySQL 实例组件步骤

下述安装过程，使用名称为 sequoiasql-mysql-5.0-linux_x86_64-installer.tar.gz 的 MySQL 实例组件产品包为示例。

Note:

  • 使用 root 用户权限来安装 MySQL实例组件
  • 检查 MySQL 实例组件产品软件包是否与 SequoiaDB 版本一致

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

    1. # tar -zxvf sequoiasql-mysql-5.0-linux_x86_64-installer.tar.gz
    2. # chmod a+x sequoiasql-mysql-5.0-linux_x86_64-installer.run

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

    1. # ./sequoiasql-mysql-5.0-linux_x86_64-installer.run --mode text

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

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

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

    1. 由BitRock InstallBuilder评估本所建立
    3. 欢迎来到 SequoiaSQL MySQL Server 安装程序
    5. ----------------------------------------------------------------------------
    6. GNU 通用公共授权
    7. 第二版, 1991年6月
    8. 著作权所有 (C) 1989，1991 Free Software Foundation, Inc. 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
    9. 允许每个人复制和发布本授权文件的完整副本，但不允许对它进行任何修改。
    11. [1] 同意以上协议: 了解更多的协议内容，可以在安装后查看协议文件
    12. [2] 查看详细的协议内容
    13. 请选择一个选项 [1] : 1

  5. 指定安装路径，输入完毕后按回车；若没有输入直接回车，将使用默认的安装路径（/opt/sequoiasql/mysql）

    1. 请指定 SequoiaSQL MySQL Server 将会被安装到的目录
    3. 安装目录 [/opt/sequoiasql/mysql]:

  6. 提示配置 Linux 用户名和用户组，输入完毕后按回车；若没有输入直接回车，将会创建默认的用户名（sdbadmin）和用户组（sdbadmin_group），该用户名用于运行 MySQL 实例服务：

    1. 数据库管理用户配置
    3. 配置用于启动SequoiaSQL-MySql的用户名、用户组和密码
    5. 用户名 [sdbadmin]:
    7. 用户组 [sdbadmin_group]:

  7. 提示配置刚才创建的 Linux 用户的密码，输入完毕后按回车；若没有输入直接回车，将会使用默认密码（sdbadmin）

    1. 密码 [********] :
    2. 确认密码 [********] :

  8. 询问是否继续安装，Y 表示继续，n 表示不继续，默认为继续

    1. 设定现在已经准备将 SequoiaSQL MySQL Server 安装到您的电脑.
    3. 您确定要继续? [Y/n]:

  9. 当屏幕上显示以下信息，表示 MySQL 实例已经安装完成

    1. 正在安装 SequoiaSQL MySQL Server 于您的电脑中，请稍候.
    3. 安装中
    4. 0% ______________ 50% ______________ 100%
    5. #########################################
    7. ----------------------------------------------------------------------------
    8. 安装程序已经完成安装 SequoiaSQL MySQL Server 于你的电脑中.

部署独立模式

下面介绍如何通过 SequoiaDB Shell 进行独立模式的部署。

部署步骤

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

Note：

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

  1. 切换到 sdbadmin 用户

    1. $ su - sdbadmin

  2. 进入 SequoiaDB Shell 控制台

    1. $ /opt/sequoiadb/bin/sdb

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

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

  4. 创建数据节点

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

    Note:

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

  5. 启动该节点

    1. > oma.startNode(11810)

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

部署SQL实例

数据库实例是位于用户和操作系统之间的数据管理软件，用户对数据库的操作都是在数据库实例下进行的，下面介绍 SequoiaDB-MySQL 的实例部署。

  1. 切换到 sdbadmin 用户

    1. $ su - sdbadmin

  2. 检查 3306 端口是否被占用

    1. $ netstat  -anp  | grep 3306

  3. 添加 MySQL 实例 myinst

    1. $ /opt/sequoiasql/mysql/bin/sdb_sql_ctl addinst myinst -D /opt/sequoiasql/mysql/database/3306/ -p 3306

  4. 启动 myinst 实例

    1. $ /opt/sequoiasql/mysql/bin/sdb_sql_ctl start myinst

  5. 查看 myinst 实例状态

    1. $ /opt/sequoiasql/mysql/bin/sdb_sql_ctl status myinst

    Note:

    • 添加实例完成后实例会自行启动，无需执行启动命令
    • 停止 MySQL 实例的命令：/opt/sequoiasql/mysql/bin/sdb_mysql_ctl stop myinst

MySQL 数据库实例部署成功，用户可以来连接 MySQL Shell 进行数据操作。