gs_expansion

注意事项

• 扩容后不会自动更新synchronous_standby_names参数。如果需要为该参数增加扩容的机器，请在扩容完成后手动更新。
• 扩容级联备之前要确保原集群中有处于同一AZ（Available Zone）且状态正常的备机，或扩容级联备的同时也扩容了处于同AZ的备机。
• 对数据库集群进行扩容前，需要关注主机及新扩容节点CPU、IO、网络等情况，不建议在硬件压力较大时执行扩容，否则可能导致扩容耗时较长甚至扩容失败。
• 当原集群数据量较大时，在进行扩容操作前应当在主机上先执行checkpoint，否则可能导致扩容耗时较长甚至扩容失败。

• 数据库主机上存在openGauss镜像包，解压镜像包后，在script目录下执行./gs_expansion命令进行扩容。
• 已存在的数据库节点和新增的扩容节点之间需要建立好root用户互信以及数据库管理用户（如omm）的互信。
• 正确配置xml文件，在已安装数据库配置文件的基础上，添加需要扩容的备机信息。
• 只能使用root用户执行gs_expansion命令。
• 不允许同时在主节点上执行gs_dropnode命令删除其他备机。
• 执行扩容命令前需要通过source命令导入主机数据库的环境变量。如果当前数据库是分离环境变量方式安装，则source导入分离的环境变量。如果未进行分离，则需要source导入子用户的.bashrc配置文件。一般该文件路径为：/home/[user]/.bashrc。
• 扩容备机的操作系统与主机保持一致。
• 操作过程中不允许同时在其他备节点上执行主备倒换或者故障倒换的操作。
• 不允许同时执行2次相同的gs_expansion命令。
• 扩容备节点的操作只能在主节点上执行。

语法

• 备机扩容

• 显示帮助信息

• 显示版本号信息

• -G

  运行openGauss的操作系统用户组。

• -X

  openGauss配置文件路径。

  取值范围：xml文件的存储路径。xml文件里面需要包含已安装的数据库以及新增扩容数据库所有节点配置信息。

• -h

  指定扩容备机的IP地址。

  取值与xml配置文件里面的backip保持一致。如果有多个节点，节点之间以逗号分隔。

• -L

  如果要扩容的节点已经安装了单机版的数据库，扩容时候添加 –L 参数可以跳过在新扩容备机上安装数据库的步骤，直接建立主备关系。

  1. 主备机器安装的数据库需要使用相同的用户和用户组，分离环境变量路径也需要保持一样。
  2. 主备机器安装时候xml配置里面的gaussdbAppPath、gaussdbLogPath、gaussdbToolPath、corePath地址需要保持一致。
  3. 扩容备机上的数据必须使用om方式安装，使用编译方式启动的数据库不支持与主机扩容。
  4. 新增扩容节点的数据库版本需要与主库保持一致。

• -?, —help

  显示帮助信息。

• -V, —version

  显示版本号信息。

示例

使用gs_expansion扩容步骤。