--- title: 安装HAF description: "请在所有的计算节点和卸载节点安装HAF，安装过程主要包括传输安装包、安装卸载节点、安装计算节点3大步骤，过程中执行的命令主要通过调用haf_installer脚本完成。在安装前，建议先了解脚本的基本用法。" url: https://www.hikunpeng.com/document/detail/zh/kunpengboostkithistory/2300/bds/kunpengbds_omniruntime_20_0027.html sourcePath: /source/zh/kunpengboostkithistory/2300/bds/kunpengbds_omniruntime_20_0027.html indexId: fde91e0647a5de15e78a02073bdf1afb3a0b829cad69fb7070002abaf11b5d6078 --- # 安装HAF 请在所有的计算节点和卸载节点安装HAF，安装过程主要包括传输安装包、安装卸载节点、安装计算节点3大步骤，过程中执行的命令主要通过调用haf_installer脚本完成。在安装前，建议先了解脚本的基本用法。 SmartKit工具的操作指导请参见SmartKit工具相关操作。 #### 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 -p -t -w -j -i -s ``` 卸载节点比计算节点多了三个选项，各个选项含义如表1所示。 **表1 haf_installer命令选项表** | 选项 | 说明 | 计算节点 | 卸载节点 | | --- | --- | --- | --- | | \-m | host /lib用来表示在计算节点还是卸载节点安装。 | √ | √ | | \-p | 软件安装包，例如haf\-target\-1.3.0.tar.gz。 | √ | √ | | \-t | 软件安装包安装根目录。 | √ | √ | | \-w | 白名单IP地址列表，支持IP地址或IP地址网段格式，多个值使用“,”分隔（格式样例：127.0.0.1,10.10.0.2,10.10.10.0/24，默认为空）。 说明： 白名单用于校验计算节点的IP地址，不在白名单的连接将被拒绝。若在IP地址白名单校验功能使能的情况下，未配置IP地址白名单，则卸载节点将会拒绝所有计算节点连接请求。 | × | √ | | \-j | 节点Java安装路径。 若该项不配置，则安装时根据系统环境变量自动解析。 使用自定义的JAVA\_HOME，请配置该项。 使用系统的默认路径，可省略该项配置。 | × | √ | | \-i | 侦听卸载节点IP地址的网段信息（格式样例：10.10.0.0/24，默认为haf\_target\_install.conf中配置的选项）。 说明： 默认侦听IP地址网段与现场运行网段差异较大，建议根据系统情况进行配置。 | × | √ | | \-s | HAF服务通信端口，默认17531，计算节点和卸载节点应保持一致。 | √ | √ | #### 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部署配置项(https://www.hikunpeng.com/document/detail/zh/kunpengaccel/system-lib/ug-haf/kunpengaccel_haf_06_0015.html)章节中默认haf_target_install.conf配置文件能满足业务诉求，则此步骤可忽略。 在安装HAF卸载节点软件过程中，可以通过修改haf_target_install.conf配置文件的方式，批量修改节点上的安装配置。支持修改的选项，请参见HAF部署配置项(https://www.hikunpeng.com/document/detail/zh/kunpengaccel/system-lib/ug-haf/kunpengaccel_haf_06_0015.html)。 对于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白名单功能(https://www.hikunpeng.com/document/detail/zh/kunpengaccel/system\-lib/ug\-haf/kunpengaccel\_haf\_06\_0066.html)。 由于SmartKit命令不支持较长的字符串配置，当IP地址白名单特别长的时候，需要到系统上手动执行IP地址白名单更新命令，具体操作见更新IP白名单或侦听IP段(https://www.hikunpeng.com/document/detail/zh/kunpengaccel/system\-lib/ug\-haf/kunpengaccel\_haf\_06\_0065.html)。 | | 是否判断返回码 | 是 | | 期望返回码 | 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部署配置项(https://www.hikunpeng.com/document/detail/zh/kunpengaccel/system-lib/ug-haf/kunpengaccel_haf_06_0015.html)章节中默认haf_host_install.conf配置文件能满足业务诉求，则此步骤可忽略。 在安装HAF计算节点软件过程中，可以通过修改haf_host_install.conf配置文件的方式，批量修改节点上的安装配置。支持修改的选项，具体见HAF部署配置项(https://www.hikunpeng.com/document/detail/zh/kunpengaccel/system-lib/ug-haf/kunpengaccel_haf_06_0015.html)。 对于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. 执行业务流。单击右下角的“完成”，选择“执行业务流”执行成功即可。