操作场景

该操作指导安装工程师安装GaussDB 200集群所有服务的客户端。GaussDB 200针对不同服务提供了Shell脚本，供开发维护人员在不同场景下登录其对应的服务维护客户端完成对应的维护任务。

说明：

• 通过Manager界面修改服务端配置或系统升级后，请重新安装客户端，否则客户端与服务端版本将不一致。
• 鲲鹏服务器建议使用OpenJDK1.8.0_161。

前提条件

• 安装目录可以不存在，会自动创建；但如果存在，则必须为空。目录路径不能包含空格。
• 客户端节点为集群外部服务器时，必须能够与集群业务平面网络互通，否则安装会失败。
• 客户端必须启用NTP服务，并保持与服务端时间一致，否则安装会失败。
• 已从管理员处获取“组件业务用户”（默认用户或新增用户）和“密码”。
• 安装和使用客户端可以使用任意用户进行操作，用户名和密码请从管理员处获取，本章节以“user_client”进行举例。要求“user_client”用户为服务器文件目录（如“/opt/client”）和客户端安装目录（如“/opt/mppdbclient”）的“owner”，两个目录的权限为“755”。

操作步骤

• 获取软件包。

  登录FusionInsight Manager系统，在“集群”下拉列表中单击需要操作的集群名称。选择“更多 > 下载客户端”，弹出“下载集群客户端”信息提示框。

  

  说明：

  • 在只安装单个服务客户端的场景中，在“集群”下拉列表中单击需要操作的集群名称。选择“服务 > 服务名称 > 更多 > 下载客户端”，弹出“下载客户端”信息提示框。
  • 对于不同的操作系统，客户端内MPPDB工具包部分文件名称会有差异，请根据待安装客户端节点的操作系统类型选择安装对应的客户端。
    • CentOS，RedHat和欧拉操作系统，客户端内部分工具包名称形式为：GaussDB-Kernel-VxxxRxxxCxx-REDHAT-64bit-*.tar.gz
    • SUSE操作系统，客户端内部分工具包名称形式为：GaussDB-Kernel-VxxxRxxxCxx-SUSExx-64bit-*.tar.gz

• “选择客户端类型”中选择“完整客户端”。

  “仅配置文件”下载的客户端配置文件，适用于应用开发任务中，完整客户端已下载并安装后，管理员通过Manager界面修改了服务端配置，开发人员需要更新客户端配置文件的场景。

  平台类型包括x86_64和aarch64两种：

  • x86_64：可以部署在x86服务器的客户端软件包，x86集群下默认选项。鲲鹏集群下默认不可用。
  • aarch64：可以部署在鲲鹏服务器的客户端软件包，鲲鹏服务器集群下默认选项。x86集群下默认不可用。

• 是否在集群的节点中生成客户端文件？
  • 是，勾选“仅保存到如下路径”，单击“确定”开始生成客户端文件，文件生成后默认保存在主管理节点“/tmp/FusionInsight-Client/”。支持自定义其他目录且omm用户拥有目录的读、写与执行权限。单击“确定”，等待下载完成后，以准备安装客户端的用户（如“user_client”），将获取的软件包“FusionInsight_Cluster_<集群ID>_Services_Client.tar”复制到将要安装客户端的服务器文件目录，例如“/opt/client”。然后执行5。
    说明：

    • 当用户无法获取root用户权限，需要用omm用户操作。
    • 获取的软件包名称格式为：“FusionInsight_Cluster_<集群ID>_Services_Client.tar”。
    • 后续步骤及章节以“FusionInsight_Cluster_3_Services_Client.tar”举例。
  • 否，单击“确定”指定本地的保存位置，开始下载完整客户端，等待下载完成，执行4。

• 上传软件包。
  使用WinSCP工具，以准备安装客户端的用户（如“user_client”），将获取的软件包“FusionInsight_Cluster_3_Services_Client.tar”上传到将要安装客户端的服务器文件目录，例如“/opt/client”。

  说明：

  • 要求“user_client”用户为服务器文件目录（如“/opt/client”）的“owner”，“/opt/client”的权限为“755”。
  • 客户端所在主机可以是集群内节点，也可以是集群外节点。当该节点为集群外部服务器时，必须能够与集群业务平面网络互通，并启用NTP服务以保持与服务端时间一致。
  • 例如可以为外部服务器配置与集群一样的NTP时钟源，配置之后可以执行ntpq -np命令检查时间是否同步。
    • 如果显示结果的NTP时钟源IP地址前有“*”号，表示同步正常，如下：

      remote refid st t when poll reach delay offset jitter 
      ============================================================================== 
      *10.10.10.162 .LOCL. 1 u 1 16 377 0.270 -1.562 0.014

    • 如果显示结果的NTP时钟源IP前无“*”号，且“refid”项内容为“.INIT.”，或者回显异常，表示同步不正常，请联系技术支持。

      remote refid st t when poll reach delay offset jitter 
      ============================================================================== 
      10.10.10.162 .INIT. 1 u 1 16 377 0.270 -1.562 0.014

• 使用“PuTTY”工具以user_client用户登录将要安装客户端的服务器。
• 解压软件包。

  进入安装包所在目录，例如“/opt/client”。执行如下命令解压安装包“FusionInsight_Cluster_3_Services_Client.tar”到本地目录。

  tar -xvf FusionInsight_Cluster_3_Services_Client.tar

• 校验软件包。

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

  sha256sum -c FusionInsight_Cluster_3_Services_ClientConfig.tar.sha256

  FusionInsight_Cluster_3_Services_ClientConfig.tar: OK     

• 解压获取的安装文件。

  执行如下命令解压安装文件“FusionInsight_Cluster_3_Services_ClientConfig.tar”。

  tar -xvf FusionInsight_Cluster_3_Services_ClientConfig.tar

• 配置客户端网络连接。
  • 确保客户端所在主机能与解压目录下“hosts”文件（例如“/opt/client/FusionInsight_Cluster_3_Services_ClientConfig/hosts”）中所列出的各主机在网络上互通。
  • 当客户端所在主机不是集群中的节点时，需要在客户端所在节点的“/etc/hosts”文件（更改此文件需要root用户权限）中设置该节点主机名和IP地址映射，主机名和IP地址请保持一一对应。
  说明：

  当客户端所在主机不是集群中的节点时，配置客户端网络连接，可避免执行客户端命令时出现错误。

• 进入安装包所在目录，执行如下命令安装客户端到指定目录（绝对路径），例如安装到“/opt/mppdbclient”目录。

  cd /opt/client/FusionInsight_Cluster_3_Services_ClientConfig

  执行./install.sh /opt/mppdbclient命令，等待客户端安装完成（以下只显示部分屏显结果）。

  Components client installation is complete.

  说明：

  • 要求“user_client”用户为客户端安装目录（如“/opt/mppdbclient”）的owner，“/opt/mppdbclient”的权限为“755”。
  • 如果已经安装的全部服务或某个服务的客户端使用了“/opt/mppdbclient”目录，再安装其他服务的客户端时，需要使用不同的目录。
  • 卸载客户端请删除客户端安装目录。
  • 如果要求安装后的客户端仅能被该安装用户（如“user_client”）使用，请在安装时加“-o”参数，即执行./install.sh /opt/mppdbclient -o命令安装客户端。

• 检查客户端是否安装成功，请登录客户端。
  • 执行cd /opt/mppdbclient命令进入客户端安装目录。
  • 执行source bigdata_env命令配置客户端环境变量。
  • 集群为安全模式时，执行以下命令，设置kinit认证，输入客户端用户登录密码

    kinit admin

    Password for admin@HADOOP.COM: #输入admin用户登录密码（与登录集群的用户密码一致）

  • 输入klist命令查询并确认权限内容。

    Ticket cache: FILE:/tmp/krb5cc_0
    Default principal: admin@HADOOP.COM
    
    Valid starting     Expires            Service principal
    03/17/17 09:24:29  03/18/17 09:24:24  krbtgt/HADOOP.COM@HADOOP.COM

• 集群重装后，之前安装的客户端将不再可用，需要重新部署客户端。
  • 使用PuTTY工具以root用户登录客户端所在节点。
  • 使用以下命令查看客户端所在目录（下例中“/opt/mppdbclient”为客户端所在目录）。

    ll /opt

    
    drwxr-x---. 6 root root       4096 Dec 11 19:00 mppdbclient 
    drwxr-xr-x. 3 root root       4096 Dec  9 02:04 huawei 
    drwx------. 2 root root      16384 Nov  6 01:03 lost+found 
    drwxr-xr-x. 2 root root       4096 Nov  7 09:49 rh      

  • 使用rm -rf命令删除所有客户端程序所在文件夹内的文件（例如删除“/opt/mppdbclient”文件夹）。

    rm -rf /opt/mppdbclient

  • 重新安装客户端。