5.2 功能参数

介绍DSS模块的功能参数。

5.2.1 accept_ip

参数含义

DSS可接收的源端和目标端的IP地址。

参数说明

只允许配置的IP向DSS模块传输数据。

参数值

IP地址之间以逗号隔开，逗号是半角。默认值为空，表示所有IP都可以访问。

参数语法

<accept_ip></accept_ip>

参数示例

<accept_ip>127.0.0.1,192.168.7.116,192.168.6.120,192.168.6.102</accept_ip>

5.2.2 cluster

参数含义

DMDSS的集群功能。

参数说明

该参数是一个功能标签，需要配置它的子项。

参数值

无

参数语法

<cluster></cluster>

参数示例

<cluster>
    <host>192.168.20.25</host>
    <initial_cluster>192.168.20.25:5345/dss_active,192.168.20.26:5345/dss_standby1,192.168.20.27:5345/dss_standby2</initial_cluster>
</cluster>

5.2.2.1 cluster_ckpt_threshold

参数含义

DMDSS双节点集群检查点强制推进的LSN阈值。

参数说明

该参数的原名为force_apply_threshold。

配置该参数后当DMDSS接收到的LSN与检查点LSN差距过大时将允许无视集群可用性，强制推进检查点LSN。

注意

检查点被强制推进后，在备节点追上主节点检查点之前将不再能成为主节点。

参数值

LSN差值，配置为0时禁用此功能。默认值为0。

参数语法

<cluster_ckpt_threshold></cluster_ckpt_threshold>

参数示例

配置当DSS接收LSN与检查点LSN差值大于10000时强制推进检查点。

<cluster_ckpt_threshold>10000</cluster_ckpt_threshold>

5.2.2.2 host

参数含义

DMDSS节点的IP地址。

参数说明

当前DMDSS节点的IP地址。当机器存在多个网卡时为必配项。

注意

DMDSS集群各节点之间能通过配置的IP地址互相访问，当无法满足时可能会导致集群不可用。

参数值

IP地址。

参数语法

<host></host>

参数示例

<host>192.168.20.25</host>

5.2.2.3 initial_cluster

参数含义

DMDSS初始化集群节点。

参数说明

当DMDSS初次启动时会使用此参数配置的节点信息作为起始集群节点信息。如果不配置该参数，DMDSS集群将仅包含当前节点，再通过命令添加集群的节点。

注意

当DMDSS完成初始化后集群信息会持久化到本地文件中，此时修改initial_cluster后重启不会变更集群信息，需要通过集群修改命令对集群节点进行修改。

参数值

集群所有节点的IP地址、Manager模块的端口号和模块名的集合，格式为IP:Port/Name[,IP:Port/Name,...]。

参数语法

<initial_cluster></initial_cluster>

参数示例

以3个节点的DMDSS集群为例。

<initial_cluster>192.168.20.25:5345/dss_active,192.168.20.26:5345/dss_standby1,192.168.20.27:5345/dss_standby2</initial_cluster>

5.2.3 delete_policy

参数含义

DSS运行时磁盘空间达到限制后的删除策略。

参数说明

该参数用于控制resvd_size与total_file_limit参数触发时的行为。当空间满足限制条件后，根据该参数来决定删除日志流以释放空间或挂起服务。

参数值

• 0：挂起服务。默认值为0。

• 1：从最旧的日志流文件开始删除，直到满足限制条件或日志流内仅剩一个文件。

参数语法

<delete_policy></delete_policy>

参数示例

<delete_policy>1</delete_policy>

5.2.4 file_size

参数含义

单个文件存储数据量的大小。

参数说明

此大小是非压缩状态下的大小，实际文件大小取决于数据压缩比。

参数值

取值范围：64～3000，单位：MB，默认值为2048。

参数语法

<file_size></file_size>

参数示例

<file_size>2048</file_size>

5.2.5 replace_brackets

参数含义

修改源DMDRS装载链路日志流的名称。

参数说明

该参数用于修改源DMDRS装载链路日志流的名称，装载链路日志流的名称默认为<topic>[LD<NET_ID>]，若开启此参数则将被修改为<topic>_LD_<NET_ID>。

参数值

• 0：不修改装载链路日志流名称。默认值为0。

• 1：修改装载链路日志流名称。

参数语法

<replace_brackets></replace_brackets>

参数示例

<replace_brackets>1</replace_brackets>

5.2.6 resvd_size

参数含义

DMDSS服务运行时预留的存储空间大小。

参数说明

当硬盘剩余空间小于预留空间时根据delete_policy参数来决定行为。

参数值

取值范围：0～2147483647，单位：GB，默认值为10。0表示不限制。根据磁盘实际空间大小设置。

参数语法

<resvd_size></resvd_size>

参数示例

<resvd_size>10</resvd_size>

5.2.7 topic_offline

参数含义

DSS模块离线Topic的配置。

参数说明

该参数一般应用于当源端与目的端存在网络隔离，需要通过文件拷贝的方式实现中转的应用场景。

一个topic_offline参数对应一个Topic存储流，如需配置多个离线Topic，可并列配置多个topic_offline参数。

当Topic配置为离线Topic后不再从源DMDRS接收消息，需要将其他在线Topic产生的mss文件复制到<topic_offline>标签下的<dir>标签中或者将其他在线Topic产生的E语言文本文件复制到<topic_offline>标签下的<cime_dir>标签中。DSS运行中会动态加载这些文件以供消费者消费。

该参数是一个功能标签，需要配置它的子项。

参数值

无

参数语法

<topic_offline></topic_offline>

参数示例

配置名称为“cpt_dm8”的离线Topic。

<topic_offline>
    <topic>
        <item>cpt_dm8</item>
    </topic>
    <dir>./cache</dir>
    <cime_dir>./cache_cime</cime_dir>
</topic_offline>

5.2.7.1 cime_dir

参数含义

E语言文本文件的存储目录。

参数说明

该参数的原名为dir_cime。

当在线Topic将备份文件转换为E语言文本文件时，必须配置该参数，将E语言文本文件复制到E语言文本文件的存储路径。DSS将该路径下的E语言文本文件转换为mss文件并保存至5.2.7.2 dir*路径下以供消费。

参数值

建议用户配置为空间足够存放需要发布的消息且有读写权限的路径。

参数语法

<cime_dir></cime_dir>

参数示例

配置名称为“cpt_dm8”的离线Topic的E语言文本文件的存储路径为“./cime”。

<topic_offline>
    <topic>
        <item>cpt_dm8</item>
    </topic>
    <dir>./cache</dir>
    <cime_dir>./cime</cime_dir>
</topic_offline>

5.2.7.2 dir*

参数含义

离线Topic的日志流存储目录。

参数说明

将日志流存储在此目录下以Topic名称命名的文件夹。

参数值

建议用户配置为空间足够存放需要发布的消息且有读写权限的路径。

参数语法

<dir></dir>

参数示例

配置名称为“cpt_dm8”的离线Topic的日志流存储路径为“./cache”。

<topic_offline>
    <topic>
        <item>cpt_dm8</item>
    </topic>
    <dir>./cache</dir>
</topic_offline>

从在线Topic的备份路径拷贝日志流文件到离线Topic的日志流存储路径后，该路径下的目录结构如下所示。

./cache
 ├── cpt_dm8
 │    ├── dss_1.mss
 │    └── dss_2.mss
 └── cpt_dm8[LD01]
      ├── dss_1.mss
      └── dss_2.mss

注意：当在线Topic的Topic名称与离线Topic的Topic名称不一致时，需要修改离线Topic的日志流存储的目录名称。如上例中，若离线Topic的名称配置为“offline”，则目录结构应修改为如下所示。

./cache
 ├── offline
 │    ├── dss_1.mss
 │    └── dss_2.mss
 └── offline[LD01]
      ├── dss_1.mss
      └── dss_2.mss

5.2.7.3 topic*

参数含义

离线Topic名称配置项。

参数说明

该参数的原名为pattern。

该参数是一个功能标签，需要配置它的子项item，如需配置多个匹配名称，可配置多个<item></item>标签。

参数值

无

参数语法

<topic>
    <item></item>
    <item></item>
</topic>

参数示例

<topic>
    <item>cpt*</item>
    <item>*ora</item>
    <item>db_mysql</item>
</topic>

5.2.7.3.1 item*

参数含义

离线Topic名称。

参数说明

CPT模块对应的主题名，见章节topic，支持通过符号*以进行模糊匹配。当replace_brackets配置为1时，需要增加配置项<topic>_LD*以匹配装载链路，其中<topic>为同步链路主题名。

参数值

• A：名称为A的主题。

• *：所有主题。

• A*：前缀为A的所有主题。

• *B：后缀为B的所有主题。

• A*B：前缀为A以及后缀为B的所有主题。

参数语法

<item></item>

参数示例

• 匹配主题名称为cpt_dm8的主题。

  <topic>
      <item>cpt_dm8</item>
  </topic>
  

• 匹配主题名称前缀为cpt的所有主题。

  <topic>
      <item>cpt*</item>
  </topic>
  

• replace_brackets配置为1时，需要增加配置项<topic>_LD*以匹配装载链路，其中<topic>为同步链路主题名。

  <topic>
      <item>cpt_dm8</item>
      <item>cpt_dm8_LD*</item>
  </topic>
  

5.2.8 topic_online

参数含义

DSS模块在线Topic的配置。

参数说明

该参数的原名为topic。

该参数一般应用于当源端与目的端存在网络隔离，需要通过文件拷贝的方式实现中转的应用场景。

一个topic_online参数可通过<topic>标签匹配多个topic，此标签可配置多个，为不同topic配置不同参数。

该参数是一个功能标签，需要配置它的子项。<topic_online>标签内可以配置dir、accept_ip、file_size、total_file_limit、resvd_size和delete_policy参数，这些参数与父级参数5.1.2 dir、5.2.1 accept_ip、5.2.4 file_size、5.2.9 total_file_limit、5.2.6 resvd_size和5.2.3 delete_policy的配置方法相同，但只作用于当前<topic_online>标签对应的Topic。当与父级参数同时存在时优先使用<topic_online>标签内的参数。

参数值

无

参数语法

<topic_online></topic_online>

参数示例

配置名称为“cpt_dm8”的在线Topic。

<topic_online>
    <topic>
        <item>cpt_dm8</item>
    </topic>
    <dir>./cache</dir>
    <bak_dir>./bak</bak_dir>
    <bak_interval>10</bak_interval>
    <enable_bak_cime>0</enable_bak_cime>
    <file_size>64</file_size>
    <limit_size>20</limit_size>
    <accept_ip>127.0.0.1,127.0.0.2</accept_ip>
</topic_online>

5.2.8.1 bak_cime_size

参数含义

E语言文本文件的大小。

参数说明

无

参数值

取值范围：1～64，单位：MB，默认值为1。

参数语法

<bak_cime_size></bak_cime_size>

参数示例

配置E语言文本文件最大为16MB。

<bak_cime_size>16</bak_cime_size>

5.2.8.2 bak_dir

参数含义

日志流文件的备份目录。

参数说明

DSS在切换写入的日志流文件时，会将已完成写入的文件复制至备份目录中。

参数值

默认不启用备份功能，建议用户配置为空间足够存放需要发布的消息且有读写权限的目录。

参数语法

<bak_dir></bak_dir>

参数示例

配置名称为“cpt_dm8”的Topic的日志流文件的备份目录为“./bak”。

<topic_online>
    <topic>
        <item>cpt_dm8</item>
    </topic>
    <bak_dir>./bak</bak_dir>
</topic_online>

当源DMDRS参数nets为1时，日志流文件的备份目录结构如下所示。

./bak
 ├── cpt_dm8
 │    ├── dss_1.mss
 │    └── dss_2.mss
 └── cpt_dm8[LD01]
      ├── dss_1.mss
      └── dss_2.mss

5.2.8.3 bak_interval

参数含义

强制备份的间隔时间。

参数说明

当最新日志流文件内有数据，且距最后一次备份的时间超出配置时间后，DSS将强制切换写入的日志流文件并进行文件备份，配置为0时不启用强制备份功能。

参数值

取值范围：0～2147483647，单位：秒，默认值为600。

参数语法

<bak_interval></bak_interval>

参数示例

配置名称为“cpt_dm8”的Topic的强制备份的时间间隔为600秒。

<topic_online>
    <topic>
        <item>cpt_dm8</item>
    </topic>
    <bak_interval>600</bak_interval>
</topic_online>

5.2.8.4 enable_bak_cime

参数含义

是否启用备份文件转换为E语言文本文件功能。

参数说明

该参数的原名为bak_cime。

启用该功能后，备份文件将输出为E语言文本文件。

参数值

• 0：禁用。默认值为0。

• 1：启用。

参数语法

<enable_bak_cime></enable_bak_cime>

参数示例

启用备份文件转换为E语言文本文件。

<enable_bak_cime>1</enable_bak_cime>

5.2.8.5 topic*

参数含义

在线Topic名称配置项。

参数说明

该参数的原名为pattern。

该参数是一个功能标签，需要配置它的子项item，如需配置多个匹配名称，可配置多个<item></item>标签。

参数值

无

参数语法

<topic>
    <item></item>
    <item></item>
</topic>

参数示例

<topic>
    <item>cpt*</item>
    <item>*ora</item>
    <item>db_mysql</item>
</topic>

5.2.8.5.1 item*

参数含义

在线Topic名称。

参数说明

CPT模块对应的主题名，见章节topic，支持通过符号*以进行模糊匹配。当replace_brackets配置为1时，需要增加配置项<topic>_LD*以匹配装载链路，其中<topic>为同步链路主题名。

参数值

• A：名称为A的主题。

• *：所有主题。

• A*：前缀为A的所有主题。

• *B：后缀为B的所有主题。

• A*B：前缀为A以及后缀为B的所有主题。

参数语法

<item></item>

参数示例

• 匹配主题名称为cpt_dm8的主题。

  <topic>
      <item>cpt_dm8</item>
  </topic>
  

• 匹配主题名称前缀为cpt的所有主题。

  <topic>
      <item>cpt*</item>
  </topic>
  

• replace_brackets配置为1时，需要增加配置项<topic>_LD*以匹配装载链路，其中<topic>为同步链路主题名。

  <topic>
      <item>cpt_dm8</item>
      <item>cpt_dm8_LD*</item>
  </topic>
  

5.2.9 total_file_limit

参数含义

单个日志流中存储文件的上限。

参数说明

该参数的原名为limit_size。

如果某一个日志流的文件超过该参数的配置大小，则会根据delete_policy参数来决定行为。

参数值

取值范围：0～8589934592，单位：GB。默认值为0，表示无上限，建议采用默认值。

参数语法

<total_file_limit></total_file_limit>

参数示例

<total_file_limit>1000</total_file_limit>