本文主要介绍如何在本地主机部署 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 选择中文
欢迎来到 SequoiaDB Server 安装程序
重要信息:请仔细阅读
下面提供了两个许可协议。
如果被许可方为了生产性使用目的(而不是为了评估、测试、试用“先试后买”或演示)获得本程序,单击下面的“接受”按钮即表示被许可方接受 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