# 安装客户端（2.x及之前版本） MRS集群创建成功后，用户可自行安装集群客户端，用于连接集群内组件服务端，进行组件连接、作业提交等任务。集群客户端可以安装在集群内的节点上，也可以安装在集群外的节点上。 集群内组件的服务端配置修改后，也建议重新安装客户端，否则客户端与服务端版本将不一致，可能影响部分功能的正常使用。 本章节指导用户安装MRS 2.x及之前版本的集群客户端，MRS 3.x版本请参考[安装客户端（3.x版本）](https://support.huaweicloud.com/usermanual-mrs/mrs_01_0089.html)。 MRS 3.x之前版本集群在集群创建后，在主Master节点默认安装有客户端，安装目录为"/opt/client"。 #### 集群内节点安装客户端 1. 登录MRS集群Manager界面。 登录集群Manager界面请参考[访问MRS集群Manager](https://support.huaweicloud.com/usermanual-mrs/mrs_01_0128.html)。 2. 选择"服务管理 \> 下载客户端"下载客户端安装包至主OMS节点。 3. 在MRS管理控制台，查看指定集群"节点管理"页面的"IP"地址。 记录待安装客户端的节点IP地址及主Master节点IP地址（主OMS节点）。 4. 以**root** 用户登录主OMS节点，执行以下命令切换至**omm** 用户。 ``` sudo su - omm ``` 5. 执行以下命令，将客户端安装包复制到指定节点。 ``` scp -p /tmp/MRS-client/MRS_Services_Client.tar 待安装客户端节点的IP地址:/opt/client_tmp ``` 6. 以**root**用户登录待安装客户端节点。 7. 执行以下命令，安装客户端： ``` cd /opt/client_tmp ``` ``` tar -xvf MRS_Services_Client.tar ``` ``` tar -xvf MRS_Services_ClientConfig.tar ``` ``` cd MRS_Services_ClientConfig ``` ``` ./install.sh 客户端安装目录 ``` 例如执行： ``` ./install.sh /opt/hadoopclient ``` 等待客户端安装成功，安装输出信息中有以下结果则表示客户端安装成功： ``` Components client installation is complete. ``` 客户端安装目录： - **客户端安装目录可以不存在，系统会自动创建，如果存在则必须为空。安装目录路径不能包含空格** **，且只能包含大写字母、小写字母、数字以及_字符**。 - 卸载客户端请手动删除客户端安装目录。 8. 检查客户端是否安装成功。 1. 执行以下命令进入客户端安装目录并加载环境变量。 ``` cd /opt/hadoopclient source bigdata_env ``` 2. 根据集群模式执行相关命令。 - 如果集群未开启Kerberos认证，则可以直接执行组件客户端相关命令。 例如使用HDFS客户端命令查看HDFS根目录文件： ``` hdfs dfs -ls / ``` - 如果集群开启了Kerberos认证，执行**kinit** 命令进行用户认证。 例如： ``` kinit admin ``` 执行后显示如下： ``` Password for xxx@HADOOP.COM: #输入用户密码 ``` 输入**klist**命令查询并确认权限内容。 ``` klist ``` 执行后显示如下： ``` Ticket cache: FILE:/tmp/krb5cc_0 Default principal: xxx@HADOOP.COM Valid starting Expires Service principal ... ``` 3. 各个组件客户端使用，具体请参考： - [ClickHouse客户端使用实践](https://support.huaweicloud.com/cmpntguide-lts-mrs/mrs_01_2345.html) - [Flink客户端使用实践](https://support.huaweicloud.com/cmpntguide-lts-mrs/mrs_01_0473.html) - [HBase客户端使用实践](https://support.huaweicloud.com/cmpntguide-lts-mrs/mrs_01_0340.html) - [HDFS客户端使用实践](https://support.huaweicloud.com/cmpntguide-lts-mrs/mrs_01_1663.html) - [Hive客户端使用实践](https://support.huaweicloud.com/cmpntguide-lts-mrs/mrs_01_0952.html) - [Impala客户端使用实践](https://support.huaweicloud.com/cmpntguide-lts-mrs/mrs_01_0639.html) - [IoTDB客户端使用实践](https://support.huaweicloud.com/cmpntguide-lts-mrs/mrs_01_24158.html) - [Kafka客户端使用实践](https://support.huaweicloud.com/cmpntguide-lts-mrs/mrs_01_1767.html) - [Spark客户端使用实践](https://support.huaweicloud.com/cmpntguide-lts-mrs/mrs_01_1929.html) - [使用Yarn客户端提交任务](https://support.huaweicloud.com/cmpntguide-lts-mrs/mrs_01_0854.html) #### 集群外节点安装客户端 1. 准备一个用于安装MRS集群客户端的Linux弹性云服务器。 - 云服务器操作系统及版本建议如下： 表1操作系统参考列表 | CPU架构 | 操作系统 | 支持的版本号 | |:---|:---|:---| | x86计算 | Euler | - 可用：Euler OS 2.2 - 可用：Euler OS 2.3 - 可用：Euler OS 2.5 | | 鲲鹏计算(ARM) | Euler | 可用：Euler OS 2.8 | - 弹性云服务器的CPU架构需和MRS集群节点保持一致。 - 弹性云服务器客户端安装目录需要分配足够的磁盘空间，至少40GB。 - 弹性云服务器需要与MRS集群在同一个VPC网络及安全组中。 - MRS集群安全组入方向将所有端口对客户端节点放开，具体操作请参考[添加安全组规则](https://support.huaweicloud.com/usermanual-vpc/zh-cn_topic_0030969470.html)。 - 弹性云服务器操作系统已安装NTP服务，且NTP服务运行正常。 若未安装，在配置了**yum** 源的情况下，可执行**yum install ntp -y**命令进行安装。 - 弹性云服务器需要允许用户使用密码方式登录（SSH方式）。 2. 参考[访问MRS集群Manager](https://support.huaweicloud.com/usermanual-mrs/mrs_01_0128.html)登录集群Manager，然后选择"服务管理 \> 下载客户端"。 - 在"客户端类型"选择"完整客户端"。 - 在"下载路径"选择"远端主机"。 - 将"主机IP"设置为待安装客户端节点的IP地址，设置"主机端口"为"22"，并将"存放路径"设置为"/tmp"。 如果节点的SSH登录默认端口被修改，请将"主机端口"设置为新端口。 - "登录用户"设置为"root"。 如果使用其他用户，请确保该用户对保存目录拥有读取、写入和执行权限。 - 在"登录方式"选择"密码"或"SSH私钥"。 - 密码：输入创建集群时设置的root用户密码。 - SSH私钥：选择并上传创建集群时使用的密钥文件。 3. 单击"确定"开始生成客户端文件。 等待界面提示文件下载成功，到待安装客户端节点的指定路径中获取客户端软件包。 如果客户端下载失败，请检查用户名密码及远端主机的安全组配置，确保用户名密码正确，及远端主机的安全组已增加SSH端口的入方向规则，然后重新下载客户端。 **生成客户端会占用大量的磁盘IO，不建议在集群处于安装中、启动中、打补丁中等非稳态场景下载客户端。** 4. 配置待安装客户端节点的NTP时间同步，使节点时间与MRS集群时间同步。 1. 登录[MRS管理控制台](https://console.huaweicloud.com/mrs/)。 2. 在集群列表单击MRS集群名称，进入MRS集群详情页面。 3. 单击"节点管理"，展开Master节点组列表，查看集群Master1、Master2节点的IP地址信息。 4. 使用**root** 用户登录待安装客户端的节点，执行以下命令编辑NTP配置文件，增加MRS集群中Master1、Master2节点的IP地址并注释掉其余**server** 地址。 ``` vi /etc/ntp.conf ``` 配置文件修改如下： ``` server master1_ip prefer server master2_ip ``` 图1NTP配置文件修改示例 ![](https://support.huaweicloud.com/usermanual-mrs/zh-cn_image_0000001980873421.png "点击放大") 5. 保存配置文件后，执行以下命令关闭NTP服务。 ``` service ntpd stop ``` 6. 执行如下命令，手动同步一次时间。 ``` /usr/sbin/ntpdate 主Master节点的IP地址 ``` 7. 执行以下命令启动NTP服务。 ``` service ntpd start ``` 或者： ``` systemctl restart ntpd ``` 8. 执行**ntpstat** 命令查看时间同步结果。 ``` synchronised to NTP server (xxx) at stratum 2 time correct to within 12 ms polling server every 16 s ``` 5. 将下载的客户端软件包复制到"/opt"目录下。 ``` cp /tmp/MRS_Services_Client.tar /opt ``` 6. 执行以下命令解压软件包。 ``` cd /opt ``` ``` tar -xvf MRS_Services_Client.tar ``` 7. 执行以下命令校验文件。 ``` sha256sum -c MRS_Services_ClientConfig.tar.sha256 ``` 界面显示如下： ``` MRS_Services_ClientConfig.tar: OK ``` 8. 执行以下命令继续解压软件包。 ``` tar -xvf MRS_Services_ClientConfig.tar ``` 9. 执行以下命令安装集群客户端。 ``` sh /opt/MRS_Services_ClientConfig/install.sh 客户端安装目录 ``` 例如执行： ``` sh /opt/MRS_Services_ClientConfig/install.sh /opt/hadoopclient ``` 查看安装输出信息，如有以下结果表示客户端安装成功： ``` Components client installation is complete. ``` 客户端安装目录： - **客户端安装目录可以不存在，系统会自动创建，如果存在则必须为空。安装目录路径不能包含空格** **，且只能包含大写字母、小写字母、数字以及_字符**。 - 卸载客户端时请手动删除客户端安装目录。 10. 检查客户端是否安装成功。 1. 执行以下命令进入客户端安装目录并加载环境变量。 ``` cd /opt/hadoopclient source bigdata_env ``` 2. 根据集群模式执行相关命令。 - 如果集群未开启Kerberos认证，则可以直接执行组件客户端相关命令。 例如使用HDFS客户端命令查看HDFS根目录文件： ``` hdfs dfs -ls / ``` - 如果集群开启了Kerberos认证，执行**kinit** 命令进行用户认证。 例如： ``` kinit admin ``` 执行后显示如下： ``` Password for xxx@HADOOP.COM: #输入用户密码 ``` 输入**klist**命令查询并确认权限内容。 ``` klist ``` 执行后显示如下： ``` Ticket cache: FILE:/tmp/krb5cc_0 Default principal: xxx@HADOOP.COM Valid starting Expires Service principal ... ``` 3. 各个组件客户端使用，具体请参考： - [ClickHouse客户端使用实践](https://support.huaweicloud.com/cmpntguide-lts-mrs/mrs_01_2345.html) - [Flink客户端使用实践](https://support.huaweicloud.com/cmpntguide-lts-mrs/mrs_01_0473.html) - [HBase客户端使用实践](https://support.huaweicloud.com/cmpntguide-lts-mrs/mrs_01_0340.html) - [HDFS客户端使用实践](https://support.huaweicloud.com/cmpntguide-lts-mrs/mrs_01_1663.html) - [Hive客户端使用实践](https://support.huaweicloud.com/cmpntguide-lts-mrs/mrs_01_0952.html) - [Impala客户端使用实践](https://support.huaweicloud.com/cmpntguide-lts-mrs/mrs_01_0639.html) - [IoTDB客户端使用实践](https://support.huaweicloud.com/cmpntguide-lts-mrs/mrs_01_24158.html) - [Kafka客户端使用实践](https://support.huaweicloud.com/cmpntguide-lts-mrs/mrs_01_1767.html) - [Spark客户端使用实践](https://support.huaweicloud.com/cmpntguide-lts-mrs/mrs_01_1929.html) - [使用Yarn客户端提交任务](https://support.huaweicloud.com/cmpntguide-lts-mrs/mrs_01_0854.html) #### 相关文档 - MRS 3.x版本集群安装客户端请参考[安装客户端（3.x版本）](https://support.huaweicloud.com/usermanual-mrs/mrs_01_0089.html)。 - 如果修改了服务配置参数并重启了服务，已安装的客户端需要重新下载并安装，或者使用配置文件更新客户端，更新客户端操作请参见[服务端配置过期后更新MRS集群客户端](https://support.huaweicloud.com/usermanual-mrs/mrs_01_0090.html)。