文档中心

独立模式部署

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

Note:

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

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

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

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

安装数据库

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

下载 SequoiaDB 安装包

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

下载地址:SequoiaDB 巨杉数据库

安装 SequoiaDB 巨杉数据库步骤

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

Note:

  • 使用 root 用户进行 SequoiaDB 数据库安装
  • 确保本地主机满足硬件和软件要求(可参考软硬件配置要求
  • 参看操作系统设置中关于 NUMA 的说明,建议关闭 NUMA 或者使用numactl --interleave=all启动数据库服务
  1. 用户可以参照操作系统设置调整 Linux 系统的环境配置。

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

    # tar -zxvf sequoiadb-3.4-linux_x86_64-installer.tar.gz
    # chmod u+x sequoiadb-3.4-linux_x86_64-installer.run
  3. 使用 root 用户运行 sequoiadb-3.4-linux_x86_64-installer.run 包:

    # ./sequoiadb-3.4-linux_x86_64-installer.run --mode text --SMS false
  4. 提示选择向导语言,可根据需要输入 1 选择英文,或者输入 2 选择中文。

    Language Selection
    Please select the installation language
    [1] English - English
    [2] Simplified Chinese - 简体中文
    Please choose an option [1] :2
  5. 显示安装协议,输入 1 表示忽略阅读并同意协议,输入 2 表示读取完整协议内容。

    ------------------------------------------------------------
    由 BitRockInstallBuilder 评估本所建立
    ------------------------------------------------------------
    
    欢迎来到 SequoiaDB Server 安装程序
    
    重要信息:请仔细阅读
    
    下面提供了两个许可协议。
    
    1. SequoiaDB 评估程序的最终用户许可协议
    2. SequoiaDB 最终用户许可协议
    
    如果被许可方为了生产性使用目的(而不是为了评估、测试、试用“先试后买”或演示)获得本程序,单击下面的“接受”按钮即表示被许可方接受 SequoiaDB 最终用户许可协议,且不作任何修改。
    
    如果被许可方为了评估、测试、试用“先试后买”或演示(统称为“评估”)目的获得本程序:单击下面的“接受”按钮即表示被许可方同时接受(i)SequoiaDB 评估程序的最终用户许可协议(“评估许可”),且不作任何修改;和(ii)SequoiaDB 最终用户程序许可协议(SELA),且不作任何修改。
    
    在被许可方的评估期间将适用“评估许可”。
    
    如果被许可方通过签署采购协议在评估之后选择保留本程序(或者获得附加的本程序副本供评估之后使用),SequoiaDB 评估程序的最终用户许可协议将自动适用。
    
    “评估许可”和 SequoiaDB 最终用户许可协议不能同时有效;两者之间不能互相修改,并且彼此独立。
    
    这两个许可协议中每个协议的完整文本如下。
    
    评估程序的最终用户许可协议
    
    [1] 同意以上协议: 了解更多的协议内容,可以在安装后查看协议文件
    [2] 查看详细的协议内容
    请选择选项 [1] :
  6. 指定 SequoiaDB 安装路径,输入完毕后按回车。若没有输入直接回车,将使用默认的安装路径 /opt/sequoiadb

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

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

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

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

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

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

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

    正在安装 SequoiaDB Server 于您的电脑中,请稍候。
    安装中
    0% ______________ 50% ______________ 100%
    #########################################
    ------------------------------------------------------------
    安装程序已经完成安装 SequoiaDB Server 于你的电脑中.
  14. 使用如下命令查看 SequoiaDB 的安装信息。其中 SDBADMIN_USER 表示 SequoiaDB 相关进程所属用户的用户名,INSTALL_DIR 表示 SequoiaDB 的安装目录。

    # cat /etc/default/sequoiadb
    NAME=sdbcm
    SDBADMIN_USER=sdbadmin
    INSTALL_DIR=/opt/sequoiadb
  15. 切换到 SDBADMIN_USER 指定的用户。

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

    $ cd /opt/sequoiadb
    $ ./bin/sequoiadb  --version
    SequoiaDB version: 3.4
    Release: 40774
    2019-12-31-00.55.13

安装SQL引擎

安装 MySQL 实例组件

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

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

下载 MySQL 实例组件安装包

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

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

安装 MySQL 实例组件步骤

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

Note:

  • 使用 root 用户权限来安装 MySQL实例组件
  • 检查 MySQL 实例组件产品软件包是否与 SequoiaDB 版本一致
  1. 以 root 用户登陆目标主机,解压 MySQL 实例组件产品包,并为解压得到的 sequoiasql-mysql-3.4-linux_x86_64-installer.run 安装包赋可执行权限:

    # tar -zxvf sequoiasql-mysql-3.4-linux_x86_64-installer.tar.gz
    # chmod a+x sequoiasql-mysql-3.4-linux_x86_64-installer.run
  2. 使用 root 用户执行 sequoiasql-mysql-3.4-linux_x86_64-installer.run 包:

    # ./sequoiasql-mysql-3.4-linux_x86_64-installer.run --mode text
  3. 提示选择向导语言,可根据需要输入 1 选择英文,或者输入 2 选择中文。

    Language Selection
    Please select the installation language
    [1] English - English
    [2] Simplified Chinese - 简体中文
    Please choose an option [1] : 2
  4. 显示安装协议,输入 1 表示忽略阅读并同意协议,输入 2 表示读取完整协议内容。

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

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

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

    密码 [********] :
    确认密码 [********] :
  8. 询问是否继续安装,Y 表示继续,n 表示不继续。默认为继续:

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

    正在安装 SequoiaSQL MySQL Server 于您的电脑中,请稍候.
    
    安装中
    0% ______________ 50% ______________ 100%
    #########################################
    
    ----------------------------------------------------------------------------
    安装程序已经完成安装 SequoiaSQL MySQL Server 于你的电脑中.

部署独立模式

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

部署步骤

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

Note:

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

  1. 切换到 sdbadmin 用户:

    $ su - sdbadmin
  2. 进入 SequoiaDB Shell 控制台:

    $ /opt/sequoiadb/bin/sdb
  3. 连接本地集群管理服务进程:

    > var oma = new Oma("localhost", 11790)
  4. 创建数据节点:

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

    Note:

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

  5. 启动该节点:

    > oma.startNode(11810)

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

部署SQL实例

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

  1. 切换到 sdbadmin 用户:

    $ su - sdbadmin
  2. 检查 3306 端口是否被占用:

    $ netstat  -anp  | grep 3306
  3. 添加 MySQL 实例 myinst:

    $ /opt/sequoiasql/mysql/bin/sdb_sql_ctl addinst myinst -D /opt/sequoiasql/mysql/database/3306/ -p 3306
  4. 启动 myinst 实例:

    $ /opt/sequoiasql/mysql/bin/sdb_sql_ctl start myinst
  5. 查看 myinst 实例状态:

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

    Note:

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

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

收起

建议反馈
本页导航
回到顶部