Linux（Centos7.6）操作系统下openGauss5.0.2安装操作指南

| 作者： | 刘自涛 |
| 创建日期： | 20240525 |
| 版本： | V1.1 |


修改记录

| 日期 | 作者 | 版本 | 修改记录 |
| 20240525 | 刘自涛 | 1.1 | First edtion |


文档概述
本文档参考opengauss官方文档等。
本文档作为openGauss(版本5.0.2)在Centos7.6 操作系统上的安装配置手册，为运维人员提供前期准备及安装配置参考，仅供参考。

注意：
此文档所提供的设定仅作为参考，由于客户环境、场景有差异，设定有所不同。
由于用户的生产系统千差万别，强烈建议工程师实施期间，根据实际环境进行适当设定，以规避可能出现的风险。
本文档仅供内部参考。

1. 安装前信息采集、需求及规划

1.1. 安装调研基本信息

| 信息项 | 说明 |
| 硬件平台 | x86 vmware |
| 操作系统及版本 | centos7.6 |
| 存储 | vmware 100GB |
| 网络 | vmware 10G |
| 数据库版本 | openGauss5.0.2 |
| 数据库架构(单实例/主备) | 单实例 |
| 数据文件存放形式 | FS |
| 是否使用操作系统HA软件 | 否 |
| VIP | 否 |
| NTP | 是 |


针对上述的信息，请验证操作系统是否得到openGauss的相关版本认证。
建议生产环境，使用通过openGauss相关版本验证过的操作系统。

1.2. 主机相关信息

| 信息项 | 说明 | 备注 |
| 硬件平台信息 | x86 vmware | |
| 操作系统及版本信息 | centos7.6 | |
| CPU个数 | 4C | |
| 内存大小 | 8G | |
| 网卡个数 | 1 | |

1.3. 网络规划

| 主机名 | IP地址 | 对应网卡 | 备注 |
| ognode1 | 192.168.87.101 | eth0 | |

1.4. 存储信息及规划

| 内容 | 描述 | 备注 |
| 存储冗余 | 建议采用存储冗余策略，如RAID10. | |
| 存储空间 | 100GB | |
| 软件安装目录 | /opengauss | |
| 日志目录 | /var/log/omm | |
| 目录权限安装时配置 | 无/root具有操作权限 | |

2. 安装准备与系统要求

2.1. 检查硬件

检查CPU核数：
lscpu |grep 'CPU(s)'
#---------------------------#
CPU(s): 4
On-line CPU(s) list: 0-3
NUMA node0 CPU(s): 0-3

检查内存：
free -m
#---------------------------#
total used free shared buff/cache available
Mem: 7803 479 4909 252 2413 5850
Swap: 8063 0 8063

检查操作系统版本：
hostnamectl
#---------------------------#
Static hostname: ognode1
Icon name: computer-vm
Chassis: vm
Machine ID: 6d29df1dfca24665bdb281cd56abfef9
Boot ID: d46faa20319e4ad98ceaf0b85ed42d82
Virtualization: vmware
Operating System: CentOS Linux 7 (Core)
CPE OS Name: cpe:/o:centos:centos:7
Kernel: Linux 3.10.0-957.el7.x86_64
Architecture: x86-64
复制

2.2. 检查及安装依赖包

rpm -q --queryformat "%{NAME}-%{VERSION}-%{RELEASE} (%{ARCH}) \n" \
lksctp-tools \
java-1.8.0-openjdk \
libaio-devel \
flex \
bison \
glibc-devel \
patch \
redhat-lsb-core \
readline-devel \
bzip2 \
python3 \
libnsl \
ncurses-devel|grep "not installed"
#---------------------------#
yum install -y lksctp*
yum install -y java-1.8.0-openjdk* psmisc bzip2
yum install -y libaio-devel \
flex \
bison \
ncurses-devel \
glibc-devel \
patch \
readline-devel \
redhat-lsb-core \
libnsl \
python3 \
ntp
复制

2.3. 修改 /etc/hosts

vi /etc/hosts
192.168.87.101 ognode1
复制

2.4. 关闭防火墙及selinux

禁用防火墙：
#---------------------------#
停止firewall
systemctl stop firewalld.service
禁止firewall开机启动 
systemctl disable firewalld.service

禁用selinux：
vi /etc/selinux/config
#---------------------------#
修改SELINUX=enforcing 为 SELINUX=disabled

临时生效：
setenforce 0
getenforce
复制

2.5. 配置SSH服务(允许root登录，关闭Banner)

vi /etc/ssh/sshd_config
#---------------------------#
Banner none
PermitRootLogin yes

重启ssh服务：
#---------------------------#
systemctl restart sshd
复制

2.6. 配置字符集

vi /etc/profile
#---------------------------#
export LANG=en_US.UTF-8
复制

2.7. 配置时区/时间/及NTP服务

配置时区：
#---------------------------#
rm -fr /etc/localtime
ln -s /usr/share/zoneinfo/Asia/Shanghai  /etc/localtime
date -R

修改时间：
#---------------------------#
date -s "2021-05-07 14:09:00"

配置NTP服务：
#---------------------------#
vi /etc/ntp.conf
添加以下一行：
restrict 192.168.87.0 mask 255.255.255.0 nomodify notrap

添加以下3行，并注释掉所有的server行：
server 127.127.1.0 # local clock
fudge 127.127.1.0 stratum 10
server ognode1 #或生产环境ntp服务器

启动ntpd时间服务器
#---------------------------#
systemctl restart ntpd

开机自启动
#---------------------------#
systemctl enable ntpd.service
复制

2.8. 关闭swap

vi /etc/fstab
#---------------------------#
注释掉： #/dev/mapper/centos-swap swap swap defaults 0 0

临时关闭：
#---------------------------#
swapoff -a
复制

2.9. 修改os 内核参数

cat >> /etc/sysctl.conf << EOF
net.ipv4.tcp_retries1 = 5
net.ipv4.tcp_syn_retries = 5
net.ipv4.tcp_fin_timeout = 60
EOF

其余参数执行预安装检查会自动配置；
复制

2.10. 关闭透明页

vi /etc/default/grub
修改GRUB_CMDLINE_LINUX值，在quite后追加：transparent_hugepage=never

grub2-mkconfig -o /boot/grub2/grub.cfg

重启机器生效；
reboot
复制

2.11.关闭RemoveIPC（openEulor需要）

##说明：CentOS 7.6已经默认关闭，该步骤可以跳过 
## sed -i '/^RemoveIPC/d' /usr/lib/systemd/system/systemdlogind.service
## echo "RemoveIPC=no" >> /etc/systemd/logind.conf
## echo "RemoveIPC=no" >> /usr/lib/systemd/system/systemdlogind.service
## systemctl daemon-reload
## systemctl restart systemd-logind
## loginctl show-session | grep RemoveIPC
## systemctl show systemd-logind | grep RemoveIPC
复制

3. 安装opengauss

3.1. 上传opengauss企业版安装包及解压

ftp openGauss-5.0.2-CentOS-64bit-all.tar.gz

cd /soft
tar -xzvf openGauss-5.0.2-CentOS-64bit-all.tar.gz
tar -xzvf openGauss-5.0.2-CentOS-64bit-om.tar.gz
复制

3.2. 创建XML文件

vi clusterconfig.xml

<?xml version="1.0" encoding="UTF-8"?>
<ROOT>
<!-- openGauss整体信息 -->
<CLUSTER>
<!-- 数据库名称 -->
<PARAM name="clusterName" value="dbCluster" />
<!-- 数据库节点名称(hostname) -->
<PARAM name="nodeNames" value="ognode1" />
<!-- 数据库安装目录-->
<PARAM name="gaussdbAppPath" value="/opengauss/install/app" />
<!-- 日志目录-->
<PARAM name="gaussdbLogPath" value="/var/log/omm" />
<!-- 临时文件目录-->
<PARAM name="tmpMppdbPath" value="/opengauss/tmp" />
<!-- 数据库工具目录-->
<PARAM name="gaussdbToolPath" value="/opengauss/install/om" />
<!-- 数据库core文件目录-->
<PARAM name="corePath" value="/opengauss/corefile" />
<!-- 节点IP，与数据库节点名称列表一一对应 -->
<PARAM name="backIp1s" value="192.168.87.101"/>
</CLUSTER>
<!-- 每台服务器上的节点部署信息 -->
<DEVICELIST>
<!-- 节点1上的部署信息 -->
<DEVICE sn="ognode1">
<!-- 节点1的主机名称 -->
<PARAM name="name" value="ognode1"/>
<!-- 节点1所在的AZ及AZ优先级 -->
<PARAM name="azName" value="AZ1"/>
<PARAM name="azPriority" value="1"/>
<!-- 节点1的IP，如果服务器只有一个网卡可用，将backIP1和sshIP1配置成同一个IP -->
<PARAM name="backIp1" value="192.168.87.101"/>
<PARAM name="sshIp1" value="192.168.87.101"/>

<!--dbnode-->
<PARAM name="dataNum" value="1"/>
<PARAM name="dataPortBase" value="26000"/>
<PARAM name="dataNode1" value="/opengauss/install/data/dn"/>
<PARAM name="dataNode1_syncNum" value="0"/>
</DEVICE>
</DEVICELIST>
</ROOT>
复制

3.3. 执行预安装检查

创建安装目录：
/opengauss

无需提前创建安装用户，直接使用预安装检查创建；
cd /soft
./script/gs_preinstall -U omm -G dbgrp -X /opt/software/openGauss/clusterconfig.xml
输入omm用户密码即可；

查看具体检查信息：
./script/gs_checkos -i A -h ognode1 --detail
复制

3.4. 自定义内存参数安装

su - omm
#---------------------------#
cd /soft/script
gs_install -X /opt/software/openGauss/script/clusterconfig.xml \
--gsinit-parameter="--encoding=UTF8" \
--dn-guc="max_connections=1000" \
--dn-guc="max_process_memory=3GB" \
--dn-guc="shared_buffers=128MB" \
--dn-guc="bulk_write_ring_size=128MB" \
--dn-guc="cstore_buffers=16MB"
 
## 系统初始用户omm的密码复杂度要求：大写+小写+数字+特殊字符(任选3类，至少8 位)，此处示例使用Passw0rd@1234
复制

3.5. 重启数据库

重启数据库：gs_om -t stop && gs_om -t start
gs_ctl restart

查看数据库状态：
gs_om -t status --detail
gs_om -t status --all
复制

3.6. 方便使用gsql工具，配置.bashrc

vi ~/.bashrc
#---------------------------#
export GS_CLUSTER_NAME=dbCluster
export PGDATABASE=postgres
export PGDATA=/opengauss/install/data/dn
export PGPORT=26000
alias gsql='gsql -r -E'   # -E 显示元命令具体SQL（帮助学习，生产可以不开启），-r 可以使用tab补全；
复制