同步MRS集群配置
在MRS集群运维中，管理员修改服务配置参数后，相关服务的“配置状态”会变为“配置过期”，表示这些服务本地的配置参数值尚未与服务端同步生效。当某个配置需要同时下发到集群所有服务，或修改某项配置导致多个不同服务的配置状态为“配置过期”或“失败”时，管理员需要对集群执行同步配置操作，将最新的配置参数下发到所有相关服务，并重启配置过期的服务实例，使新配置正式生效。本文介绍如何通过MRS管理控制台或Manager界面同步集群配置。
前提条件
- 如果通过MRS管理控制台操作，需要已完成IAM用户同步（在集群详情页的“概览”页签，单击“IAM用户同步”右侧的“同步”进行IAM用户同步）。
- 如果通过Manager界面操作，需要已登录MRS集群Manager界面，详情请参考访问MRS集群Manager。
对系统的影响
- 集群执行同步配置后，需要重启配置过期的服务，重启时对应的服务不可用。
- 重启配置过期的实例时，该实例不可用。
同步集群配置
当前支持通过管理控制台同步配置，或通过Manager同步配置。
本操作适用于MRS 2.x及之前版本。
- 登录MRS管理控制台。
- 选择“现有集群”，选中一个待操作的运行中的集群并单击集群名称，进入集群概览信息页面。
- 单击页面右上角“配置 > 同步配置”。 图1 同步配置（以MRS 1.9.2版本为例）
- 在弹出窗口勾选“重启配置过期的服务或实例。”，并单击“确定”，重启配置过期的服务。
界面提示“操作成功”，单击“完成”，集群成功启动。
验证操作：
同步配置并重启完成后，在集群概览页面查看各服务的配置状态。若所有服务的配置状态显示正常，则表示同步配置成功完成。
- 登录MRS集群Manager界面。
登录集群Manager界面请参考访问MRS集群Manager。
- 选择“集群 > 概览”。
- MRS 3.3.0及之后版本的Manager界面中，“集群 > 概览”页面已移除，可直接在“主页”界面的“更多”菜单中执行集群相关维护管理功能。
- MRS 2.x及之前版本集群，单击“服务管理”，选择“更多 > 同步配置”进行操作。
- 选择。
- 在弹出窗口中单击“确定”，开始为当前集群同步配置。
- 在集群概览页面选择。
- 在弹出窗口中输入当前登录的用户密码确认身份，然后单击“确定”。
- 在确认重启实例的对话框中单击“确定”。
支持单击“查看实例”打开所有配置已过期的实例列表，确认可以执行重启任务。
验证操作：
同步配置并重启完成后，在Manager的“集群 > 服务”页面查看各服务的“配置状态”。若所有服务的配置状态显示为“已同步”，则表示同步配置成功完成。
常见问题
- 同步配置失败
同步配置失败的常见原因包括：集群中部分服务实例状态异常导致配置无法下发、网络不通导致Manager与实例节点通信失败、或部分节点磁盘空间不足无法写入新配置文件。
请先在Manager的服务页面查看各服务状态，修复状态异常的服务实例。检查集群网络连通性和节点磁盘空间。排除故障后重新执行同步配置操作。
- 重启配置过期的实例后服务状态异常
重启后服务状态异常的常见原因包括：新修改的配置参数值不合法导致服务启动失败、或参数之间存在依赖关系但未同时修改。
请在Manager的“集群 > 服务”页面查看异常服务的告警信息，根据告警提示定位具体参数问题。修正配置参数后重新执行同步配置和重启操作。
- 同步配置后服务配置状态仍显示“配置过期”
同步配置操作仅将配置参数下发到服务实例的本地配置文件，但未触发重启。配置状态显示“配置过期”表示配置已同步但尚未重启生效。
这是正常现象。请在同步配置后重启配置过期的实例，重启完成后配置状态将更新为“已同步”。
相关文档
- 了解如何修改MRS角色实例参数，请参考修改MRS角色实例参数。
- 了解如何修改OMS服务配置，请参考修改OMS服务配置。
- 了解如何查看MRS集群告警，请参考查看MRS集群告警。
