功能介绍

• cm ctl query命令用于查询集群状态、集群中各实例的状态。
• cm ctl reload命令用于重新加载集群配置，在需要改变集群成员等场景下使用。
  

  cm ctl reload命令导入的新的配置文件不需要包含全部的配置信息，但是需要将所有的修改信息呈现在新json中。

  在新json中需要注意以下几点：

  • GlobalConfig参数必须要有，且里面的参数值要和系统中现存的值完全一致。
  • 若要删除某个实例，需要在新json中将该实例字段中的内容置为空。若删除的实例是数据库，需要在新json中将该实例所在的group中删除该实例。
  • 若要删除的某一节点，要保证该节点中没有正常工作的主数据库，将该节点的“IP”字段设为“REMOVE”，将节点中数据库从所在的Group中删掉。
    新json的示例文件如下所示，该示例是删除Euler3服务器中的一个数据库实例，该实例属于GROUP2。

    "GlobalConfig": {
            "BuildAfterStartFailed": 1,
            "BuildCommandTimeout": 1800,
            "CMLogLevel": "debug",
            "CMVersion": 1,
            "CheckAZTimeout": 20,
            "CheckCommandTimeout": 10,
            "CheckInterval": 6,
            "CommandRetryCount": 3,
            "CommandRetryInterval": 5,
            "CommonCommandTimeout": 60,
            "DBGroupLSNGap": 10,
            "HostStatusTTL": 15,
            "InstanceRestartCount": 25,
            "KillETCDInstance": 1
        },
        "Layouts": [
            {
                "AZName": "AZ1",
                "Hosts": {
                        "Euler3": {
                        "IP": "10.185.181.229",
                        "Instances": {
                        }
                    }
                }
            }
        ],
        "Groups": {
            "GROUP2": {
                "GroupType": "gaussdbV1R3",
                "Instances": {
                    "AZ1/Euler4/DB4_2": {
                        "ParentNode": "",
                        "Role": "primary"
                    },
                    "AZ2/Euler10/DB10_2":{
                        "ParentNode":"AZ1/Euler4/DB4_2",
                        "Role":"standby"
                    }
                }
            }
        }
    }

• cm ctl start命令用于启动集群服务，启动单个服务器上除etcd之外的所有实例或单独启动某个实例进程。
• cm ctl stop命令用户停止集群服务，停止单个服务器上除etcd之外的所有实例或单独停止某个实例进程。
• cm ctl switchover命令用于主备倒换，将指定备数据库转换为主数据库。
• cm ctl updateCNSwitchCmd命令用于指定主备倒换后，是否更新CN访问DN的路由系统表。
• cm ctl build命令用于重建DN备。
• cm ctl list命令用于列出CM模块内部使用的所有全局变量，该值可以由cm ctl set -p xxx -v xxx命令修改，重启集群后生效。
• cm ctl set命令用于设置集群的一些全局参数，例如探测时间CheckInterval、CommandRetryCount、CheckAZTimeOut、KillETCDInstance、CN故障隔离CoordinatorHearbeatTimeout等。
• cm ctl querySubhealth用于查询集群各节点某个时刻CPU使用率、内存使用率、磁盘IO使用率、网络延迟、磁盘占用量的当前值，用于CM内部调试。

命令参考

• 查询集群状态。

  cm ctl query -e $ETCD_ADDRESS [-l logLevel] [-L logfile]

  重新加载配置参数。

• cm ctl reload -r reloadfile -e $ETCD_ADDRESS [-l logLevel] [-L logfile]

  启动实例。

• cm ctl start -e $ETCD_ADDRESS  [-H hostName] [-I instanceName] [-l logLevel] [-L logfile]

  重建备DN。

• cm ctl build -e $ETCD_ADDRESS [-H hostName] [-I instanceName] [-l logLevel] [-L logfile]

  停止实例。

• cm ctl stop [-f] -e $ETCD_ADDRESS [-H hostName] [-I instanceName] [-l logLevel] [-L logfile]

  数据库主备倒换。

• cm ctl switchover  -e $ETCD_ADDRESS [-H hostName] [-I instanceName] [-l logLevel] [-L logfile]

  设置参数

• cm ctl set -p param_name -v param_value

  更新主备倒换后CN访问DN的路由系统表。

• cm ctl updateCNSwitchCmd updateNodeRoute=OFF -e $ETCD_ADDRESS

  CN故障隔离恢复后，恢复集群中的故障CN的状态。

cm ctl参数分为：

• 常用参数，详细请参见表1。
• 全局参数，详细请参见表2
• 集群常用全局参数，详细请参见表3
• updateCNSwitchCmd参数，详细请参见表4

• CM agent每天零点（即00:00:00）检查一次ETCD证书是否过期。如果超过CredentialsExpireAlarmTime参数设置的阀值，则上报告警，DM侧获取到该告警之后触发告警，用户获取到该告警后根据实际情况手动更新ETCD证书。
• 触发告警后，会生成对应日志
  • 在$GAUSSLOG/alarm/CM/alarm.log日志中上报如下告警信息供DM解析。

    2024-08-11 00:00:00|1103040013|EtcdCredentialsExpired|ETCD|ETCD|ETCD,ETCD,host_156_127,10.171.156.127|1

    在$GAUSSLOG/cm/cm_agent/agent.log日志中生成一条如下用于定位的告警日志。

  • time="2024-07-19T00:00:00+08:00" level=warning msg="[CheckEtcdCredentialsExpireTime] the ETCD credentials will be expired after (29) days.

    用户可使用如下命令修改CredentialsExpireAlarmTime参数的值，重启集群生效。

• cm ctl set -p CredentialsExpireAlarmTime -v param_value