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

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

IBM Spectrum MPI v10.1 supports the following OSs:
  • IBM Spectrum MPI 10.1.0.1 Eval for x86_64 Linux
    • Red Hat Enterprise Linux version 6.6 and later
    • Red Hat Enterprise Linux version 7.1 and later
    • SUSE Linux Enterprise Server version 11 SP4
    • SUSE Linux Enterprise Server version 12 and later
  • IBM Spectrum MPI 10.1.0.2 Eval for Power 8 Linux

    Red Hat Enterprise Linux version 7.3 and later

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