openEuler 22.03 LTS本机上安装openGuass2.1.0

---

前言

最近上半年新发布了openEuler 22.03LTS，本人根据网上各式各样的openGuass安装教程以及openGuasss官网上发布的安装教程，由于他们都是基于openEuler 22.03LTS之前的版本上进行安装的，本人尝试着在openEuler 22.03LTS上进行安装，结果安装均以失败告终。虽然现在在虚拟机上安装openEuler 22.03LTS时可以直接勾选上openGauss数据库，或者安装完操作系统后使用yum（yum install opengauss -y）一键安装，但是这两种安装方式安装的opengauss版本与本人后续的一些工作不适应。在和一位华为大佬的一番交流与他的指导下，在openEuler 22.03LTS上成功的安装上openGauss,以便本人尝试后续的一些工作。

---

一、openGuass简单介绍

openGauss的内核源自PostgreSQL，听说是华为云深度融合在数据库领域多年的经验，结合企业级场景需求，推出的新一代企业级分布式数据库，支持集中式与分布式两种部署形态。openGauss于2019年9月19日正式开源，于2020年6月30日正式开放源代码，并成立openGuass社区。想了解更多的关于openGaussd的信息直接去官方网站地址 https://opengauss.org。

二、openGuass2.1.0安装步骤

虚拟环境：VMware Workstation Pro 16
操作系统：openEuler 22.03 LTS
数据库：openGauss2.1.0-openEulerX86_64 极简版
本机操作系统：windows10

1.在openEuler上安装相关的依赖

yum install -y net-tools libaio-devel flex bison ncurses-devel glibc-devel patch libnsl openeuler-lsb-core readline-devel

2.创建软链接（这是一个坑）

opengauss依赖于libreadline7，但openEuler 22.03LTS只提供libreadline8，这里手动创建一个libreadline7软链接

ln -s /usr/lib64/libreadline.so.8 /usr/lib64/libreadline.so.7

3.下载openGauss

根据安装的openEuler 22.03LTS架构（openeuler_x86_64与openeuler_aarch64）安装对应的openGauss。

# [[ `arch` == "x86_64" ]] 
wget https://opengauss.obs.cn-south-1.myhuaweicloud.com/2.1.0/x86_openEuler/openGauss-2.1.0-openEuler-64bit.tar.bz2
# [[ `arch` == "aarch64" ]]
wget https://opengauss.obs.cn-south-1.myhuaweicloud.com/2.1.0/arm/openGauss-2.1.0-openEuler-64bit.tar.bz2

4.创建安装目录并解压文件

mkdir -p /opt/software/openGauss
tar -xf openGauss-2.1.0-openEuler-64bit.tar.bz2 -C /opt/software/openGauss

5.创建opengaus的用户和组

mkdir -p /var/lib/opengauss/
groupadd -r opengauss
adduser -M -N -g opengauss -r -d /var/lib/opengauss -s /bin/bash opengauss
chown -R opengauss:opengauss /var/lib/opengauss/
chown -R opengauss:opengauss /opt/software/openGauss

6.执行安装脚本并设置密码

su - opengauss
cd /opt/software/openGauss/simpleInstall
sh install.sh -w "password@123" &&source ~/.bashrc

-w：初始化数据库密码（gs_initdb指定），安全需要必须设置。
-p：指定的openGauss端口号，如不指定，默认为5432。
安装后，该数据库部署结点的名称为sgnode（gs_initdb指定）。

安装后，数据库目录安装路径/opt/software/openGauss/data/single_node，其中/opt/software/openGauss为解压包路径，data/single_node为新创建的数据库节点目录。
默认生成名称为postgres的数据库。第一次连接数据库时可以连接到此数据库。

7.验证安装结果

安装执行完成后，使用ps和gs_ctl查看进程是否正常。

ps ux | grep gaussdb
gs_ctl query -D /opt/software/openGauss/data/single_node

执行ps ux | grep gaussdb命令，显示类似如下信息：

[opengauss@localhost simpleInstall]$ ps ux | grep gaussdb
opengau+   31186  2.2 45.3 2748340 665464 pts/1  Sl   10:11   0:02 /opt/software/openGauss/bin/gaussdb -D /opt/software/openGauss/data/single_node
opengau+   31275  0.0  0.1   6164  2168 pts/1    S+   10:13   0:00 grep --color=auto gaussdb

执行gs_ctl query -D /opt/software/openGauss/data/single_node命令，显示类似如下信息：

[opengauss@localhost simpleInstall]$ gs_ctl query -D /opt/software/openGauss/data/single_node
[2022-07-07 10:13:57.459][31277][][gs_ctl]: gs_ctl query ,datadir is /opt/software/openGauss/data/single_node 
 HA state:           
	local_role                     : Normal
	static_connections             : 0
	db_state                       : Normal
	detail_information             : Normal

 Senders info:       
No information 
 Receiver info:      
No information 

到这里算是安装成功了，就可以进行后续的工作啦！

8.尝试使用gsql本地连接

openGauss数据库进程的管理用户为opengauss，切换到该用户下可以进行数据库的常用操作。

gsql是openGauss提供的在命令行下运行的数据库连接工具。

gsql -d postgres -p 5432

其中postgres为需要连接的数据库名称，8000为数据库主节点的端口号。请根据实际情况替换。
连接成功后，系统显示类似如下信息：

[opengauss@localhost simpleInstall]$ gsql -d postgres -p 5432
gsql ((openGauss 2.1.0 build 590b0f8e) compiled at 2021-09-30 14:29:54 commit 0 last mr  )
Non-SSL connection (SSL connection is recommended when requiring high-security)
Type "help" for help.

openGauss=# 

然后就可以进行数据库的一系列的操作，ok，就到此结束啦！

---

参考资料

1、官网安装文档
2、A-Tune for opengauss tuning