Spectrum MPI

Scenarios

This section describes how to install and use Spectrum MPI (version 10.01.01 is used as an example) in a BMS cluster.

Perform this operation on each BMS in a cluster.

Background

Prerequisites

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

Procedure

1. Install IBM Spectrum MPI.
   1. Obtain IBM Spectrum MPI software packages for registration.

      There are two IBM Spectrum MPI software packages, including the license and software:

      • ibm_smpi_lic_s-10.1Eval-rh7_Aug11.x86_64.rpm
      • ibm_smpi-10.01.01.0Eval-rh7_Aug11.x86_64.rpm

      Download path: https://www-01.ibm.com/marketing/iwm/iwm/web/preLogin.do?source=swerpsysz-lsf-3

   2. Install IBM Spectrum MPI.
      1. Upload the obtained MPI software packages to a directory, /home/rhel is recommended, on the BMS running the MPI.
      2. Configure environment variables.
         • If you choose to automatically accept the IBM Spectrum MPI installation license agreement, run the following command:

           # export IBM_SPECTRUM_MPI_LICENSE_ACCEPT=yes

         • If you choose to manually accept the IBM Spectrum MPI installation license agreement, run the following command:

           # export IBM_SPECTRUM_MPI_LICENSE_ACCEPT=no

      3. Install the license.
         • If you choose to automatically accept the IBM Spectrum MPI installation license agreement, run the following command:

           # rpm -ivh ibm_smpi_lic_s-10.1Eval-rh7_Aug11.x86_64.rpm

         • If you choose to manually accept the IBM Spectrum MPI installation license agreement, run the following commands:

           # rpm -ivh ibm_smpi_lic_s-10.1Eval-rh7_Aug11.x86_64.rpm

           # sh /opt/ibm/spectrum_mpi/lap_se/bin/accept_spectrum_mpi_license.sh

      4. Install the software.

         # rpm -ivh ibm_smpi-10.01.01.0Eval-rh7_Aug11.x86_64.rpm

2. Configure environment variables.
   1. By default, Spectrum MPI is installed in the /opt/ibm/spectrum_mpi directory. In this case, you need to configure the following environment variables:

      $ export MPI_ROOT=/opt/ibm/spectrum_mpi

      $ export LD_LIBRARY_PATH=$MPI_ROOT/lib:$LD_LIBRARY_PATH

      $ export PATH=$MPI_ROOT/bin:$PATH

      $ export MANPATH=$MPI_ROOT/share/man:$MANPATH

      $ unset MPI_REMSH

   2. Run the following command to check whether the MPI environment variables are correct:

      $ which mpirun

      Figure 1 Viewing Spectrum MPI environment variables
      

3. Run the executable file on a BMS through Spectrum MPI.
   1. For example, the hello.c file is in the /home/rhel/ directory, and the generated executable file is named hello. Then, run the following commands:

      $ cd /home/rhel/

      $ mpicc hello.c -o hello

   2. Run the following command on a BMS to run the executable file through Spectrum MPI:

      $ mpirun -np 2 /home/rhel/hello

      Figure 2 Successful Spectrum MPI execution on the BMS