openGauss 脚本源码浅析（1）—— simpleInstall

openGauss 脚本源码浅析（1）—— simpleInstall

摘要

在编译完成 openGauss 或者已 download 了 openGauss 的 bin 后，想要做简易安装，官方给的使用方法是使用 simpleInstall。本文主要介绍 simpleInstall 的脚本的功能，来了解一下简易安装内部实现原理。

openGauss 简易安装

postgres 初始化数据库

了解 openGauss 安装之前简单说一下 postgres 的安装过程，postgres 没有提供安装脚本，但是初始化数据库集簇的命令很简单：

initdb -D $PGDATA

会在指定的 PGDATA 目录下创建数据库，可以参考之前的一篇文章postgresql 15 源码浅析（1）—— postgres 中的 1 号数据库 。

openGauss 脚本安装

openGauss 简易安装是使用 simpleInstall 下面的 install.sh 脚本。

simpleInstall 源码解析

step1 获取命令行参数（get_param）

先看一下需要那些参数

function usage()
{
    echo "
Usage: sh $0 -w password
Arguments:
   -w                   login password
   -p                   datanode port, default 5432
   --multinode          if specify, will install master_slave cluster. default install single node.
   -h, --help           Show this help, then exit
   "
}

主要有 3 个参数：

-w 设置超级用户的源码，这个是必选项，如不设置后续初始化流程无法完成，这也是和 postgres 的一个区别，postgres 不强制要求超级用户密码。且使用-W（大写）设置密码，设置形式是交互的。-w（小写）是 openGauss 引入的新参数；

-p 设置服务端口，非必选，默认是 5432；

--multinode 初始化数据库提供两种形式，及单节点和主备两种；

-w 和 -W 的区别

<img src='./images/bC0K0WfvrI-N1f4UtiZg8DHwafzyD9YxsLRgtmm2zyY.png'>

两个参数的功能是一样的，但是-W 是 postgres 保留的功能，是交互是的，需要手动数据密码；-w 是自动的方式将密码通过命令行传入程序，我猜 openGauss 是为了兼容原有的用法，所以新加了-w 的参数，且出于安全性考虑，是必须设置的。

step2 检查参数（check_param）

主要检查一下几项：

1. -w 参数必须填写，且不能为空
2. 密码必须大于 8 个字符
3. 不能使用 root 用户安装
4. 如不设置-p，怎使用默认端口 5432，否则使用-p 的设置
5. 如果设置了—multinode，则备节点的端口为主节点端口+200

step3 检查安装环境（check_install_env）

1. 检查目录是否存在，如果是单节点模式，检查 data 下是否存在 single_node 目录，是否为空目录，如果是主备检查 master 和 slave 是否存在，是否为空；
2. 检查端口是否被占用；
3. 检查 unix sock 是否有权限，是否被占用

step4 检查操作系统参数（check_os）

1. 检查系统共享内存和页大小

1. x86 下还要检查 rdtscp，应该是和指令顺序有关

这块有留个坑吧，不是很了解，后续有机会在填上。

step5 修改应用目录的属组和权限（change_gausshome_owner）

1. 修改属组：chown omm:dbgrp \$app
2. 修改权限：chmod 700 \$app

step6 设置 omm 用户的环境变量

设置的环境变量包括：PATH、GAUSSHOME、LD_LIBRARY_PATH、GS_CLUSTER_NAME、ulimit -n 1000000

上图是 omm 用户的.bashrc 的内容

step7-1 初始化数据库（single_install）

1. 初始化数据库集簇，参考postgresql 15 源码浅析（1）—— postgres 中的 1 号数据库 基本流程没有太大区别；

第二个坑，后续会对比一下 initdb 过程 postgres 和 openGauss 的有哪