• 已完成用户组和普通用户的创建。
    • 所有服务器操作系统和网络均正常运行。
    • 普通用户必须有数据库安装包解压目录、安装目录、数据目录的读、写和执行权限，并且安装目录，数据目录必须为空，且安装目录和数据目录以及配置的日志目录不能存在交叉。
    • 普通用户对下载的openGauss轻量版压缩包有执行权限。
    • 安装前请检查指定的端口是否被占用，如果被占用请更改端口或者停止当前使用端口进程。
    • 环境变量：新安装时请确保GAUSSHOME，GAUSSDATA，GAUSSLOG，GAUSSENV不存在，如果是执行配置启动等后续操作，确保这些环境变量对应的配置正确。

    操作步骤

    1. 使用普通用户登录到openGauss轻量版包安装的主机，解压轻量版安装包到安装目录。

    2. 假定解压包的路径为/opt/software/openGauss，进入解压后目录。

    3. 执行install.sh脚本安装openGauss轻量版安装包。

      1. 单机：echo password | sh ./install.sh --mode single -D ~/openGauss/data -R ~/openGauss/install  --start
      2. 主备：
      3.     1、主节点：echo password | sh ./install.sh --mode primary -D ~/openGauss/data -R ~/openGauss/install  -C "replconninfo1='localhost=ip1 localport=port1 remotehost=ip2 remoteport=port2'" --start
      4.     2、备节点：echo password | sh ./install.sh --mode standby -D ~/openGauss/data -R ~/openGauss/install  -C "replconninfo1='localhost=ip1 localport=port1 remotehost=ip2 remoteport=port2'" --start

      说明：

      • -D|–data-path：数据库数据路径， 不可和安装目录交叉，必须为空。
      • -R|–app-path：数据库安装路径，不可和数据目录交叉。
      • -l|–log-path：日志保存路径。
      • -f|–guc-file：guc配置文件，批量进行guc参数设置，默认为安装脚本同级文件opengauss_lite.conf，可指定。
      • -m|–mode：节点类型，默认single，支持primary（主节点），standby（备节点），single（单机）。
      • -n|–nodename：实例名称，主节点默认master，备节点默认slave，单机默认single。
      • -P|–gsinit-parameter：初始化参数，具体详见文档《工具与命令参考》中的“系统内部使用的工具 > gs_initdb”章节，出于安全考虑，不建议使用该接口传递密码。建议使用echo和pipe方式来传递密码，如果主备密码设置的不一致，最终会使用主节点设置的密码，同时密码长度为8-32位。
      • -C|–dn_guc：数据库配置参数，具体详见文档《工具与命令参考》中的“服务端工具 > gs_guc”章节。
      • –start：安装完成是否启动集群，默认不启动。
      • –ulimit：是否进行最大文件数配置（配置数为1000000），默认不设置。
      • –cert-path：ssl证书路径，传递了该参数，ssl会被设置为on，同时会把该路径下证书拷贝到数据目录。
      • –ssl-client-ip：客户端ip，只有在–cert-path参数启用的时候生效，会把客户端ip添加到白名单里面。
      • -h|–help：打印使用说明。

      • 因为每一步都是可重入的，所以如果分离了环境变量，每一步执行脚本需要指定环境变量路径。

      • 主备节点保证IP类型一致，如果主节点使用IPV6，备节点也请使用IPV6。

      • 如果有多个备节点，需要在每一个节点上安装的时候传递所有节点的信息，注意区分本机和远端的信息。

      • 如果进行ulimit设置的时候，报错ulimit: open files: cannot modify limit: Operation not permitted，请使用root权限，在/etc/security/limits.conf中修改该用户可配文件数量的上限。

      • 如果安装异常终止，请检查安装目录和数据目录是否符合预期条件，必要情况下手动清理环境变量。

      操作步骤

      • 准备证书、私钥。有关生成证书操作，请参考《数据库管理指南》中的“管理数据库安全 > SSL证书管理 > 证书生成”章节。 服务端各个配置文件名称约定：
        • 证书名称约定：server.crt。
        • 私钥名称约定：server.key。
        • 私钥密码加密文件约定：server.key.cipher、server.key.rand。 客户端各个配置文件名称约定：
        • 证书名称约定：client.crt。
        • 私钥名称约定：client.key。
        • 私钥密码加密文件约定：client.key.cipher、client.key.rand。
        • 根证书名称约定：cacert.pem。
        • 吊销证书列表文件名称约定：sslcrl-file.crl。
      • 拷贝证书到各个节点的数据目录。
        1. 将服务端各个配置文件server.crt、server.key、server.key.cipher、server.key.rand拷贝到对应目录下。
        2. 将客户端各个配置文件client.crt、client.key、client.key.cipher、client.key.rand、cacert.pem（如果需要配置吊销证书列表，则列表中包含sslcrl-file.crl）拷贝到到对应目录下。

      • 配置ssl

      • 备节点导出如下环境变量（文件权限不能大于600）

        1. export PGSSLCERT="${GAUSSDATA}/client.crt"
        2. export PGSSLKEY="${GAUSSDATA}/client.key"

      • 依次重启主备openGauss。

        1. gs_ctl restart -D ${GAUSSDATA}

    4. 安装执行完成后，使用ps和gs_ctl查看进程是否正常。

      1. omm      24209 11.9  1.0 1852000 355816 pts/0  Sl   01:54   0:33 /opt/install/bin/gaussdb -D /opt/data
      2. omm      20377  0.0  0.0 119880  1216 pts/0    S+   15:37   0:00 grep --color=auto gaussdb

      执行gs_ctl命令，显示类似如下信息：

      1. gs_ctl query ,datadir is /opt/data
      2. HA state:
      3.     local_role                     : Normal
      5.     db_state                       : Normal
      6.     detail_information             : Normal
      8. Senders info:
      9.     No information