服务端配置过期后更新MRS集群客户端

更新客户端配置（3.x及之后版本）

方法一：

1. 访问MRS集群Manager，选择“集群 > 概览 > 更多 > 下载客户端”（MRS 3.3.0及之后版本在“主页”选择“下载客户端”）。
2. 选择“更多 > 下载客户端 > 仅配置文件”。

   此时生成的压缩文件包含所有服务的配置文件。

   图1 下载客户端配置文件
   

3. 配置相关参数。

   MRS 3.3.1之前版本：

   是否在集群的节点中生成配置文件？

   • 是，勾选“仅保存到如下路径”，单击“确定”开始生成客户端文件，文件生成后默认保存在主管理节点“/tmp/FusionInsight-Client”。支持自定义其他目录且omm用户拥有目录的读、写与执行权限。然后执行4。
   • 否，单击“确定”指定本地的保存位置，开始下载完整客户端，等待下载完成，然后执行4。
   MRS 3.3.1及之后版本：

   1. 根据实际情况配置“选择下载位置”参数。
      • 服务器端：下载到当前集群的主OMS节点上。
      • 浏览器：下载到本地电脑。
      • 远端节点：下载到主OMS节点外的其他节点上。
   2. 根据界面提示配置“保存到如下路径”参数。如果下载位置选择“浏览器”则无需配置该参数。
   3. 如果选择下载到“远端节点”还需参考表1进行配置。

      表1 下载到远端节点配置参数

      参数名称	样例	参数说明
      主机IP	x.x.x.x	远端节点的IP地址。 说明： 远端节点的平台类型需要与所下载客户端的平台类型一致，否则可能导致安装客户端失败。
      主机端口	22	远端节点的主机端口。
      登录用户名称	xxx	登录远端节点的用户名称。 远端节点用户需要对下载路径具有写权限。
      登录方式	密码	登录方式： 密码：使用密码登录。 SSH私钥：使用SSH私钥登录。 免密：选择该方式，用户需要具有免密登录节点的功能。
      登录用户密码	xxx	“登录方式”选择“密码”时，需要配置该参数。 配置为登录用户的密码。
      SSH私钥	-	“登录方式”选择“SSH私钥”时，需要配置该参数。 单击“添加文件”选择SSH私钥文件并上传。
      自动部署到节点	是	是否自动部署到节点。客户端类型选择“完整客户端”时，支持配置该参数。 是，客户端会自动在当前节点上安装部署。 否，客户端不会自动安装部署。需要在客户端下载成功后手动进行安装。
      客户端部署路径	/opt/testclient	“自动部署到节点”选择“是”时，需要配置该参数。如果仅下载配置文件，则无该参数。 远端节点上部署路径若已存在，该路径下不能包含任何文件。若不存在，该路径会被创建。登录远端节点用户需要对该路径具有执行和写权限。

4. 使用WinSCP工具，以客户端安装用户将压缩文件保存到客户端安装的目录，例如“/opt/hadoopclient”。
5. 解压软件包。

   例如下载的客户端文件为“FusionInsight_Cluster_1_Services_Client.tar”执行如下命令进入客户端所在目录，解压文件到本地目录。

   cd /opt/hadoopclient

   tar -xvf FusionInsight_Cluster_1_Services_Client.tar

6. 校验软件包。

   执行sha256sum命令校验解压得到的文件，检查回显信息与sha256文件里面的内容是否一致，例如：

   sha256sum -c FusionInsight_Cluster_1_Services_ClientConfig_ConfigFiles.tar.sha256

   FusionInsight_Cluster_1_Services_ClientConfig_ConfigFiles.tar: OK     

7. 解压获取配置文件。

   tar -xvf FusionInsight_Cluster_1_Services_ClientConfig_ConfigFiles.tar

8. 在客户端安装目录下执行如下命令，使用配置文件更新客户端。

   sh refreshConfig.sh 客户端安装目录 配置文件所在目录

   例如，执行以下命令：

   sh refreshConfig.sh /opt/hadoopclient /opt/hadoopclient/FusionInsight_Cluster_1_Services_ClientConfig_ConfigFiles

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

   Succeed to refresh components client config.

方法二：

1. 以root用户登录客户端安装节点。
2. 进入客户端安装的目录，例如“/opt/hadoopclient”，执行以下命令更新配置文件：

   cd /opt/hadoopclient

   sh autoRefreshConfig.sh

3. 按照提示输入FusionInsight Manager管理员用户名，密码以及OMS浮动IP地址。
   

   OMS浮动IP地址获取方式：远程登录Master2节点，执行“ifconfig”命令，系统回显中“eth0:wsom”表示OMS浮动IP地址，请记录“inet”的实际参数值。如果在Master2节点无法查询到OMS浮动IP地址，请切换到Master1节点查询并记录。如果只有一个Master节点时，直接在该Master节点查询并记录。

4. 输入需要更新配置的组件名，组件名之间使用“,”分隔。如需更新所有组件配置，可直接单击回车键。

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

   Succeed to refresh components client config.

方法三：（仅适用于MRS 3.3.1及之后版本）

1. 登录FusionInsight Manager。
2. 选择“集群 > 客户端管理”，在客户端管理界面查看是否存在待操作的客户端。
   • 是，执行3。
   • 否，单击“添加”，根据界面提示配置待添加客户端的相关信息，单击“确定”。然后执行3。

3. 在待更新的客户端后的“操作”列单击“更新”。

   如果需要批量更新客户端，请勾选待更新的客户端（客户端的安装“用户”必须相同）后，选择“更多 > 批量更新”。

4. 确认并勾选操作影响，配置表2信息后，单击“确定”进行更新。
   

   更新客户端配置期间，客户端不能正常对外提供服务，可能导致使用客户端的业务中断。

   表2 更新客户端参数配置

   参数名称	取值样例	描述
   登录方式	密码	登录方式： 密码：使用密码登录。 SSH私钥：使用SSH私钥登录。 免密：选择该方式，用户需要具有免密登录节点的功能。
   密码/SSH私钥	xxx	“登录方式”选择“密码”时，需要配置用户密码。 “登录方式”选择“SSH私钥”时，需要配置“SSH私钥”参数。单击“添加文件”选择SSH私钥文件并上传。
   主机端口	22	待更新客户端安装节点的主机端口。
   安装包保存路径	/tmp/FusionInsight-Client/	更新后客户端安装包保存路径。 安装包保存到所选节点对应路径，如果存在客户端文件，会覆盖路径下已有的客户端文件。登录远端节点用户需要对该路径具有写权限。

更新客户端配置（2.x及之前版本）

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

1. 登录MRS Manager页面，选择“服务管理”。
2. 单击“下载客户端”。

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

   图2 下载客户端配置文件
   

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

   sudo su - omm

5. 执行以下命令切换客户端目录。

   cd {客户端安装目录}

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. 执行以下命令切换客户端目录。

   cd {客户端安装目录}

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地址。