Rate This Document
Findability
Accuracy
Completeness
Readability

Installing HPCKit (Non-Interactive)

Non-interactive installation allows you to install all HPCKit components.

  1. Use PuTTY to log in to the node where HPCKit is installed.
  2. (Optional) If you need to install KuLitho, run the following commands to go to the directory where the KuLitho software package is stored and decompress the package:
    cd Directory_hosting_the_KuLitho_software_package
    tar xvf HPCKit_KuLitho_26.1.RC1_Linux-aarch64.tar.gz
  3. (Optional) If you need to install KuRTM, run the following commands to go to the directory where the KuRTM software package is stored and decompress the package:
    cd Directory_hosting_the_KuRTM_software_package
    tar xvf HPCKit_KuRTM_26.1.RC1_Linux-aarch64.tar.gz
  4. Run the following command to go to the directory where the HPCKit software package is stored:
    cd Directory_hosting_the_HPCKit_software_package

    To install HPCKit in a shared directory, obtain the installation directory by referring to Basic Project Info > Shared Storage Directory Plan > HPCKit Installation Directory in the Kunpeng HPC Solution 26.1.RC1 LLD Template.

  5. Run the following command to decompress the HPCKit software package:
    tar xvf HPCKit_26.1.RC1_Linux-aarch64.tar.gz
  6. Run the following command to start the installation:
    sh HPCKit_26.1.RC1_Linux-aarch64/install.sh -y --prefix=HPCKit_installation_directory --hmpi_type=mlx|hns --install_kulitho=y --kulitho_path=/xxx/KuLitho_package_path --install_kurtm=y --kurtm_path=/xxx/KuRTM_package_path
    • --hmpi_type defaults to hns. If the Huawei-developed NIC driver is used, select hns. If the Mellanox NIC driver is used, select mlx. Run the following command to query the NIC driver type:
      rpm -qa | grep rdma-core

      If the command output contains mlnx, use --hmpi_type=mlx. The following is an example of the command output:

      rdma-core-58mlnx43-1.58112.aarch64
      rdma-core-devel-58mlnx43-1.58112.aarch64

      Otherwise, use the default setting --hmpi_type=hns. The following is an example of the command output:

      rdma-core-41.0-36.oe2203sp4.aarch64
      rdma-core-devel-41.0-36.oe2203sp4.aarch64
    • --install_kulitho is optional. If the value is y, KuLitho will be installed. The default value is n, indicating that KuLitho will not be installed.
    • --kulitho_path is optional. It specifies the path where the KuLitho installation package is decompressed. This option can be specified only when --install_kulitho is set to y. The default value is the package folder generated after the HPCKit installation package is decompressed.
    • --install_kurtm is optional. If the value is y, KuRTM will be installed. The default value is n, indicating that KuRTM will not be installed.
    • --kurtm_path is optional. It specifies the path where the KuRTM installation package is decompressed. This option can be specified only when --install_kurtm is set to y. The default value is the package folder generated after the HPCKit installation package is decompressed.
    If the following information is displayed, the installation is successful and no further action is required. Otherwise, rectify the fault based on the error message and perform the installation again.
     1
     2
     3
     4
     5
     6
     7
     8
     9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37
    38
    39
    40
    Start installing HPCKit...
    You have selected: HPCKit_installation_directory
    Start Installing Bisheng Compiler
    Bisheng Compiler Installation Finished.
    Start Installing Gcc For openEuler
    Gcc For openEuler Installation Finished.
    Start Installing bisheng compiled KML
    KML Installation Finished
    Start Installing bisheng compiled KUPL
    KUPL Installation Finished.
    Start Installing bisheng compiled Hyper MPI
    HMPI Release Version Installation Finished.
    HMPI Debug Version Installation Finished.
    Start Installing bisheng compiled KuLitho
    KuLitho Installation Finished.
    Start Installing bisheng compiled KuTACC
    KuTACC Installation Finished.
    Start Installing bisheng compiled KuRTM
    KuRTM Installation Finished.
    Start Installing bisheng compiled KuDNN
    KuDNN Installation Finished.
    Start Installing bisheng compiled KuQCD
    KuQCD Installation Finished.
    Start Installing gcc compiled KML
    KML Installation Finished
    Start Installing gcc compiled KUPL
    KUPL Installation Finished.
    Start Installing gcc compiled Hyper MPI
    HMPI Release Version Installation Finished.
    HMPI Debug Version Installation Finished.
    Start Installing gcc compiled KuLitho
    KuLitho Installation Finished.
    Start Installing gcc compiled KuRTM
    KuRTM Installation Finished.
    Start Installing gcc compiled KuDNN
    KuDNN Installation Finished.
    Start Installing gcc compiled KuQCD
    KuQCD Installation Finished.
    Start Installing HIO
    HIO Installation Finished.
    
    • If you have the write permission on the HPCKit installation directory entered in 6, HPCKit can be installed in this directory.
    • If you do not have the write permission on the HPCKit installation directory entered in 6, information similar to the following will be displayed and you will be prompted to enter the installation directory again. If you do not enter the installation directory but directly press Enter, HPCKit will be installed in the ~ directory by default. The ~ directory is the $HOME directory of the user.
      1
      Error: You do not have permission to write to HPCKit_installation_directory. Please choose another path.
      
    • If the value of hmpi_type entered in 6 is incorrect, an error message is displayed, indicating that the input is invalid and you need to reinstall HMPI. If the OS is Kylin Linux Advanced Server V10 SP2 AArch64 or openEuler 20.03 LTS SP3 AArch64, only the mlx version can be installed.
    • During the HIO installation, if any dynamic library on which HIO depends is missing, the following message will be displayed. Install the required dynamic library by referring to Installing HIO Bridge Target Libraries. Otherwise, HIO cannot be used. If the HIO bridge target libraries do not exist in the environment, install them and configure environment variables by referring to Installing HIO Bridge Target Libraries. If the HIO bridge target libraries exist in the environment but environment variables have not been configured, configure environment variables by referring to Configuring Environment Variables for HIO Bridge Target Libraries.
      1
      2
      3
      libhdf5.so >= 1.12.0 required, Please update the library to the required version.
      libnetcdf.so >= 4.7.4 required, Please update the library to the required version.
      libpnetcdf.so >= 1.12.1 required, Please update the library to the required version.
      
    • If the space of the configured installation directory is less than 10 GB, the following information will be displayed. In this case, you are advised to replan the installation directory or clear the directory.
      1
      2
      3
      The space of the HPCKit installation directory is insufficient.
      About 10 GB space is required for installing HPCKit.
      Run the 'df -h /opt' command to check the space of the installation directory.