Installing mpich for Others to Use
Up: Contents Next: User commands Previous: Thorough Testing
This step is optional.
Once you have tested all parts of the MPI distribution (including the tools,
particularly upshot and/or nupshot), you may install mpich into
a publically available directory, and disseminate information for other users,
so that everyone can use the shared installation.
To install the libraries and include files in a
publicly available place, choose a directory, such as /usr/local/mpi,
change to the top-level mpich directory, and do
make install PREFIX=/usr/local/mpiThe man pages will have been copied with the installation, so you might want to add /usr/local/mpi/man to the default system MANPATH. The man pages can be conveniently browsed with the mpiman command, found in the mpich/bin directory.
A good way to handle multiple releases of mpich is to install
them into directories whose names include the version number and then
set a link from mpi to that directory. For example, if the
current version is 1.1.0, the installation commands to install into
/usr/local are
make install PREFIX=/usr/local/mpi-1.1.0 rm /usr/local/mpi ln -s /usr/local/mpi-1.1.0 /usr/local/mpiThe script util/mpiinstall provides more control over the installation of MPICH (in fact, make install just runs this script). For example, you can change the protection of the files when they are installed with the options -mode=nnnn (for regular files) and -xmode=nnnn (for executables and directories). You can set the directory into which the man pages will be placed with -manpath=<path>. The option -help shows the full set of options for mpiinstall.
Installing nupshot can sometimes be troublesome. You can use the switch -nonupshot to mpiinstall to not install nupshot; alternately, you can use the switch -cpnuphost to install the copy in mpich/profiling/nupshot. Normally, mpiinstall builds a new version of nupshot to insure that all of the paths are correct (nupshot needs to find files where it is installed). If you need to ``manually'' build nupshot for installation, the -cpnupshot switch will allow you to install that version.
If you are supporting multiple devices on a single platform (for example,
ch_p4 and ch_shmem), you should build one and install it in the
regular way, then build the second and install it with mpiinstall
-libonly. In this case, make sure that your users use the programs in the
library directory rather than the bin directory. If you want to
install a device that you have previously built, for example, a
ch_shmem device, use
util/mpiinstall -device=ch_shmem -libonly
Up: Contents Next: User commands Previous: Thorough Testing
