$COPYRIGHT$

Installation instructions for LAM LAMRV
=========================================

This file contains the installation instructions for LAM/MPI version
LAMRV.  

THIS IS AN EXPERIMENTAL ALPHA DISTRIBUTION OF LAM/MPI.  It is intended
for users of the Interoperable MPI (IMPI) standard only.  If you want
a stable release of LAM/MPI, please visit the main LAM web site:
http://www.lam-mpi.org/

There are also some tips for writing/developing/running parallel
programs, especially in parallel environments that are clusters of
workstations.  Here's a brief table of contents:

     * For the impatient
     * Unpacking the distribution
     * Configuration

For the impatient
-----------------

If you don't want to read all of the instructions, the following
should do the trick for most situations: 

     % gunzip -c lam-LAMRV.tar.gz | tar xf -
     % cd lam-LAMRV
     % ./configure --prefix=/path/to/install/in
     [...lots of output...]
     % make
     [...lots of output...]
     % make install
     [...lots of output...]

If you do not specify a prefix, LAM/MPI will use /usr/local/lam-LAMRV.
Now go read the RELEASE_NOTES-6.4 file followed by the RELEASE_NOTES
file; they contain information about the new features of the LAMRV
release of LAM/MPI.

Common causes of failure: 

     * No C++ compiler installed
     * C++ compiler does not support required C++ features like STL
     * No Fortran compiler installed; use --without-fc configure
       option.  

Download and build the IMPI server, which can be found at:

     http://www.mpi.nd.edu/research/impi/ 

Unpacking the distribution
--------------------------

The LAM/MPI distribution is packaged as a compressed tape archive,
lam-LAMRV.tar.Z or lam-LAMRV.tar.gz.  It is available from the main
LAM download site.

Uncompress the archive and extract the sources. 

     % gunzip -c lam-LAMRV.tar.gz | tar xf -

or 

     % uncompress -c lam-LAMRV.tar.Z | tar xf -


The remainder of the instructions are identical to the LAM 6.5.x
instructions, which are available in the INSTALL file.  The LAM LAMRV
configure defaults to building with IMPI support enabled.  If for some
reason you would like to disable this, the --without-impi flag can be
supplied to configure.  It should be noted that doing so builds the
same LAM/MPI as is available with the LAM 6.5.x release.