操作步骤
- 以root或普通用户登录待安装openGauss的任意主机,并按规划创建存放安装包的目录。
mkdir -p /opt/software/openGauss
说明:
- 不建议把安装包的存放目录规划到openGauss用户的根目录或其子目录下,可能导致权限问题。
2.将安装包“openGauss-x.x.x-openEuler-64bit-all.tar.gz”和配置文件“cluster_config.xml”都上传至上一步所创建的目录中。
3.在第一步所创建的安装包的目录下,解压安装包openGauss-x.x.x-openEuler-64bit-all.tar.gz。安装包解压后,会有OM安装包和Server安装包。继续解压OM安装包,会在/opt/software/openGauss路径下自动生成script子目录,并且在script目录下生成gs_preinstall等各种OM工具脚本。
cd /opt/software/openGauss
tar -zxvf openGauss-x.x.x-openEuler-64bit-all.tar.gz
tar -zxvf openGauss-x.x.x-openEuler-64bit-om.tar.gz
说明:
在执行前置脚本gs_preinstall时,需要规划好openGauss配置文件路径、安装包存放路径、程序安装目录、实例数据目录,后续普通用户使用过程中不能再更改这些路径。
运行前置脚本gs_preinstall准备安装环境时,脚本内部会自动将openGauss配置文件、解压后的安装包同步拷贝到其余服务器的相同目录下。
在执行前置脚本或者互信前,请检查/etc/profile文件中是否包含错误输出信息,如果存在错误输出,需手动处理。
4.修改安装包目录权限
chmod 755 -R /opt/software
说明:
- openGauss用户须具有/opt/software/openGauss目录的读写权限。
5.进入到工具脚本存放目录下。
cd /opt/software/openGauss/script
6.如果是openEuler的操作系统(openEuler 20.03),执行如下命令打开performance.sh文件,用#注释sysctl -w vm.min_free_kbytes=112640 &> /dev/null,键入“ESC”键进入指令模式,执行 :wq 保存并退出修改。
vi /etc/profile.d/performance.sh
7.为确保成功安装,检查hostname与/etc/hostname是否一致。预安装过程中,会对hostname进行检查。
8.使用gs_preinstall准备好安装环境。若为共用环境需加入--sep-env-file=ENVFILE参数分离环境变量,避免与其他用户相互影响,ENVFILE为用户自行指定的环境变量分离文件的路径,可以为一个空文件。
- 采用交互模式执行前置,并在执行过程中自动创建操作系统root用户互信和omm用户互信:
./gs_preinstall -U omm -G dbgrp -X /opt/software/openGauss/cluster_config.xml [--sep-env-file=ENVFILE]
omm为数据库管理员(也是运行openGauss的操作系统用户),dbgrp为运行openGauss的操作系统用户的群组名称,/opt/software/openGauss/cluster_config.xml为openGauss配置文件路径。在执行过程中,用户根据提示选择是否创建互信,并输入操作系统root用户或omm用户的密码。
注意:
分离的环境变量ENVFILE为用户可以访问到的目录,例如,/opt/software/openGauss/ENVFILE,不指定目录的情况下会默认将ENVFILE放在script目录下。
-
允许创建root用户互信时,预安装脚本在执行的时候会将各个主机的ip,hostname写入到/etc/hosts中,并在每个映射关系后边加入注释内容:#Gauss OM IP Hosts Mapping。
-
不允许创建root用户互信时,此时需要用户手动先建立互信(也就是将各个主机的ip,hostname写入到/etc/hosts中),然后执行预安装脚本
a.执行下面命令准备安装环境。
cd /opt/software/openGauss/script ./gs_preinstall -U omm -G dbgrp -L -X /opt/software/openGauss/cluster_config.xml
说明: 此操作需要在每台主机上执行该命令。
- 采用非交互模式执行前置:
a.参考手工建立互信章节手工建立root用户互信和openGauss用户互信。
b.执行下面命令准备安装环境。
cd /opt/software/openGauss/script ./gs_preinstall -U omm -G dbgrp -X /opt/software/openGauss/cluster_config.xml --non-interactive
说明:
-
此模式要求用户确保在执行前,已经建立了各节点root用户互信和openGauss用户互信。
-
root用户互信可能会存在安全隐患,因此建议用户在执行完安装后,立即删除各主机上root用户的互信。