配置说明
XML文件模板位于软件解压目录下的script/gspylib/etc/conf/cluster_config_template.xml。
以下配置内容为示例,用户可根据每行信息的注释说明自行替换。
配置数据库名称及各项目录
配置项
<?xml version="1.0" encoding="UTF-8"?>
<ROOT>
<!-- 整体信息 -->
<CLUSTER>
<!-- 数据库名称 -->
<PARAM name="clusterName" value="Cluster_template" />
<!-- 数据库节点名称(hostname) -->
<PARAM name="nodeNames" value="Vastbase1,Vastbase2,Vastbase3" />
<!-- 数据库安装目录-->
<PARAM name="gaussdbAppPath" value="/opt/vastbase/install/app" />
<!-- 日志目录-->
<PARAM name="gaussdbLogPath" value="/var/log/vastbase" />
<!-- 临时文件目录-->
<PARAM name="tmpMppdbPath" value="/opt/vastbase/tmp" />
<!--数据库工具目录-->
<PARAM name="gaussdbToolPath" value="/opt/vastbase/install/om" />
<!--数据库core文件目录-->
<PARAM name="corePath" value="/opt/vastbase/corefile"/>
<!-- 节点IP,与数据库节点名称列表一一对应 -->
<PARAM name="backIp1s" value="172.16.105.54,172.16.105.58,172.16.105.60"/>
<!-- 是否开启数据库节点自选主 -->
<PARAM name="enable_dcf" value="off"/>
</CLUSTER>
注意事项
/opt/vastbase/install/om路径存放互信等工具,为了避免权限问题,不要把实例数据目录放在此目录下。
安装目录和数据目录需为空或者不存在,否则可能导致安装失败。
在对数据库节点的实例进行具体配置时,需确保配置的目录之间不相互耦合。即各个配置目录不关联,删除其中任意一个目录,不会级联删除其它目录。如当设置
gaussdbAppPath
为/opt/vastbase/install/app,gaussdbLogPath
为/opt/vastbase/install/app/omm。若gaussdbAppPath
目录被删除时,则会级联删除gaussdbLogPath
目录,从而引起其它问题。若需要预安装脚本自动创建安装用户时,各配置的目录需保证不与系统创建的默认用户目录耦合关联。
路径中不能包含“| , ; , & , $ , < , > , ` , \ , ‘ , “ , { , } , ( , ) , [ , ] , ~ , * , ? ”特殊字符
配置数据库节点名称时,请通过
hostname
命令获取各数据库节点的主机名称。
参数说明
参数 | 说明 |
---|---|
clusterName | 集群名称。 |
nodeNames | 主机名称。 |
backIp1s | 主机在后端存储网络中的IP地址(内网IP)。所有Vastbase主机使用后端存储网络通讯。 |
gaussdbAppPath | 程序安装目录。应满足如下要求:磁盘空间>1GB;与数据库所需其它路径相互独立,没有包含关系。 |
gaussdbLogPath | 运行日志和操作日志存储目录。磁盘空间建议根据主机上的数据库节点数规划。数据库节点预留1GB空间的基础上,再适当预留冗余空间。与其它路径相互独立,没有包含关系。 |
corePath | Vastbase core文件的指定目录。 |
enable_dcf | 是否开启DCF模式。 |
配置host基本信息
配置项
每台host服务器都必须有如下配置信息,示例以node1为例:
<!-- 每台服务器上的节点部署信息 -->
<DEVICELIST>
<!-- 节点1上的部署信息 -->
<DEVICE sn="Vastbase1">
<!-- 节点1的主机名称 -->
<PARAM name="name" value="Vastbase1"/>
<!-- 节点1所在的AZ及AZ优先级 -->
<PARAM name="azName" value="AZ1"/>
<PARAM name="azPriority" value="1"/>
<!-- 节点1的IP,如果服务器只有一个网卡可用,将backIP1和sshIP1配置成同一个IP -->
<PARAM name="backIp1" value="172.16.105.54"/>
<PARAM name="sshIp1" value="172.16.105.54"/>
<!-- node1是否为级联备, on表示该实例为级联备,另外级联备机在相同的AZ里需要配有备机 -->
<PARAM name="cascadeRole" value="on"/>
参数说明
参数 | 说明 |
---|---|
name | 主机名称。 |
azName | 指定azName(Available Zone Name),字符串(不能含有特殊字符),例如AZ1、AZ2、AZ3。 |
azPriority | 指定azPriority的优先级。 |
backIp1 | 主机在后端存储网络中的IP地址(内网IP)。所有Vastbase主机使用后端存储网络通讯。 |
sshIp1 | 设置SSH可信通道IP地址(外网IP)。 若无外网,则可以不设置该选项或者同backIp1设置相同IP。 |
配置数据库主节点信息
配置项
数据库主节点配置以下信息,示例如下:
<!--DBnode-->
<PARAM name="dataNum" value="1"/>
<!--DBnode端口号-->
<PARAM name="dataPortBase" value="15400"/>
<!--DBnode侦听IP-->
<PARAM name="cmServerListenIp1" value="172.16.105.54,172.16.105.58,172.16.105.60"/>
<!--DBnode主节点上数据目录,及备机数据目录-->
<PARAM name="dataNode1" value="/opt/vastbase/install/data/dn,Vastbase2,/opt/vastbase/install/data/dn,Vastbase3,/opt/vastbase/install/data/dn"/>
<!--数据库主节点上的xlog目录,及备机xlog目录-->
<PARAM name="dataNodeXlogPath1" value="/home/omm/gauss_xlog,/home/omm/gauss_xlog "/>
<!--DBnode节点上设定同步模式的节点数-->
<PARAM name="dataNode1_syncNum" value="0"/>
参数说明
参数 | 说明 |
---|---|
dataNum | 当前主机上需要部署的数据库节点个数。 |
dataPortBase | 数据库节点的基础端口号。 |
dataListenIp1 | 定azPriority的优先级。 |
backIp1 | 侦听的IP地址。 未设置时,使用对应主机上的backIp1生成。第一个IP是主节点所在主机IP,第二个IP是备节点所在主机IP。 |
dataNode1 | 用于指定当前主机上的数据库节点的数据存储目录。此目录为数据库的数据存储目录。应规划到数据盘上。 |
dataNodeXlogPath1 | 可选参数,用于指定当前数据库中xlog存储路径。此目录为数据库xlog日志存储目录,只支持绝对路径。 如不指定,则默认存放在数据目录的pg_xlog目录下。 |
dataNode1_syncNum | 可选参数,用于指定当前数据库中同步模式的节点数目。取值范围为0~数据库备机节点数。 |
配置集群管理服务信息
配置项
主CMS节点配置以下信息:
<!--CM节点部署信息--> <PARAM name="cmsNum" value="1"/> <PARAM name="cmServerPortBase" value="15000"/> <PARAM name="cmServerListenIp1" value="172.16.105.54,172.16.105.58,172.16.105.60"/> <PARAM name="cmServerHaIp1" value="172.16.105.54,172.16.105.58,172.16.105.60"/> <PARAM name="cmServerlevel" value="1"/> <PARAM name="cmServerRelation" value="Vastbase1,Vastbase2,Vastbase3"/> <PARAM name="cmDir" value="/opt/vastbase/data/cmserver"/>
非主CMS节点配置以下信息:
<!-- cm --> <PARAM name="cmServerPortStandby" value="15000"/> <PARAM name="cmDir" value="/opt/vastbase/data/cmserver"/>
参数说明
参数 | 说明 |
---|---|
cmServerPortBase | 主CM Server端口。 |
cmServerPortStandby | 备CM Server端口号。 |
cmServerListenIp1 | CM Server用于侦听CM Agent连接请求或DBA管理请求的IP地址。 |
cmServerHaIp1 | 主、备CM Server间通信的IP地址。Value中左边为主CM Server的主机IP地址,右边为备CM Server的主机IP地址。 未设置时,默认根据主、备CM Server所在主机的backIp1生成。 |
cmDir | CM数据文件路径。保存CM Server和CM Agent用到的数据文件,参数文件等。 |