安装HAF

HAF安装的实现方式

HAF的安装，通过对外提供haf_installer脚本的方式实现。haf_installer将调用haf-tool命令行接口完成安装。

脚本的对外安装接口

• 计算节点：

  cd /home/omm/omnidata-software
  ./haf_installer -m <mode> -p <package> -t <target_dir> -s <communication_port>

  计算节点安装-p选项指定的软件安装包，并根据haf_host_install.conf文件内容，生成计算节点初始化证书。haf_host_install.conf文件在与haf_installer脚本同目录的install-config文件夹中。

  

  根据实际情况修改“/home/omm/omnidata-software”路径。

• 卸载节点：

  cd /home/omm/omnidata-software
  ./haf_installer -m <mode> -p <package> -t <target_dir> -w <ip_white_list> -j <java_home> -i <service_ip_duration> -s <communication_port>

haf-tool对外提供的安装接口

• 计算节点。

  1	/home/omm/omnidata-install/haf-host/tools/haf-tool install

• 卸载节点。

  1	/home/omm/omnidata-install/haf-target/tools/haf-tool install

  

  该接口主要提供给haf_installer脚本使用，不建议单独调用该接口。

传输HAF软件安装包

1. 向卸载节点和计算节点分发HAF程序包，选中全部节点，配置业务流。
2. 将软件获取中准备好的HAF软件安装包，使用文件传输功能拷贝HAF软件安装包到所有卸载节点和计算节点。

   表2 任务1编辑参数内容

   参数	内容
   任务名称	传输HAF包
   任务描述	拷贝HAF软件安装包到所有节点
   传输方向	从本地传至远端主机
   本地路径	本地软件安装包所在的目录
   远端路径	/home/omm/omnidata-software

   

   • 表2中的远端路径可修改，用户可根据实际情况进行填写。
   • 如果集群上“/home/omm/omnidata-software”目录不存在，则需要提前创建。可在SmartKit中选中所有节点后选择命令执行，运行目录中的执行命令mkdir -p /home/omm/omnidata-software，然后执行业务流。
3. 使用命令执行功能解压文件传输之后的HAF软件安装包，并解压软件安装包内的脚本工具包。

   表3 任务2编辑参数内容

   参数	内容
   任务名称	解压HAF压缩包
   任务描述	解压HAF和HAF-Tool工具包
   运行目录	/home/omm/omnidata-software
   执行命令	unzip BoostKit-haf_1.3.0.zip; tar -zxvf haf-1.3.0.tar.gz; tar -zxvf haf-tool-1.3.0.tar.gz
   是否判断返回码	是
   期望返回码	0

4. 导出业务流，保存至本地。后续其他安装，即可通过导入业务流，快速安装。
5. 执行业务流，执行状态成功即可。

安装HAF卸载节点

1. 安装HAF卸载节点（ceph1、ceph2、ceph3）软件安装包，选中ceph1~ceph3节点，配置卸载节点。
2. 使用命令执行功能，修改安装配置文件。

   以修改证书校验周期为例，默认情况下证书校验周期为7天，若设置其为6天，对应的命令如下。

   1 2	cd /home/omm/omnidata-software sed -i 's/\"cert_check_period_time\": 7/\"cert_check_period_time\": 6/g' install-config/haf_target_install.conf

   

   • 如果HAF部署配置项章节中默认haf_target_install.conf配置文件能满足业务诉求，则此步骤可忽略。
   • 在安装HAF卸载节点软件过程中，可以通过修改haf_target_install.conf配置文件的方式，批量修改节点上的安装配置。支持修改的选项，请参见HAF部署配置项。

   • 对于haf-tool不支持修改的配置，建议通过修改配置文件的方式进行修改。
   • 其他选项的修改，可以根据需要自行实现相关命令，上例仅供参考。
   • 若有多个选项需要修改，可以在SmartKit的命令执行模块的执行命令单元格内配置多条命令，以“;”分隔。
   • 如下命令是修改证书校验周期。

     1	sed -i 's/\"cert_check_period_time\": 7/\"cert_check_period_time\": 6/g' install-config/haf_target_install.conf

   表4 任务编辑参数内容

   参数	内容
   任务名称	修改证书校验周期
   任务描述	修改证书校验周期
   运行目录	/home/omm/omnidata-software
   执行命令	sed -i 's/\"cert_check_period_time\": 7/\"cert_check_period_time\": 6/g' install-config/haf_target_install.conf
   是否判断返回码	是
   期望返回码	0

3. 使用命令执行功能，安装HAF卸载节点。

   表5 任务编辑参数内容

   参数	内容
   任务名称	安装HAF卸载节点软件安装包
   任务描述	安装HAF卸载节点软件安装包，并生成初始化密钥
   运行目录	/home/omm/omnidata-software
   执行命令	./haf_installer -m lib -p /home/omm/omnidata-software/haf-offload-1.3.0.tar.gz -i listen_ip_duration -w ip_white_list -j java_home -t /home/omm/omnidata-install -s communication_port 说明： 脚本参数分别表示： -m lib表示卸载节点方式安装。 -p /home/omm/omnidata-software/haf-target-1.3.0.tar.gz表示卸载节点软件安装包路径。 可选：-i listen_ip_duration表示卸载节点侦听IP地址的网段信息（格式样例：10.10.0.1/24），HAF在安装过程中会与当前卸载节点的IP地址匹配并完成侦听绑定。 可选：-w ip_white_list表示白名单IP地址列表，支持IP地址或IP地址网段格式，多个值使用“,”分隔（格式样例：127.0.0.1,10.10.0.2,10.10.10.0/24）。 可选：-j java_home表示节点Java安装路径，使用系统默认路径则可省略该参数。 -t install_dir表示卸载节点软件安装包安装根目录。 可选：-s communication_port表示服务侦听的端口，默认为17531，支持haf-tool配置，值需与计算节点保持一致。 若不需要使用IP地址白名单校验时，IP地址白名单可不填，但是需要关闭IP地址白名单校验开关，具体见关闭IP白名单功能。 由于SmartKit命令不支持较长的字符串配置，当IP地址白名单特别长的时候，需要到系统上手动执行IP地址白名单更新命令，具体操作见更新IP白名单或侦听IP段。
   是否判断返回码	是
   期望返回码	0

4. 执行业务流，执行成功即可。

安装HAF计算节点

1. 安装计算节点（agent1、agent2、agent3）软件安装包，配置计算节点业务流。
2. 使用命令执行功能，修改安装配置文件。

   以修改证书校验周期为例，默认情况下证书校验周期为7天，若设置其为6天，对应的命令如下：

   1 2	cd /home/omm/omnidata-software sed -i 's/\"cert_check_period_time\": 7/\"cert_check_period_time\": 6/g' install-config/haf_host_install.conf

   

   • 如果HAF部署配置项章节中默认haf_host_install.conf配置文件能满足业务诉求，则此步骤可忽略。
   • 在安装HAF计算节点软件过程中，可以通过修改haf_host_install.conf配置文件的方式，批量修改节点上的安装配置。支持修改的选项，具体见HAF部署配置项。
   • 对于haf-tool不支持修改的配置，建议通过修改配置文件的方式进行修改。
   • 其他选项的修改，可以根据需要自行实现相关命令，上例仅供参考。

   表6 任务1编辑参数内容

   参数	内容
   任务名称	修改证书校验周期
   任务描述	修改证书校验周期
   运行目录	/home/omm/omnidata-software
   执行命令	sed -i 's/\"cert_check_period_time\": 7/\"cert_check_period_time\": 6/g' install-config/haf_host_install.conf
   是否判断返回码	是
   期望返回码	0

3. 使用命令执行功能，安装HAF计算节点。

   表7 任务1编辑参数内容

   参数	内容
   任务名称	安装HAF计算节点软件安装包
   任务描述	安装HAF计算节点软件安装包，并生成初始化密钥
   运行目录	/home/omm/omnidata-software
   执行命令	./haf_installer -m host -p /home/omm/omnidata-software/haf-host-1.3.0.tar.gz -t /home/omm/omnidata-install -s communication_port 说明： 脚本参数分别代表： -m host表示计算节点方式安装。 -p /home/omm/omnidata-software/haf-host-1.3.0.tar.gz表示计算节点软件安装包路径。 -t /home/omm/omnidata-install表示计算节点HAF安装目录。 可选：-s communication_port表示服务侦听的端口，默认17531，支持haf-tool配置，值须与卸载节点保持一致。
   是否判断返回码	是
   期望返回码	0

4. 执行业务流。单击右下角的“完成”，选择“执行业务流”执行成功即可。