金仓数据库KingbaseES 集群快速部署

关键字：

KingbaseES、集群、快速部署、人大金仓、KingbaseES

一、安装前准备

1.1环境要求

金仓数据库KingbaseES RWC集群当前支持各国产架构下的（LoongArch、Feiteng、Sw64、Kunpeng、Mips64）Kylin V10操作系统以及大部分x86平台下的Linux企业级发行版（CentOS、Kylin V10以及UOS）。

在进行集群快速部署前，请先安装好KES单机数据库。

1.2 安装准备

使用Linux命令将我们安装需要的文件提前准备好：

1. 切换当前工作路径至单机数据库安装路径下，命令如下：

cd {single_install_dir}（如：cd ~/V8R6B20230930SIT05/）

1. 拷贝我们需要的安装文件至当前用户的家目录下的cluster_install文件夹内，命令如下：

1. 切换当前工作路径至刚才的cluster_install文件夹，命令如下：

cd ~/cluster_install

1. （可选）提前准备好license.dat文件用于较长时间的测试

1.3 注意事项

请确认用户权限是否正确（umask为022）。

二、执行安装

执行安装有以下几个步骤：1、配置安装信息；2、配置免密；3、执行安装。下面我们将依次讲解每一步需要注意的一些细节。

2.1配置安装信息（install.conf）

我们打开install.conf（vim ./install.conf），其中提供了众多的配置项用以实现丰富的集群定制化部署。我们首先对文件进行一个简单的结构介绍。

install.conf可以分为三个部分，分别是[install]、[expand]、[shrink]，分别对应安装、扩容、缩容三个部分。因此对于安装来说，我们只需要关注install部分的内容。

对于快速部署集群来说，install中需要关注以下参数：

• all_ip：参与RWC集群部署的所有节点[1]IP；
• install_dir：集群的安装路径，尽量用空的路径；
• zip_package：我们cluster_install文件夹中的db.zip压缩包路径，这里需要使用绝对路径；
• trusted_servers：可信网关，这里可以填网关地址，或者非集群内部的其他节点IP；
• execute_user：执行用户，这里填当前的用户名。

此外还有一些需要注意的参数：

• db_port：数据库端口，部署好后通过该端口访问集群的数据库，该端口可能会冲突，公共环境下尽量不要用默认的；
• use_scmd：是否使用SecureCMD，启用该功能后集群通信将通过SecureCMD实现，但公共环境下该端口可能会冲突，值为0时关闭该功能；
• scmd_port：SecureCMD的端口号；
• ssh_port：SSH对应的端口号；
• license_file：证书名称，这里的证书使我们前面可选部分上传的license.dat，这里如果需要填写的话，就与证书同名即可。

完成上述操作后，我们就算是完成了对集群安装的基本配置。

2.2配置免密（trust_cluster.sh）

配置免密只需要运行trust_cluster.sh脚本即可，命令如下：

sh ./trust_cluster.sh

2.3执行安装（cluster_install.sh）

执行安装只需要运行cluster_install.sh脚本即可，命令如下：

sh ./cluster_install.sh

三、检查是否完成安装

进入到集群主节点的bin目录下（cluster_install_dir/kingbase/bin），命令如下：

cd {cluster_install_dir}/kingbase/bin

执行以下命令：

./repmgr cluster show # 预期能看到所有节点

./repmgr service status # 预期能看到所有节点

./ksql –Uesrep –desrep –p{your_port} –c’select * from sys_stat_replication;’ # 预期能看到所有备节点

如果上述能够按照预期正确执行，则认为安装完成

四、总结

首先准备好集群部署所需的内容，然后填写安装信息、配置节点间免密通信并执行安装，最后检查安装的集群是否正常正确。如果有更多的定制需要，请参考手册《金仓数据守护集群和读写分离集群使用手册》。

参考文档：

《金仓数据守护集群和读写分离集群使用手册》

1. 除witness ↑