Directory Description
You can specify the directory for storing the HAF installation package. This document uses the omm user and the cgroup subdirectory omm_haf as an example. During the installation, select /home/omm/haf-software as the directory for storing the software installation package and /home/omm/haf-install as the software installation directory. After HAF is installed on the host node, the haf-host directory is generated in /home/omm/haf-install. After HAF is installed on the offload node, the haf-target directory is generated in /home/omm/haf-install.
- The HAF installation package contains three software packages: haf-host, haf-target, and haf-tool. After HAF is installed on the host node, all related files are stored in /home/omm/haf-install/haf-host. After HAF is installed on the offload node, all related files are stored in /home/omm/haf-install/haf-target. The haf-tool software package is used to run maintenance commands.
- You can specify the directory for storing the OmniData installation package. In this document, /home/omm/haf-software is the default directory for storing installation packages. Program installation directories are under the HAF installation directory, and /home/omm/haf-install/haf-target/run/haf_user/omnidata is the root directory for software installation. After the OmniData program package is decompressed, the omnidata and omnidata-setup directories are generated. All related files are stored in /home/omm/haf-install/haf-target/run/haf_user/omnidata and /home/omm/haf-software/omnidata-setup.
Table 1 describes the installation packages and their installation directories.
The /home/omm/haf-software directory created by the user is used only for running the installation package and related installation scripts. The /home/omm/haf-install/haf-host and /home/omm/haf-install/haf-target directories are used for service running.
Installation Node |
Directory Category |
Directory Name |
Description |
|---|---|---|---|
All nodes (management nodes + compute nodes + storage nodes) |
Directory for storing software packages |
/home/omm/haf-software |
Stores BoostKit-haf_1.2.0.zip. The haf-1.2.0.tar.gz package extracted from BoostKit-haf_1.2.0.zip contains the software package, tool script package, and installation configuration file required for HAF installation, which are: haf-host-1.2.0.tar.gz, haf-target-1.2.0.tar.gz, haf-tool-1.2.0.tar.gz Stores the software package BoostKit-omnidata_1.3.0.zip required for OmniData installation. NOTE:
Scripts for deployment and installation are contained in haf-tool-1.2.0.tar.gz. Decompress haf-tool-1.2.0.tar.gz before installation. The decompressed files are described as follows:
|
Offload nodes (storage nodes) |
Directory for storing software packages |
/home/omm/haf-software/omnidata-setup |
Stores OmniData installation, upgrade, and uninstallation scripts and inner signature verification file, which are: omnidata-install.sh, omnidata-upgrade.sh, omnidata-destroy.sh, and verification |
Host nodes (management nodes + compute nodes) |
Installation directory of HAF on the host node |
/home/omm/haf-install/haf-host/bin |
Stores the binary file of the software on the host node: kmc_tool_bin |
/home/omm/haf-install/haf-host/lib |
Stores dynamic libraries and JAR packages of the host node: libcrypto.so, libhaf_common.so, libhaf_link_host.so, libhaf_offload_host.so, libkmc.so, libkmc_tool.so, liblog.so, libsdp.so, libsecurec.so, libssl.so, and jar/haf-jni-call-1.2.0.jar |
||
/home/omm/haf-install/haf-host/tools |
Stores the management tool and script on the host node: haf-tool and scripts To view the haf-tool version, run the following commands: haf-tool --version |
||
/home/omm/haf-install/haf-host/logs |
Stores host node logs by default. |
||
/home/omm/haf-install/haf-host/env.sh |
Stores the script for setting environment variables on the host node. |
||
/home/omm/haf-install/haf-host/haf_user.conf |
Stores the default offload user configuration file on the host node. |
||
/home/omm/haf-install/haf-host/LogAuditCfg.json |
Stores the audit log configuration file on the host node. |
||
/home/omm/haf-install/haf-host/LogServiceCfg.json |
Stores the function log configuration file on the host node. |
||
Offload nodes (storage nodes) |
Installation directory of HAF on the offload node |
/home/omm/haf-install/haf-target/bin |
Stores the binary file of the software on the offload node: haf_daemon, haf_executor, kmc_tool_bin, and verification NOTE:
To view the version information about HAF components, run the following commands: LD_LIBRARY_PATH=../lib:$JAVA_HOME/jre/lib/aarch64/server/:$LD_LIBRARY_PATH ./haf_daemon --version LD_LIBRARY_PATH=../lib:$JAVA_HOME/jre/lib/aarch64/server/:$LD_LIBRARY_PATH ./haf_executor --version $JAVA_HOME indicates the Java installation directory. |
/home/omm/haf-install/haf-target/lib |
Stores dynamic libraries and JAR packages of the offload node: libcrypto.so, libffi.so, libhaf_common.so, libhaf_link_target.so, libhostJNI_device.so, libkmc.so, libkmc_tool.so, liblog.so, libsdp.so, libsecurec.so, libssl.so, libcpuchecker.so, and jar/haf-jni-call-1.2.0.jar |
||
/home/omm/haf-install/haf-target/etc |
Stores the crontab task configuration file, runtime configuration file, and installation configuration file on the offload node. crontab.job, haf.conf, and haf_target_install.conf |
||
/home/omm/haf-install/haf-target/run |
Stores working directories, configuration files, and certificates required for HAF startup. |
||
/home/omm/haf-install/haf-target/tools |
Stores the management tool and script on the offload node: haf-tool, scripts, haf_uninstaller, and haf_upgrade |
||
/home/omm/haf-install/haf-target/logs |
Stores daemon and executor logs on the offload node by default. |
||
Installation directory of OmniData on the offload node |
/home/omm/haf-install/haf-target/run/haf_user/omnidata/deploy |
Stores installation and deployment scripts: generate-config.sh and get_ip.sh, log.sh |
|
/home/omm/haf-install/haf-target/run/haf_user/omnidata/etc |
Stores the configuration files required for starting OmniData. |
||
/home/omm/haf-install/haf-target/run/haf_user/omnidata/lib |
Stores the list of third-party open source software packages on which OmniData depends. This directory contains only boostkit-omnidata-server-1.3.0-aarch64.jar. Obtain other contents (boostkit-omnidata-server-1.3.0-aarch64-lib.zip) of the lib folder from the Kunpeng community. For details, see Obtaining Software. To view the omnidata version information, run the following commands: java -cp ./:/xxx/boostkit-omnidata-server-1.3.0-aarch64-lib/* com.huawei.boostkit.omnidata.server.OmniDataServerMain --version |
||
/home/omm/haf-install/haf-target/run/haf_user/omnidata/plugin |
Stores UDF plugins. Currently, the boostkit-omnidata-udf-1.3.0-aarch64 directory is included. This directory contains only boostkit-omnidata-udf-1.3.0-aarch64.jar. Obtain the third-party package (boostkit-omnidata-udf-1.3.0-aarch64.zip) that the JAR package depends on from the Kunpeng community. For details, see Obtaining Software. |
Planning Installation Nodes
- During the deployment, you need to plan a root CA server for issuing authentication certificates to HAF host and offload nodes. If there is only one node, perform all operations on the node.
- When issuing certificates by using the root CA server, ensure that the time on each node is synchronized. Otherwise, the certificate verification fails due to the system time difference. You can configure NTP for synchronization.
Node |
OmniData Service |
Installing HAF |
Whether to Generate a Certificate |
Function |
|---|---|---|---|---|
server |
- |
Yes |
Yes |
Controller node/Root CA server (you need to plan your own root CA server) for issuing certificates |
agent1 |
- |
Yes |
Yes |
Host node for HAF offload |
agent2 |
- |
Yes |
Yes |
Host node for HAF offload |
agent3 |
- |
Yes |
Yes |
Host node for HAF offload |
ceph1/hdfs1 |
Yes |
Yes |
Yes |
Offload node that provides the HAF OmniData service |
ceph2/hdfs2 |
Yes |
Yes |
Yes |
Offload node that provides the HAF OmniData service |
ceph3/hdfs3 |
Yes |
Yes |
Yes |
Offload node that provides the HAF OmniData service |