gs_install

背景信息

数据库的部署是一个复杂的过程。openGauss提供了gs_install工具来帮助完成openGauss的安装和部署。

openGauss安装部署，要求用户指定配置文件，配置文件中会指定程序安装路径、实例数据目录、主备关系、实例数、各实例的业务IP端口等信息。

前提条件

  • 已成功执行前置脚本gs_preinstall。
  • 用户需确保各个节点上的locale保持一致。
  • 需要使用前置时设置的openGauss用户进行安装操作。

语法

  • 安装openGauss

    1. gs_install -X XMLFILE [--gsinit-parameter="PARAMETER" [...]] [--dn-guc="PARAMETER" [...]] [--alarm-component=ALARMCOMPONENT] [--time-out=SECS] [-l LOGFILE]

    gs_install - 图1 说明：

  • 显示帮助信息

    1. gs_install -? | --help

  • 显示版本号信息

    1. gs_install -V | --version

参数说明

  • -X

    openGauss配置文件的路径。

    取值范围：xml文件的存储路径。

  • -l

    指定安装日志文件及日志文件存放的路径。

    当既不明确指定-l，又不在XML文件中配置gaussdbLogPath时，默认值为“$GAUSSLOG/om/gs_install-YYYY-MM-DD_hhmmss.log”；

    当不明确指定-l，但在XML文件中配置了gaussdbLogPath时，默认值为“gaussdbLogPath的值、用户名和om/gs_install-YYYY-MM-DD_hhmmss.log”的组合。

  • –gsinit-parameter=PARAM

    数据实例参数指定。

    取值范围请参见gs_initdb的参数说明，其中对-A、-D、-U、-C、-X参数的设置不生效。

  • –dn-guc=PARAM

    配置参数。

    取值范围请参见gs_guc的参数说明。

  • –time-out=SECS

    启动超时等待时间。单位：s。

    若–time-out取值过小，有可能会因为需要启动的实例数过多而引起超时。若在超时时间内启动不成功，则会报错启动超时，但是openGauss会在后台继续启动。可以等待一段时间后，查询openGauss状态，检查openGauss是否启动成功。

    取值范围：正整数，若无特殊需求，不需要配置该参数，系统会自动调整超时时间。

  • –alarm-component=alarm_component

    指定告警上报组件的绝对路径。

  • -?, –help

    显示帮助信息。

  • -V, –version

    显示版本号信息。

示例

使用gs_install脚本进行openGauss安装。

  1. gs_install -X /opt/software/openGauss/clusterconfig.xml
  2. Parsing the configuration file.
  3. Check preinstall on every node.
  4. Successfully checked preinstall on every node.
  5. Creating the backup directory.
  6. Successfully created the backup directory.
  7. begin deploy..
  8. Installing the cluster.
  9. begin prepare Install Cluster..
  10. Checking the installation environment on all nodes.
  11. begin install Cluster..
  12. Installing applications on all nodes.
  13. Successfully installed APP.
  14. begin init Instance..
  15. encrypt cipher and rand files for database.
  16. Please enter password for database:
  17. Please repeat for database:
  18. begin to create CA cert files
  19. The sslcert will be generated in /opt/gaussdb/cluster/app/share/sslcert/om
  20. Cluster installation is completed.
  21. Configuring.
  22. Deleting instances from all nodes.
  23. Successfully deleted instances from all nodes.
  24. Checking node configuration on all nodes.
  25. Initializing instances on all nodes.
  26. Updating instance configuration on all nodes.
  27. Check consistence of memCheck and coresCheck on DN nodes.
  28. Successful check consistence of memCheck and coresCheck on all nodes.
  29. Configuring pg_hba on all nodes.
  30. Configuration is completed.
  31. Successfully started cluster.
  32. Successfully installed application.

相关命令

gs_postuninstall，gs_preinstall，gs_uninstall