2019-04-11
技术教程， SequoiaDB
本文主要介绍如何在本地主机部署 SequoiaDB 巨杉数据库的独立模式。
独立模式是 SequoiaDB 部署的最简模式，该模式仅包含数据库存储引擎，支持基于JSON API的数据操作指令，而对于高可用、容灾和数据分区等能力需要使用集群模式进行部署。
在部署独立模式之前，需要先在本地主机安装 SequoiaDB 巨杉数据库软件。下面介绍如何通过命令行安装的方式将其库安装到本地主机。
请到 SequoiaDB 巨杉数据库的官方网站下载相应版本的安装包。
下载地址：SequoiaDB 巨杉数据库
下述安装过程，使用名称为 sequoiadb-3.0.1-linux_x86_64-installer.tar.gz 的 SequoiaDB 产品包为示例。
Note:
参照操作系统设置调整 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 进行数据操作。
MySQL 是一款开源的关系型数据库管理系统，也是目前最流行的关系型数据库管理系统之一，支持标准的 SQL 语言。SequoiaDB 支持创建 MySQL 实例，完全兼容MySQL 语法和协议，用户可以使用 SQL 语句访问 SequoiaDB 数据库，完成对数据的增、删、查、改操作以及其他 MySQL 语法操作。
下面介绍如何通过命令行安装的方式将 MySQL 实例组件安装到本地主机。
请到 SequoiaDB 巨杉数据库官方网站下载相应版本的 MySQL 实例组件安装包。
下载地址：MySQL 实例组件
下述安装过程，使用名称为 sequoiasql-mysql-3.0.1-linux_x86_64-installer.tar.gz 的 MySQL 实例组件产品包为示例。
Note:
使用 root 用户进行 MySQL 实例组件安装
确保 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月 著作权所有 (C) 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）。该用户名用于运行 MySQL 实例服务
数据库管理用户配置 配置用于启动SequoiaSQL-MySql的用户名、用户组和密码 用户名 [sdbadmin]: 用户组 [sdbadmin_group]:
提示配置刚才创建的 Linux 用户的密码，输入完毕后按回车。若没有输入直接回车，将会使用默认密码（sdbadmin）
密码 [********] : 确认密码 [********] :
询问是否添加默认实例，Y 表示添加，n 表示不添加，默认为添加
---------------------------------------------------------------------------- 是否添加默认实例？ 添加默认实例。 [Y/n]:
提示配置默认实例的端口号，输入完毕按回车。若没有输入直接回车，将使用默认端口号（3306）
---------------------------------------------------------------------------- 设置实例端口号 实例端口号 [3306]:
指定 MySQL 实例组件安装路径，输入完毕后按回车。若没有输入直接回车，将使用默认的安装路径（/opt/sequoiasql/mysql/data3306）
---------------------------------------------------------------------------- 设置实例数据目录 实例数据目录 [/opt/sequoiasql/mysql/data3306]:
询问是否继续安装，Y 表示继续，n 表示不继续。默认为继续
设定现在已经准备将 SequoiaSQL MySQL Server 安装到您的电脑. 您确定要继续? [Y/n]:
当屏幕上显示以下信息，表示 MySQL 实例组件已经安装完成
正在安装 SequoiaSQL MySQL Server 于您的电脑中，请稍候. 安装中 0% ______________ 50% ______________ 100% ######################################### ---------------------------------------------------------------------------- 安装程序已经完成安装 SequoiaSQL MySQL Server 于你的电脑中.
切换 sdbadmin 用户，检查实例状态。显示如下信息说明 MySQL 实例组件安装成功，用户可以来连接 MySQL Shell 进行数据操作。
$ /opt/sequoiasql/mysql/bin/sdb_mysql_ctl status 3306 mysqld3306 is running
Note:
安装完成后实例已经自动启动，无需执行启动步骤
启动 MySQL 实例组件的命令：/opt/sequoiasql/mysql/bin/sdb_mysql_ctl start 3306
停止 MySQL 实例组件的命令：/opt/sequoiasql/mysql/bin/sdb_mysql_ctl stop 3306
查看实例状态的命令： /opt/sequoiasql/mysql/bin/sdb_mysql_ctl status 3306
400-8038-339
邮箱
微信公众号
