二进制安装Hyper MPI

操作步骤

1. 获取二进制安装包。

   登录https://kunpeng.huawei.com/#/developer/boostkit/hpc/hypermpi，在“软件下载”区域中，单击目标版本“软件包下载”，获取软件包。

2. 使用PuTTY工具，以Hyper MPI安装维护用户，如“hmpi_master”登录作业执行节点。
3. 将Hyper MPI安装包“Hyper-MPI_1.1.0_os-platform.tar.gz”上传至服务器。
   

   • os：表示安装包所适用的平台，分为x64和aarch64。
   • platform：表示操作系统版本，为CentOS7.6。

4. 在“软件下载”区域中，单击“复制MD5码”，获取MD5码。
5. 使用md5sum命令生成已下载软件包的MD5校验码，然后与网页上下载的MD5码进行比较。以Hyper MPI安装包“HPC_21.0.RC1_CentOS-aarch64 .tar.gz”为例进行校验：

   md5sum Hyper-MPI_1.1.0_CentOS-aarch64.tar.gz

   e76d3d64fa6e18f142a4b671a8010955  Hyper-MPI_1.1.0_CentOS-aarch64.tar.gz

   如果两个MD5码一致，则说明软件包合法，没有被篡改，可以进行下一步操作。否则应暂停部署，重新获取完整的软件包。

6. 执行以下命令，解压Hyper MPI“Hyper-MPI_1.1.0_os-platform.tar.gz”软件包，请根据实际环境获取对应的二进制安装包，例如：Hyper-MPI_1.1.0_CentOS-aarch64.tar.gz。

   tar -zxvf Hyper-MPI_1.1.0_os-platform.tar.gz

7. 执行以下命令，解压Hyper MPI二进制安装包至安装目录。

   tar -zxvf Hyper-MPI_1.1.0_platform_os_GCCVersion_MLNXVersion.tar.gz -C /path/to/install

   表1 Hyper MPI二进制包版本说明

   项目	说明
   platform	安装包所适用的平台，分为x64和aarch64。
   os	操作系统版本，为CentOS7.6。
   GCCVersion	GCC编译器版本，为GCC9.3.0。
   MLNXVersion	Mellanox OFED网卡驱动版本，为MLNX-OFED4.9。

   

   • Hyper-MPI_1.1.0_platform_os_GCCVersion_MLNXVersion.tar.gz：代表Hyper MPI二进制安装包名称，具体以最终下载的安装包名称为准进行替换。
   • /path/to/install：代表Hyper MPI的安装目录，用户可自定义，现场请以实际情况进行替换。该文档后续均以安装路径“/path/to/install”为例进行说明及相关操作。使用MPI的用户应具有该目录的访问权限。

配置环境变量

使用MPI的用户，需要配置环境变量。可通过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：运行Hyper MPI二进制安装包解压目录下的“install.sh”脚本，将Hyper MPI环境变量写到用户的“~/.bashrc”文件中，使其配置生效。
  1. 使用PuTTY工具，以Hyper MPI普通用户，如“hmpi_user”登录作业执行节点。
  2. 执行以下命令，进入安装目录。

     cd /path/to/install

  3. 执行以下命令，添加“install.sh”脚本的执行权限。

     chmod +x install.sh

  4. 执行“install.sh”脚本，将Hyper MPI环境变量写到用户的“~/.bashrc”文件中。

     ./install.sh

  5. 执行以下命令，使环境变量生效。

     source ~/.bashrc