VastbaseG100

基于openGauss内核开发的企业级关系型数据库。

Menu

配置说明

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_dss" value="on"/>
    <!-- dss实例目录 -->
    <PARAM name="dss_home" value="/opt/vastbase/install/data/dss"/>
    <!-- dss共享卷名 -->
    <PARAM name="ss_dss_vg_name" value="data"/>
    <!-- dss挂载卷组名和卷组信息,包含共享卷 -->
    <PARAM name="dss_vg_info" value="data:/dev/sdb,p0:/dev/sdc,p1:/dev/sdd"/>
    <!-- cm投票卷 -->
    <PARAM name="votingDiskPath" value="/dev/sde"/>
    <!-- cm共享卷 -->
    <PARAM name="shareDiskDir" value="/dev/sdf"/>
    <!-- dss开启ssl认证开关 -->
    <PARAM name="dss_ssl_enable" value="on"/>
    <!-- mes通信协议类型  -->
    <PARAM name="ss_interconnect_type" value="TCP"/>
    <!-- rdma绑定cpu序列  -->
    <PARAM name="ss_rdma_work_config" value="1 7"/>
    </CLUSTER>

上述配置项中,enable_dss之后的内容为资源池化集群的相关配置项。

开启资源池化开关(enable_dss=on)表示集群为资源池化模式,关闭资源池化开关(enable_dss=off)表示集群为传统流复制模式。

注意事项

  • /opt/vastbase/install/om路径存放互信等工具,为了避免权限问题,不要把实例数据目录放在此目录下。

  • 安装目录和数据目录需为空或者不存在,否则可能导致安装失败。

  • 在对数据库节点的实例进行具体配置时,需确保配置的目录之间不相互耦合。即各个配置目录不关联,删除其中任意一个目录,不会级联删除其它目录。如当设置gaussdbAppPath为/opt/vastbase/install/app,gaussdbLogPath为/opt/vastbase/install/app/omm。若gaussdbAppPath目录被删除时,则会级联删除gaussdbLogPath目录,从而引起其它问题。

  • 若需要预安装脚本自动创建安装用户时,各配置的目录需保证不与系统创建的默认用户目录耦合关联。

  • 配置路径和实例路径时,路径中不能包含“| , ; , & , $ , < , > , ` , \ , ‘ , “ , { , } , ( , ) , [ , ] , ~ , * , ? ”特殊字符。

  • 配置数据库节点名称时,请通过hostname命令获取各数据库节点的主机名称。

  • 资源池化中请谨慎配置所有包含磁盘信息的参数,安装时工具会低格(Low Level Formatting,低级格式化)所有参数中配置的磁盘,所有参数中的磁盘不能重复。

  • 资源池化中的ip和dn的数据ip保持一致,dss的端口是db端口+10,dms的端口是db端口+20。

参数说明

实例类型

参数

说明

整体信息

clusterName

Vastbase名称。

nodeNames

Vastbase中主机名称。

backIp1s

主机在后端存储网络中的IP地址(内网IP)。所有Vastbase主机使用后端存储网络通讯。

gaussdbAppPath

Vastbase程序安装目录。此目录应满足如下要求:

  • 磁盘空间>1GB。
  • 与数据库所需其它路径相互独立,没有包含关系。

gaussdbLogPath

Vastbase运行日志和操作日志存储目录。此目录应满足如下要求:

  • 磁盘空间建议根据主机上的数据库节点数规划。数据库节点预留1GB空间的基础上,再适当预留冗余空间。
  • Vastbase所需其它路径相互独立,没有包含关系。

此路径可选。不指定的情况下,Vastbase安装时会默认指定“$GAUSSLOG/安装用户名”作为日志目录。

tmpMppdbPath

数据库临时文件存放目录。

若不配置tmpMppdbPath,默认存放在/opt/vastbase/wisequery/安装用户名_mppdb目录下,其中"opt/vastbase/wisequery"是默认指定的数据库系统工具目录。

gaussdbToolPath

Vastbase系统工具目录,主要用于存放互信工具等。此目录应满足如下要求:

  • 磁盘空间>100MB。
  • 固定目录,与数据库所需其它目录相互独立,没有包含关系。

此目录可选。不指定的情况下,Vastbase安装时会默认指定“/opt/vastbase/wisequery”作为数据库系统工具目录。

corePath

Vastbase core文件的指定目录。

enable_dss

资源池化模式开关,取值范围on/off,默认为off。

dss_home

dss实例目录enable_dss为on时必选

ss_dss_vg_name

dss共享卷名enable_dss为on时必选

dss_vg_info

dss挂载卷组信息,包含一个共享卷组,其余为日志卷组,日志卷组的数量和dn的数量保持一致,集中式每个节点最多有一个dn。卷组形如“data:/dev/sdb”,卷组和卷组之间以“,”隔开,enable_dss为on时必选日志卷组磁盘大小需要大于dn参数max_size_for_xlog_prune的值,

votingDiskPath

has的投票卷,enable_dss为on时必选

shareDiskDir

has的共享卷enable_dss为on时必选

dss_ssl_enable

dss开启ssl认证开关,取值范围on/off,默认为on

ss_interconnect_type

mes通信协议类型,默认值TCP,取值范围TCP/RDMA,默认为TCP

ss_rdma_work_config

rdma用户态poll占用起止cpuss_interconnect_type为RDMA时有效,形如"10 15",中间以空格分隔。

配置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。
cascadeRole value为on表示该实例为级联备库。
详细说明参见级联备库

配置文件中所有IP参数(包含backIp、sshIp、listenIp等)均只支持配置一个IP。如果配置第二个IP参数,则不会读取第二个参数的配置值。

示例:xml配置文件中同时配置backIp1和backIp2参数: 在解析配置文件时仅读取backIp1参数的配置值,不会读取backIp2参数的配置值。

<PARAM name="backIp1" value="172.16.105.54"/>
<PARAM name="backIp2" value="172.16.105.58"/>

配置数据库主节点信息

配置项

数据库主节点配置以下信息,内容为示例,可自行替换。每行信息均有注释进行说明。

<!--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"/>
<!--数据库节点上自定义设定同步模式的节点方式、数量及顺序,hostname根据主机名自行替换-->
<PARAM name="syncNode_hostname" value="ANY 1(node1_hostname,node2_hostname)"/>

参数说明

参数 说明
dataNum 当前主机上需要部署的数据库节点个数。
dataPortBase 数据库节点的基础端口号。
cmServerListenIp1 侦听的IP地址。未设置时,使用对应主机上的backIp1生成。
第一个IP是主节点所在主机IP,第二个IP是备节点所在主机IP。
dataNode1 用于指定当前主机上的数据库节点的数据存储目录。此目录为数据库的数据存储目录。应规划到数据盘上。
dataNodeXlogPath1 可选参数,用于指定当前数据库中xlog存储路径。此目录为数据库xlog日志存储目录,只支持绝对路径。
如不指定,则默认存放在数据目录的pg_xlog目录下。
dataNode1_syncNum 可选参数,与下面syncNode_hostname参数二选一。如需配置,仅在主机节点下配置。用于指定当前数据库中同步模式的节点数目。取值范围为0~数据库备机节点数。
syncNode_hostname 可选参数,与前面的dataNode1_syncNum参数二选一。用于一主四备集群时自定义利用FIRST、ANY设置同步备机,即指定当前数据库中同步模式的备机节点方式、数量及顺序。
如需配置,需要在所有的节点下同时配置。
syncNode_hostname中的hostname根据主机名自行替换。参数中指定同步备主机名存在且正确,同步备数量不能超过备选同步备主机个数。参数中FIRST与ANY不可以同时存在,ANY支持组合配置,FIRST不支持组合配置。

配置HAS_SERVER(主、非主)信息

配置项

  • has_server(主)配置以下信息:

    <!--HAS节点部署信息--> 
    <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"/>
    <!--cmServerlevel目前只支持1-->
    <PARAM name="cmServerlevel" value="1"/>
    <!--cms主及所有hostname-->
    <PARAM name="cmServerRelation" value="Vastbase1,Vastbase2,Vastbase3"/>
    <PARAM name="cmDir" value="/opt/vastbase/data/cmserver"/>
    
  • has_server(非主)配置以下信息:

    <!-- cm --> 
    <PARAM name="cmServerPortStandby" value="15000"/>
    <PARAM name="cmDir" value="/opt/vastbase/data/cmserver"/>
    

参数说明

参数 说明
cmServerPortBase 主has Server端口。
cmServerPortStandby 备has Server端口号。
cmServerListenIp1 has Server用于侦听has Agent连接请求或DBA管理请求的IP地址。
cmServerHaIp1 主、备has Server间通信的IP地址。Value中左边为主has Server的主机IP地址,右边为备has Server的主机IP地址。
未设置时,默认根据主、备has Server所在主机的backIp1生成。
cmDir has数据文件路径。保存has Server和has Agent用到的数据文件,参数文件等。