# 执行MRS角色实例主备倒换
MRS角色实例主备倒换功能适用于需要对主备部署的角色实例执行主备切换的MRS集群管理员和运维工程师。
典型业务场景包括：
- **主节点故障切换**：主实例节点资源负载过高或软件进程异常时，手动触发主备倒换，将服务切换到备节点恢复业务。
- **计划性维护**：需要对主节点执行维护操作（如系统升级、硬件更换）前，先执行主备倒换将服务切换到备节点，实现不停机维护。
- **故障演练**：通过手动执行主备倒换验证集群高可用性，确保故障场景下业务能正常切换。
在MRS集群系统中，主备倒换（主实例节点与备实例节点的切换）是保障组件高可用性和数据可靠性的关键机制。
对于MRS集群中主备部署的角色实例（例如HDFS组件的NameNode实例），当主实例节点发生故障无法提供服务时，系统会自动触发主备倒换，备实例节点自动升为主实例。
MRS集群中支持主备部署的角色实例可参考[MRS集群部署方案说明](https://support.huaweicloud.com/usermanual-mrs/mrs_01_0121.html)。
#### 基本概念
- **主备部署**：MRS集群中对关键组件（如HDFS NameNode、YARN ResourceManager、HBase HMaster等）采用的高可用部署模式，同时运行一个主实例和一个或多个备实例，主实例对外提供服务，备实例实时同步主实例数据并待命。
- **主备倒换（Failover）**：将主实例与备实例的角色进行切换的操作。倒换后，原备实例升为主实例对外提供服务，原主实例降为备实例进入待命状态。
![](https://support.huaweicloud.com/usermanual-mrs/public_sys-resources/note_3.0-zh-cn.png)
主备倒换期间，对应组件的服务可能会短暂影响正在进行的读写操作，建议在业务空闲期或确认业务可容忍短暂中断后执行操作。倒换前请确认备实例状态正常，否则倒换后服务可能无法正常恢复。
#### 执行角色实例主备倒换
1. 登录MRS集群Manager界面。 
   登录集群Manager界面请参考[访问MRS集群Manager](https://support.huaweicloud.com/usermanual-mrs/mrs_01_0128.html)。
   
   
2. 选择"集群 \> 服务"。 
   MRS 2.x及之前版本，请单击"服务管理"。不同版本参数略有差别，请以环境实际显示为准。
   
   
3. 单击待执行主备倒换角色实例所在组件的名称（例如"HDFS"）。 
   在"实例"页签界面中，可查看当前角色实例的主备状态。
   图1查看角色实例主备状态   
   ![](https://support.huaweicloud.com/usermanual-mrs/zh-cn_image_0000002303029208.png "点击放大")
   
   
4. 在服务概览详情页面单击"更多"，单击"执行*角色实例* 倒换"。
   
   例如单击HDFS的"更多 \> 执行NameNode倒换"。
   
   
5. 验证当前登录的用户密码确认身份，单击"确定"。 
   在弹出界面确认操作影响后单击"确定"，执行角色实例主备倒换。
   HDFS的角色NameNode在进行主备倒换时，需要指定NameService。
   **验证主备倒换结果：**
   等待角色实例主备倒换成功后，单击"实例"，可查看到原主实例节点降为了备实例，原备实例升为了主实例，且实例"运行状态"均为"良好"。
   
   
 
#### 常见问题
**Q：主备倒换后服务不可用怎么办？**
A：请按以下步骤排查：
1. 在Manager实例页面检查新主实例的运行状态是否为良好。
2. 查看新主实例日志，排查启动失败原因（如数据同步不完整、端口冲突等）。
3. 如果新主实例无法正常工作，可尝试再次执行主备倒换切回原主实例。
**Q：备实例状态不是"良好"时可以执行主备倒换吗？**
A：不建议。备实例状态异常时执行倒换，可能导致倒换后服务无法正常恢复。请先排查备实例异常原因并恢复后再执行倒换。
**Q：主备倒换会丢失数据吗？**
A：正常情况下不会丢失数据。主备实例通过实时同步保持数据一致，倒换后新主实例拥有完整数据。但如果主实例在数据同步完成前发生故障（如非正常退出），可能存在少量未同步的数据丢失。
**Q：哪些组件支持主备倒换？**
A：支持主备部署的组件均可执行主备倒换，具体支持主备部署的角色实例可参考[MRS集群部署方案说明](https://support.huaweicloud.com/usermanual-mrs/mrs_01_0121.html)。