2.1.7 初始化安装环境
在执行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.