gs_install

背景信息

数据库的部署是一个复杂的过程。MogDB提供了gs_install工具来帮助完成MogDB的安装和部署。

MogDB安装部署，要求用户指定配置文件，配置文件中会指定程序安装路径、实例数据目录、主备关系、实例数、各实例的业务IP端口等信息。

前提条件

已成功执行前置脚本gs_preinstall。
用户需确保各个节点上的locale保持一致。
需要使用前置时设置的MogDB用户进行安装操作。

语法

安装MogDB
```
gs_install -X XMLFILE [--gsinit-parameter="PARAMETER" [...]] [--dn-guc="PARAMETER" [...]] [--alarm-component=ALARMCOMPONENT] [--time-out=SECS] [-l LOGFILE]
```
说明: 安装时若不指定字符集，默认字符集为SQL_ASCII，为简化和统一区域locale默认设置为C，若想指定其他字符集和区域，请在安装时使用参数--gsinit-parameter=“--locale=LOCALE”来指定，LOCALE为新数据库设置缺省的区域。
显示帮助信息
```
gs_install -? | --help
```
显示版本号信息
```
gs_install -V | --version
```

参数说明

-X

MogDB配置文件。

取值范围: xml配置文件。
-l

指定安装日志文件及日志文件存放的路径。

当不明确指定-l，但在XML文件中配置了gaussdbLogPath时，默认值为“gaussdbLogPath的值、用户名和om/gs_install-YYYY-MM-DD_hhmmss.log”的组合。
--gsinit-parameter=PARAM

数据实例参数指定。

取值范围请参见gs_initdb的参数说明，其中对-A、-D、-U、-C、-X参数的设置不生效。
--dn-guc=PARAM

配置参数。

取值范围请参见gs_guc的参数说明。
--time-out=SECS

启动超时等待时间。单位：s。

若-time-out取值过小，有可能会因为需要启动的实例数过多而引起超时。若在超时时间内启动不成功，则会报错启动超时，但是MogDB会在后台继续启动。可以等待一段时间后，查询MogDB状态，检查MogDB是否启动成功。

取值范围: 正整数，若无特殊需求，不需要配置该参数，系统会自动调整超时时间。
--alarm-component=alarm_component

指定告警上报组件的绝对路径。
-?, --help

显示帮助信息。
-V, --version

显示版本号信息。

示例

使用gs_install脚本进行MogDB安装。

gs_install -X /opt/software/MogDB/clusterconfig.xml
Parsing the configuration file.
Check preinstall on every node.
Successfully checked preinstall on every node.
Creating the backup directory.
Successfully created the backup directory.
begin deploy..
Installing the cluster.
begin prepare Install Cluster..
Checking the installation environment on all nodes.
begin install Cluster..
Installing applications on all nodes.
Successfully installed APP.
begin init Instance..
encrypt cipher and rand files for database.
Please enter password for database:
Please repeat for database:
begin to create CA cert files
The sslcert will be generated in /opt/mogdb/cluster/app/share/sslcert/om
Cluster installation is completed.
Configuring.
Deleting instances from all nodes.
Successfully deleted instances from all nodes.
Checking node configuration on all nodes.
Initializing instances on all nodes.
Updating instance configuration on all nodes.
Check consistence of memCheck and coresCheck on DN nodes.
Successful check consistence of memCheck and coresCheck on all nodes.
Configuring pg_hba on all nodes.
Configuration is completed.
Successfully started cluster.
Successfully installed application.