执行安装

执行前置脚本准备好openGauss安装环境之后，按照启动安装过程部署openGauss。

前提条件

  • 已成功执行前置脚本gs_preinstall。即完成了准备安装用户及环境。
  • 所有服务器操作系统和网络均正常运行。
  • 用户需确保各个主机上的locale保持一致。

操作步骤

  1. 检查安装包和openGauss配置文件在规划路径下是否已存在，如果没有，重新执行预安装，确保预安装成功，再执行以下步骤。

  2. 登录到openGauss的主机，并切换到omm用户。

    1. su - omm

    执行安装 - 图1 说明：

    • omm指的是前置脚本gs_preinstall中-U参数指定的用户。

    • 安装脚本gs_install必须以前置脚本中指定的omm执行，否则，脚本执行会报错。

    • openGauss在海思高版本芯片上编译的不能在海思低版本芯片的服务器上运行，比如Hi620编译的版本不能在Hi1616环境上运行。

  3. 使用gs_install安装openGauss。若为环境变量分离的模式安装的数据库需要source环境变量分离文件ENVFILE。

    1. gs_install -X /opt/software/openGauss/cluster_config.xml

    /opt/software/openGauss/cluster_config.xml为openGauss配置文件的路径。在执行过程中，用户需根据提示输入数据库的密码，密码具有一定的复杂度，为保证用户正常使用该数据库，请记住输入的数据库密码。

    设置的密码要符合复杂度要求：

    • 最少包含8个字符。
    • 不能和用户名、当前密码（ALTER）、或当前密码反序相同。
    • 至少包含大写字母（A-Z），小写字母（a-z），数字，非字母数字字符（限定为~!@#$%^&*()-_=+\|[{}];:,<.>/?）四类字符中的三类字符。

    安装过程中会生成ssl证书，证书存放路径为{gaussdbAppPath}/share/sslcert/om，其中{gaussdbAppPath}为openGauss配置文件中指定的程序安装目录。

    日志文件路径下会生成两个日志文件：“gs_install-YYYY-MMDD_HHMMSS.log”和“gs_local-YYYY-MM-DD_HHMMSS.log”。

    执行安装 - 图2 说明：

    • openGauss支持字符集的多种写法：gbk/GBK、UTF-8/UTF8/utf8/utf-8和Latine1/latine1。

    • 安装时若不指定字符集，默认字符集为SQL_ASCII，为简化和统一区域loacle默认设置为C，若想指定其他字符集和区域，请在安装时使用参数–gsinit-parameter=“–locale=LOCALE”来指定，LOCALE为新数据库设置缺省的区域。

      例如用户要将数据库编码格式初始化为UTF-8，可以采用如下步骤：

      用locale -a |grep utf8命令查看系统支持UTF-8编码的区域，如下：

      1. omm@linux:~>  locale -a|grep utf8

      显示类似如下信息，其中en_US.utf8表示区域en_US支持UTF-8编码。

      1. en_SG.utf8 
      2. en_US.utf8

      根据需要选择区域，如en_US.utf8，初始化数据库时加入–locale=en_US.utf8选项进行安装，示例如下：

      1. gs_install -X /opt/software/openGauss/cluster_config.xml --gsinit-parameter="--locale=en_US.utf8"

  4. 安装执行成功之后，需要手动删除主机root用户的互信，即删除openGauss数据库各节点上的互信文件。

    1. rm –rf ~/.ssh

安装生成的目录

安装后的目录及各目录下的文件说明请参见表1。

表 1 安装生成的目录

序号

项目目录说明

目录

子目录

说明

1

openGauss安装目录

/opt/huawei/install/app

bin

存放数据库二进制文件的目录。

etc

cgroup工具配置文件。

include

存放数据库运行所需要的头文件。

lib

存放数据库的库文件的目录。

share

存放数据库运行所需要的公共文件，如配置文件模板。

2

openGauss数据目录

/opt/huawei/install/data/dn

data_dnxxx

DBnode实例的数据目录，其中主实例的目录名为“data_dnxxx”，

备实例的为data_dnSxxx。xxx代表DBnode编号。

3

openGauss日志目录

/var/log/omm/用户名

bin

二进制程序的日志目录。

gs_profile

数据库内核性能日志目录。

om

OM的日志目录。例如：

部分local脚本产生的日志，增删数据库节点接口的日志，gs_om接口的日志，前置接口的日志，节点替换接口的日志等。

pg_audit

数据库审计日志目录。

pg_log

数据库节点实例的运行日志目录。

4

openGauss系统工具目录

/opt/huawei/install/om

script

用于openGauss用户进行openGauss管理的脚本文件。

lib

bin目录下的二进制文件依赖的库文件。

5

openGauss临时文件目录

/opt/huawei/tmp

  

用于放置临时文件

示例

执行安装：

  1. omm@plat1:~> gs_install -X /opt/software/openGauss/cluster_config.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 ciper 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.

错误排查

如果安装失败请根据openGauss日志目录下的“gs_install-YYYY-MM-DD_HHMMSS.log”和“gs_local-YYYY-MM-DD_HHMMSS.log”中的日志信息排查错误。