安装

前提条件

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

安装 - 图1 注意： 如果安装前没有执行关闭HISTORY记录禁用history命令，为防止历史记录敏感信息泄露，安装完成后请手动清理history中的敏感信息。 若安装前已执行操作关闭HISTORY记录，请忽略该说明。

操作步骤

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

    1. tar -zxf openGauss-Lite-3.0.0-openEuler-aarch64.tar.gz -C ~/openGauss

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

    1. cd ~/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

    安装 - 图2 说明：

    • -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”章节。
    • –env-sep-file：分离环境变量文件，会将使用过程中需要的环境变量写到该文件中，默认为用户的bashrc文件，注意不要传递目录。
    • –start：安装完成是否启动集群，默认不启动。
    • –ulimit：是否进行最大文件数配置（配置数为1000000），默认不设置。
    • –cert-path：ssl证书路径，传递了该参数，ssl会被设置为on，同时会把该路径下证书拷贝到数据目录。
    • –ssl-client-ip：客户端ip，只有在–cert-path参数启用的时候生效，会把客户端ip添加到白名单里面。
    • -h|–help：打印使用说明。

    安装 - 图3 注意：

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

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

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

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

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

    • 安装主备环境的时候，如果replconninfo中采用的是sslmode=verify-ca，会出现备机连不上主机的现象，需要通过以下方式解决

    • ${GAUSSDATA}代表dn数据目录

    • 示例：sh install.sh -R ~/app -m primary -D ~/data -l ~/log –start -C “replconninfo1=’localhost=xxx.xx.xx.x localport=xxxx remotehost=xxx.xx.xx.x remoteport=xxxx sslmode=verify-ca’”

    • 操作步骤

    • 准备证书、私钥。有关生成证书操作，请参考《数据库管理指南》中的“管理数据库安全 > SSL证书管理 > 证书生成”章节。

    • 服务端各个配置文件名称约定：

      1. 证书名称约定：server.crt。
      2. 私钥名称约定：server.key。
      3. 私钥密码加密文件约定：server.key.cipher、server.key.rand。

    • 客户端各个配置文件名称约定：

      1. 证书名称约定：client.crt。
      2. 私钥名称约定：client.key。
      3. 私钥密码加密文件约定：client.key.cipher、client.key.rand。
      4. 根证书名称约定：cacert.pem。
      5. 吊销证书列表文件名称约定：sslcrl-file.crl。

    • 拷贝证书到各个节点的数据目录。

      1. 1.  将服务端各个配置文件server.crt、server.key、server.key.cipher、server.key.rand拷贝到对应目录下。
      2. 2.  将客户端各个配置文件client.crt、client.key、client.key.cipher、client.key.rand、cacert.pem（如果需要配置吊销证书列表，则列表中包含sslcrl-file.crl）拷贝到到对应目录下。

    • 加密用户密码 （可选，如果证书已经生成了私钥可跳过）

      1. 主节点： gs\_guc encrypt -M server -K 数据库密码 -D $\{GAUSSDATA\}/
      2. 备节点： gs\_guc encrypt -M client -K 数据库密码 -D $\{GAUSSDATA\}/
      3. 其中$\{GAUSSDATA\}为数据目录

    • 配置ssl

      1. gs_guc set -D ${GAUSSDATA} -c "ssl=on" 
      2. gs_guc set -D ${GAUSSDATA} -c "ssl_ciphers = 'ALL'" 
      3. gs_guc set -D ${GAUSSDATA} -c "ssl_cert_file = 'server.crt'" 
      4. gs_guc set -D ${GAUSSDATA} -c "ssl_key_file = 'server.key'" 
      5. gs_guc set -D ${GAUSSDATA} -c "ssl_ca_file = 'cacert.pem'"

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

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

    • 依次重启主备openGauss。

      1. gs_ctl restart -D ${GAUSSDATA}

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

    1. ps ux | grep gaussdb
    2. gs_ctl query -D /opt/data

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

    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
    4.     static_connections             : 0
    5.     db_state                       : Normal
    6.     detail_information             : Normal
    8. Senders info:
    9.     No information
    11.  Receiver info:
    12. No information