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