本章节适用于MRS 3.x之前版本的集群。MRS 3.x及之后版本，请参考更新客户端（3.x及之后版本）。

MRS集群提供了客户端，可以在连接服务端、查看任务结果或管理数据的场景中使用。用户使用MRS的客户端时，如果在MRS Manager修改了服务配置参数并重启了服务或者重启了服务，需要先下载并更新客户端配置文件。

用户创建集群时，默认在集群所有节点的“/opt/client”目录安装保存了原始客户端。集群创建完成后，仅Master节点的客户端可以直接使用，Core节点客户端在使用前需要更新客户端配置文件。

操作步骤

方法一：所有版本集群均支持使用。

1. 登录MRS Manager页面，具体请参见访问MRS Manager（MRS 2.x及之前版本），然后选择“服务管理”。
2. 单击“下载客户端”。

   “客户端类型”选择“仅配置文件”，“下载路径”选择“服务器端”，单击“确定”开始生成客户端配置文件，文件生成后默认保存在主管理节点“/tmp/MRS-client”。文件保存路径支持自定义。

   图1 下载客户端配置文件
   

3. 查询并登录主Master节点。
4. 若在集群内使用客户端，执行以下命令切换到omm用户，若在集群外使用客户端，请切换到root用户：

   sudo su - omm

5. 执行以下命令切换客户端目录，例如“/opt/Bigdata/client”：

   cd /opt/Bigdata/client

6. 执行以下命令，更新客户端配置：

   sh refreshConfig.sh 客户端安装目录客户端配置文件压缩包完整路径

   例如，执行命令：

   sh refreshConfig.sh /opt/Bigdata/client /tmp/MRS-client/MRS_Services_Client.tar

   界面显示以下信息表示配置刷新更新成功：

   ReFresh components client config is complete.
   Succeed to refresh components client config.

方法二：

1. 集群安装完成之后，执行以下命令切换到omm用户，若在集群外使用客户端，请切换到root用户。

   sudo su - omm

2. 执行以下命令切换客户端目录，例如“/opt/Bigdata/client”。

   cd /opt/Bigdata/client

3. 执行以下命令并按照提示输入MRS Manager有下载权限的用户名和密码（例如，用户名为admin，密码为创建集群时设置的密码），更新客户端配置。

   sh autoRefreshConfig.sh

4. 命令执行后显示如下信息，其中XXX表示集群安装的组件名称，如需更新全部组件配置，单击“Enter”键，如需更新部分组件配置，请输入需要更新的组件名称，多个组件名称以逗号相隔。

   Components "xxx" have been installed in the cluster. Please input the comma-separated names of the components for which you want to update client configurations. If you press Enter without inputting any component name, the client configurations of all components will be updated:

   界面显示以下信息表示配置更新成功：

   Succeed to refresh components client config.

   界面显示以下信息表示用户名或者密码错误：

   login manager failed,Incorrect username or password.

   

   • 该脚本会自动连接到集群并调用refreshConfig.sh脚本下载并刷新客户端配置文件。
   • 客户端默认使用安装目录下文件Version中的“wsom=xxx”所配置的浮动IP刷新客户端配置，如需刷新为其他集群的配置文件，请执行本步骤前修改Version文件中“wsom=xxx”的值为对应集群的浮动IP地址。