# 手动切换集群主备节点
#### 操作场景
集群实例由dds mongos（路由）、Config（配置）和Shard（分片）组件构成，其中Config和Shard分别由主节点、备节点和隐藏节点组成。主节点和备节点不对外提供访问地址，隐藏节点用于备份数据。当主节点故障时，系统会自动分配新的主节点保障高可用。同时，文档数据库服务提供主备切换功能，供用户在容灾演练等场景下自行切换主备节点。
#### 使用须知
- 实例状态为正常或异常、恢复检查中、转包周期中、修改安全组中、高负载时，允许切换主备节点。
- 主备节点切换可能会造成1分钟的服务闪断，切换前请确认客户端具备重连机制。
- 主备同步的延迟时间过长时，主备切换耗时可能很久。因此，当主备同步的延迟时间超过300s时，控制台将不允许下发主备切换。关于副本集主备同步的延迟时间，请参见[副本集中主备同步存在多长时间的延迟](https://support.huaweicloud.com/dds_faq/dds_faq_0006.html)。
 
#### 操作步骤
- [切换Config主备节点]
  1. [登录管理控制台](https://console.huaweicloud.com)。
  
  2. 单击管理控制台左上方的![](https://support.huaweicloud.com/usermanual-dds/zh-cn_image_0000001533899028.png)，选择区域和项目。
  
  3. 在页面左上角单击![](https://support.huaweicloud.com/usermanual-dds/zh-cn_image_0000001534218688.png)，选择"数据库 \> 文档数据库服务 DDS"，进入文档数据库服务信息页面。
  
  4. 在"实例管理"页面，选择指定的集群实例，单击实例名称。
  
  5. 在"基本信息"页面"节点信息"区域，选择"config"页签，单击操作列的"主备切换"。 
     图1主备切换   
     ![](https://support.huaweicloud.com/usermanual-dds/zh-cn_image_0000002337823341.png "点击放大")
     
     
  
  6. 在弹出框中单击"是"，开始执行主备切换。 
     图2执行config主备切换   
     ![](https://support.huaweicloud.com/usermanual-dds/zh-cn_image_0000002337943133.png "点击放大")
     
     
  
  7. 查看切换结果。 
     - 主备切换过程中，实例运行状态显示为"主备切换中"，切换完成后，实例状态显示为"正常"。
     
     - 在实例"基本信息"页面的"节点信息"区域，可查看切换后的主备节点。
     
     - 切换完成后，原先的主节点会变为备节点，如果需要重新连接集群主节点，请参见[连接实例](https://support.huaweicloud.com/usermanual-dds/dds_03_0308.html)。
     
     
     
     
   
- [切换Shard主备节点]
  1. [登录管理控制台](https://console.huaweicloud.com)。
  
  2. 单击管理控制台左上方的![](https://support.huaweicloud.com/usermanual-dds/zh-cn_image_0000001533899028.png)，选择区域和项目。
  
  3. 在页面左上角单击![](https://support.huaweicloud.com/usermanual-dds/zh-cn_image_0000001534218688.png)，选择"数据库 \> 文档数据库服务 DDS"，进入文档数据库服务信息页面。
  
  4. 在"实例管理"页面，选择指定的集群实例，单击实例名称。
  
  5. 在"基本信息"页面"节点信息"区域，选择"shard"页签，在"操作"列单击"更多 \> 主备切换"。 
     图3Shard主备切换   
     ![](https://support.huaweicloud.com/usermanual-dds/zh-cn_image_0000002337823353.png "点击放大")
     
     
  
  6. 在弹出框中单击"是"，开始执行主备切换。 
     图4执行Shard主备切换   
     ![](https://support.huaweicloud.com/usermanual-dds/zh-cn_image_0000002337943201.png "点击放大")
     
     
  
  7. 查看切换结果。 
     - 主备切换过程中，实例运行状态显示为"主备切换中"，切换完成后，实例状态显示为"正常"。
     
     - 在实例"基本信息"页面的"节点信息"区域，可查看切换后的主备节点。
     
     - 切换完成后，原先的主节点会变为备节点，如果需要重新连接集群主节点，请参见[连接实例](https://support.huaweicloud.com/usermanual-dds/dds_03_0314.html)。
     
     
     
     
   
- [备节点强制升主]
  1. [登录管理控制台](https://console.huaweicloud.com)。
  
  2. 单击管理控制台左上方的![](https://support.huaweicloud.com/usermanual-dds/zh-cn_image_0000001533899028.png)，选择区域和项目。
  
  3. 在页面左上角单击![](https://support.huaweicloud.com/usermanual-dds/zh-cn_image_0000001534218688.png)，选择"数据库 \> 文档数据库服务 DDS"，进入文档数据库服务信息页面。
  
  4. 在"实例管理"页面，选择指定的集群实例，单击实例名称。
  
  5. 在"基本信息"页面"节点信息"区域，选择"config"或者"shard"页签，选择角色为Secondary的节点，单击"强制升主"。 
     图5强制升主   
     ![](https://support.huaweicloud.com/usermanual-dds/zh-cn_image_0000002337823417.png "点击放大")
     
     
  
  6. 在弹出框中单击"是"，开始执行强制升主。 
     图6执行强制升主   
     ![](https://support.huaweicloud.com/usermanual-dds/zh-cn_image_0000002337943209.png "点击放大")
     
     
  
  7. 查看强制升主结果。 
     - 在实例"基本信息"页面的"节点信息"区域，可查看操作后的主备节点。
     
     
     
     
   
#### 相关API
| API                                                                    | 说明                  |
|:---|:---|
| [切换实例的主备节点](https://support.huaweicloud.com/api-dds/dds_api_0050.html) | 切换副本集实例和集群实例下的主备节点。 |