3.2 Loading the MPI Software

This section describes how to load the MPI software onto each MPI cluster member.

3.2.1 Deleting Existing MPI Software Subsets

Before loading a new version of the MPI software, any previous versions of the software must be deleted.

If you are upgrading from a previous version of MPI, Digital recommends you follow the upgrading procedure detailed in the release notes.

To delete MPI software, you must be superuser (username root ). Make sure there are no MPI applications currently running. The command for deleting MPI software is:

# cd /
# setld -d MPIBINnnn

Replace nnn with the MPI version number (e.g. 180 for version 1.8).

For More Information:

On upgrading from a previous version of MPI, see the instructions in the release notes.

3.2.1.1 MPI Installation Summary

This section contains a brief summary of the MPI software installation procedure. The procedure is explained in detail in Chapter 4.

To load the MPI software kit onto a host, follow these steps:

For installation from a CD-ROM:
1. Log in as superuser (login name root ).
2. Type the following commands (substitute your CD-ROM drive name for rzxxc .
```
# cd /
# mount -rd /dev/rzxxc /mnt
# setld -l /mnt/pse190/kit
```
3. Refer to Section 3.1.1.4.3 to select the appropriate subsets.
For installation from an RIS (Remote Installation Service) server:
1. Log in as superuser (login name root ).
2. Type the following commands (substitute your RIS server for nodename):
```
# cd /
# setld -l nodename:
```
3. Refer to Section 3.1.1.4.3 to select the appropriate subsets.

For More Information:

On using setld to install the MPI software, see Chapter 4.
On setld , see the setld(8) manpage.

3.2.2 Running the Installation Verification Procedure

Note: The installation steps detailed in the preceding sections must successfully complete before attempting to execute the IVP for MPI.

After installing MPI, you can run the (IVP) independently to verify that the software is available on your system. You might also want to run the IVP after a system failure to be sure that users can access MPI. The MPI IVP verifies the installation as shown in Example 3-1.

Example 3-1 Sample MPI IVP Log

# setld -v MPIBIN190

Digital MPI V1.9 Binary (MPIBIN190)

Copyright (c) Digital Equipment Corporation, 1995, 1999.  All Rights Reserved.
Starting the verification of
Digital MPI V1.9 (MPIBIN190)

Compiling an MPI test program ... Done.
Linking test program with the libmpi.a library ...
Link succeeded.

*** The program however cannot be executed as root.
*** To test that the compiled MPI program runs successfully
*** (and prints an approximation of 'pi'),
*** you may, as a non-privileged user:
> cd /tmp
> dmpirun -np 4 /tmp/mb_pi.mpi
> echo ok

MPIBIN190 IVP passed.

# exit
> cd /tmp
> dmpirun -np 4 /tmp/mb_pi.mpi
3.1415926535897932384626433832795028