1. 环境检查

1.1 检查OS版本

openGauss支持的操作系统：

CentOS 7.6（x86_64 架构）
openEuler-20.03-LTS（aarch64 架构）
openEuler-20.03-LTS（x86_64架构）
Kylin-V10（aarch64 架构）

Kylin-V10（x86_64 架构）

Asianux 7.6（x86_64架构）
FusionOS 22 (aarch64 架构)
FusionOS 22 (x86 架构)

cat /etc/os-release

操作系统为openEuler-20.03-LTS（aarch64 架构）

1.2 检查cpu型号

lscpu | grep "Vendor ID"

安装平台Vendor ID:0x70为飞腾CPU

1.3. 禁用防火墙和selinux

禁用防火墙

systemctl status firewalld systemctl stop firewalld systemctl disable firewalld systemctl is-enabled firewalld

禁用SELINUX

/usr/sbin/sestatus -v

如果selinux为enable状态，则修改/etc/selinux/config文件：
SELINUX=disabled
或使用下面命令：

sed -i '/^SELINUX=.*/ s//SELINUX=disabled/' /etc/selinux/config

并重启服务器

1.4 配置yum源并安装依赖包

上传操作系统iso到/tmp目录
配置本地yum源

mkdir /mnt/iso mount -o loop /tmp/openeuler20.03LTS.iso /mnt/iso cd /etc/yum.repos.d vi media.repo [InstallMedia] name=openeuler20.03LTS gpgcheck=0 enabled=1 baseurl=file:///mnt/iso yum clean all yum makecache yum list yum -y install libaio-devel flex bison ncurses-devel glibc-devel patch openeuler-lsb readline-devel unzip dos2unix vim git wget lrzsz net-tools bzip2 gcc tree zlib*

1.5 安装Python3

建议安装Python3.6+

yum install python3 python3-pip

软链接python命令为python3.7

ln -s /usr/bin/python3.7 /usr/bin/python python -V

1.6 设置字符集参数

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

1.7 设置时区和时间

[root@localhost ~] timedatectl set-timezone Asia/Shanghai [root@localhost ~] timedatectl status

2 下载软件包

cd /soft2/ git clone https://gitee.com/opengauss/openGauss-server.git openGauss-server -b 5.0.0 wget -c https://opengauss.obs.cn-south-1.myhuaweicloud.com/5.0.0/binarylibs/openGauss-third_party_binarylibs_openEuler_arm.tar.gz

3. 脚本编译安装

3.1 openGauss-server编译

tar -xvf openGauss-third_party_binarylibs_openEuler_arm.tar.gz mv openGauss-third_party_binarylibs_openEuler_arm binarylibs cd openGauss-server/ sh build.sh -m debug -3rd /soft/binarylibs -pkg

   说明

-m [debug | release | memcheck]表示可选择三种目标版本：
release：代表生成release版本的二进制程序，该版本编译时，配置GCC高级别优化选项，去除内核调试代码，通常用于生产环境或性能测试环境。
debug：代表生成debug版本的二进制程序，该版本编译时，增加内核代码调试功能，通常用于开发自测环境。
memcheck：代表生成memcheck版本的二进制程序，该版本编译时，在debug版本基础上新增ASAN功能，通常用于定位内存问题。

显示如下内容，表示编译成功。

生成的安装包会存放在./output目录下。
编译和打包日志为：./build/script/makemppdb_pkg.log。

4. 编译后验证

编译结束后，可按以下方式对编译后的openGauss进行验证:

4.1 创建用户

groupadd dbgrp useradd omm -g dbgrp passwd omm

4.2 使用omm用户，在~/.bashrc中增加以下环境变量

su - omm vi ~/.bashrc

使环境变量生效

source .bashrc

4.3 建立数据目录和日志目录

su - root chown -R omm:dbgrp /soft2/openGauss-server su - omm mkdir ~/data mkdir ~/log

4.4 数据库初始化

su - omm gs_initdb -D /home/omm/data --nodename=db1

初始化日志如下：

The files belonging to this database system will be owned by user “omm”. This user must also own the server process. The database cluster will be initialized with locale “en_US.UTF-8”. The default database encoding has accordingly been set to “UTF8”. The default text search configuration will be set to “english”. fixing permissions on existing directory /home/omm/data … ok creating subdirectories … in ordinary occasionok creating configuration files … ok selecting default max_connections … 100 selecting default shared_buffers … 1024MB Begin init undo subsystem meta. [INIT UNDO] Init undo subsystem meta successfully. creating template1 database in /home/omm/data/base/1 … The core dump path is an invalid directory 2023-07-20 16:10:19.012 [unknown] [unknown] localhost 281468516106256 0[0:0#0] [BACKEND] WARNING: macAddr is 64174/3171074048, sysidentifier is 4205755650/3221270315, randomNum is 96513835ok initializing pg_authid … ok setting password … ok initializing dependencies … ok loading PL/pgSQL server-side language … ok creating system views … ok creating performance views … ok loading system objects’ descriptions … ok creating collations … ok creating conversions … ok creating dictionaries … ok setting privileges on built-in objects … ok initialize global configure for bucketmap length … ok creating information schema … ok loading foreign-data wrapper for distfs access … ok loading foreign-data wrapper for log access … ok loading hstore extension … ok loading foreign-data wrapper for MOT access … ok loading security plugin … ok update system tables … ok creating snapshots catalog … ok vacuuming database template1 … ok copying template1 to template0 … ok copying template1 to postgres … ok freezing database template0 … ok freezing database template1 … ok freezing database postgres … ok WARNING: enabling “trust” authentication for local connections You can change this by editing pg_hba.conf or using the option -A, or –auth-local and --auth-host, the next time you run gs_initdb. Success. You can now start the database server of single node using: gaussdb -D /home/omm/data --single_node or gs_ctl start -D /home/omm/data -Z single_node -l logfile

4.5 启动数据库

su - omm gs_ctl start -D /home/omm/data -Z single_node -l /home/omm/log/opengauss.log

启动完毕后可通过 ps -ef | grep gaussdb检查数据库进程情况，或通过 gs_ctl query -D /home/omm/data检查数据库状态，或使用 gsql -d postgres 进入gsql命令行查看数据库的相关信息。

5. FAQ

编译安装过程中遇到的问题

FAQ 1：python版本需要3.6+以上版本，操作系统自带的python2.7不符合要求，需要安装python3.7，不然编译脚本错误。

解决方案：
yum安装Python3.7

yum install python3 python3-pip

软链接python命令为python3.7

ln -s /usr/bin/python3.7 /usr/bin/python

FAQ 2：一键式脚本编译build.sh使用 -m release编译release版本的二进制程序，初始化数据库报错。

解决方案：
目前还未解决，绕过方案使用-m debug编译debug版本的二进制程序.可以初始化数据库成功。

sh build.sh -m debug -3rd /soft/binarylibs -pkg

-m [debug | release | memcheck]表示可选择三种目标版本：

release：代表生成release版本的二进制程序，该版本编译时，配置GCC高级别优化选项，去除内核调试代码，通常用于生产环境或性能测试环境。

debug：代表生成debug版本的二进制程序，该版本编译时，增加内核代码调试功能，通常用于开发自测环境。

memcheck：代表生成memcheck版本的二进制程序，该版本编译时，在debug版本基础上新增ASAN功能，通常用于定位内存问题。