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