openGauss数据库源码解析（二）| openGauss开发快速入门（3）

初始化安装环境
在执行openGauss安装前，为了后续能以最小权限进行openGauss的安装以及管理操作，保证系统安全性，需要执行安装前置脚本gs_preinstall准备安装用户及环境。
安装前置脚本gs_preinstall可以协助用户自动完成如下的安装环境准备工作。
（1） 自动设置Linux内核参数以达到提高服务器负载能力的目的，这些参数直接影响数据库系统的运行状态。
（2） 自动将openGauss配置文件、安装包拷贝到openGauss主机的相同目录下。
（3） openGauss安装用户、用户组不存在时，自动创建安装用户以及用户组。
（4） 读取openGauss配置文件中的目录信息并创建，将目录权限授予安装用户。
1） 注意事项
（1） 用户需要检查上层目录权限，保证安装用户对安装包和配置文件目录读写执行的权限。
（2） XML文件中各主机的名称与IP映射配置正确。
（3） 只能使用root用户执行gs_preinstall命令。
2） 操作步骤
（1）以root用户登录待安装openGauss的主机。创建存放安装包的目录，并设置该目录的读写权限。
mkdir -p /opt/software/openGauss
chmod 755 -R /opt/software
不建议将安装包的存放目录规划至openGauss用户的家目录或其子目录下，否则可能导致权限问题。
（2） 将安装包“openGauss-x.x.x-openEuler-64bit-all.tar.gz”和配置文件“cluster_config.xml”上传至（1）所创建的目录中。
（3） 在安装包所在的目录下，解压安装包。安装包解压后，会有OM安装包和Server安装包。继续解压OM安装包，会在/opt/software/openGauss路径下自动生成script子目录，并且在script目录下生成gs_preinstall等各种OM工具脚本。
cd /opt/software/openGauss
tar -zxvf openGauss-x.x.x-openEuler-64bit.tar-all.gz
（4） 进入工具脚本存放目录下。
cd /opt/software/openGauss/script
（5） （可选）如果是openEuler的操作系统，执行如下命令打开performance.sh文件。
vi /etc/profile.d/performance.sh
用#注释以下命令，按“ESC”键进入指令模式，执行“:wq”命令保存并退出修改。
sysctl -w vm.min_free_kbytes=112640 &> /dev/null
（6） 为确保成功安装，执行如下命令检查hostname文件内容与/etc/hostname文件中的主机名是否一致。
hostname
cat /etc/hostname
如果hostname与/etc/hostname中的主机名不一致，请执行如下命令打开/etc/hostname文件，将主机名改为一致。
vi /etc/hostname
然后按“ESC”键进入指令模式，执行:wq保存并退出修改。
（7）执行gs_preinstall命令准备安装环境。
执行过程中会自动创建root用户互信和openGauss用户互信。
./gs_preinstall -U omm -G dbgrp -X /opt/software/openGauss/cluster_config.xml
其中，omm为数据库管理员（也是运行openGauss的操作系统用户），dbgrp为运行openGauss的操作系统用户的群组名称，“/opt/software/openGauss/cluster_config.xml”为openGauss配置文件路径。在执行过程中，用户根据提示选择是否创建互信，并输入root用户或openGauss用户的密码。
openGauss在安装过程中，需要在openGauss中的主机间执行命令，传送文件等操作。因此，在普通用户安装前需要确保互信是连通的。前置脚本中会先建立root用户间的互信，然后创建普通用户，并建立普通用户间的互信。
2.1.8 执行安装
准备好openGauss安装环境之后，执行安装部署openGauss。
1） 前提条件
（1） 已成功执行前置脚本gs_preinstall。
（2） 所有服务器操作系统和网络均正常运行。
（3） 用户需确保各个主机上的locale保持一致。
2） 操作步骤
（1） 登录openGauss的主机，并切换至omm用户。
su – omm
此处，omm为前置脚本gs_preinstall中-U参数指定的用户。执行安装时，必须以omm用户执行，否则执行脚本会报错。
（2） 使用gs_install安装openGauss。
gs_install -X /opt/software/openGauss/cluster_config.xml
其中“/opt/software/openGauss/cluster_config.xml”为openGauss配置文件的路径。在执行过程中用户需要根据提示输入数据库的密码，密码具有一定的复杂度。为保证用户正常使用该数据库，请记住输入的数据库密码。
数据库的密码需要符合这些要求：最少包含8个字符；不能和用户名和当前密码（ALTER）相同，或和当前密码反序；至少包含大写字母（A-Z），小写字母（a-z），数字，非字母数字字符（限定为~!@#$%^&*()-_=+|[{}];:,/?）四类字符中的三类字符。
安装过程中会生成ssl证书，证书存放路径为“{gaussdbAppPath}/share/sslcert/om”，其中“{gaussdbAppPath}”为集群openGauss配置文件中指定的程序安装目录。
日志文件路径（安装openGauss时在XML文件中指定）下会生成两个日志文件：“gs_install-YYYY-MM-DD_HHMMSS.log”和“gs_local-YYYY-MM-DD_HHMMSS.log”。
openGauss支持字符集的多种写法：gbk/GBK、UTF-8/UTF8/uft8/utf-8和Latine1/latine1。安装时如果不指定字符集，默认字符集为SQL_ASCII，为简化和统一区域locale默认设置为C。如果想指定其他字符集和区域，请在安装时使用参数–gsinit-parameter=”–locale=LOCALE”来指定，LOCALE为新数据库设置缺省的区域。例如用户要将数据库编码格式初始化为UTF-8，可以采用如下步骤。
（1） 用locale -a |grep utf8命令查看系统支持UTF-8编码的区域。
omm@linux:~> locale -a|grep utf8
显示类似如下信息，其中en_US.utf8表示区域en_US支持UTF-8编码。
…
en_SG.utf8
en_US.utf8
…
（2） 根据需要选择区域，如“en_US.utf8”，在初始化数据库时加入“–locale=en_US.utf8”选项进行安装。示例如下。
gs_install -X /opt/software/openGauss/cluster_config.xml –gsinit-parameter=”–locale=en_US.utf8″
2.1.9 安装验证
通过openGauss提供的gs_om工具可以完成数据库状态检查。
1） 前提条件
openGauss数据库已安装。
2） 操作步骤
（1） 以omm用户身份登录服务器。
（2） 执行如下命令检查数据库状态是否正常，“cluster_state”显示“Normal”表示数据库可正常使用。
gs_om -t status
数据库安装完成后，默认生成名称为postgres的数据库。第一次连接数据库时可以连接到此数据库。
其中为需要连接的数据库名称，为数据库主节点的端口号，即XML配置文件中的dataPortBase的值。请根据实际情况替换。
gsql -d -p

连接成功后，系统显示类似如下信息表示数据库连接成功。
gsql ((openGauss x.x.x build 290d125f) compiled at 2021-03-08 02:59:43 commit 2143 last mr 131
Non-SSL connection (SSL connection is recommended when requiring high-security)
Type “help” for help.