cm_agent参数

log_dir

**参数说明:**log_dir决定存放cm_agent日志文件的目录。 可以是绝对路径,或者是相对路径(相对于$GAUSSLOG的路径)。通过cm_ctl设置绝对路径时需要将路径用''把路径包含起来,例如:cm_ctl set –param –agent -k log_dir="'/log/dir'"。

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

默认值:“log”,表示在$GAUSSLOG下对应的cm目录下生成cm_agent日志。

log_file_size

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

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

**默认值:**16MB。

log_min_messages

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

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

**默认值:**warning

incremental_build

**参数说明:**控制重建备节点模式是否为增量。打开这个开关,则增量重建备节点;否则,全量重建备节点。

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

  • on、yes、true、1:表示增量重建备节点。

  • off、no、false、0:表示全量重建备节点。

**默认值:**on

security_mode

**参数说明:**控制是否以安全模式启动节点。打开这个开关,则以安全模式启动节点;否则,以非安全模式启动节点。

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

  • on、yes、true、1:表示以安全模式启动节点。

  • off、no、false、0:表示以非安全模式启动节点。

**默认值:**off

upgrade_from

**参数说明:**就地升级过程中使用,用于标示升级前数据库的内部版本号,此参数禁止手动修改。

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

**默认值:**0

alarm_component

**参数说明:**在使用第一种告警方式时,设置用于处理告警内容的告警组件的位置。通过cm_ctl设置绝对路径时需要将路径用''把路径包含起来,例如:cm_ctl set –param –agent -k alarm_component="'/alarm/dir'"。

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

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

alarm_report_interval

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

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

**默认值:**1

agent_heartbeat_timeout

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

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

**默认值:**5

agent_connect_timeout

**参数说明:**cm_agent连接cm_server超时时间。

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

**默认值:**1

agent_connect_retries

**参数说明:**cm_agent连接cm_server尝试次数。

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

**默认值:**15

agent_kill_instance_timeout

参数说明:当cm_agent在无法连接cm_server主节点后,发起一次杀死本节点上所有实例的操作之前,所需等待的时间间隔。

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

**默认值:**0,不发起杀死本节点上所有实例的操作。

agent_report_interval

**参数说明:**cm_agent上报实例状态的时间间隔。

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

**默认值:**1

alarm_report_max_count

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

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

**默认值:**1

agent_check_interval

**参数说明:**cm_agent查询实例状态的时间间隔。

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

**默认值:**2

enable_log_compress

参数说明:控制压缩日志功能。

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

  • on、yes、true、1:表示允许压缩日志。
  • off、no、false、0:表示不允许压缩日志。

默认值:on

process_cpu_affinity

**参数说明:**控制是否以绑核优化模式启动主节点进程。配置该参数为0,则不进行绑核优化;否则,进行绑核优化,且物理CPU片数为2n个。仅支持ARM。

**取值范围:**整型,[0, 2]。修改后需要重启数据库、cm_agent才能生效,参数修改请参考表 set cm参数进行设置。

**默认值:**0

enable_xc_maintenance_mode

**参数说明:**在数据库为只读模式下,控制是否可以修改pgxc_node系统表。

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

  • on、yes、true、1:表示开启可以修改pgxc_node系统表功能。

  • off、no、false、0:表示关闭可以修改pgxc_node系统表功能。

**默认值:**on

log_threshold_check_interval

参数说明:cm日志压缩和清除的时间间隔,每1800秒压缩和清理一次。

生效范围:$GAUSSLOG/cm/cm_ctl;$GAUSSLOG/cm/cm_server;$GAUSSLOG/cm/om_monitor目录下的文件以及$GAUSSLOG/cm/cm_agent目录下以cm_agent-、system_call-、system_alarm-为前缀的日志文件。

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

默认值:1800

log_max_size

参数说明:控制cm日志最大存储值,当CM日志总大小超过(log_max_size*95/100)MB时,根据压缩日志生成时间,依次删除历史压缩日志,直到日志总大小小于(log_max_size*95/100)MB。

生效范围:$GAUSSLOG/cm/cm_ctl;$GAUSSLOG/cm/cm_server;$GAUSSLOG/cm/om_monitor目录下的文件以及$GAUSSLOG/cm/cm_agent目录下以cm_agent-、system_call-、system_alarm-为前缀的日志文件。

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

默认值:10240

log_max_count

参数说明:cm可存储的最多日志数量,当cm日志总个数超过该值,根据压缩日志文件名时间,删除超过保留天数log_saved_days的压缩日志。

生效范围:$GAUSSLOG/cm/cm_ctl;$GAUSSLOG/cm/cm_server;$GAUSSLOG/cm/om_monitor目录下的文件以及$GAUSSLOG/cm/cm_agent目录下以cm_agent-、system_call-、system_alarm-为前缀的日志文件。

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

默认值:10000

log_saved_days

参数说明:cm压缩日志保存的天数,cm压缩日志超过该值并且cm日志总个数超过log_max_count,删除压缩日志。

生效范围:$GAUSSLOG/cm/cm_ctl;$GAUSSLOG/cm/cm_server;$GAUSSLOG/cm/om_monitor目录下的文件以及$GAUSSLOG/cm/cm_agent目录下以cm_agent-、system_call-、system_alarm-为前缀的日志文件。

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

默认值:90

须知: 日志压缩能力受限于内存限制,最多只能检测到30000个日志文件。总日志量超过30000个文件时,则无法保证日志能被正常压缩及删除。可以通过调整log_saved_days和log_threshold_check_interval快速清理已压缩日志文件。

agent_phony_dead_check_interval

**参数说明:**cm_agent检测进程是否僵死的时间间隔。

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

**默认值:**10

unix_socket_directory

**参数说明:**unix套接字的目录位置。通过cm_ctl设置绝对路径时需要将路径用''把路径包含起来,例如:cm_ctl set –param –agent -k unix_socket_directory="'/unix/dir'"。

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

默认值:''

dilatation_shard_count_for_disk_capacity_alarm

参数说明:扩容场景下,设置新增的扩容分片数,用于上报磁盘容量告警时的阈值计算。

取值范围:整型,[0, 2147483647],单位:个。该参数设置为0,表示关闭磁盘扩容告警上报;该参数设置为大于0,表示开启磁盘扩容告警上报,且告警上报的阈值根据此参数设置的分片数量进行计算。修改后可以reload生效,参数修改请参考表 set cm参数进行设置。

默认值:1

enable_dcf

参数说明:DCF模式开关。

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

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

默认值:off

disaster_recovery_type

参数说明:主备数据库灾备关系的类型。

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

  • 0表示未搭建灾备关系。
  • 1表示搭建了obs灾备关系。
  • 2表示搭建了流式灾备关系

默认值:0

agent_backup_open

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

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

  • 0表示未搭建灾备关系。
  • 1表示搭建了obs灾备关系(之后不再支持)。
  • 2表示搭建了流式灾备关系。

默认值:0

disk_timeout

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

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

**默认值:**200

voting_disk_path

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

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

**默认值:**无,需要安装时进行配置。

agent_rhb_interval

**参数说明:**cma节点间网络连通性检测周期。

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

**默认值:**1000

enable_ssl

参数说明:ssl证书开关。

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

  • on、yes、true、1:表示启用ssl。

  • off、no、false、0:表示不启用ssl。

  • 默认值:on

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

ssl_cert_expire_alert_threshold

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

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

默认值:90

ssl_cert_expire_check_interval

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

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

默认值:86400