基于OpenEuler-20.03部署OpenGauss

安装OpenGauss

操作系统和软件依赖要求

openGauss支持以下操作系统：

CentOS 7.6（x86架构）

openEuler-20.03-LTS（aarch64架构）

openEuler下载地址：

https://repo.openeuler.openatom.cn/

以下表格列举了编译openGauss的软件要求如下

libaio-devel 0.3.109-13

flex 2.5.31及以上版本

bison 2.7-4

ncurses-devel 5.9-13.20130511

glibc-devel 2.17-111

patch 2.7.1-10

lsb_release 4.1

readline-devel 7.0-13

下载 openGauss-server和openGauss-third_party

https://opengauss.org/zh/

初始化安装环境

创建完openGauss配置文件后，在执行安装前，为了后续能以最小权限进行安装及openGauss管理操作，保证系统安全性，需要运行安装前置脚本gs_preinstall准备好安装用户及环境。

安装环境准备工作

自动设置Linux内核参数以达到提高服务器负载能力的目的。这些参数直接影响数据库系统的运行状态，请仅在确认必要时调整。

自动将openGauss配置文件、安装包拷贝到openGauss主机的相同目录下。

openGauss安装用户、用户组不存在时，自动创建安装用户以及用户组。

读取openGauss配置文件中的目录信息并创建，将目录权限授予安装用户。

注意事项

• 用户需要检查上层目录权限，保证安装用户对安装包和配置文件目录读写执行的权限。

• xml文件中各主机的名称与IP映射配置正确。

• 只能使用root用户执行gs_preinstall命令。

操作步骤

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

mkdir -p /opt/software/openGauss

chmod 755 -R /opt/software

说明：不建议把安装包的存放目录规划到openGauss用户的家目录或其子目录下，可能导致权限问题。

openGauss用户须具有/opt/software/openGauss目录的读写权限。

2.将安装包“openGauss-x.x.x-openEULER-64bit.tar.gz”和配置文件“clusterconfig.xml”都上传至上一步所创建的目录中。

3.在安装包所在的目录下，解压安装包openGauss-x.x.x-openEULER-64bit.tar.gz。安装包解压后，在/opt/software/openGauss目录下自动生成script目录。在script目录下生成gs_preinstall等OM工具脚本。

cd /opt/software/openGauss

tar -zxvf openGauss-x.x.x-openEULER-64bit.tar.gz

4.进入工具脚本目录。

cd /opt/software/openGauss/script

5.如果是openEuler的操作系统，执行如下命令打开performance.sh文件

用#注释sysctl -w vm.min_free_kbytes=112640 &> /dev/null，键入“ESC”键进入指令模式，执行 :wq保存并退出修改。

vi /etc/profile.d/performance.sh

6.为确保openssl版本正确，执行预安装前请加载安装包中lib库。

执行命令如下，其中 {packagePath} 为用户安装包放置的路径，本示例中为/opt/software/openGauss。

export LD_LIBRARY_PATH={packagePath}/script/gspylib/clib:$LD_LIBRARY_PATH

7.为确保成功安装，检查 hostname 与 /etc/hostname 是否一致。

预安装过程中，会对hostname进行检查。

8.使用gs_preinstall准备好安装环境。

若为共用环境需加入--sep-env-file=ENVFILE参数分离环境变量，避免与其他用户相互影响，ENVFILE为用户自行指定的环境变量分离文件的路径。 执行如下命令，即采用交互模式执行前置，并在执行过程中自动创建root用户互信和openGauss用户互信：

./gs_preinstall -U omm -G dbgrp -X /opt/software/openGauss/clusterconfig.xml

omm为数据库管理员用户（即运行openGauss的操作系统用户）,dbgrp为运行openGauss的操作系统用户的组名，/opt/software/ openGauss/clusterconfig.xml为openGauss的配置文件路径。执行过程中需要根据提示选择建立互信，并输入root或openGauss用户的密码。

执行安装

执行前置脚本准备好openGauss安装环境之后，按照启动安装过程部署openGauss。

前提条件

• 已成功执行前置脚本gs_preinstall。

• 所有服务器操作系统和网络均正常运行。

• 用户需确保各个主机上的locale保持一致。

操作步骤

1.（可选）检查安装包和openGauss配置文件在规划路径下是否已存在，如果没有，重新执行预安装，确保预安装成功，再执行以下步骤。

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

su - omm

说明:omm为gs_preinstall脚本中-U参数指定的用户。

以上述omm用户执行gs_install脚本。否则会报执行错误。

3.使用gs_install安装openGauss。若为环境变量分离的模式安装的集群需要source环境变量分离文件ENVFILE。

gs_install -X /opt/software/openGauss/clusterconfig.xml

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

密码复杂度要求：长度至少8个字符。

不能和用户名、当前密码（ALTER）、当前密码的倒序相同。

以下至少包含三类：大写字母（A - Z）、小写字母（a - z）、数字（0 - 9）、其他字符（仅限~!@#$%^&*()-_=+|[{}];:,<.>/?）。

4.安装执行成功之后，需要手动删除主机root用户的互信，即删除openGauss数据库各节点上的互信文件。

rm -rf ~/.ssh

卸载openGauss

卸载openGauss的过程包括卸载openGauss和清理openGauss服务器环境。

执行卸载

openGauss提供了卸载脚本，帮助用户卸载openGauss。

操作步骤

1.以操作系统用户omm登录数据库主节点。

2.使用gs_uninstall卸载openGauss。

gs_uninstall --delete-data

或者在openGauss中每个节点执行本地卸载。

gs_uninstall --delete-data -L

一键式环境清理

在openGauss卸载完成后，如果不需要在环境上重新部署openGauss，可以运行脚本gs_postuninstall对openGauss服务器上环境信息做清理。openGauss环境清理是对环境准备脚本gs_preinstall所做设置的清理。 前提条件

• openGauss卸载执行成功;

• root用户互信可用。

只能使用root用户执行gs_postuninstall命令。

操作步骤

1.以root用户登录openGauss服务器。

2.查看互信是否建成功，可以互相执行ssh 主机名。输入exit退出。

plat1:~ # ssh plat2 

Last login: Tue Jan 5 10:28:18 2016 from plat1

plat2:~ # exit 

logout

Connection to plat2 closed.

plat1:~ #

3.进入script路径下。

cd /opt/software/openGauss/script

4.使用gs_postuninstall进行清理。

若为环境变量分离的模式安装的集群需要source环境变量分离文件ENVFILE。

./gs_postuninstall -U omm -X /opt/software/openGauss/clusterconfig.xml --delete-user --delete-group

或者在openGauss中每个节点执行本地后置清理。

./gs_postuninstall -U omm -X /opt/software/openGauss/clusterconfig.xml --delete-user --delete-group -L

omm为运行openGauss的操作系统用户名，/opt/software/openGauss/clusterconfig.xml为openGauss配置文件路径。

若为环境变量分离的模式安装的集群需删除之前source的环境变量分离的env参数unset MPPDB_ENV_SEPARATE_PATH

5.删除各openGauss数据库节点root用户互信。