快速部署工具

quickDeploy.sh 是 SequoiaDB 巨杉数据库的快速部署工具，用于部署 SequoiaDB 集群和 SQL 实例。其中，SequoiaDB 集群支持部署在单台或多台机器，SQL 实例仅支持部署在单台机器。

语法规则

quickDeploy.sh [--sdb] [--mysql] [--pg] [--cm=Number] [--mysqlPath=String] [--pgPath=String]

参数说明

Note:

• 当不指定参数 --sdb、--mysql 和 --pg 时，快速部署工具将根据本机的安装情况自动部署 SequoiaDB 集群和 SQL 实例。
• 快速部署工具不支持同时部署多个 MySQL 或 PostgreSQL 实例组件。如果本机安装了多个 MySQL 或 PostgreSQL 实例组件，需指定参数 --mysqlPath 或 --pgPath。

常见场景

快速部署工具常用于伪集群或集群部署。伪集群部署是指在单台机器上部署集群，而集群部署是指在多台机器上部署集群。部署完成后，用户可使用 sdblist 工具查看当前集群的部署情况。

伪集群部署

快速部署工具默认在当前机器中部署一个三组单副本的伪集群，同时根据已安装的实例组件创建 SQL 实例。以 MySQL 实例组件为例，具体步骤如下：

1. 切换至 SequoiaDB 安装目录

   $ cd /opt/sequoiadb

2. 执行快速部署工具

   $ ./tools/deploy/quickDeploy.sh

   输出如下信息则表示部署成功：

   ************ Deploy SequoiaDB ************************
   Create catalog: sdbserver1:11800
   Create coord:   sdbserver1:11810
   Create data:    sdbserver1:11820
   Create data:    sdbserver1:11830
   Create data:    sdbserver1:11840
   ************ Deploy SequoiaSQL-MySQL *****************
   Create instance: [name: myinst, port: 3306]

集群部署

快速部署工具通过配置文件实现集群部署。用户可根据业务需求，修改配置文件以调整集群规模。

配置文件位于目录 <INSTALL_DIR>\tools\deploy，其中 sequoiadb.conf 用于配置 SequoiaDB 集群，mysql.conf 和 postgresql.conf 用于配置 SQL 实例。下述以三台机器为例，部署一个三组三副本的集群，并创建多个 MySQL 实例。

1. 切换至 SequoiaDB 安装目录

   $ cd /opt/sequoiadb

2. 编辑配置文件 sequoiadb.conf

   $ vim tools/deploy/sequoiadb.conf

   修改内容如下：

   role,groupName,hostName,serviceName,dbPath
   
   catalog,SYSCatalogGroup,sdbserver1,11800,[installPath]/database/catalog/11800
   catalog,SYSCatalogGroup,sdbserver2,11800,[installPath]/database/catalog/11800
   catalog,SYSCatalogGroup,sdbserver3,11800,[installPath]/database/catalog/11800
   
   coord,SYSCoord,sdbserver1,11810,[installPath]/database/coord/11810
   coord,SYSCoord,sdbserver2,11810,[installPath]/database/coord/11810
   coord,SYSCoord,sdbserver3,11810,[installPath]/database/coord/11810
   
   data,group1,sdbserver1,11820,[installPath]/database/data/11820
   data,group1,sdbserver2,11820,[installPath]/database/data/11820
   data,group1,sdbserver3,11820,[installPath]/database/data/11820
   
   data,group2,sdbserver1,11830,[installPath]/database/data/11830
   data,group2,sdbserver2,11830,[installPath]/database/data/11830
   data,group2,sdbserver3,11830,[installPath]/database/data/11830
   
   data,group3,sdbserver1,11840,[installPath]/database/data/11840
   data,group3,sdbserver2,11840,[installPath]/database/data/11840
   data,group3,sdbserver3,11840,[installPath]/database/data/11840

3. 编辑配置文件 mysql.conf

   $ vim tools/deploy/mysql.conf 

   分别配置端口为 3306 和 3307 的实例，修改内容如下：

   instanceName,port,databaseDir,coordAddr
   myinst1,3306,[installPath]/database/3306,-
   myinst2,3307,[installPath]/database/3307,sdbserver1:11810

   Note:

   • 符号“-”表示 sequoiadb.conf 中第一个协调节点的地址。
   • 如果需要指定多个协调地址，可使用逗号（,）间隔，例如 [sdbserver1:11810,sdbserver2:11810]。

4. 执行快速部署工具

   $ ./tools/deploy/quickDeploy.sh

   输出如下内容则表示部署成功：

   ************ Deploy SequoiaDB ************************
   Create catalog: sdbserver1:11800
   Create catalog: sdbserver2:11800
   Create catalog: sdbserver3:11800
   ...
   Create data:    sdbserver1:11840
   Create data:    sdbserver2:11840
   Create data:    sdbserver3:11840
   
   ************ Deploy SequoiaSQL-MySQL *****************
   Create instance: [name: myinst1, port: 3306]
   Create instance: [name: myinst2, port: 3307]