openGauss 企业版安装全流程指南

介绍

本文详细介绍了 openGauss 企业版在 CentOS 7.6 环境下的完整安装流程，涵盖环境准备、安装包获取、配置文件创建、预安装、正式安装、远程连接配置及常见问题排查。

一、 环境准备

1.1 硬件与操作系统要求

• 操作系统：CentOS 7.6 或 openEuler 2.0 及以上（推荐 CentOS 7.6）。

• 硬件配置：建议至少 4 核 CPU、16GB 内存（测试环境可临时使用 2 核 8GB）。

1.2 系统环境配置

以 root​ 用户执行以下命令，关闭防火墙和 SELinux，并安装必要的依赖包。

# 1. 关闭防火墙
systemctl stop firewalld
systemctl disable firewalld

# 2. 关闭 SELinux
setenforce 0
sed -i 's/SELINUX=enforcing/SELINUX=disabled/' /etc/selinux/config

# 3. 安装依赖包
yum install -y libaio-devel readline-devel expect python3

二、 获取安装包

1. 访问 openGauss 官网下载页面：https://opengauss.org/zh/download/。

2. 选择 企业版，下载对应操作系统（如 CentOS 7）的安装包。

3. 将下载的安装包上传至服务器 /opt/software/openGauss目录。

三、 解压与配置

3.1 解压安装包

# 进入安装包目录
cd /opt/software/openGauss

# 解压主安装包
tar -xzvf openGauss-All-*.tar.gz

# 解压 OM 管理工具包
tar -xzvf openGauss-OM-*.tar.gz

3.2 创建 XML 配置文件

创建 cluster_config.xml文件，用于定义数据库的安装参数。

# 创建并编辑配置文件
vi /opt/software/openGauss/cluster_config.xml

配置文件内容示例（单节点部署）：

<?xml version="1.0" encoding="UTF-8"?>
<ROOT>
    <!-- openGauss整体信息 -->
    <CLUSTER>
        <!-- 数据库名称 -->
        <PARAM name="clusterName" value="dbCluster" />
        <!-- 数据库节点名称(hostname) -->
        <PARAM name="nodeNames" value="node1_hostname" />
        <!-- 数据库安装目录-->
        <PARAM name="gaussdbAppPath" value="/opt/huawei/install/app" />
        <!-- 日志目录-->
        <PARAM name="gaussdbLogPath" value="/var/log/omm" />
        <!-- 临时文件目录-->
        <PARAM name="tmpMppdbPath" value="/opt/huawei/tmp" />
        <!-- 数据库工具目录-->
        <PARAM name="gaussdbToolPath" value="/opt/huawei/install/om" />
        <!-- 数据库core文件目录-->
        <PARAM name="corePath" value="/opt/huawei/corefile" />
        <!-- 节点IP，与数据库节点名称列表一一对应 -->
        <!-- 如果用ipv6 替换ipv4地址即可 如：<PARAM name="backIp1s" value="2407:xxxx:xxxx:xxxx:xxxx:xxxx:caa:2335"/> -->
        <PARAM name="backIp1s" value="192.168.0.1"/> 
    </CLUSTER>
    <!-- 每台服务器上的节点部署信息 -->
    <DEVICELIST>
        <!-- 节点1上的部署信息 -->
        <DEVICE sn="node1_hostname">
            <!-- 节点1的主机名称 -->
            <PARAM name="name" value="node1_hostname"/>
            <!-- 节点1所在的AZ及AZ优先级 -->
            <PARAM name="azName" value="AZ1"/>
            <PARAM name="azPriority" value="1"/>
            <!-- 节点1的IP，如果服务器只有一个网卡可用，将backIP1和sshIP1配置成同一个IP -->
            <!-- 用ipv6安装部署时 换上ipv6地址即可，后面xml文件示例也是同样操作 -->
            <PARAM name="backIp1" value="192.168.0.1"/>
            <PARAM name="sshIp1" value="192.168.0.1"/>
               
     <!--dbnode-->
     <PARAM name="dataNum" value="1"/>
     <PARAM name="dataPortBase" value="15400"/>
     <PARAM name="dataNode1" value="/opt/huawei/install/data/dn"/>
            <PARAM name="dataNode1_syncNum" value="0"/>
        </DEVICE>
    </DEVICELIST>
</ROOT>

四、 执行预安装

预安装脚本会自动创建安装用户、配置环境变量并检查系统参数。

# 创建用户组dbgrp和数据库管理员omm
groupadd dbgrp 
useradd -g dbgrp omm

# 为omm用户设置密码（执行后按提示输入密码）
passwd omm

# 验证用户和组的关联
id omm

# 进入脚本目录
cd /opt/software/openGauss/script


# 执行预安装脚本
./gs_preinstall -U omm -G dbgrp -X /opt/software/openGauss/cluster_config.xml

执行过程说明：

• -U omm：指定数据库管理用户为 omm。

• -G dbgrp：指定用户组为 dbgrp。

• -X：指定配置文件路径。

• 脚本执行过程中会提示输入 omm用户的密码，请设置一个强密码（需包含大小写字母、数字和特殊字符）。

五、 正式安装

预安装成功后，切换到 omm用户执行正式安装。

# 切换到 omm 用户
su - omm

# 执行安装命令
gs_install -X /opt/software/openGauss/cluster_config.xml

安装过程中会提示输入数据库密码，请确保密码复杂度符合要求（至少 8 位，包含大写字母、小写字母、数字和特殊字符）。

六、 安装验证

安装完成后，使用以下命令验证数据库状态。

# 查看数据库状态 显示Normal
gs_om -t status

# 连接数据库
gsql -d postgres -p 5432 -U omm -W

七、 配置远程连接

默认情况下，openGauss 仅允许本地连接。如需远程连接，需修改配置文件。

7.1 修改 pg_hba.conf

编辑数据库目录下的 pg_hba.conf文件，添加允许远程连接的规则。

# 编辑配置文件（路径根据实际安装目录调整）
vi /opt/gaussdb/data/pg_hba.conf

# 在文件末尾添加以下行，允许所有 IP 连接（生产环境建议限制 IP 范围）
host    all             all             0.0.0.0/0               sha256

7.2 修改 postgresql.conf

编辑 postgresql.conf文件，修改监听地址。

# 编辑配置文件
vi /opt/gaussdb/data/postgresql.conf

# 修改 listen_addresses 参数
listen_addresses = '*'

7.3 重启数据库

修改配置后，重启数据库使配置生效。

# 重启数据库
gs_om -t restart

八、 常见问题与解决方案

8.1 预安装失败：SSH 互信建立失败

• 现象 ：执行 gs_preinstall时提示 SSH 互信失败。

• 原因：节点间网络不通或 SSH 服务未启动。

• 解决：

  • 检查网络连通性：ping <目标节点IP>。

  • 检查 SSH 服务状态：systemctl status sshd。

  • 手动建立 SSH 互信：ssh-keygen -t rsa和 ssh-copy-id root@<目标节点IP>。

8.2 数据库启动失败：端口冲突

• 现象：安装完成后数据库无法启动，日志提示端口冲突。

• 原因：端口被其他服务占用。

• 解决 ：检查端口占用情况：netstat -tulnp | grep <端口号>，关闭占用端口的服务或修改数据库端口。

8.3 远程连接失败：认证失败

• 现象：远程客户端连接时提示认证失败。

• 原因 ：pg_hba.conf配置未生效或密码错误。

• 解决 ：检查 pg_hba.conf文件中的规则是否正确，并确认输入的密码无误。