Documentation
Rate This Document
Findability
Accuracy
Completeness
Readability
SubmitClose

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.

Adjust the following installation settings based on your requirements.

  1. Create a /home/omm/omnidata-software directory on all nodes, upload BoostKit-haf_1.3.0.zip obtained from Obtaining Software to this directory, and decompress the package.
    1
2
3
4
5
    mkdir -p /home/omm/omnidata-software
cd /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
  2. 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.3.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.3.0.tar.gz: path of 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.
  3. 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.3.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.3.0.tar.gz: path of 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.
Parent topic: Installing the Software