MPE Installation Instructions


Up: The MPE Library Next: Configure the mpe library as part of the mpich configure and make process Previous: Configure Options

As noted in the previous section, the mpe library can be installed as part of the mpich configure and make process or as an extension of an existing MPI implementation. This section describes the instructions and examples for each type of installation.



Up: The MPE Library Next: Configure the mpe library as part of the mpich configure and make process Previous: Configure Options


Configure the mpe library as part of the mpich configure and make process


Up: MPE Installation Instructions Next: Configure the mpe library as part of an existing MPI implementation Previous: MPE Installation Instructions

In this mpe installation, no switches or flags are required. The configure in the top-level mpich directory will gather the necessary information and pass it to the configures in the mpe and jumpshot directories. If no switches and flags are given, then the mpe library and the graphical tool jumpshot will be automatically configured. However, the user can choose to override this by configuring MPICH with the following options:

     -mpe_opts=MPE_OPTS 

     -jumpshot_opts=JUMP_OPTS 

where MPE_OPTS is one or more of the choices in Section Configure Options , and JUMP_OPTS is one of the options in Section Configure Options . Multiple uses of -mpe_opts is allowed to specify several options for the MPE configure.

Example 1:
Configure MPICH with the mpe library and jumpshot
     In the top-level mpich directory, 

1) ./configure <mpich options>

2) make

Example 2:
Configure MPICH with tcldir and tkdir given as options to the mpe configure
     In the top-level mpich directory, 

1) ./configure <mpich options> \ -mpe_opts=--with-tcldir=<path of tcldir> \ -mpe_opts=--with-tkdir=<path of tkdir>

2) make

Example 3:
Configure MPICH, the mpe library, and jumpshot with an install directory
     In the top-level mpich directory, 

1) ./configure <mpich options> -prefix=<install directory>

2) make

This is useful if you wish to install mpich, the mpe library, and jumpshot in a public place so that others may use it. To install all 3 packages into the install directory, type
         make install 

in the top-level mpich directory.

Example 4:
Configure MPICH with the mpe library and without jumpshot
     In the top-level mpich directory, 

1) ./configure <mpich options> -mpe_opts=--enable-jumpshot=no

2) make

The jumpshot configure is invoked through the mpe configure. Thus, the way in which to disable the configuration of jumpshot is through a configure option to the mpe configure. Refer to section Installation Instructions for instructions on how to install jumpshot separately.

Example 5:
Configure MPICH without the mpe library and jumpshot
     In the top-level mpich directory, 

1) ./configure <mpich options> -nompe

2) make

It should be noted here that after mpich is configured, it is possible to configure the mpe library and jumpshot without reconfiguring mpich. Or, if mpich needs to be reconfigured, there is often no need to reconfigure the mpe library or jumpshot.



Up: MPE Installation Instructions Next: Configure the mpe library as part of an existing MPI implementation Previous: MPE Installation Instructions


Configure the mpe library as part of an existing MPI implementation


Up: MPE Installation Instructions Next: Example MPE Programs Previous: Configure the mpe library as part of the mpich configure and make process

In this mpe installation, a specific MPI implementation switch is necessary. Also, if the MPI implementation is not MPICH, then the generic flag -libdir is mandatory.

Example 1:
Configure mpe with SGI's MPI and without jumpshot
     In the top-level mpe directory, 

1) ./configure --with-sgi -libdir=<directory path of libdir> or ./configure --with-sgi64 -libdir=<directory path of libdir>

2) make

By not specifying --with-jumpshot_home (and not using MPICH), jumpshot does not get configured.

Example 2:
Configure mpe with IBM's MPI and jumpshot
     In the top-level mpe directory, 

1) ./configure --with-sp -libdir=<directory path of libdir> \ --with-jumpshot_home=<directory path of jumpshot>

2) make

By not specifying -bindir=DIR, the jumpshot executable will be located in libdir/../bin. If specification of a particular bin directory is desired, then configure as follows:
    In the top-level mpe directory, 

1) ./configure --with-sp -libdir=<directory path of libdir> \ --with-jumpshot_home=<directory path of jumpshot> \ -bindir=<directory path of bindir>

2) make

Example 3:
Configure mpe with an existing MPICH implementation and with jumpshot
     In the top-level mpe directory, 

1) ./configure --with-mpich=<directory path of MPICH> \ --with-mpichdev=<library subdirectory for MPICH>

2) make

If your MPICH implementation has a mpich/jumpshot subdirectory, there is no need to configure with the option --with-jumpshot_home. If not, then this is a necessary configure option.

Example 4:
Configure mpe with SGI's MPI and pass options to jumpshot's configure
     In the top-level mpe directory, 

1) ./configure --with-sgi -libdir=<directory path of libdir> \ --with-jumpshot_home=<directory path of jumpshot> \ --with-jumpshot_opts=<jumpshot option>

2) make




Up: MPE Installation Instructions Next: Example MPE Programs Previous: Configure the mpe library as part of the mpich configure and make process