一站式安装指南

本章详细介绍openGauss的一站式安装，通过交互式方便用户快速配置xml文件，大大减少用户安装数据库的时间。如果使用一站式安装，那么就可以直接跳过创建xml配置文件和初始化安装。

前提条件：

所有服务器操作系统和网络均正常运行
用户必须有数据库包解压路径、安装路径的读、写和执行操作权限，并且安装路径必须为空。
用户对下载的openGauss压缩包有执行权限。
如果使用中文界面来安装，需要检查当前本地字符集是否支持中文(如:zh_CN.UTF-8)

操作步骤

使用root或普通用户，下载软件包并解压，到script目录下，执行预安装。以版本6.0.0为例：

tar -zxvf openGauss-All-6.0.0-openEuler20.03-aarch64.tar -C targetDir
cd targetDir
tar -zxvf openGauss-OM-6.0.0-openEuler20.03-aarch64.tar.gz -C omDir
cd omDir/script
./gs_preinstall -U omm -G dbgroup --one-stop-install --sep-env-file=ENVFILE

其中--sep-env-file是环境分离时使用，如果不使用环境分离，可以去掉该参数；targetDir为包解压后的保存路径；omDir为OM包解压后的保存路径。

执行后，首先程序会根据本地的默认字符集，程序根据配置的语言设置会显示对应语言的导航栏，用户在导航栏选择使用哪种语言来进行下面的安装(支持:中文，英文)

可以通过如下命令来查看本地操作系统的语言设置:

echo $LANG

如果系统显示值包含"en_US"，则导航栏为英文

Please choose whether to generate an XML file with one click navigation in English or Chinese?
>> 1) chinese
   2) english

如果系统显示值包含"zh_CN"，则为中文语言，导航栏会显示中文内容。否则，您可以执行如下命令修改语言设置为中文：

export LANG=zh_CN.UTF-8

请选择是英文还是中文导航一键式生成xml文件?
>> 1) 中文
   2) 英文

请输入xml的路径和文件名(默认:./cluster.xml)

用户输入的xml文件路径如果存在，会对判断该输入是否有非法字符，是否是文件，当前用户是否有权限；如果输入xml文件路径不存在，那么不会判断；默认生成的cluster.xml文件默认会在解压包路径下script/base_utils/template/cluster.xml。

请输入数据库安装目录(默认:/opt/openGauss/install)

用户输入的数据库安装目录如果存在，会判断该目录是否有非法字符，是否是一个空目录，当前用户是否有权限操作；如果目录不存在，那么不会判断。

请输入数据库端口(默认:15000)

数据库端口在1024-65535之间，并且输入必须是数字。

请选择是否主备部署

用户可以选在主备部署或单机部署，如果单机部署默认会将本地ip和hostname写入xml中，后面的流程跳过；如果主备部署继续后面的流程。

请选择是否部署资源池化

用户选择部署或不部署资源池化，如果部署，默认会部署CM；如果不部署，继续后面的流程

请选择是否部署CM

用户选择部署CM或不部署CM

请输入cmserver端口(默认:15400)

用户输入的端口在1024-65535之间，必须是数字，不能和上面配置的数据库的端口重复，并且cm端口和数据库端口距离至少间隔10。

请输入节点数量,最多支持一主八备,即9个节点(默认是一主两备,3个节点)

用户输入节点数量在1-9之间，必须是数字

请输入主机节点IP和节点名称(如:192.168.0.1 hostname1;192.168.0.2 hostname2)

用户输入的节点ip和名称，首先数量必须一致，ip和hostname之间用空格分隔，每一组ip hostname之间用分号分隔；其次输入的ip不能重复。

生成的xml路径是: /xxx/script/base_utils/template/cluster.xml

默认生成的xml路径在script/base_utils/template/cluster.xml

xml的内容

<ROOT>
    <CLUSTER>
        <PARAM name="clusterName" value="Cluster_template" />
        <PARAM name="nodeNames" value="hostname1,hostname2,hostname3" />
        <PARAM name="gaussdbAppPath" value="/opt/openGauss/install/app" />
        <PARAM name="gaussdbLogPath" value="/opt/openGauss/install/log" />
        <PARAM name="tmpMppdbPath" value="/opt/openGauss/install/tmp" />
        <PARAM name="gaussdbToolPath" value="/opt/openGauss/install/tool" />
        <PARAM name="corePath" value="/opt/openGauss/install/corefile" />
        <PARAM name="backIp1s" value="192.168.0.1,192.168.0.2,192.168.0.3" />
        </CLUSTER>

    <DEVICELIST>
        <DEVICE sn="node1_hostname">
            <PARAM name="name" value="hostname1" />
            <PARAM name="azName" value="AZ1" />
            <PARAM name="azPriority" value="1" />
            <PARAM name="backIp1" value="192.168.0.1" />
            <PARAM name="sshIp1" value="192.168.0.1" />
            <PARAM name="cmsNum" value="1" />
            <PARAM name="cmServerPortBase" value="15000" />
            <PARAM name="cmServerListenIp1" value="192.168.0.1,192.168.0.2,192.168.0.3" />
            <PARAM name="cmServerHaIp1" value="192.168.0.1,192.168.0.2,192.168.0.3" />
            <PARAM name="cmServerlevel" value="1" />
            <PARAM name="cmServerRelation" value="hostname1,hostname2,hostname3" />
            <PARAM name="cmDir" value="/opt/openGauss/install/data/cmserver" />
            <PARAM name="dataNum" value="1" />
            <PARAM name="dataPortBase" value="15000" />
            <PARAM name="dataNode1" value="/opt/openGauss/install/data/dn1,hostname2,/opt/openGauss/install/data/dn1,hostname3,/opt/openGauss/install/data/dn1" />
            <PARAM name="dataNode1_syncNum" value="0" />
        </DEVICE>

        <DEVICE sn="node2_hostname">
            <PARAM name="name" value="hostname2" />
            <PARAM name="azName" value="AZ1" />
            <PARAM name="azPriority" value="1" />
            <PARAM name="backIp1" value="192.168.0.2" />
            <PARAM name="sshIp1" value="192.168.0.2" />
            <PARAM name="cmServerPortStandby" value="15000" />
            <PARAM name="cmDir" value="/opt/openGauss/install/data/cmserver" />
        </DEVICE>

        <DEVICE sn="node3_hostname">
            <PARAM name="name" value="hostname3" />
            <PARAM name="azName" value="AZ1" />
            <PARAM name="azPriority" value="1" />
            <PARAM name="backIp1" value="192.168.0.3" />
            <PARAM name="sshIp1" value="192.168.0.3" />
            <PARAM name="cmServerPortStandby" value="15000" />
            <PARAM name="cmDir" value="/opt/openGauss/install/data/cmserver" />
        </DEVICE>

        </DEVICELIST>
</ROOT>

请确认xml的内容是否正确,正确输入yes;如需修改xml内容请自行修改,然后输入yes确认

生成的xml先让用户确认下是否正确，如果正确输入y或yes继续后面的流程；如果不正确，请用户重新开个窗口直接修改生成的xml，修改完毕，回到当前窗口，输入y或yes继续下面的流程。