Rate This Document
Findability
Accuracy
Completeness
Readability

Preparing the Installation Directory

The directories for storing and installing the OmniData and HAF software are associated with the installation user and the cgroup subdirectory created in advance. Plan the directories in advance based on this section. In addition, you are advised to understand the usage of each directory generated after the installation so that you can quickly locate files during subsequent management and O&M.

You can specify the directory for storing the HAF installation package. This document uses the omm user and the cgroup subdirectory omm as an example. During the installation, select /home/omm/omnidata-software as the directory for storing the software installation package and /home/omm/omnidata-install as the software installation directory. After HAF is installed on the compute node, the haf-host directory is generated in /home/omm/omnidata-install. After HAF is installed on the offload node, the haf-offload directory is generated in /home/omm/omnidata-install.

  • The HAF installation package contains three software packages: haf-host, haf-target, and haf-tool. After HAF is installed on the compute node, all related files are stored in /home/omm/omnidata-install/haf-host. After HAF is installed on the offload node, all related files are stored in /home/omm/omnidata-install/haf-offload. 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, the /home/omm/omnidata-software directory is used as the directory for storing the installation package, and the /home/omm/omnidata-install directory is used as the root directory for installing the software. After the OmniData program package is decompressed, the omnidata and omnidata-setup directories are generated. All related files are stored in /home/omm/omnidata-install/omnidata and /home/omm/omnidata-install/omnidata-setup.

Table 1 describes the installation packages and their installation directories.

The /home/omm/omnidata-software directory is used only to store the installation packages and installation scripts. The /home/omm/omnidata-install directory is used to run services.

Table 1 Directories after the installation

Installation Node

Directory Category

Directory Name

Directory Description

All nodes (management, compute, and storage nodes)

Directory for storing software packages

/home/omm/omnidata-software

Decompress the BoostKit-haf_1.3.0.zip package to obtain the haf-1.3.0.tar.gz package. The haf-1.3.0.tar.gz package contains the software package, tool script package, and installation configuration file required for HAF installation: haf-host-1.3.0.tar.gz, haf-target-1.3.0.tar.gz, and haf-tool-1.3.0.tar.gz.

Stores the software package BoostKit-omnidata_1.5.0.zip required for OmniData installation.

NOTE:

Scripts required for installation are contained in haf-tool-1.3.0.tar.gz. Decompress the package before installation. The files and folders generated after decompression are described as follows:

  • bin: binary files for inner signature verification
  • tools: haf-tool and related scripts
  • install-config: path for storing the configuration file during installation
  • haf_installer: installation program
  • haf_uninstaller: uninstallation program
  • haf_upgrade: upgrade program

Management and compute nodes

Directory for installing HAF on a compute node

/home/omm/omnidata-install/haf-host/bin

Stores software binary files of a compute node, for example, kmc_tool_bin.

/home/omm/omnidata-install/haf-host/lib

Stores dynamic libraries and JAR packages of a compute node, for example, 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-1.3.0.jar.

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

Stores management tools and scripts of a compute node, for example, haf-tool, haf_uninstaller, and scripts. To view the haf-tool version, run the haf-tool --version command.

/home/omm/omnidata-install/haf-host/logs

Default directory for storing logs of a compute node.

/home/omm/omnidata-install/haf-host/env.sh

Stores the script for setting environment variables of a compute node.

/home/omm/omnidata-install/haf-host/cert

Stores files including the certificates and keys of a compute node, for example, service.ksfa, service.ksfb, service.prvk, service.pw, service.crt, and ca.crt.

/home/omm/omnidata-install/haf-host/etc

Stores the configuration files of a compute node, for example, haf_user.conf, LogAuditCfg.json, and LogServiceCfg.json.

/home/omm/omnidata-install/haf-host/conf-bak

Default path for storing backup configuration files of a compute node.

Offload nodes (storage nodes)

Installation directory of HAF on each offload node

/home/omm/omnidata-install/haf-offload/bin

Stores software binary files on the offload node, for example, kmc_tool_bin.

/home/omm/omnidata-install/haf-offload/lib

Stores dynamic libraries and JAR packages of the offload node, for example, libcrypto.so, libffi.so, libhaf_common.so, libhaf_offload_device.so, libhaf_link_target.so, libhostJNI_device.so, libkmc.so, libkmc_tool.so, liblog.so, libsdp.so, libsecurec.so, libssl.so, and jar/haf-1.3.0.jar.

/home/omm/omnidata-install/haf-offload/etc

Stores the configuration file and log configuration files of the library service on the offload node.

  • The configuration file is haf_offload.conf.
  • The log configuration files are LogAuditCfg.json and LogServiceCfg.json.

/home/omm/omnidata-install/haf-offload/conf-bak

Default path for storing configuration files of the offload node.

/home/omm/omnidata-install/haf-offload/env.sh

Stores the script for setting environment variables of the offload node.

/home/omm/omnidata-install/haf-offload/cert

Stores files including the certificates and key files of the offload node, for example, service.ksfa, service.ksfb, service.prvk, service.pw, service.crt, ca.crt, and ip_white_list.

/home/omm/omnidata-install/haf-offload/tools

Stores management tools and scripts of the offload node, for example, haf-tool, scripts, and haf_uninstaller.

/home/omm/omnidata-install/haf-offload/logs

Default directory for storing offload node logs.

Installation directory of OmniData on the offload node

/home/omm/omnidata-install/omnidata/deploy

Stores installation scripts, for example, generate_config.sh, get_ip.py, and log.sh.

/home/omm/omnidata-install/omnidata/etc

Stores the configuration files required for starting OmniData.

/home/omm/omnidata-install/omnidata/lib

Stores the list of third-party open source software packages on which OmniData depends. This directory contains only boostkit-omnidata-server-1.5.0-aarch64.jar. Obtain other contents (for example, boostkit-omnidata-server-1.5.0-aarch64-lib.zip) of the lib folder from the Kunpeng community. For details, see Obtaining Software.

/home/omm/omnidata-install/omnidata/plugin

Stores plugins.