更新时间:2024-06-03 GMT+08:00

cm_server参数

log_dir

参数说明log_dir决定存放cm_server日志文件的目录。它可以是绝对路径,或者是相对路径(相对于cm_server数据目录的路径)。

取值范围:字符串。修改后需要重启cm_server才能生效。参数修改请参考表2进行设置。

默认值:“log”,表示在cm_server数据目录下生成cm_server日志。

log_file_size

参数说明:控制日志文件的大小。当日志文件达到指定大小时,则重新创建一个日志文件记录日志信息。

取值范围:整型,取值范围0~2047,单位为MB。修改后可以reload生效,参数修改请参考表2进行设置。

默认值:16MB

log_min_messages

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

取值范围:枚举类型,有效值有debug5、debug1、log、warning、error、fatal。修改后可以reload生效,参数修改请参考表2进行设置。

默认值:warning

thread_count

参数说明:agent线程池的线程数。

参数类型:字符串

参数单位:

取值范围:该参数分为2个部分,'worker_thread_count, io_ratio',这2个部分的具体含义如下:

  • worker_thread_count:AgentWorker的线程数量,取值范围2~1000。
  • io_ratio:io和worker线程的比例,值为n代表一个AgentIO线程对应n个AgentWorker线程,取值范围1~100。AgentIO线程最少一个。

如果第一部分的参数,即AgentWorker的线程数量大于集群节点数与处理cm_ctl请求的线程数(集群节点数小于32默认1个线程,否则4个线程)之和,实际生效值为集群节点数与处理cm_ctl请求的线程数之和。

默认值:"(1000,1)"

设置方式:参见《工具参考》的“统一数据库管理工具 > cm_ctl工具介绍”章节的表“set cm参数”进行参数设置,然后执行reload指令才能生效。

设置建议:设置为默认值。若要更改,请在理解参数含义后谨慎操作,避免因误操作产生意料之外的风险。

alarm_component

参数说明:设置用于处理告警内容的告警组件的位置。

取值范围:字符串。修改后可以reload生效,参数修改请参考表2进行设置。

  • 若前置脚本gs_preinstall中的--alarm-type参数设置为5时,表示未对接第三方组件,告警写入system_alarm日志,此时GUC参数alarm_component的取值为:/opt/huawei/snas/bin/snas_cm_cmd。
  • 若前置脚本gs_preinstall中的--alarm-type参数设置为1时,表示对接第三方组件,此时GUC参数alarm_component的值为第三方组件的可执行程序的绝对路径。

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

instance_failover_delay_timeout

参数说明:cm_server检测到主机宕机,failover备机的延迟时间。

取值范围:整型,单位为秒。修改后可以reload生效,参数修改请参考表2进行设置。

默认值:0

instance_heartbeat_timeout

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

取值范围:整型,单位为秒。修改后可以reload生效,参数修改请参考表2进行设置。

默认值:6

coordinator_heartbeat_timeout

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

取值范围:整型,单位为秒。修改后可以reload生效,参数修改请参考表2进行设置。

默认值:25

cmserver_ha_connect_timeout

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

取值范围:整型,单位为秒。修改后可以reload生效,参数修改请参考表2进行设置。

默认值:2

cmserver_ha_heartbeat_timeout

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

取值范围:整型,单位为秒。修改后可以reload生效,参数修改请参考表2进行设置。

默认值:6

phony_dead_effective_time

参数说明:用于CN/DN/GTM进程的僵死检测,当检测到的僵死次数大于该参数值,认为进程僵死,将进程重启。

取值范围:整型,单位为次数。修改后可以reload生效,参数修改请参考表2进行设置。

默认值:5

enable_transaction_read_only

参数说明:控制是否打开cm_server磁盘自动阈值检测功能,该功能打开后,当磁盘使用率大于datastorage_threshold_value_check值时,cm_server会自动将数据库设置为只读模式。

取值范围:布尔型,有效值有on、off、true、false、yes、no、1、0。修改后可以reload生效,参数修改请参考表2进行设置。

默认值:on

datastorage_threshold_check_interval

参数说明:检测磁盘占用的时间间隔。间隔用户指定时间,检测一次磁盘占用。

取值范围:整型,单位为秒。修改后可以reload生效,参数修改请参考表2进行设置。

默认值:10

datastorage_threshold_value_check

参数说明:设置数据库只读模式的磁盘占用阈值,当数据目录所在磁盘占用超过这个阈值,自动将数据库设置为只读模式。数据库只读后无法限制日志回放,应当关注集群磁盘容量,及时处理数据库只读相关告警,防止出现磁盘空间写满、出现无法快速恢复的场景。

参数类型:整型

参数单位:百分比

取值范围:1 ~ 99

默认值:85

设置方式:修改后可以reload生效,参数修改请参考表2进行设置。

设置建议:建议设置为默认值,不做调整。根据磁盘空间可作适当调整,调整该参数时,建议同步调整dn的max_size_for_xlog_retention参数,避免因备份操作触发集群只读阈值。

max_datastorage_threshold_check

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

取值范围:整型,单位为秒。修改后可以reload生效,参数修改请参考表2进行设置。

默认值:43200

cmserver_ha_status_interval

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

取值范围:整型,单位为秒。修改后可以reload生效,参数修改请参考表2进行设置。

默认值:1

cmserver_self_vote_timeout

参数说明:cm_server自仲裁超时时间。

取值范围:整型,单位为秒。修改后可以reload生效,参数修改请参考表2行设置。

默认值:6

alarm_report_interval

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

取值范围:非负整型,单位为秒。修改后可以reload生效,参数修改请参考表2进行设置。

默认值:3

alarm_report_max_count

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

取值范围:非负整型。修改后可以reload生效,参数修改请参考表2进行设置。

默认值:1

enable_az_auto_switchover

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

取值范围:非负整型,0或1,0表示开关关闭,1表示开关打开。修改后可以reload生效,参数修改请参考表2进行设置。

默认值:1

instance_keep_heartbeat_timeout

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

取值范围:整型,单位为秒。修改后可以reload生效,参数修改请参考表2进行设置。

默认值:40

az_switchover_threshold

参数说明:若一个AZ内DN分片的故障率(故障的dn分片数 / 总dn分片数 * 100%)超过该数值,则会触发AZ自动切换。

取值范围:整型,0~100。修改后可以reload生效,参数修改请参考表2进行设置。

默认值:100

az_check_and_arbitrate_interval

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

取值范围:整型,单位为秒。修改后可以reload生效,参数修改请参考表2进行设置。

默认值:2

az_connect_check_interval

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

取值范围:整型,单位为秒。修改后可以reload生效,参数修改请参考表2进行设置。

默认值:60

az_connect_check_delay_time

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

取值范围:整型,单位为秒。修改后可以reload生效,参数修改请参考表2进行设置。

默认值:150

cmserver_demote_delay_on_etcd_fault

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

取值范围:整型,单位为秒。修改后可以reload生效,参数修改请参考表2进行设置。

默认值:8

instance_phony_dead_restart_interval

参数说明:当cn/dn/gtm实例僵死时,会被cm_agent重启,相同的实例连续因僵死被杀时,其间隔时间不能小于该参数数值,否则cm_agent不会下发命令

取值范围:整型,1800~231 - 1,单位为秒。修改后可以reload生效,参数修改请参考表2进行设置。

默认值:21600

cm_auth_method

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

取值范围:枚举类型,有效值有trust, gss。修改后可以reload生效,参数修改请参考表2进行设置。

默认值:trust

cm_krb_server_keyfile

参数说明:kerberos服务端key文件所在位置,需要配置为绝对路径。该文件通常为${GAUSSHOME}/kerberos路径下,以keytab格式结尾,文件名与集群运行所在用户名相同。与上述cm_auth_method参数是配对的,当cm_auth_method参数修改为gss时,该参数也必须配置为正确路径,否则将影响集群状态

取值范围:字符串类型,修改后可以reload生效,参数修改请参考表2进行设置。

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

cm_server_arbitrate_delay_base_time_out

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

取值范围:整型,index>0,单位为秒。修改后可以reload生效,参数修改请参考表2进行设置。

默认值:10

cm_server_arbitrate_delay_incrememtal_time_out

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

取值范围:整型,index>0,单位为秒。修改后可以reload生效,参数修改请参考表2进行设置。

默认值:3

force_promote

参数说明:cm_server是否打开强切逻辑(指集群状态为Unknown的时候以丢失部分数据为代价保证集群基本功能可用)的开关。0代表功能关闭,1代表功能开启。该参数同时适用于cn和dn。

取值范围:整型,0~1。修改后可以reload生效,参数修改请参考表2进行设置。

默认值:0

switch_rto

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

取值范围:整型,0~2147483647,单位为秒。最小生效值为60,若设置参数值小于此值实际生效值为最小生效值。修改后可以reload生效,参数修改请参考表2进行设置。

默认值:600

enable_finishredo_retrieve

参数说明:cm_server强切后是否对redo切除的xlog进行数据找回的功能开关。置为on时,发生强切后进行数据自动找回。

参数类型:布尔型

参数单位

取值范围:

  • off:表示关闭。
  • on:表示开启。

默认值off

设置方式该参数属于SIGHUP类型参数,请参考表1中对应设置方法进行设置。

设置建议如果用户可以接受业务(系统)发生强切导致部分数据丢失,恢复业务的优先级最高的情况就可以设置为开启。

backup_open

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

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

  • 0:表示关闭。
  • 1:表示开启。

默认值:0

enable_e2e_rto

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

参数类型:整型

参数单位:

取值范围:

  • 1表示开启。
  • 0表示关闭。

默认值:

独立部署:1

金融版(标准型)、企业版、金融版(数据计算型):0

设置方式:参见《工具参考》的“统一数据库管理工具 > cm_ctl工具介绍”章节的表“set cm参数”进行参数设置,然后执行reload指令才能生效。

设置建议:建议设置为默认值,不做调整。如场景需要,根据磁盘空间可作适当调整。

cluster_starting_aribt_delay

参数说明:cm_server在集群启动阶段,等待DN静态主升主的时间。

取值范围:整型,单位为秒。修改后可以reload生效,参数修改请参考表2进行设置。

默认值:180

enable_dcf

参数说明:DCF模式开关。

取值范围:布尔型。修改后可以reload生效,参数修改请参考表2进行设置。

  • 0表示关闭。
  • 1表示开启。

默认值:off

ddb_type

参数说明:etcd,dcc模式切换开关。

取值范围:整型。0:etcd;1:dcc。修改后需要重启cm_server才能生效。参数修改请参考表2进行设置。

默认值:0

enable_ssl

参数说明:ssl证书开关。

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

默认值

  • on表示启用ssl。
  • off表示不启用ssl。
  • 默认值:off

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

ssl_cert_expire_alert_threshold

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

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

默认值:90

ssl_cert_expire_check_interval

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

取值范围:整型,单位为秒。修改后需要重启cm_server才能生效。参数修改请参考表2进行设置。

默认值:86400

ddb_log_level

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

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

开启日志:“RUN_ERR|RUN_WAR|RUN_INF|DEBUG_ERR|DEBUG_WAR|DEBUG_INF|TRACE|PROFILE|OPER”日志级别可以从上述字符串中选取字符串并使用竖线组合使用,不能配置空串。

取值范围:字符串,RUN_ERR|RUN_WAR|RUN_INF|DEBUG_ERR|DEBUG_WAR|DEBUG_INF|TRACE|PROFILE|OPER。修改后可以reload生效,参数修改请参考表2进行设置。

默认值:RUN_ERR|RUN_WAR|DEBUG_ERR|OPER|RUN_INF|PROFILE

ddb_log_backup_file_count

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

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

默认值:10

ddb_max_log_file_size

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

取值范围:字符串,[1MB, 1000MB]。修改后可以reload生效,参数修改请参考表2进行设置。

默认值:10MB

ddb_log_suppress_enable

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

取值范围:整型,0:关闭;1:开启。修改后可以reload生效,参数修改请参考表2进行设置。

默认值:1

ddb_election_timeout

参数说明:dcc选举超时时间。

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

默认值:3

delay_arbitrate_timeout

参数说明:设置等待跟主DN同AZ节点redo回放后升主的时间。

取值范围:整型,[0, 21474836],单位:秒。修改后可以reload生效,参数修改请参考表2进行设置。

默认值:0

install_type

参数说明:容灾集群相关的设置,用来区别集群的类型。

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

默认值:0

  • 0表示未搭建容灾关系的集群。
  • 1表示基于dorado的集群。
  • 2表示基于流式的集群。

enable_synclist_single_inst

参数说明:开启降副本降至一主零备功能。

参数类型:布尔型

参数单位:

取值范围

  • off:表示关闭降副本降至一主零备功能。
  • on:表示开启降副本降至一主零备功能。

默认值:off

设置方式:参见《工具参考》的“统一数据库管理工具 > cm_ctl工具介绍”章节的表“set cm参数”进行参数设置,然后执行reload指令才能生效。

设置建议:建议设置为默认值。