openGauss 作为一款企业级开源数据库，凭借卓越的性能、安全性与可扩展能力，成为企业数据库系统建设的重要选择。本文将系统讲解openGauss安装部署的完整流程，从环境规划、依赖安装、配置文件编写到数据库初始化，帮助你高效完成openGauss安装部署，掌握在openEuler等主流操作系统上进行openGauss安装部署的标准方法，并具备独立搭建生产级数据库环境的能力。
## 一、安装规划与环境要求
谋定而后动，周密的规划是成功安装的前提。

| 规划项 | 建议值/说明 |
| :--------------- | :------------------------------------------------------------------------- |
| **操作系统** | openEuler 22.03 LTS (x86\_64) |
| **安装用户** | omm (运行用户), root (安装准备) |
| **用户组** | dbgrp |
| **安装包路径** | /opt/software/openGauss (用于存放安装包和解压文件) |
| **程序安装路径** | /opt/gauss/app (数据库程序二进制文件) |
| **数据文件路径** | /opt/gauss/data (数据库数据、日志等) |

## 二、系统环境深度配置 (root 用户)
在正式安装 openGauss 之前，一个干净、规范的系统环境是成功的关键。**以下所有操作均需使用 `root` 用户执行。**

### **1. 系统参数与工具检查**
首先，确保系统基础工具已安装。
```bash
# 安装 lsb_release 以便后续检查
yum install -y openeuler-lsb
# 检查操作系统版本，确保是 openEuler 22.03
lsb_release -a
```

![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-11843411/e30020b1ef09b0e19d9c95760c416c68.png)
![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-11843411/8116989f67df56fb33c05a0cdefa6874.png)


接下来，关闭防火墙和 SELinux，避免安装过程中的网络和权限问题。
```bash
systemctl stop firewalld
systemctl disable firewalld
sed -i 's/SELINUX=enforcing/SELINUX=disabled/' /etc/selinux/config
# 临时禁用SELinux，使其立即生效
setenforce 0
```
![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-11843411/5e2c1933f8080051c91bbeb63ceeca1e.png)

### **2. 配置网络与主机名**
确保服务器的 `/etc/hosts` 文件包含了本机的 IP 地址和主机名映射。这对于集群通信至关重要。

```bash
echo "192.168.121.183 ivan" >> /etc/hosts
```

![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-11843411/51d7f90f8d4e4fbac4c686b91a7b5e01.png)

### **3. 安装核心依赖包**
openGauss 依赖一些关键的系统库来保证其正常运行。
```bash
yum install -y bzip2 libaio-devel flex bison ncurses-devel glibc-devel patch python3
```

![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-11843411/008e1033415ac901efbf09f37b040d5c.png)

### **4. 创建用户与目录**
为了安全起见，我们不应使用 `root` 用户直接安装和运行数据库。
```bash
# 创建用户组
groupadd dbgrp
# 创建用户并加入用户组，-d 指定家目录
useradd -g dbgrp -d /home/omm -m omm
# 为新用户设置一个强密码
passwd omm
```
![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-11843411/d09aa1ef4b4b63b67f4a1effd7ee6160.png)
![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-11843411/3a0e15665df37202ccec50ae307964ab.png)


接下来，创建我们规划好的安装和数据目录。

```bash
mkdir -p /opt/software/openGauss
chmod -R 755 /opt/software/
```
![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-11843411/998ad8fb80b25b240321c0320e7c5fc3.png)
上图仅创建了软件包目录，我们需要创建所有规划的目录并赋予正确的所有者。
```bash
# 创建程序和数据目录
mkdir -p /opt/gauss/app /opt/gauss/data
# 将所有相关目录的所有权交给 omm 用户
chown -R omm:dbgrp /opt/software/openGauss /opt/gauss
```
![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-11843411/ac3bb3e600118ee251f37eafb8b044af.png)

## 三、准备安装包 (root 用户)
环境准备就绪后，我们前往 openGauss 官方网站下载安装包。

![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-11843411/57249f69b6b976ba0d5c01c5c7d0cc60.png)

如上图所示，在 openGauss 官方下载页面，我们需要根据我们的服务器环境进行选择：
>1.**Architecture (架构)**: 根据你的 CPU 架构选择，常见的服务器是 `x86_64`。
>2. **OS (操作系统)**: 选择与你服务器操作系统匹配的版本，我们这里选择 `openEuler 22.03 LTS`。
>3. **Download (下载)**: 点击 Enterprise (企业版) 下方的 `Download` 按钮。

下载完成后，将安装包（例如 `openGauss-6.0.0-openEuler-64bit-all.tar.gz`）上传到我们之前创建的 `/opt/software/openGauss` 目录下，并确保其属主为 `omm`。
![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-11843411/342d72088a278445354ec91ebf254cc0.png)

```bash
# 如果是用 root 上传的，需要修改所有者
chown omm:dbgrp /opt/software/openGauss/openGauss-*.tar.gz
```
![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-11843411/0ccd603314c4b8de447c298b3559e6c8.png)


## 四、解压与配置 (omm 用户)

从现在开始，我们将切换到 `omm` 用户完成后续的所有安装步骤。

```bash
# 切换到 omm 用户
su - omm
# 进入软件包所在目录
cd /opt/software/openGauss
# 解压安装包
tar -zxvf openGauss-*.tar.gz
tar -zxvf openGauss-OM-6.0.2-openEuler22.03-x86_64.tar.gz
# 进入解压后的 script 目录
cd script
```

![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-11843411/013f1a664c061c36125f2807be50ae88.png)

### **配置核心 XML 文件**

安装的所有配置信息都集中在 `cluster_config.xml` 文件中。我们直接用 `cat <<'XML'` 一次性写入最终配置（保持你的风格与路径）。

```bash
# 覆盖写入 cluster_config.xml（仅 DataNode，单机）
cat >/opt/software/openGauss/script/cluster_config.xml <<'XML'
<?xml version="1.0" encoding="UTF-8"?>
<ROOT>
 
 <CLUSTER>
 
 <PARAM name="clusterName" value="dbCluster" />
 
 <PARAM name="nodeNames" value="ivan" />
 
 <PARAM name="gaussdbAppPath" value="/opt/gauss/app" />
 
 <PARAM name="gaussdbLogPath" value="/var/log/omm" />
 
 <PARAM name="tmpMppdbPath" value="/opt/gauss/tmp" />
 
 <PARAM name="gaussdbToolPath" value="/opt/gauss/om" />
 
 <PARAM name="corePath" value="/opt/gauss/corefile" />
 
 <PARAM name="backIp1s" value="192.168.121.183"/>
 </CLUSTER>

 
 <DEVICELIST>
 
 <DEVICE sn="ivan">
 
 <PARAM name="name" value="ivan"/>
 
 <PARAM name="azName" value="AZ1"/>
 <PARAM name="azPriority" value="1"/>
 
 <PARAM name="backIp1" value="192.168.121.183"/>
 
 <PARAM name="sshIp1" value="192.168.121.183"/>

 
 <PARAM name="dataNum" value="1"/>
 <PARAM name="dataPortBase" value="15400"/>
 <PARAM name="dataNode1" value="/opt/gauss/data/dn1" />
 <PARAM name="dataNode1_syncNum" value="0"/>
 </DEVICE>
 </DEVICELIST>
</ROOT>
XML
```

你需要重点关注并确保以上几个关键参数与主机实际一致（`ivan` 等于 `hostname` 输出，IP 与 `/etc/hosts` 映射一致）。


## 五、执行安装 (omm 用户)

万事俱备，只欠东风。我们分两步执行安装。

### **1. 预安装检查**

用 root 创建基础目录并授予权限（并准备 OM 期望的路径映射）：

```bash
exit

# 1) 创建 /opt/huawei 基础目录
mkdir -p /opt/huawei
chown -R omm:dbgrp /opt/huawei
chmod -R 750 /opt/huawei

# 2) 准备 OM 期望的脚本路径（将实际 script 目录做符号链接过去）
mkdir -p /opt/huawei/install/tool
ln -sfn /opt/software/openGauss/script /opt/huawei/install/tool/script
chown -h omm:dbgrp /opt/huawei/install/tool/script

# 回到 omm
su - omm
```

`gs_preinstall` 脚本会自动检查并配置系统环境（如修改内核参数、设置limit等），确保满足所有安装条件。

```bash
# (在 omm@ivan 终端中直接执行)
cd /opt/software/openGauss/script
./gs_preinstall -U omm -G dbgrp -X /opt/software/openGauss/script/cluster_config.xml --non-interactive
```

如果脚本执行成功，你将看到 `Preinstallation succeeded.` 的提示。

![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-11843411/823d577037890f9df0d4ff06ae0bd4a5.png)
![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-11843411/a181796a6c9d917df208f01d4e44ef19.png)

### **2. 正式安装**

预安装通过后，执行 `gs_install` 脚本来完成数据库的初始化和启动。

```bash
# 交互式输入数据库口令（你的这版 gs_install 不支持 -w）
cd /opt/software/openGauss/script
./gs_install -X /opt/software/openGauss/script/cluster_config.xml
```



安装过程可能需要几分钟时间，请耐心等待。

![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-11843411/9ec769b402c6610d24b955972b421b4b.png)
![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-11843411/e62bfba68cc6241239f53dd5724eeea9.png)


## 六、验证与使用
安装完成后，我们需要验证数据库集群是否正常运行。

### **1. 设置环境变量 (重要)**
为了方便使用 `gsql`, `gs_om` 等命令，强烈建议将数据库的环境变量加入到 `omm` 用户的配置文件中。
```bash
# 编辑 profile 文件
vim /etc/profile

# 在文件末尾添加以下内容
export GAUSS_HOME=/opt/gauss/app
export PATH=$GAUSS_HOME/bin:$PATH
export LD_LIBRARY_PATH=$GAUSS_HOME/lib:$LD_LIBRARY_PATH

# 使环境变量立即生效
source /etc/profile
```
![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-11843411/da5124d20a5f65bc01b4e1848cfacff6.png)

### **2. 检查集群状态**
现在，你可以在任何路径下执行 `gs_om` 命令。
```bash
gs_om -t status --all
```
如果所有组件的状态都显示为 `Normal` 或 `Primary`，则表示集群启动成功！

![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-11843411/f063b9b42d40cea6684391aefadc8785.png)


### **3. 登录数据库**
最后，我们使用 `gsql` 客户端工具来连接并操作数据库。
```bash
# 登录数据库，-d 是默认数据库，-p 是端口号
gsql -d postgres -p 15400
```
成功进入 `gsql` 交互命令行后，你就可以执行 SQL 语句了。
```sql
-- 查看版本
SELECT version();
-- 查看所有数据库
\l
-- 退出
\q
```
![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-11843411/5b9019f1b23fc1d5520c7fdea54da5ff.png)

openGauss 作为一款企业级开源数据库，凭借卓越的性能、安全性与可扩展能力，成为企业数据库系统建设的重要选择。本文将系统讲解openGauss安装部署的完整流程，从环境规划、依赖安装、配置文件编写到数据库初始化，帮助你高效完成openGauss安装部署，掌握在openEuler等主流操作系统上进行openGauss安装部署的标准方法，并具备独立搭建生产级数据库环境的能力。

openGauss安装部署详细教程

想把 openGauss 快速、稳妥地跑成生产库？这份实操指南不绕弯：先规划用户/目录与主机名映射，再用 root 完成依赖、内核与安全基线；切换到 omm 解包、写好 cluster_config.xml，一把梭 gs_preinstall → gs_install 完成初始化；最后配置环境变量、gs_om 验证、gsql 登陆。按图索骥，从空机到可用数据库，全流程可复制、可审计、可上线

编程语言

前端

本文详细讲解openGauss数据库安装部署全流程，涵盖环境规划、系统配置、依赖安装、用户创建、安装包准备、XML文件配置到最终安装验证。提供在openEuler系统上部署企业级openGauss数据库的标准化方法，帮助用户快速掌握生产环境搭建技巧，实现高性能数据库系统部署。

数据库集群

数据库

服务器

防火墙

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

openGauss安装部署详细教程-腾讯云开发者社区-腾讯云

openGauss安装部署详细教程

openGauss安装部署详细教程

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐