集群主CM发生故障，备CM会自动升为主，待故障CM恢复正常后，可以手工执行主备切换，使CM切回到原来的主机上。在其他场景，如有需要也可以通过命令行手动切换CM。
背景信息
部署集群时，建议用户将CM Server主和备实例分散部署在其他多个主机上。如表1所示。
主机 | AZ | CN | CM | ETCD | DN |
|---|---|---|---|---|---|
plat1 | AZ1 | CN 1 | CM备 | ETCD1 | DN1备 |
plat2 | AZ1 | CN 2 | CM主 | ETCD2 | DN2备 |
plat3 | AZ1 | - | - | ETCD3 | DN1主 |
plat4 | AZ1 | - | - | - | DN2主 |
如果主机plat2中CM Server主实例发生故障，则主机plat1中CM Server备实例会自动升主。待plat2的CM Server实例恢复正常后，可以手动切换回plat2的CM Server实例。
前提条件
集群已经启动，实例的主备关系正常。
操作步骤
- 以omm用户身份登录GaussDB 100所在的任意服务器。
- 在集群的任意一台主机上执行如下命令，切换主CM到备CM。
gs_om -t switch -h plat1 -I CM1plat1为当前备CM所在的主机名称。
CM1为plat1主机上的CM实例名称。
对于同一对实例，上一次主备切换未完成，不能执行下一次切换。
示例
omm@plat1:~> gs_om -t switch -h plat1 -I CM1
Switching instances.
Successfully switched cluster.
错误排查
如果集群组件切换失败，请根据日志文件中的日志信息排查错误，参见管理日志。
