Help Center> High Performance Computing> User Guide> Typical Applications in the BMS Scenario> Installing and Using MPIs (BMS)> Platform MPI
View PDF

Platform MPI

Scenarios

This section describes how to install and use Platform MPI (version platform_mpi- 09.01.04.03r-ce.bin is used as an example) in a BMS cluster.

Perform this operation on each BMS in a cluster.

Prerequisites

Password-free login has been configured between BMSs in the cluster.

Procedure

  1. Install Platform MPI.

    1. Download the software package, such as platform_mpi- 09.01.04.03r-ce.bin.
    2. Run the following command to install the dependency package:

      # yum install glibc.i686 libgcc-4.8.5-11.el7.i686 libgcc_s.so.1

    3. Run the following command to assign execution permissions:

      #chmod +x platform_mpi-09.01.04.03r-ce.bin

    4. Install Platform MPI.

      # ./platform_mpi-09.01.04.03r-ce.bin

      Platform MPI is installed in /opt/ibm/platform_mpi by default.

      Figure 1 Installed Platform MPI

  2. Configure environment variables.

    1. Run the following command to obtain the pkey:

      # cat /sys/class/infiniband/mlx5_0/ports/1/pkeys/* | grep -v 0000

      Figure 2 Obtaining the pkey
    2. Add the following data to ~/.bashrc as a common user:

      export MPI_ROOT=/opt/ibm/platform_mpi

      export PATH=$MPI_ROOT/bin:$PATH

      export LD_LIBRARY_PATH=/opt/ibm/platform_mpi/lib/linux_amd64

      export MPI_IB_PKEY=pkey obtained in 2.a

      $source ~/.bashrc

      If there are multiple pkeys, use a comma to separate them.

    3. Run the following command to check whether the environment variables have been configured:

      # which mpirun

      Figure 3 Viewing the environment variables

  3. Run Platform MPI on a BMS.

    1. Run the following command to re-compile the hello.c file:

      $ mpicc hello.c -o hello

    2. Run the following command to run Platform MPI on a BMS:

      $ mpirun -np 2 /home/rhel/hello

      Figure 4 Running Platform MPI on a BMS