源码安装Hyper MPI

前提条件

已完成以下依赖包的安装。
表1 每种操作系统需安装的依赖包

操作系统

依赖包
  • CentOS Linux release 7.6 aarch64
  • CentOS Linux release 8.2 aarch64
  • Kylin Linux Advanced Server V10 SP2 aarch64
  • openEuler 22.03 LTS SP2
  • perl-Data-Dumper
  • autoconf
  • automake
  • Libtool
  • GCC编译器9.3.0或毕昇编译器2.5.0
  • numactl
  • binutils
  • systemd-devel
  • valgrind
  • cmake3
  • Flex

Ubuntu18.04.5(ARM)
  • libdata-dumper-simple-perl
  • autoconf
  • automake
  • Libtool
  • GCC编译器9.3.0或毕昇编译器2.5.0
  • numactl
  • binutils
  • libsystemd-dev
  • valgrind
  • cmake3
  • Flex

编译环境变量检查

  1. 使用PuTTY工具，以Hyper MPI安装维护用户，如“hmpi_master”登录作业执行节点。
  2. 执行以下命令，检查GCC 9.3.0/毕昇编译器2.5.0是否安装。

    • GCC 9.3.0

      gcc -v

      检查回显信息中是否包含GCC 9.3.0。

    • 毕昇编译器2.5.0

      clang -v

      检查回显信息中是否包含毕昇编译器，且版本号是否正确。

  3. 执行以下命令，检查Libtool是否安装。

    libtool --version

    回显如下类似信息，说明已安装Libtool。

    libtool (GNU libtool) 2.4.2

GCC编译Hyper MPI软件包

Hyper MPI包含Hyper MPI和HUCX两个软件层，其中Hyper MPI的安装依赖于HUCX，编译时应先编译HUCX。

毕昇编译Hyper MPI软件包

Hyper MPI包含Hyper MPI和HUCX两个软件层，其中Hyper MPI的安装依赖于HUCX，编译时应先编译HUCX。

配置环境变量

使用MPI的用户，需要配置环境变量，可通过environment-modules工具方式配置环境变量。
  1. 使用PuTTY工具，以Hyper MPI普通用户，如“hmpi_user”登录作业执行节点。
  2. 安装environment-modules工具。
    1. 执行以下命令，安装environment-modules。
      表2 每种操作系统对应安装的操作步骤

      操作系统

      操作步骤
      • CentOS Linux release 7.6 aarch64
      • CentOS Linux release 8.2 aarch64
      • Kylin Linux Advanced Server V10 SP2 aarch64
      • openEuler 22.03 LTS SP2

      yum install -y environment-modules

      Ubuntu18.04.5(ARM)

      apt-get install -y environment-modules
    2. 执行以下命令，查看environment-modules是否安装成功。

      module --version

      若module命令不可用，请先执行以下命令，使module命令生效。

      • CentOS Linux release 7.6 aarch64、CentOS Linux release 8.2 aarch64、Kylin Linux Advanced Server V10 SP2 aarch64、openEuler 22.03 LTS SP2

        source /usr/share/Modules/init/bash

      • Ubuntu18.04.5(ARM)

        source /usr/share/modules/init/bash

      回显如下类似信息，说明environment-modules安装成功。

      Modules Release 4.1.1 (2018-02-17)
  3. 执行以下命令，在environment-modules工具安装路径下创建并编辑“Hmpi_modulefiles”配置文件。
    1. 打开“Hmpi_modulefiles”配置文件。

      vi /path/to/install/Hmpi_modulefiles

    2. 按“i”进入编辑模式，修改如下内容。
      #%Module1.0
#  HMPI module for use with 'environment-modules' package:
conflict mpi 
prepend-path  OPAL_PREFIX /path/to/install/hmpi/
prepend-path  PATH /path/to/install/hmpi/bin:/path/to/install/hucx/bin:/path/to/install/xucg/bin
prepend-path  LD_LIBRARY_PATH /path/to/install/hmpi/lib:/path/to/install/hucx/lib:/path/to/install/xucg/lib
prepend-path  INCLUDE /path/to/install/hmpi/include:/path/to/install/hucx/include:/path/to/install/xucg/include

      /path/to/install：表示environment-modules工具的安装路径。若用户不指定安装路径，则会安装在默认路径下，不同操作系统的默认路径如下。

      • CentOS Linux release 7.6 aarch64、CentOS Linux release 8.2 aarch64、Kylin Linux Advanced Server V10 SP2 aarch64、openEuler 22.03 LTS SP2的默认路径：/usr/share/Modules/modulefiles
      • Ubuntu18.04.5(ARM)的默认路径：/usr/share/modules/modulefiles
    3. 按“Esc”键，输入:wq!，按“Enter”保存并退出编辑。
  4. 执行以下命令，在工具安装路径下加载环境变量。

    module use /path/to/install

    module load /path/to/install/Hmpi_modulefiles

  5. 执行以下命令，将Hyper MPI环境变量写到用户的“~/.bashrc”文件中。
    1. 打开“~/.bashrc”文件。

      vi ~/.bashrc

    2. 按“i”进入编辑模式，添加如下内容。
      module use /path/to/install
module load /path/to/install/Hmpi_modulefiles
    3. 按“Esc”键，输入:wq!，按“Enter”保存并退出编辑。

      默认用户的“~/.bashrc”文件在共享目录中，若不在，请修改所有节点的“~/.bashrc”。

  6. 执行以下命令，使配置生效。

    source ~/.bashrc

父主题： 安装介绍