源码安装Hyper MPI

前提条件

已完成以下依赖包的安装。

perl-Data-Dumper
autoconf
automake
libtool 2.4.2
GCC编译器9.3
安装GCC编译器9.3版本前，需按如下顺序安装依赖：gmp-6.2.0.tar.bz2、mpfr-4.0.2.tar.bz2、mpc-1.1.0.tar.gz、isl-0.18.tar.bz2。
numactl
binutils
systemd-devel
valgrind

编译环境变量检查

使用PuTTY工具，以Hyper MPI安装维护用户，如“hmpi_master”登录作业执行节点。
执行以下命令，检查GCC 9.3.0是否安装。
gcc -v

回显信息显示如下表示GCC 9.3.0已安装：
```
gcc version 9.3.0(GCC);
```
执行以下命令，检查libtool是否安装。
libtool --version

回显信息显示如下表示libtool 2.4.2已安装：
```
libtool (GNU libtool) 2.4.2
```

软件包编译

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

HUCX编译
1. 使用PuTTY工具，以Hyper MPI安装维护用户，如“hmpi_master”登录作业执行节点。
2. 下载HUCX源码包“hucx-1.1.0-huawei.tar.gz”。
  下载地址：https://github.com/kunpengcompute/hucx/archive/refs/tags/v1.1.0-huawei.tar.gz。
3. 下载XUCG源码包“xucg-1.1.0-huawei.tar.gz”。
  下载地址： https://github.com/kunpengcompute/xucg/archive/refs/tags/v1.1.0-huawei.tar.gz。
4. 将上述两个源码包上传至服务器HUCX源码包安装目录，如“/path/to/download/hucx”。
5. 执行以下命令，解压上述两个源码包。
  tar -zxvf hucx-1.1.0-huawei.tar.gz
  
  tar -zxvf xucg-1.1.0-huawei.tar.gz
6. 执行以下命令，进入HUCX源码包安装路径。
  cd /path/to/download/hucx
7. 执行以下命令，将XUCG源码包中的内容复制到HUCX源码包中的“src/ucg”目录下。
  cp -r xucg-1.1.0-huawei/* hucx-1.1.0-huawei/src/ucg
8. 执行以下命令，进入“autogen.sh”脚本所在目录。
  cd hucx-1.1.0-huawei/
9. 执行以下命令，进行源码包安装。
  ./autogen.sh
  
  ./contrib/configure-opt --prefix=/path/to/install/hucx
  - 环境上若没有安装numactl插件，则需要执行以下命令，指定--disable-numa参数：
    ./contrib/configure-opt --prefix=/path/to/install/hucx --disable-numa
  - /path/to/install/hucx：代表HUCX的安装路径。
  make -j32
  
  make -j32 install
  
  make后面-j参数为并行编译参数，表示有多少CPU核数参与编译过程，请根据实际CPU核数进行指定。

Hyper MPI编译
1. 使用PuTTY工具，以Hyper MPI安装维护用户，如“hmpi_master”登录作业执行节点。
2. 下载Hyper MPI源码包“hmpi-1.1.0-huawei.tar.gz”。
  下载地址： https://github.com/kunpengcompute/hmpi/archive/refs/tags/v1.1.0-huawei.tar.gz
3. 将源码包上传至服务器Hyper MPI源码包安装目录，如“/path/to/download/hmpi”。
4. 执行以下命令，进入源码包安装目录。
  cd /path/to/download/hmpi
5. 执行以下命令，解压软件包。
  tar -zxvf hmpi-1.1.0-huawei.tar.gz
6. 执行以下命令，进入“autogen.pl”脚本所在目录。
  cd hmpi-1.1.0-huawei/
7. 执行以下命令，进行Hyper MPI源码包安装。
  ./autogen.pl
  
  ./configure --prefix=/path/to/install/hmpi --with-platform=contrib/platform/mellanox/optimized --enable-mpi1-compatibility --with-ucx=/path/to/install/hucx
  
  make
  
  make install

配置环境变量

可通过environment-modules工具和写入“~/.bashrc”文件两种方式配置环境变量。

方式1：使用environment-modules工具配置环境变量。
1. 使用PuTTY工具，以Hyper MPI普通用户，如“hmpi_user”登录作业执行节点。
2. 执行以下命令，安装environment-modules工具。
  yum install -y environment-modules
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
prepend-path  LD_LIBRARY_PATH /path/to/install/hmpi/lib:/path/to/install/hucx/lib
prepend-path  INCLUDE /path/to/install/hmpi/include
```
    /path/to/install：表示environment-modules工具的安装路径。用户若不指定安装路径，则默认安装在“/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”保存并退出编辑。
6. 执行以下命令，使配置生效。
  source ~/.bashrc
方式2：
1. 使用PuTTY工具，以Hyper MPI普通用户，如“hmpi_user”登录作业执行节点。
2. 执行以下命令，将以下环境变量写到用户的“~/.bashrc”文件中，使其配置生效。
  export PATH=/path/to/install/hmpi/bin:/path/to/install/hucx/bin:$PATH
  
  export OPAL_PREFIX=/path/to/install/hmpi/
  
  export LD_LIBRARY_PATH=/path/to/install/hmpi/lib:/path/to/install/hucx/lib:$LD_LIBRARY_PATH
  
  配置环境变量主要是将HUCX和Hyper MPI加入到PATH和LD_LIBRARY_PATH中。

父主题： 安装介绍