# 启停MRS集群节点上所有角色
MRS集群节点角色启停功能适用于需要对集群节点进行维护或故障处理的MRS集群管理员和运维工程师。
在MRS集群日常运维中，节点可能因硬件老化、磁盘故障、操作系统补丁升级等原因需要临时下线维护。此时需要先停止该节点上运行的所有角色实例，确保服务进程安全退出后再执行维护操作；维护完成后，再启动所有角色实例恢复该节点的业务服务。
- **节点故障维护**：当主机出现硬件异常、磁盘故障或系统问题时，停止该节点上所有角色后进行维护修复，修复完成后重新启动角色恢复业务。
- **滚动升级维护**：在集群配置变更时，逐节点停止角色执行维护操作，避免全集群业务中断。
- **资源临时释放** ：在业务低谷期临时停止部分节点角色以节省资源，业务高峰前重新启动。
  ![](https://support.huaweicloud.com/usermanual-mrs/public_sys-resources/note_3.0-zh-cn.png)
  停止节点上所有角色将导致该节点上的所有服务进程中断，正在运行的任务可能失败。请确保已评估业务影响，并在业务空闲期执行操作。停止角色前建议先检查该节点上是否有正在运行的关键任务，必要时进行任务迁移。
  
#### 前提条件
- 如果通过MRS管理控制台操作，需要**已完成IAM用户同步** （在集群详情页的"概览"页签，单击"IAM用户同步"右侧的"同步"进行IAM用户同步）**。**
- 如果通过Manager界面操作，需要已登录MRS集群Manager界面，详情请参考[访问MRS集群Manager](https://support.huaweicloud.com/usermanual-mrs/mrs_01_0128.html)。
- 停止角色前，建议通过Manager查看该节点上正在运行的角色实例和任务状态，评估停止操作对业务的影响。
- 对于主备部署的角色（如NameNode、ResourceManager），如果该节点运行的是主实例，建议先执行主备倒换，再停止角色，避免服务中断。
 
#### 启停角色
当前支持通过管理控制台启停角色，或通过Manager启停角色。
- [通过管理控制台启停角色]
  1. 登录[MRS管理控制台](https://console.huaweicloud.com/mrs/)。
  
  2. 选择"现有集群"，选中一个待操作的运行中的集群并单击集群名称，进入集群概览信息页面。
  
  3. 在集群详情页，单击"节点管理"。
  
  4. 展开节点组信息，勾选待操作节点前的复选框。
  
  5. 选择"节点操作 \> 启动所有角色"或"停止所有角色"执行相应操作。
   
- [通过Manager启停角色]
  1. 登录MRS集群Manager界面。 
     登录集群Manager界面请参考[访问MRS集群Manager](https://support.huaweicloud.com/usermanual-mrs/mrs_01_0128.html)。
     
     
  
  2. 单击"主机"，进入主机列表界面。 
     MRS 2.x及之前版本集群，请单击"主机管理"。
     
     
  
  3. 勾选待操作主机前的复选框。
  
  4. 在"更多"选择"启动所有实例"或"停止所有实例"执行相应操作。 
     在弹出的确认对话框中，验证当前用户密码确认身份后，单击"确定"。
     执行启停操作后，可通过以下方式验证：
     1. 在Manager界面单击"主机"，单击目标主机名称，进入主机详情页。
     
     2. 在"进程"页签查看各角色实例的运行状态。
     
     
     
     
   
#### 常见问题
**Q：停止角色后，该节点上正在运行的任务会怎样？**
A：停止角色后，该节点上正在运行的Container和进程将被终止。YARN任务（如MapReduce、Spark作业）会在其他健康节点上重新调度失败的任务（前提是任务支持重试且重试次数未耗尽）。HBase RegionServer上的Region将被自动迁移到其他节点，期间相关数据的读写可能出现短暂延迟。建议在停止角色前，通过YARN ResourceManager查看该节点上正在运行的任务，必要时先停止任务。
**Q：启动所有角色后，部分角色启动失败怎么办？**
A：可在Manager主机详情页的实例列表区查看失败角色实例的日志。常见原因包括：磁盘空间不足、端口被占用、配置文件错误、依赖角色未就绪等。解决底层问题后，在实例列表中单击失败实例后的启动按钮，单独启动该角色实例。
**Q：停止角色后可以直接关机或重启主机吗？**
A：可以。停止所有角色并确认实例状态均为已停止后，即可安全关机或重启主机。不建议在角色运行状态下直接关机，可能导致数据损坏或服务异常。
**Q：停止角色和隔离节点有什么区别？**
A：停止角色仅终止该节点上的服务进程，节点仍处于集群管理中，恢复启动后即可正常使用。隔离节点是在停止角色的基础上，将节点从集群调度中移除，防止新任务分配到该节点。如需长时间维护，建议先停止角色再隔离节点。
#### 相关文档
- 了解如何查看节点健康状态和资源使用情况，请参考[查看MRS集群节点运行状态](https://support.huaweicloud.com/usermanual-mrs/mrs_01_300120.html)。
- 如果需要在停止角色后进一步隔离节点以防止新任务调度，请参考[隔离MRS集群节点](https://support.huaweicloud.com/usermanual-mrs/mrs_01_0212.html)。
- 如果停止的节点上运行有主实例角色，请参考[执行MRS角色实例主备倒换](https://support.huaweicloud.com/usermanual-mrs/mrs_01_300014.html)先执行主备倒换。
- 如果需要了解MRS集群各组件的部署架构和角色说明，请参考[MRS集群部署方案说明](https://support.huaweicloud.com/usermanual-mrs/mrs_01_0121.html)。
- 了解如何登录MRS集群Manager界面，请参考访问MRS集群Manage[访问MRS集群Manager](https://support.huaweicloud.com/usermanual-mrs/mrs_01_0128.html)。
- 如果启动角色后实例状态异常，请参考[查看MRS集群组件监控指标](https://support.huaweicloud.com/usermanual-mrs/mrs_01_0517.html)查看组件运行状态和日志。