背景：openEuler为openEuler-24.03-LTS-x86_64版本。openGauss为openGauss-Server-6.0.2-openEuler22.03-x86_64版本

一、下载openGauss

        直接在官网搜索下载，地址https://opengauss.org/zh/。（建议每一次使用都在官网下载新的，不要下载一次多次安装）。

        本次下载的文件名为：openGauss-Server-6.0.2-openEuler22.03-x86_64.tar.bz2

二、安装准备

2.1 创建数据库的安装目录

        一般安装在这里，也可以选择其他地方。（不建议换，换了你的和别人不一样，找教程怕你看不懂）

[root@localhost ~]# mkdir -p /opt/software/openGauss

2.2 配置环境变量

[root@localhost ~]# vi /etc/profile

        用vi编辑器打开profile文件，点击i进入输入模式。在文件中加入以下配置。

export GAUSSHOME=/opt/software/openGauss/bin
export LD_LIBRARY_PATH=$GAUSSHOME/lib::$LD_LIBRARY_PATH
export PATH=$GAUSSHOME/bin:$PATH

        添加之后先按[ESC]退出编辑，再按住[shift]+:wq保存并退出。运行以下命令使配置文件生效。

[root@localhost etc]# source /etc/profile

2.3 添加用户信息

        设置管理员用户，一般设置omm。

[root@localhost etc]# groupadd dbgroup
[root@localhost etc]# useradd -g dbgroup omm
[root@localhost etc]# passwd omm
#接下来会两次提示输入密码，两次密码后创建成果，接下来赋予权限
[root@localhost etc]# chown -R omm:dbgroup /opt/software/openGauss

2.4 上传本地安装包，解压文件并安装

        利用sftp工具上传（openEuler系统本身已经开启了，可以直接连接）。直接重开cmd窗口，建立sftp连接。将文件上传到/opt/software/openGauss文件夹下。解压文件并安装。

C:\Users\li694>sftp root@10.201.142.199  #IP地址根据实际来，接下来输入密码
sftp> cd /opt/software/openGauss
sftp> put D:/openGauss-Server-6.0.2-openEuler22.03-x86_64.tar.bz2

        利用tar解压工具解压。openEuler本省不带tar命令，如果报错  “-bash: tar: 未找到命令”,运行下载命令。

[root@localhost openGauss]# tar -xf openGauss-Server-6.0.2-openEuler22.03-x86_64.tar.bz2 #软件包名根据实际改
-bash: tar: 未找到命令 #如果显示这个命令，运行以下命令，如果没有报错。省略
[root@localhost openGauss]# sudo yum install tar #提示Is this ok [y/N]: 一路输入y

三、安装软件

3.1 安装软件

[root@localhost openGauss]# cd /opt/software/openGauss/simpleInstall
[root@localhost simpleInstall]# su omm
[omm@localhost simpleInstall]$ sh install.sh -w "密码，设置自己的" &&source ~/.bashrc

3.2 查看安装情况

        运行命令出现以下两行数据则成功。

[omm@localhost openGauss]$ ps ux | grep gaussdb
omm        12727  1.3 14.9 5784004 870112 ?      Ssl  10:44   0:00 /opt/software/openGauss/bin/gaussdb -D /opt/software/openGauss/data/single_node
omm        12813  0.0  0.0  21984  2352 pts/0    S+   10:45   0:00 grep --color=auto gaussdb

3.3 配置数据库连接

        主要分为两个部分，一个是postgresql.conf文件、一个是pg_hba.conf文件。

[omm@localhost openGauss]$ cd /opt/software/openGauss/data/single_node/
[omm@localhost single_node]$ vi postgresql.conf
在postgresql.conf表中找到 #listen_addresses = ‘localhost’ 这里表示可以连接openGauss的连接地址，可以根据实际添加。我一般所有都允许，改为*。改完退出保存。具体命令看之前的。
listen_addresses = ‘*’

还需要找到session_timeout = 100min  默认是10分钟断开链接，建议设置为180min或更长。
[omm@localhost single_node]$ vi pg_hba.conf
在vi pg_hba.conf表中找到host all all 127.0.0.1/32 trust命令，在下面加入命令。比如允许10.201.143.200通过sha256连接输入以下命令。改完退出保存。具体命令看之前的.
host all all 10.201.143.200/32 sha256

不做任何限制
host all all 0.0.0.0/0 trust

3.4 重启数据库

        执行停止和重启命令，允许gsql命令进入数据库，添加用户并设置权限和密码。退出数据库。

[omm@localhost single_node]$ gs_ctl stop -D /opt/software/openGauss/data/single_node
[omm@localhost single_node]$ gs_ctl start -D /opt/software/openGauss/data/single_node
[omm@localhost single_node]$ gsql -d postgres
gsql ((openGauss 6.0.2 build 6285c0ef) compiled at 2025-07-15 17:31:11 commit 0 last mr 8059 )
Non-SSL connection (SSL connection is recommended when requiring high-security)
Type "help" for help.
openGauss=# create user 自定义用户名 password "自定义密码";
openGauss=# alter role 自定义用户名 sysadmin;
openGauss-# \q

四、通过数据库管理软件连接数据库

        连接之前需要开放openEuler的数据库端口5432。两种办法，只开放5432（演示这个），或者关闭防火墙（网上自己看）。

[root@localhost openGauss]# firewall-cmd --zone=public --add-port=5432/tcp --permanent
success
[root@localhost openGauss]# firewall-cmd --zone=public --add-port=5432/udp --permanent
success
[root@localhost openGauss]# firewall-cmd --reload
success

        用DBeaver连接数据库即可。第一次使用需要手动添加openGauss驱动。

五、设置openGauss自启动

        进入到系统的自启动文件编辑存放位置/etc/systemd/system。新建一个openGauss.service文件。

[root@localhost ~]# cd /etc/systemd/system
[root@localhost system]# vi openGauss.service

        在文件中写入以下内容。写入后保存退出（Esc -> :/wq ->回车）

[Unit]
Description=OpenGauss Database Server
After=syslog.target network.target

[Service]
Type=forking
User=omm
Group=dbgroup
Environment="GAUSSHOME=/opt/software/openGauss"
Environment="LD_LIBRARY_PATH=/opt/software/openGauss/lib"
# 启动命令
ExecStart=/opt/software/openGauss/bin/gs_ctl start -D /opt/software/openGauss/data/single_node -Z single_node
ExecStop=/opt/software/openGauss/bin/gs_ctl stop -D /opt/software/openGauss/data/single_node
ExecReload=/opt/software/openGauss/bin/gs_ctl restart -D /opt/software/openGauss/data/single_node -Z single_node



# 设置超时时间避免启动失败
TimeoutSec=300
Restart=on-failure
RestartSec=30

[Install]
WantedBy=multi-user.target

        设置自启动。设置完可以reboot一下，测试是否成功。

# 设置自启动
[root@localhost system]# systemctl enable openGauss
# 现场启动，为了避免已经启动导致失败，直接用重启命令
[root@localhost system]# systemctl restart openGauss