cm_server参数

cm_server参数

log_dir

**参数说明：**log_dir决定存放cm_server日志文件的目录。它可以是绝对路径，或者是相对路径（相对于$GAUSSLOG的路径）。通过cm_ctl设置绝对路径时需要将路径用’’把路径包含起来，例如：cm_ctl set –param –server -k log_dir=”‘/log/dir’”。

**取值范围：**字符串，最大长度为1024。修改后需要重启cm_server才能生效。参数修改请参考表 set cm参数进行设置。

默认值：“log”，表示在$GAUSSLOG下对应的cm目录下生成cm_server日志。

log_file_size

**参数说明：**控制日志文件的大小。当’cm_server-xx-current.log’日志文件达到指定大小时，则重新创建一个日志文件记录日志信息。

**取值范围：**整型，[0, 2047]，实际生效范围[1, 2047]，单位：MB。修改后可以reload生效，参数修改请参考表 set cm参数进行设置。

**默认值：**16MB

log_min_messages

**参数说明：**控制写到cm_server日志文件中的消息级别。每个级别都包含排在它后面的所有级别中的信息。级别越低，服务器运行日志中记录的消息就越少。

**取值范围：**枚举类型，有效值有debug5、debug1、log、warning、error、fatal（不区分大小写）。修改后可以reload生效，参数修改请参考表 set cm参数进行设置。

**默认值：**warning

thread_count

**参数说明：**cm_server线程池的线程数。

**取值范围：**整型，[2, 1000]。修改后需要重启cm_server才能生效。参数修改请参考表 set cm参数进行设置。

**默认值：**1000

instance_heartbeat_timeout

**参数说明：**实例心跳超时时间。

**取值范围：**整型，[1, 2147483647]，单位：秒。修改后可以reload生效，参数修改请参考表 set cm参数进行设置。

**默认值：**6

instance_failover_delay_timeout

**参数说明：**cm_server检测到主机宕机，failover备机的延迟时间。

**取值范围：**整型，[0, 2147483647]，单位：秒。修改后可以reload生效，参数修改请参考表 set cm参数进行设置。

**默认值：**0

cmserver_ha_connect_timeout

**参数说明：**cm_server主备连接超时时间。

**取值范围：**整型，[0, 2147483647]，单位：秒。修改后可以reload生效，参数修改请参考表 set cm参数进行设置。

**默认值：**2

cmserver_ha_heartbeat_timeout

**参数说明：**cm_server主备心跳超时时间。

**取值范围：**整型，[1, 2147483647]，单位：秒。修改后可以reload生效，参数修改请参考表 set cm参数进行设置。

**默认值：**6

cmserver_ha_status_interval

**参数说明：**cm_server主备同步状态信息间隔时间。

**取值范围：**整型，[1, 2147483647]，单位：秒。修改后可以reload生效，参数修改请参考表 set cm参数进行设置。

**默认值：**1

cmserver_self_vote_timeout

**参数说明：**cm_server之间相互投票的超时时间。旧版本遗留参数，实际不生效。

**取值范围：**整型，[0, 2147483647]，单位：秒。修改后可以reload生效，参数修改请参考表 set cm参数进行设置。

默认值：6

phony_dead_effective_time

**参数说明：**用于数据库节点僵死检测，当检测到的僵死次数大于该参数值，认为进程僵死，将进程重启。

**取值范围：**整型，[1, 2147483647]，单位：次数。修改后可以reload生效，参数修改请参考表 set cm参数进行设置。

**默认值：**5

cm_server_arbitrate_delay_base_time_out

**参数说明：**cm_server仲裁延迟基础时长。cm_server主断连后，仲裁启动计时开始，经过仲裁延迟时长后，将选出新的cm_server主。其中仲裁延迟时长由仲裁延迟基础时长、节点index（server ID序号）和增量时长共同决定。公式为：仲裁延迟时长=仲裁延迟基础时长+节点index*仲裁延迟增量时长参数。

**取值范围：**整型，[0, 2147483647]，单位：秒。修改后可以reload生效，参数修改请参考表 set cm参数进行设置。

**默认值：**10

cm_server_arbitrate_delay_incrememtal_time_out

**参数说明：**cm_server仲裁延迟增量时长。cm_server主断连后，仲裁启动计时开始，经过仲裁延迟时长后，将选出新的cm_server主。其中仲裁延迟时长由仲裁延迟基础时长、节点index（server ID序号）和增量时长共同决定。公式为：仲裁延迟时长=仲裁延迟基础时长+节点index*仲裁延迟增量时长参数。

**取值范围：**整型，[0, 2147483647]，单位：秒。修改后可以reload生效，参数修改请参考表 set cm参数进行设置。

**默认值：**3

alarm_component

**参数说明：**在使用第一种告警方式时，设置用于处理告警内容的告警组件的位置。参数修改请参考表 set cm参数进行设置。通过cm_ctl设置绝对路径时需要将路径用’’把路径包含起来，例如：cm_ctl set –param –server -k alarm_component=”‘/alarm/dir’”。

**取值范围：**字符串，最大长度为1024。修改后可以reload生效，参数修改请参考表 set cm参数进行设置。

默认值：/opt/huawei/snas/bin/snas_cm_cmd

alarm_report_interval

**参数说明：**指定告警上报的时间间隔。

**取值范围：**非负整型，[0, 2147483647]，单位：秒。修改后可以reload生效，参数修改请参考表 set cm参数进行设置。

**默认值：**3

alarm_report_max_count

**参数说明：**指定告警上报的最大次数。

**取值范围：**非负整型，[1, 2592000]。修改后可以reload生效，参数修改请参考表 set cm参数进行设置。

**默认值：**1

instance_keep_heartbeat_timeout

**参数说明：**cm_agent会定期检测实例状态并上报给cm_server，若实例状态长时间无法成功检测，累积次数超出该数值，则cm_server将下发命令给agent重启该实例。

**取值范围：**整型，[0, 2147483647]，单位：秒。修改后可以reload生效，参数修改请参考表 set cm参数进行设置。

**默认值：**40

az_switchover_threshold

**参数说明：**若一个AZ内节点分片的故障率（故障的节点分片数 / 总节点分片数 * 100%）超过该数值，则会触发AZ自动切换。

**取值范围：**整型，[1, 100]。修改后可以reload生效，参数修改请参考表 set cm参数进行设置。

**默认值：**100

az_check_and_arbitrate_interval

**参数说明：**当某个AZ状态不正常时，会触发AZ自动切换，该参数是检测AZ状态的时间间隔。

**取值范围：**整型，[1, 2147483647]，单位：秒。修改后可以reload生效，参数修改请参考表 set cm参数进行设置。

**默认值：**2

az_connect_check_interval

**参数说明：**定时检测AZ间的网络连接，该参数表示连续两次检测之间的间隔时间。

**取值范围：**整型，[1, 2147483647]，单位：秒。修改后可以reload生效，参数修改请参考表 set cm参数进行设置。

**默认值：**60

az_connect_check_delay_time

参数说明：每次检测AZ间的网络连接时有多次重试，该参数表示两次重试之间的延迟时间。

**取值范围：**整型，[1, 2147483647]，单位：秒。修改后可以reload生效，参数修改请参考表 set cm参数进行设置。

**默认值：**150

cmserver_demote_delay_on_etcd_fault

参数说明：因为etcd不健康而导致cm_server从主降为备的时间间隔。

**取值范围：**整型，[1, 2147483647]，单位：秒。修改后可以reload生效，参数修改请参考表 set cm参数进行设置。

**默认值：**8

instance_phony_dead_restart_interval

参数说明：当数据库实例僵死时，会被cm_agent重启，相同的实例连续因僵死被杀时，其间隔时间不能小于该参数数值，否则cm_agent不会下发命令。

**取值范围：**整型，[0, 2147483647]，单位：秒。修改后可以reload生效，参数修改请参考表 set cm参数进行设置。

**默认值：**21600

enable_transaction_read_only

**参数说明：**控制数据库是否为只读模式开关。

**取值范围：**布尔型，有效值有on，off，true，false，yes，no，1，0。修改后可以reload生效，参数修改请参考表 set cm参数进行设置。

**默认值：**on

datastorage_threshold_check_interval

参数说明：检测磁盘占用的时间间隔。间隔时间由用户指定，表示检测一次磁盘的间隔时间。

取值范围：整型，[1, 2592000]，单位：秒。修改后可以reload生效，参数修改请参考表 set cm参数进行设置。

默认值：10

datastorage_threshold_value_check

**参数说明：**设置数据库只读模式的磁盘占用阈值，当某个节点的数据目录所在磁盘占用阈值超过这个阈值，如果该节点为备机，自动将该节点设置为只读，如果该节点为主机，则会自动将主机切换到一个合适的主机上。如果所有节点的阈值均达到阈值，则会将集群设置为只读。

**取值范围：**整型，[1, 99]。修改后可以reload生效，参数修改请参考表 set cm参数进行设置。

**默认值：**85

max_datastorage_threshold_check

**参数说明：**设置磁盘使用率的最大检测间隔时间。当用户手动修改只读模式参数后，会自动在指定间隔时间后开启磁盘检测操作。

**取值范围：**整型，[1, 2592000]，单位：秒。修改后可以reload生效，参数修改请参考表 set cm参数进行设置。

**默认值：**43200

enable_az_auto_switchover

**参数说明：**AZ自动切换开关，若打开，则表示允许cm_server自动切换AZ。否则当发生节点故障等情况时，即使当前AZ已经不再可用，也不会自动切换到其他AZ上，除非手动执行切换命令。

**取值范围：**非负整型，0或1，0：开关关闭，1：开关打开。修改后可以reload生效，参数修改请参考表 set cm参数进行设置。

**默认值：**1

cm_krb_server_keyfile

**参数说明：**kerberos服务端key文件所在位置，需要配置为绝对路径。该文件通常为${GAUSSHOME}/kerberos路径下，以keytab格式结尾，文件名与集群运行所在用户名相同。与上述cm_auth_method参数是配对的，当cm_auth_method参数修改为gss时，该参数也必须配置为正确路径，否则将影响集群状态。通过cm_ctl设置绝对路径时需要将路径用’’把路径包含起来，例如：cm_ctl set –param –server -k cm_krb_server_keyfile=”‘/krb/dir’”。

**取值范围：**字符串类型，修改后可以reload生效，参数修改请参考表 set cm参数进行设置。

默认值：${GAUSSHOME}/kerberos/{UserName}.keytab，默认值无法生效，仅作为提示。

switch_rto

**参数说明：**cm_server强起逻辑等待时延。在force_promote被置为1时，当集群的某一分片处于无主状态开始计时，等待该延迟时间后开始执行强起逻辑。

**取值范围：**整型，[60, 2147483647]，单位：秒。修改后可以reload生效，参数修改请参考表 set cm参数进行设置。

**默认值：**600

force_promote

**参数说明：**cm_server是否打开强起逻辑（指集群状态为Unknown的时候以丢失部分数据为代价保证集群基本功能可用）的开关。0代表功能关闭，1代表功能开启。

**取值范围：**整型，[0, 1]。修改后可以reload生效，参数修改请参考表 set cm参数进行设置。

**默认值：**0

backup_open

参数说明：灾备集群设置，开启后CM按照灾备集群模式运行。

取值范围：整型，[0, 1]。修改后需要重启cm_server才能生效。非灾备集群不能开启该参数。参数修改请参考表 set cm参数进行设置。

0表示关闭。
1表示开启

默认值：0

enable_dcf

参数说明：DCF模式开关。

取值范围：布尔型。修改后需要重启cm_server才能生效。参数修改请参考表 set cm参数进行设置。

on、yes、true、1：表示启用dcf。
off、no、false、0：表示不启用dcf。

默认值：off

ddb_type

参数说明：ETCD，DCC、share disk模式切换开关。

取值范围：整型。0：ETCD；1：DCC；2：share disk。修改后需要重启cm_server才能生效。参数修改请参考表 set cm参数进行设置。

默认值：1

说明： （opengauss只支持DCC或者share disk模式）。

enable_ssl

参数说明：ssl证书开关。

取值范围：布尔型。打开后使用ssl证书加密通信。修改后需要重启cm_server才能生效。参数修改请参考表 set cm参数进行设置。

on、yes、true、1：表示启用ssl。
off、no、false、0：表示不启用ssl。
默认值：on

须知： 出于安全性考虑，建议不要关闭该配置。关闭后cm将不使用加密通信，所有信息明文传播，可能带来窃听、篡改、冒充等安全风险。

ssl_cert_expire_alert_threshold

参数说明：ssl证书过期告警时间。

取值范围：整型，[7, 180]，单位：天。证书过期时间少于该时间时，上报证书即将过期告警。修改后需要重启cm_server才能生效，参数修改请参考表 set cm参数进行设置。

默认值：90

ssl_cert_expire_check_interval

参数说明：ssl证书过期检测周期。

取值范围：整型，[0, 2147483647]，单位：秒。修改后需要重启cm_server才能生效，参数修改请参考表 set cm参数进行设置。

默认值：86400

ddb_log_level

参数说明：设置ddb日志级别。

关闭日志：“NONE”，NONE表示关闭日志打印，不能与以下日志级别混合使用。

ddb_log_backup_file_count

参数说明：最大保存日志文件个数。

取值范围：整型，[1, 100]。修改后可以reload生效，参数修改请参考表 set cm参数进行设置。

默认值：10

ddb_max_log_file_size

参数说明：单条日志最大字节数。

取值范围：字符串，长度最大为1024，[1M, 1000M]。修改后可以reload生效，参数修改请参考表 set cm参数进行设置。

默认值：10M

ddb_log_suppress_enable

参数说明：是否开启日志抑制功能。

取值范围：整型，0：关闭； 1：开启。修改后可以reload生效，参数修改请参考表 set cm参数进行设置。

默认值：1

ddb_election_timeout

参数说明：DCC 选举超时时间。

取值范围：整型，[1, 600], 单位：秒。修改后可以reload生效，参数修改请参考表 set cm参数进行设置。

默认值：3

coordinator_heartbeat_timeout

**参数说明：**节点故障自动剔除心跳超时时间。设置后立即生效，不需要重启cm_server。该参数设置为0，则节点故障后不会自动剔除。

**取值范围：**整型，单位为秒。修改后可以reload生效，参数修改请参考表 set cm参数进行设置。

**默认值：**25

cluster_starting_aribt_delay

**参数说明：**cm_server在集群启动阶段，等待节点静态主升主的时间。

**取值范围：**整型，[1,2592000]，单位：秒。修改后可以reload生效，参数修改请参考表 set cm参数进行设置。

**默认值：**180

enable_e2e_rto

**参数说明：**端到端RTO开关，开启后僵死检测周期及网络检测超时时间将缩短，CM可以达到端到端RTO指标（单实例故障RTO<=10s，叠加故障RTO<=30s）。

**取值范围：**整型，[0, 1]。1表示开启，0表示关闭。修改后可以reload生效，参数修改请参考表 set cm参数进行设置。

**默认值：**0

disk_timeout

**参数说明：**磁盘心跳超时时间。

**取值范围：**整型，[0, 2147483647]，单位：秒。修改后可以reload生效，参数修改请参考表 set cm参数进行设置。

**默认值：**200

agent_network_timeout

参数说明：节点间网络超时时间。

**取值范围：**整型，[0, 2147483647]，单位：秒。修改后可以reload生效，参数修改请参考表 set cm参数进行设置。

**默认值：**6

voting_disk_path

**参数说明：**投票盘路径。

**取值范围：**字符串，最大长度为1024。修改后需要重启cm_server才能生效。

**默认值：**无，需要安装时进行配置。

share_disk_path

**参数说明：**共享盘路径。

**取值范围：**字符串，最大长度为1024。修改后需要重启cm_server才能生效。

**默认值：**无，需要安装时进行配置。

dn_arbitrate_mode

参数说明：dn仲裁模式。

取值范围：字符串。修改后可以reload生效。参数修改请参考表 set cm参数进行设置，share_disk模式下，不建议用户修改仲裁模式。

quorum
paxos
share_disk

默认值：quorum

delay_arbitrate_max_cluster_timeout

参数说明：启动过程中，延迟仲裁最大集群时间。

取值范围：整型，[0, 1000]，单位：秒。0：表示不进行仲裁。修改后可以reload生效。参数修改请参考表 set cm参数进行设置。

默认值：300

delay_arbitrate_timeout

参数说明：设置等待跟主DN同AZ节点redo回放，优先选择同AZ升主的时间。

取值范围：整型，[0, 2147483647]，单位：秒。参数修改请参考表 set cm参数进行设置。

默认值：0

cm_auth_method

**参数说明：**CM模块端口认证方式，trust表示未配置端口认证，gss表示采用kerberos端口认证。必须注意的是：只有当kerberos服务端和客户端成功安装后才能修改为gss，否则CM模块无法正常通信，将影响数据库状态。

**取值范围：**枚举类型，有效值有trust, gss。修改后需要重启cm_server才能生效。参数修改请参考表 set cm参数进行设置。

**默认值：**trust

third_party_gateway_ip

**参数说明：**CM两节点部署模式必备参数。当前AZ中第三方网关IP地址或任何其他独立于当前集群的可用IP地址，需要确保其与集群中节点间的网络相通。

**取值范围：**字符串。修改后可以reload生效。参数修改请参考表 set cm参数进行设置。

**默认值：**无，需要安装时进行配置。

cms_enable_failover_on2nodes

**参数说明：**CM两节点部署模式必备参数。是否允许CM集群自身故障自动切换，默认禁止CM集群自身自动故障切换。

**取值范围：**布尔型。修改后可以reload生效。参数修改请参考表 set cm参数进行设置。

on、yes、true、1：表示允许CM集群自身自动故障切换。
off、no、false、0：表示禁止CM集群自身自动故障切换。

**默认值：**false

cms_enable_db_crash_recovery

**参数说明：**CM两节点部署模式必备参数。是否允许数据库集群脑裂自动故障恢复。为了确保数据库集群的数据一致性，默认不支持其自动故障恢复。

**取值范围：**布尔型。修改后可以reload生效。参数修改请参考表 set cm参数进行设置。

on、yes、true、1：表示允许DN集群脑裂自动故障恢复。
off、no、false、0：表示禁止DN集群脑裂自动故障恢复。

**默认值：**false

cms_network_isolation_timeout

**参数说明：**CM两节点部署模式必备参数。cm_server检索ddb集群信息同步异常的最大连续检测次数，超过最大检测次数则认为发生网络分区故障。

取值范围：整型，单位：次。修改后需要重启cm_server才能生效。

**默认值：**20