VastbaseG100

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

Menu

has_server参数

列出所有HAS参数:

has_ctl list --param [--agent | --server]

log_dir

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

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

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

log_file_size

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

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

默认值: 16MB

log_min_messages

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

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

默认值: warning

thread_count

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

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

默认值: 1000

instance_heartbeat_timeout

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

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

默认值: 6

instance_failover_delay_timeout

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

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

默认值: 0

cmserver_ha_connect_timeout

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

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

默认值: 2

cmserver_ha_heartbeat_timeout

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

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

默认值: 6

cmserver_ha_status_interval

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

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

默认值: 1

cmserver_self_vote_timeout

参数说明: has_server之间相互投票的超时时间。旧版本遗留参数,实际不生效。

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

默认值: 6

phony_dead_effective_time

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

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

默认值: 5

cm_server_arbitrate_delay_base_time_out

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

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

默认值: 10

cm_server_arbitrate_delay_incrememtal_time_out

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

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

默认值: 3

alarm_component

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

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

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

alarm_report_interval

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

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

默认值: 3

alarm_report_max_count

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

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

默认值: 1

instance_keep_heartbeat_timeout

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

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

默认值: 40

az_switchover_threshold

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

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

默认值: 100

az_check_and_arbitrate_interval

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

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

默认值: 2

az_connect_check_interval

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

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

默认值: 60

az_connect_check_delay_time

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

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

默认值: 150

cmserver_demote_delay_on_etcd_fault

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

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

默认值: 8

instance_phony_dead_restart_interval

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

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

默认值: 21600

enable_transaction_read_only

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

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

默认值: on

datastorage_threshold_check_interval

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

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

默认值: 10

datastorage_threshold_value_check

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

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

默认值: 85

max_datastorage_threshold_check

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

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

默认值: 43200

enable_az_auto_switchover

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

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

默认值: 1

cm_auth_method

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

取值范围: 枚举类型,有效值有trust, gss。修改后需要重启has_server才能生效。参数修改请参考表11进行设置。

默认值: trust

cm_krb_server_keyfile

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

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

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

switch_rto

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

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

默认值: 600

force_promote

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

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

默认值: 0

backup_open

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

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

  • 0表示关闭(默认值)。

  • 1表示开启。

enable_dcf

参数说明: DCF模式开关。

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

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

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

默认值: off

ddb_type

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

取值范围: 整型。0:ETCD;1:DCC;2:share disk。修改后需要重启has_server才能生效。参数修改请参考表11进行设置。

默认值: 1

Vastbase只支持DCC或者share disk模式。

enable_ssl

参数说明: ssl证书开关。

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

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

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

默认值: on

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

ssl_cert_expire_alert_threshold

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

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

默认值: 90

ssl_cert_expire_check_interval

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

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

默认值: 86400

delay_arbitrate_timeout

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

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

默认值: 0

delay_arbitrate_max_cluster_timeout

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

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

默认值: 300

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生效,参数修改请参考表11进行设置。

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

ddb_log_backup_file_count

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

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

默认值: 10

ddb_max_log_file_size

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

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

默认值: 10M

ddb_log_suppress_enable

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

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

默认值: 1

ddb_election_timeout

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

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

默认值: 3

enable_e2e_rto

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

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

默认值: 0

share_disk_path

参数说明: 共享盘路径。

取值范围: 字符串,最大长度为1024。修改后需要重启has_server才能生效。

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

voting_disk_path

参数说明: 投票盘路径。

取值范围: 字符串,最大长度为1024。修改后需要重启has_server才能生效。

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

disk_timeout

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

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

默认值: 200

agent_network_timeout

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

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

默认值: 6

dn_arbitrate_mode

参数说明: dn仲裁模式。

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

  • quorum

  • paxos

  • share_disk

默认值: quorum

agent_fault_timeout

参数说明: 控制的DN主机异常时,HAS自动kill数据库实例进程的时间。

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

默认值: 60

third_party_gateway_ip

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

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

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

cms_enable_failover_on2nodes

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

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

  • on、yes、true、1:表示允许HAS集群自身自动故障切换。

  • off、no、false、0:表示禁止HAS集群自身自动故障切换。

默认值: false

cms_enable_db_crash_recovery

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

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

  • on、yes、true、1:表示允许DN集群脑裂自动故障恢复。

  • off、no、false、0:表示禁止DN集群脑裂自动故障恢复。

默认值: false

cms_network_isolation_timeout

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

取值范围: 整型,单位:次。修改后需要重启has_server才能生效。

默认值: 20