Installing HAF

OmniData is connected to HAF. The OmniData Client uses the plugin provided by HAF to add annotations to the functions to be pushed down. Then HAF automatically pushes the task down to the OmniData Server on the offload node, making users feel as if the task is executed locally. Therefore, before installing OmniData, you need to install HAF on all compute and offload nodes. HAF installation in SmartKit is different from a local installation. This section describes how to install HAF locally.

Installing the Software

Adjust the following installation settings based on your requirements.

Include the downloaded binary package into the BoostKit-haf_1.4.0.zip package.
1. Save the binary package to the haf-host directory.
  Save libcrypto.so, libcrypto.so.1.1, libssl.so, and libssl.so.1.1 into BoostKit-haf_1.4.0.zip\haf-1.4.0.tar.gz\haf-host-1.4.0.tar.gz\lib\.
2. Save the binary package to haf-target.
  Save libcrypto.so, libcrypto.so.1.1, libssl.so, and libssl.so.1.1 into BoostKit-haf_1.4.0.zip\haf-1.4.0.tar.gz\haf-target-1.4.0.tar.gz\lib\.

Create a /home/omm/omnidata-software directory on all nodes, upload BoostKit-haf_1.4.0.zip obtained from Obtaining Software to this directory, and decompress the package.

mkdir -p /home/omm/omnidata-software
cd /home/omm/omnidata-software
unzip BoostKit-haf_1.4.0.zip
tar -zxvf haf-1.4.0.tar.gz
tar -zxvf haf-tool-1.4.0.tar.gz

Install the HAF software package on the offload nodes (ceph1, ceph2, and ceph3).
```
mkdir -p /home/omm/omnidata-install
cd /home/omm/omnidata-software
./haf_installer -m lib -p /home/omm/omnidata-software/haf-target-1.4.0.tar.gz -i listen_ip_duration -w ip_white_list -j java_home -t install_dir -s communication_port
```
The script parameters are described as follows:
- -m lib: installing HAF on the offload nodes in client/server decoupled scenarios.
- -p /home/omm/omnidata-software/haf-target-1.4.0.tar.gz: path to the HAF installation package for the offload node.
- Optional: -i listen_ip_duration: listening IP address segment of the offload node (format: 10.10.0.1/24). During the installation, HAF matches and binds the IP address of the offload node.
- Optional: -w ip_white_list: IP address trustlist. The value can be an IP address or IP address segment. Use commas (,) to separate multiple values, for example, 127.0.0.1,10.10.0.2,10.10.10.0/24.
- Optional: -j java_home: Java installation path on the node. If this parameter is left blank, the value is automatically parsed based on the system environment variables during installation.
- -t install_dir: root installation directory of the software package on the offload node. In the example, the value is /home/omm/omnidata-install. This directory must be created before the installation.
- Optional: -s communication_port: service listening port. The default value is 17531.
Install the HAF software package on the compute nodes (agent1, agent2, and agent3).
If you need to modify the installation configuration file before the installation, see step 2 in Installing the HAF Library on an Offload Node in the HAF User Guide.
1 2
mkdir -p /home/omm/omnidata-install ./haf_installer -m host -p /home/omm/omnidata-software/haf-host-1.4.0.tar.gz -t /home/omm/omnidata-install -s communication_port
The script parameters are described as follows:
- -m host: installation on a compute node.
- -p /home/omm/omnidata-software/haf-host-1.4.0.tar.gz: path to the HAF installation package for the compute node.
- -t /home/omm/omnidata-install: root installation directory of the software package on the compute node. This directory must be created before the installation.
- Optional: -s communication_port: service listening port. The default value is 17531.

Obtaining the Issued HAF Certificate

When the TLS identity authentication and data encryption/decryption switches (target_tls_switch and host_tls_switch) are enabled, HAF needs to use a certificate to authenticate the identities of the communication compute nodes and storage nodes. Therefore, a trusted certificate is required. HAF does not provide a default certificate, and you need to manually generate one.

For details, see Obtaining and Issuing HAF Certificates in the HAF User Guide.

When referring to the HAF User Guide, change the HAF installation path (/home/omm/haf-install) to the OmniData installation path (/home/omm/omnidata-install).

Parent topic: Installing the Software