更新时间：2026-08-18 GMT+08:00
修改MRS角色实例参数
在MRS集群运行过程中，管理员可能需要调整单个角色实例的配置参数以优化服务性能或适配业务需求。例如，在集群迁移或重新部署相同服务的场景下，管理员可以通过导出和导入实例配置数据，实现配置结果的快速复制。修改角色实例配置参数、导出或导入实例配置时不影响其他实例的正常运行。
对系统的影响
- 修改角色实例配置后，如果实例状态为“配置过期”，则需要重启此实例。重启时对应的实例不可用，请在业务空闲期操作。
- 配置HBase、HDFS、Hive、Spark、Yarn、Mapreduce服务属性后，需要重新下载并更新客户端配置文件。了解如何更新客户端配置，请参考服务端配置过期后更新MRS集群客户端。
前提条件
- 如果通过MRS管理控制台操作，需要已完成IAM用户同步（在集群详情页的“概览”页签，单击“IAM用户同步”右侧的“同步”进行IAM用户同步）。
- 如果通过Manager界面操作，需要已登录MRS集群Manager界面，详情请参考访问MRS集群Manager。
修改角色实例参数
当前支持通过管理控制台修改参数，或通过Manager修改参数。
- 登录MRS管理控制台。
- 单击待操作的集群名称。
- 在集群详情页，单击“组件管理”。
- 单击服务列表中指定的服务名称。
- 单击“实例”页签。
- 单击角色实例列表中指定的角色实例名称。
- 单击“实例配置”页签。
- 将页面右侧“基础配置”切换为“全部配置”，界面上将显示该角色实例的全部配置参数导航树。
- 在导航树选择指定的参数，修改参数值。支持在“搜索”输入参数名直接搜索并显示结果。
修改某个参数的值后需要取消修改，可以单击
恢复。 - 单击“保存配置”，根据界面提示保存配置。
角色实例配置参数修改后，如果实例状态为“配置超期”则需要重启此实例，可在“实例”页面勾选“配置超期”的实例，选择“更多 > 重启实例”。
验证配置修改结果：
- 保存配置后，确认界面提示操作成功。
- 检查实例状态：如果实例状态为“配置过期”，需重启实例使配置生效；如果参数为动态生效类型，确认参数已自动刷新。
- 重启完成后，在实例列表页面确认实例运行状态是否正常。
- 登录MRS集群Manager界面。
登录集群Manager界面请参考访问MRS集群Manager。
- 选择“集群 > 服务”。
MRS 2.x及之前版本，单击“服务管理”。
- 单击指定的服务名称，并选择“实例”页签。
- 单击指定的实例，选择“实例配置”。
默认显示“基础配置”，如果需要修改更多参数，请选择“全部配置”，界面上将显示该实例支持的所有参数分类。
- 在导航树选择指定的参数分类，并在右侧修改参数值。
支持在右上角输入参数名，Manager将实时进行搜索并显示结果。
- 单击“保存”，并在确认对话框中单击“确定”。
MRS 2.x及之前版本，请单击“保存配置”，勾选“重启角色实例”并单击“确定”，重启角色实例。
等待界面提示“操作成功”，单击“完成”，配置已修改。
- 角色实例配置参数修改后，如果实例状态为“配置过期”则需要重启此实例，可在“实例”页面勾选“配置过期”的实例，选择“更多 > 重启实例”。
- 配置参数前包含
图标时，表示该参数为动态生效，保存配置后参数值会自动刷新到配置文件中。（动态生效图标
仅MRS 3.2.0及之后版本支持）
验证配置修改结果：
- 保存配置后，确认界面提示操作成功。
- 检查实例状态：如果实例状态为“配置过期”，需重启实例使配置生效；如果参数为动态生效类型，确认参数已自动刷新。
- 重启完成后，在实例列表页面确认实例运行状态是否正常。
常见问题
- 修改参数后实例状态显示“配置过期”怎么办？
这是正常现象。修改非动态生效的参数后，实例状态会变为“配置过期”，表示需要重启实例才能使新配置生效，请重启该实例。
- 修改参数后如何恢复原值？
在保存配置前，可以单击参数输入框旁的撤销按钮恢复到修改前的值。如果已保存配置，需要手动将参数改回原值并重新保存。
- 哪些参数修改后不需要重启实例？
参数前包含动态生效图标的参数为动态生效参数，保存配置后会自动刷新到配置文件中，无需重启实例。该功能仅MRS 3.2.0及之后版本支持。无动态生效图标的参数修改后需要重启实例才能生效。
相关文档
- 如果需要了解如何导出导入角色实例配置，请参考管理MRS角色实例。
- 如果需要了解如何更新客户端配置文件，请参考服务端配置过期后更新MRS集群客户端。
