【AntDB数据库】初始化与启动

• antdb_init.sh

• 集中式

  1. 编辑 setup/common/initconf-c.template，与构建环境保持一致，各参数说明参考下文

  2. 执行如下命令进行初始化部署

     ./antdb_init.sh -c ./setup/common/initconf-c.template
     

     注意：可能存在脚本执行权限不够的问题，请为脚本增加执行权限，示例如下：

     chmod u+x ./antdb_init.sh
     

  3. 执行完成后，会输出集群的部署信息。例如

     +-----------+--------------------+--------------+---------+----+-----------+
     | Member    | Host               | Role         | State   | TL | Lag in MB |
     + Cluster: antdbcluster (7200244341737363629) --+---------+----+-----------+
     | patroni-1 | 10.21.10.211:5432  | Leader       | running |  2 |           |
     | patroni-2 | 10.21.10.212:22222 | Replica      | running |  2 |         0 |
     | patroni-3 | 10.21.10.213:22222 | Sync Standby | running |  2 |         0 |
     +-----------+--------------------+--------------+---------+----+-----------+
     

• 分布式

  1. 编辑 setup/common/initconf-d.template，与构建环境保持一致，各参数说明参考下文

  2. 执行如下命令进行初始化部署

     ./antdb_init.sh -c ./setup/common/initconf-d.template
     

  3. 执行完成后，会输出集群的部署信息。例如

     nodename |      nodetype      | status | description |     host     | port  | recovery |           boot time           | nodezone
     ----------+--------------------+--------+-------------+--------------+-------+----------+-------------------------------+----------
     gc_1     | gtmcoord master    | t      | running     | 10.21.10.212 | 60103 | false    | 2023-02-15 13:07:01.171103+08 | local
     cn1      | coordinator master | t      | running     | 10.21.10.211 | 60100 | false    | 2023-02-15 12:56:54.735623+08 | local
     dn1_1    | datanode master    | t      | running     | 10.21.10.211 | 60104 | false    | 2023-02-15 12:56:56.112354+08 | local
     dn2_1    | datanode master    | t      | running     | 10.21.10.212 | 60105 | false    | 2023-02-15 13:07:40.49796+08  | local
     dn3_1    | datanode master    | t      | running     | 10.21.10.213 | 60106 | false    | 2023-02-15 12:56:55.875072+08 | local
     (5 rows)
     

     在使用adb指令连接AntDB数据库前，请检查当前环境是否已安装adb，检查语句示例：

[antdb@adb03 antdb-ce-7.2.0.centos7.x86_64]$ which adb
~/app/antdb/bin/adb

• 配置文件说明

  根据上面示例所示，配置文件位于 setup/common 中，initconf-c.template 为集中式配置文件，initconf-d.template 为分布式配置文件。各个配置文件中的参数说明如下：

  集中式：

  1. [clusterinfo]
     • clustertype：表示数据库初始化的类型，C_ALONE 为单机版；C_HA 为集中式高可用版。如果是 C_HA 时，需要同时需要填写 standbyinfo、etcdinfo、patroniinfo。
     • clustername：数据库集簇的名称，作为标识使用，无特殊要求。
     • user：执行此安装程序的用户，初始化完成后，这个用户就是一个超级用户。
     • password：为上述安装用户（超级用户）设置一个密码。
     • defaultdatabase：初始化时，默认创建的数据库。
  2. [primaryinfo]
     • antdbapppath：执行此程序的节点的数据库二进制程序的安装目录，即安装时指定的目录。
     • dbdatapath：数据库初始化时的数据目录，需要设定为空目录。
     • dbport：数据库的端口号。
     • ip：执行此程序的节点的ip地址。
     • sshport：执行此程序的节点的SSH服务端口号。
  3. [standbyinfo]
     • standby_num：备节点数量。
     • standby_n：备节点的明细信息，逗号分隔。分别为备节点名称、备节点ip地址、备节点SSH服务端口号、备节点数据库程序目录、备节点数据库数据目录、备节点数据库端口号、备节点同步模式
  4. [etcdinfo]
     • etcdnode_num：etcd数量，每个数据节点一个etcd。
     • etcdnode_n：etcd的详细配置信息，逗号分隔。分别为etcd节点名称、etcd数据目录、etcd客户端连接端口、etcd通信端口、etcd所在的节点名称（与数据库节点名称对应，如上述的primary，standby_1~standby_n）。
  5. [patroniinfo]
     • patroninode_num：patroni数量，每个数据节点一个patroni。
     • patroninode_n：patroni的信息配置信息，逗号分隔。分别为patroni节点名称、patroni端口、patroni所在的节点名称（与数据库节点名称对应）。

  分布式：

  1. [clusterinfo]
     • clustertype：表示数据库初始化的类型，D 为分布式。
     • user：执行此安装程序的用户，初始化完成后，这个用户就是一个超级用户。
     • password：为上述安装用户（超级用户）设置一个密码。
  2. [mgrinfo]
     • antdbapppath：执行此程序的节点的数据库二进制程序的安装目录，即安装时指定的目录。
     • dbdatapath：mgr管理节点的初始化时的数据目录，需要设定为空目录。
     • dbport：mgr管理节点的数据库端口号。
     • ip：mgr管理节点的的ip地址。
     • sshport：执行此程序的节点的SSH服务端口号。
  3. [agentinfo]
     • agent_num：分布式数据库所使用的主机数量。
     • agent_n：分布式主机信息，逗号分隔。分别为节点名称、主机间通信端口、主机间通信方式（暂时只支持ssh通信）、数据库二进制程序的安装目录、主机ip地址、数据库代理程序端口号、主机上操作系统用户（通常与clusterinfo配置为同一用户）。
  4. [nodeinfo]
     • node_num：分布式数据库集群中所有节点数量。
     • node_n：分布式数据库中各个角色的详细信息，逗号分隔。分别为角色名称、角色类型（GC、CN、DN）、角色所在主机名称（与agentinfo对应）、角色的数据库端口号、角色的数据目录、角色的身份（master、slave）、角色对应的主库的角色名称、角色的数据同步模式（如果节点为slave，则需要最后两个配置项；分别为master节点名称、自身的同步模式）