【我和 openGauss 的故事】openGauss 主备集群节点的添加与删除

风一样自由 [openGauss](javascript:void(0);) 2023-07-29 17:58 发表于四川

一．环境准备

已搭建 openGauss 一主两备集群（企业版 5.0），环境如下：

主机 IP 主机名 节点类型

10.100.10.92 yf1 主节点

10.100.10.93 yf2 备节点

10.100.10.94 yf3 备节点

二．gs_dropnode 删除集群备节点

拟删除 10.100.10.94 节点。

1.前提条件

删除备节点的操作只能在主节点上执行；

执行删除操作前，确保主节点和备节点之间建立好 omm（数据库管理用户）用户的互信；

需要使用数据库管理用户执行该命令；

如果数据库是分离环境，则需要先 source 导入分离的环境变量。

2.注意事项

从主备数据库实例中移除当前仍可连通的备机时，会自动停止目标备机上正在运行的数据库服务，但是不会删除备机上的应用；

如果删除后数据库只剩下一个主机时，会建议重启当前主机，此时建议用户根据当前业务运行环境重启主机；

如果目标备机在执行操作前处于不可连通的状态，需要用户在目标备机恢复后手动停止或删除目标备机的数据库服务；

仅支持使用 om 方式安装的主备数据库实例中移除备机，不支持使用编译方式安装组建的主备数据库实例；

当移除的备机处于同步模式时，如果执行删除命令的同时主机上存在事务操作，事务提交时会出现短暂卡顿，删除完成后事务处理可继续运行；

当目标备机被移除后，如果不需要目标备机，请在目标备机上使用 gs_uninstall --delete-data -L 命令单点卸载 openGauss,请注意务必添加-L 选项；

当目标备机被移除后，如果暂时不确定是否需要目标备机，请删除目标备机的远程 ssh 文件，避免在目标备机上的误操作。

3.操作步骤

3.1 查看当前主备集群状态

3.2 移除备节点 10.100.10.94

执行命令：gs_dropnode -U omm -G dbgrp -h 10.100.10.94

注：从执行结果上可以推断节点已删除，但自动重启集群超时，可能由于网络或其他问题导致，可通过手动重启集群恢复。

3.3 查看集群状态

集群状态显示已成功删除节点 10.100.10.94。

3.4 在已删除节点关闭与原集群的 SSH 链接，避免后续操作

3.5 清理删除的备机系统环境数据（必须添加-L 参数）

3.6 清理删除后的备机系统环境软件及目录（必须添加-L 参数）

注：清理过程遇到缺失 netifaces 包，使用 pip 安装后重新执行命令

3.7 删除残留软件目录

节点删除完成。

三．gs_expansion 增加集群备节点

openGauss 提供了 gs_expansion 工具对数据库的备机进行扩容。

1.前提条件

数据库主机上存在 openGauss 镜像包，解压镜像包后，在 script/目录下执行./gs_expansion 命令进行扩容；

在新增的扩容备机上创建好与主机上相同的用户与用户组；

已存在的数据库节点和新增的扩容节点之间需要建立好 root 用户互信和 omm 用户（数据库管理用户）互信；

配置 xml 文件，在已安装数据库配置文件的基础上，添加需要扩容的备机信息；

只能使用 root 用户执行 gs_expansion 命令；

如果当前数据库是分离环境变量方式安装，则执行扩容命令前需要 source 导入主机数据库的分离环境变量。

2.注意事项

从单机扩容到主备模式时，需要将单机数据库以 primary 的方式启动，因此会对数据库进程进行重启操作。单机扩容时请规划好运行中的业务。主备模式扩容时不需要重启数据库。

主备机器安装的数据库需要使用相同的用户和用户组，分离环境路径也需要保持一样；

主备机器安装时 xml 配置里面的 gaussdbAppPath、gaussdbLogPath、gaussdbToolPath、corePath 地址需要保持一致；

扩容机器上的数据必须使用 om 方式安装，使用编译方式启动的数据库不支持与主机扩容。

3.操作步骤

3.1 新备机操作：配置用户、用户组、hosts 文件（与 primary 节点相同）

3.2 主节点操作：建立新节点与所有节点的 SSH 互信

3.3 主节点操作：修改 xml 文件，添加新节点信息

3.4 主节点操作：执行 gs_expansion 完成扩容操作

执行命令：./gs_expansion -U omm -G dbgrp -X /opt/opengauss/cluster_config.xml -h 10.100.10.94

注：结果显示在执行预初始化新节点时超时了，可能由于网络或其他问题导致。重新执行后如下所示：

从执行结果上可以推断节点已完成扩容，但自动重启集群超时，可能由于网络或其他问题导致，可通过手动重启集群恢复。

3.5 检查扩容后集群状态

集群状态正常，扩容完成。