操作场景
openGauss在运行过程中，数据库管理员可能需要手工对数据库节点做主备切换。例如发现数据库节点主备failover后需要恢复原有的主备角色，或怀疑硬件故障需要手动进行主备切换。
说明：
主备切换为维护操作，确保openGauss状态正常，所有业务结束后，再进行切换操作。
操作步骤
-
以操作系统用户omm登录数据库任意节点，执行如下命令，查看主备情况。
gs_om -t status --detail -
以操作系统用户omm登录准备切换为主节点的备节点，执行如下命令。
gs_ctl switchover -D /home/omm/cluster/dn1//home/omm/cluster/dn1/为备数据库节点的数据目录。
须知：
对于同一集群，上一次主备切换未完成，不能执行下一次切换。对于业务正在操作时，发起switchover，可能主机的线程无法停止导致switchover显示超时，实际后台仍然在运行，等主机线程停止后，switchover即可完成。比如在主机删除一个大的分区表时，可能无法响应switchover发起的信号。 -
switchover成功后，执行如下命令记录当前主备机器信息。
gs_om -t refreshconf
示例
将数据库节点备实例切换为主实例。
1.查询集群状态。
``` gs_om -t status --detail [ Cluster State ]
cluster_state : Normal redistributing : No current_az : AZ_ALL
[ Datanode State ]
node node_ip instance state | node node_ip instance state
1 pekpopgsci00234 10.244.60.70 6001 /home/wuqw/cluster/dn1 P Primary Normal | 2 pekpopgsci00238 10.244.61.81 6002 /home/wuqw/cluster/dn1 S Standby Normal ```
2.登录备节点，进行主备切换。
gs_ctl switchover -D /home/wuqw/cluster/dn1/
[2020-06-17 14:28:01.730][24438][][gs_ctl]: gs_ctl switchover ,datadir is -D "/home/wuqw/cluster/dn1"
[2020-06-17 14:28:01.730][24438][][gs_ctl]: switchover term (1)
[2020-06-17 14:28:01.768][24438][][gs_ctl]: waiting for server to switchover............
[2020-06-17 14:28:11.175][24438][][gs_ctl]: done
[2020-06-17 14:28:11.175][24438][][gs_ctl]: switchover completed (/home/wuqw/cluster/dn1)
3.保存集群主备机器信息。
gs_om -t refreshconf
Generating dynamic configuration file for all nodes.
Successfully generated dynamic configuration file.
错误排查
如果switchover过程中出现失败，请根据日志文件中的日志信息排查错误，参见日志参考。
异常处理
异常判断标准如下：
- 业务压力下，主备实例切换时间长，这种情况不需要处理。
- 其他备机正在build的情况下，主机需要发送日志到备机后，才能降备，导致主备切换时间长。这种情况不需要处理，但应尽量避免build过程中进行主备切换。
-
切换过程中，因网络故障、磁盘满等原因造成主备实例连接断开，出现双主现象时，此时请参考如下步骤修复。
警告：
出现双主状态后，请按如下步骤恢复成正常的主备状态。否则可能会造成数据丢失。 -
执行以下命令查询数据库当前的实例状态。
gs_om -t status --detail若查询结果显示两个实例的状态都为Primary，这种状态为异常状态。
-
确定降为备机的节点，在节点上执行如下命令关闭服务。
gs_ctl stop -D /home/omm/cluster/dn1/ -
执行以下命令，以standby模式启动备节点。
gs_ctl start -D /home/omm/cluster/dn1/ -M standby -
保存集群主备机器信息。
gs_om -t refreshconf -
查看集群状态，确认实例状态恢复。
