openGauss源码解析（18）

openGauss源码解析：第2章 openGauss开发快速入门（8）

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"