Jumpshot is distributed with 2 script files, jumpshot.in (for use with Java 1.1.*) and jumpshot12.in (for use with Java 1.2.*), which are located in the mpe/viewers/jumpshot-2/bin subdirectory. The purpose of these script files is to set the CLASSPATH variable before invoking jumpshot. In order to set the CLASSPATH varible, the variables JAVA_HOME and JUMPSHOT_HOME must be determined. The role of configure in the jumpshot directory is to determine these variables, substitute them into the appropriate .in file, create the executable jumpshot or jumpshot12, and place it in the appropriate bin directory. After setting your path to include this directory, you should be able to invoke jumpshot from any directory by typing
jumpshotor
jumpshot <name of clog file>
Jumpshot can be configured in 3 ways:
./configure --helpin the top-level jumpshot directory, a list of flags/switches can be viewed.
Mandatory configure flags/switches:
As noted above, jumpshot can be installed as part of mpich's configure, mpe's configure, or by itself. Below is the instructions and examples for each type of installation.
Configure jumpshot as part of the mpich configure. In this jumpshot installation, no switches and flags are required.
The configures in the mpich and mpe directories will locate
the necessary information and pass it to the configure in the jumpshot
directory. If no options are given to the configure in the mpich
directory, jumpshot will be configured with the default values. The
user can choose to override this by configuring mpich with the
following options:
-mpe_opts=MPE_OPTS -jumpshot_opts=JUMP_OPTSwhere JUMP_OPTS is one of the choices in Section Configure Options (multiple uses of -jumpshot_opts is not allowed to specify more than one option for jumpshot's configure). See Section Configure Options for MPE_OPTS.
In the top-level mpich directory,
./configure <mpich configure options> make
In the top-level mpich directory,
./configure <mpich configure options> -nompe makeIn the jumpshot subdirectory,
configure --with-bindir=<directory path of mpich/bin> \ --with-jumpshot_home=<directory path of jumpshot>
In the top-level mpich directory,
./configure <mpich configure options> \ -jumpshot_opts=--with-jumpshot_opts=--with-java=<directory path of java> makeIt is necessary to include --with-jumpshot_opts since mpich's configure will strip off -jumpshot_opts and mpe's configure will strip off --with-jumpshot_opts and pass the option to jumpshot's configure.
In the top-level mpich directory,
./configure <mpich configure options> \ -jumpshot_opts=--with-jumpshot_opts=--with-jumpshot_home=DIR make
Configure jumpshot as part of the mpe configure
In the top-level mpe directory,
./configure --with-mpich=<top-level directory of MPICH> \ --with-mpichdev=<library subdirectory of MPICH> make
In the top-level mpe directory,
./configure --with-sgi -libdir=<directory path of libdir> \ --with-jumpshot_home=<directory path of jumpshot> make
In the top-level mpe directory,
./configure --with-sp -libdir=<directory path of libdir> \ --enable-jumpshot=no make
In the top-level mpe directory,
./configure <MPI implementation switch> \ --with-jumpshot_opts=--with-java=<directory path of java> make
Configure jumpshot by itself
In the top-level jumpshot directory,
./configure -bindir=<directory path of bindir> \ --with-jumpshot_home=<directory path of jumpshot>
In the top-level jumpshot directory,
./configure -bindir=<directory path of bindir> \ --with-jumpshot_home=<directory path of jumpshot> \ --enable-echo=yes
The corresponding visualization tools for slog files is called jumpshot-3 which is located in mpich/jumpshot-3.
Building jumpshot-3:
cd to $(MPICH)/jumpshot-3 and type configure at the command line. If either configure returns an error that it could not find a valid version of Java or you would like jumpshot-3 to be configured with a particular version of Java. Do
./configure --with-java=/homes/chan/java/jdk117_v3and then type
makecd to $(MPICH)/jumpshot-3/bin to see if the executables jumpshot and slog_print are there. slog_print is the script to run the SLOG Java API to print the information in the logfiles. jumpshot is the script to run the jumpshot-3 visualization tool to display slogfile.
If you have any questions, send them to mpi-bugs@mcs.anl.gov.