gs_expansion

背景信息

openGauss提供了gs_expansion工具对数据库的备机进行扩容。支持从单机或者一主多备最多扩容到一主八备。

注意事项

  • 从单机扩容到主备模式时，需要将单机数据库以Primary的方式启动，因此会对数据库进程进行重启操作。单机扩容时请规划好运行中的业务。
  • 扩容后不会自动更新synchronous_standby_names参数。如果需要为该参数增加扩容的机器，请在扩容完成后手动更新。

前提条件

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

语法

  • 备机扩容

    1. ./gs_expansion -U USER -G GROUP -X XMLFILE -h hostlist [-L]

  • 显示帮助信息

    1. ./gs_expansion -? | --help

  • 显示版本号信息

    1. ./gs_expansion -V | --version

参数说明

  • -U

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

    新增扩容的备机用户名必须与已安装数据库的主机保持一致，且要提前创建好。

  • -G

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

    新增扩容的备机用户组必须与已安装数据库的主机保持一致。

  • -X

    openGauss配置文件路径。

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

  • -h

    指定扩容备机的IP地址。

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

  • -L

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

    需要注意：

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

  • -?, –help

    显示帮助信息。

  • -V, –version

    显示版本号信息。

示例

使用gs_expansion扩容步骤。

  1. # ./gs_expansion -U zxb -G zxb -X /opt/zxb/instance4.xml -h 90.90.44.165
  2. Start to preinstall database on the new standby nodes.
  3. Successfully preinstall database on the new standby nodes.
  5. Start to install database on the new standby nodes.
  7. installing database on node 90.90.44.165:
  8. Please enter the password of user [zxb] on node [90.90.44.165]:
  9. Parsing the configuration file.
  10. Check preinstall on every node.
  11. Successfully checked preinstall on every node.
  12. Creating the backup directory.
  13. Successfully created the backup directory.
  14. begin deploy..
  15. Installing the cluster.
  16. begin prepare Install Cluster..
  17. Checking the installation environment on all nodes.
  18. begin install Cluster..
  19. Installing applications on all nodes.
  20. Successfully installed APP.
  21. begin init Instance..
  22. encrypt cipher and rand files for database.
  23. Please enter password for database:
  24. Please repeat for database:
  25. begin to create CA cert files
  26. The sslcert will be generated in /usr1/zxb/opengauss/gaussdb/app/share/sslcert/om
  27. Cluster installation is completed.
  28. Configuring.
  29. Deleting instances from all nodes.
  30. Successfully deleted instances from all nodes.
  31. Checking node configuration on all nodes.
  32. Initializing instances on all nodes.
  33. Updating instance configuration on all nodes.
  34. Check consistence of memCheck and coresCheck on database nodes.
  35. Configuring pg_hba on all nodes.
  36. Configuration is completed.
  37. Successfully started cluster.
  38. Successfully installed application.
  39. end deploy..
  41. Successfully install database on node ['90.90.44.165']
  43. Database on standby nodes installed finished. Start to establish the primary-standby relationship.
  45. Success to expansion standby nodes.

相关命令

gs_preinstall，gs_install，gs_ctl