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/mpi 
The 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/mpi 
The 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