openGauss5.0单机版安装指南（企业版）

1.下载openGauss安装包

点击下载

2.准备安装环境

2.1修改/etc/selinux/config文件中的“SELINUX”值为“disabled”。

#使用VIM打开config文件。
vim /etc/selinux/config
#修改“SELINUX”的值“disabled”，执行:wq保存并退出修改。
SELINUX=disabled

2.2重新启动操作系统。

reboot

2.3检查防火墙是否关闭。

systemctl status firewalld

#若防火墙状态显示为active (running)，则表示防火墙未关闭，请执行步骤4；
#若防火墙状态显示为inactive (dead)，则无需再关闭防火墙

2.4关闭防火墙并禁止开机重启。

systemctl disable firewalld.service
systemctl stop firewalld.service

3.安装openGauss

3.1在/opt目录下创建gaussdb.xml文件

touch gaussdb.xml

3.2编辑gaussdb.xml

vi gaussdb.xml

3.3插入以下内容，根据实际情况进行修改

<?xml version="1.0" encoding="UTF-8"?>
<ROOT>
    <!-- openGauss整体信息 -->
    <CLUSTER>
        <!-- 数据库名称 -->
        <PARAM name="clusterName" value="gaussdb" />
        <!-- 数据库节点名称(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，与数据库节点名称列表一一对应 -->
        <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 -->
            <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="5432"/>
	    <PARAM name="dataNode1" value="/opt/huawei/install/data/dn"/>
            <PARAM name="dataNode1_syncNum" value="0"/>
        </DEVICE>
    </DEVICELIST>
</ROOT>

3.4以root用户登录待安装openGauss的主机，并按规划创建存放安装包的目录。

mkdir -p /opt/software/openGauss
chmod 755 -R /opt/software

3.5在安装包所在的目录下，解压安装包openGauss-x.x.x-openEuler-64bit-all.tar.gz。安装包解压后，会有OM安装包和Server安装包。继续解压OM安装包，会在/opt/software/openGauss路径下自动生成script子目录，并且在script目录下生成gs_preinstall等各种OM工具脚本。

cd /opt/software/openGauss
tar -zxvf openGauss-x.x.x-openEuler-64bit-all.tar.gz
tar -zxvf openGauss-x.x.x-openEuler-64bit-om.tar.gz

3.6进入到工具脚本存放目录下。

cd /opt/software/openGauss/script

3.7为确保成功安装，检查gaussdb.xml的hostname与/etc/hostname是否一致。预安装过程中，会对hostname进行检查。

3.8采用交互模式执行前置，并在执行过程中自动创建操作系统root用户互信和omm用户互信：

./gs_preinstall -U omm -G dbgrp -X /opt/gaussdb.xml

3.9登录到openGauss的主机，并切换到omm用户。

su - omm

3.10 使用gs_install安装openGauss。

gs_install -X /opt/gaussdb.xml

/opt/software/openGauss/cluster_config.xml为openGauss配置文件的路径。在执行过程中，用户需根据提示输入数据库的密码，密码具有一定的复杂度，为保证用户正常使用该数据库，请记住输入的数据库密码。

设置的密码要符合复杂度要求：

• 最少包含8个字符，最多包含16个字符。
• 不能和用户名、当前密码（ALTER）、或当前密码反序相同。
• 至少包含大写字母（A-Z）、小写字母（a-z）、数字、非字母数字字符（限定为~!@#$%^&*()-_=+|[{}];:,<.>/?）四类字符中的三类字符。

安装过程中会生成ssl证书，证书存放路径为{gaussdbAppPath}/share/sslcert/om，其中{gaussdbAppPath}为openGauss配置文件中指定的程序安装目录。

日志文件路径下会生成两个日志文件：“gs_install-YYYY-MMDD_HHMMSS.log”和“gs_local-YYYY-MM-DD_HHMMSS.log”。

4.安装验证

4.1 以omm用户身份登录服务器。

4.2执行如下命令检查数据库状态是否正常，“cluster_state ”显示“Normal”表示数据库可正常使用

gs_om -t status

4.3数据库安装完成后，默认生成名称为postgres的数据库。第一次连接数据库时可以连接到此数据库。

其中postgres为需要连接的数据库名称，5432为数据库主节点的端口号，即XML配置文件中的dataPortBase的值。请根据实际情况替换。

gsql -d postgres -p 5432

连接成功后，系统显示类似如下信息表示数据库连接成功。

gsql ((openGauss x.x.x build 290d125f) compiled at 2021-03-08 02:59:43 commit 2143 last mr 131
Non-SSL connection (SSL connection is recommended when requiring high-security)
Type "help" for help.