MPICH

MPICH is a portable implementation of the MPI standard. You can get both the software and lots of documentation from the MPICH web site:

http://www-unix.mcs.anl.gov/mpi/mpich/

ADF uses the ch_p4 device.

→ Install MPICH following the MPICH documentation.

For compiling, linking, and running, ADF needs to know where your MPICH ch_p4 installation lives. You need to set the MPIDIR environment variable to this value, and you need to add $MPIDIR/bin to your PATH.

→ Set MPIDIR, and add $MPIDIR/bin to your PATH

Example

MPIDIR=/usr/local/mpich/1.2.4/ch_p4
export MPIDIR
PATH=$MPIDIR/bin:$PATH

Furthermore, at runtime you need to specify what machines to run on. You can do this by making a file that should contain the names of all nodes (one per line) you will use in your parallel job. ADF needs to know what name you use for this file. You pass this information to ADF by setting the environment variable SCM_MACHINEFILE to the absolute path of your machine file.

If you are using a batch system on your machine, it would be convenient to make a submit script that automatically creates the correct machine file for you.

→ Make script to build machine file, and set SCM_MACHINEFILE

Example (for use within the PBS batch system):

SCM_MACHINEFILE=$HOME/.machines.$$
export SCM_MACHINEFILE
uniq < $PBS_NODEFILE > $SCM_MACHINEFILE

Note about Linux and MPICH. The current MPI version of ADF for Linux is linked with MPICH 1.2.5.2 which was compiled using gcc 3.2.2 and Intel Fortran 8.0. You may need to install the same version of MPICH compiled with Intel Fortran compiler and not g77.