手把手带你快速安装openGauss

openGauss在开源后受到业界的广泛关注，与此同时，可能还有不少朋友不太清楚如何安装部署openGauss，本文主要向大家介绍如何快速安装openGauss。

准备安装环境
环境

类别

要求

硬件环境

内存

建议32GB以上

CPU

建议8核以上

软件环境

操作系统

openEuler 20.03 LTS

CentOS 7.6

Python

openEuler 搭配 Python 3.7.X

CentOS 搭配 Python 3.6.X

libaio

建议版本0.3.109-13

创建配置文件
安装openGauss前需要创建XML文件。用户需根据不同场景配置对应的XML文件。

mkdir -p /opt/setup

cd /opt/setup

vi clusterconfig.xml
以下为配置文件示例，加粗字体内容请替换。

<?xml version="1.0" encoding="UTF-8"?>

<!-- openGauss整体信息 -->

<CLUSTER>

    <PARAM name="clusterName" value="dbCluster" />

    <PARAM name="nodeNames" value="ecs-edison" />

    <PARAM name="backIp1s" value="192.168.0.113"/>

    <PARAM name="gaussdbAppPath" value="/opt/opengauss/install/app" />

    <PARAM name="gaussdbLogPath" value="/var/log/omm" />

    <PARAM name="tmpMppdbPath" value="/opt/opengauss/tmp" />

    <PARAM name="gaussdbToolPath" value="/opt/opengauss/install/om" />

    <PARAM name="corePath" value="/opt/opengauss/corefile" />

    <PARAM name="clusterType" value="single-inst"/>

</CLUSTER>

<!-- 节点部署信息 -->

<DEVICELIST>

    <DEVICE sn="ecs-edison">

        <PARAM name="name" value="ecs-edison"/>

        <PARAM name="azName" value="AZ1"/>

        <PARAM name="azPriority" value="1"/>

        <PARAM name="backIp1" value="192.168.0.113"/>

        <PARAM name="sshIp1" value="192.168.0.113"/>

        <!--dbnode-->

        <PARAM name="dataNum" value="1"/>

        <PARAM name="dataPortBase" value="26000"/>

        <PARAM name="dataNode1" value="/opt/opengauss/install/data/db1"/>

    </DEVICE>

</DEVICELIST>

配置节点

参数

说明

CLUSTER

clusterName

名称。

nodeNames

主机名称。请使用/etc/hostname中的名称。

backIp1s

主机在后端存储网络中的IP地址。所有openGauss主机使用后端存储网络通讯。

gaussdbAppPath

openGauss程序安装目录。

gaussdbLogPath

openGauss运行日志和操作日志存储目录。

tmpdbPath

数据库临时文件存放目录。

gaussdbToolPath

openGauss系统工具目录，主要用于存放互信工具等。

corePath

openGauss core文件的指定目录。

clusterType

openGauss类型。single-inst表示单机一主多备部署形态。

DEVICELIST

name

主机名称。请使用/etc/hostname中的名称。

azName

指定azName，字符串（不能含有特殊字符），例如AZ1、AZ2、AZ3。

azPriority

指定azPriority的优先级。

backIp1

主机在后端存储网络中的IP地址（内网IP）。所有openGauss主机使用后端存储网络通讯。

sshIp1

设置SSH可信通道IP地址（外网IP）。若无外网，则可以不设置该选项或者同backIp1设置相同IP。

初始化安装环境
（1）以root用户登录待安装openGauss的机器。

（2）下载安装包，这里以CentOS安装包为例。

cd /opt/setup

wget https://opengauss.obs.cn-south-1.myhuaweicloud.com/1.0.0/x86/openGauss-1.0.0-CentOS-64bit.tar.gz
（3）对openGauss-1.0.0-CentOS-64bit.tar.gz进行解压。

tar -zxvf openGauss-1.0.0-CentOS-64bit.tar.gz
（4）修改安装目录权限。

chmod 755 -R /opt/setup
（5）进入到工具脚本存放目录。

cd /opt/setup/script
（6）如果是openEuler的操作系统，需要修改 /etc/profile.d/performance.sh文件

使用#注释sysctl -w vm.min_free_kbytes=112640 &> /dev/null
（7）为确保openssl版本正确，执行预安装前请加载安装包中lib库。

export LD_LIBRARY_PATH=/opt/setup/script/gspylib/clib:$LD_LIBRARY_PATH
（8）使用gs_preinstall准备好安装环境。这里采用交互模式执行前置，并在执行过程中自动创建root用户互信和openGauss用户互信。

./gs_preinstall -U omm -G dbgrp -X /opt/setup/clusterconfig.xml
omm为数据库管理员，也是运行openGauss的操作系统用户，dbgrp为运行openGauss的操作系统用户的群组名称。

执行安装
（1）登录到openGauss的主机并切换到omm用户。

su - omm
（2）使用gs_install安装openGauss。

gs_install -X /opt/setup/clusterconfig.xml
在执行过程中，用户需根据提示输入数据库的密码，密码具有一定的复杂度。设置的密码要符合复杂度要求：

1）最少包含8个字符；

2）不能和用户名和当前密码（ALTER）相同，或和当前密码反序；

3）至少包含大写字母（A-Z），小写字母（a-z），数字，非字母数字字符（限定为~!@#$%^&*()-_=+|[{}];:,/?）四类字符中的三类字符。

（3）连接数据库

数据库安装完成后，默认生成名称为postgres的数据库。执行如下命令连接数据库。26000为之前在配置文件中设置的端口。

gsql -d postgres -p 26000
检查健康状态
通过openGauss提供的gs_checkos工具可以完成系统状态检查。

（1）以root用户身份登录。

（2）执行如下命令对openGauss节点服务器的OS参数进行检查。

gs_checkos -i A
检查节点服务器的OS参数的目的是为了保证在安装成功后可以安全高效的运行。

以上就是openGauss的快速安装过程。openGauss社区正在构建Docker镜像，以方便广大用户快速地体验openGauss，也期望您可以参与openGauss社区贡献，共同构建企业级的开源数据库社区。

openGauss开源社区官方网站：

https://opengauss.org/

openGauss组织仓库：

https://gitee.com/opengauss

openGauss镜像仓库：

https://github.com/opengauss-mirror

原文链接：https://www.hikunpeng.com/zh/developer/techArticles/20230911-1