Java requirements

MPE includes a viewers subdirectory, which is an independent package, includes 2 versions of Jumpshots, Jumpshot-2 and Jumpshot-3. Both need to be built with Java Development Kit (JDK), i.e. Java distribution that includes a Java compiler, javac. Theoretically, Jumpshots can be distributed with precompiled byte code instead of source code that needs to be compiled. The main reason is that there exists JDK which isn't compatible with Swing and one of the easiest ways to detect this problem is to compile and link the code to see if things are fine. We are still planning to distribute byte code in later version.

Jumpshot-2 and Jumpshot-3 are both developed based on Sun's JDK. Jumpshot-2 is developed based on Java1, JDK-1.1 and Swing-1.0.3. So it can only be built with JDK-1.1, not JDK-1.2 or later. On the other hand, Jumpshot-3 is developed based on JDK-1.1 and Swing-1.1.1, so it can be built by both Java1 and Java2, i.e. JDK-1.1 to JDK-1.4. It is recommended that user should use the latest Java1, i.e. JDK-1.1.8, to build Jumpshot-2, and use the latest Java2, i.e. JDK-1.4.x to build Jumpshot-3 for optimal performance when configuring MPE or mpich. Jumpshot-2 understands both configure options: --with-java and --with-java1 options. Jumpshot-3 understands --with-java and --with-java2 options. If only one version of JDK is installed, like JDK-1.1.8, --with-java option should be used. If both JDK-1.1.8 and JDK-1.4.x are installed on the machine, viewers package can be configured by defining --with-java1=<JDK-1.1.8> and --with-java2=<JDK-1.4.0>.

We will list the status of the JDK distributions on some of the popular UNIX platforms that we have tested and what is needed to build the JDK properly for Jumpshots.

Linux: There are many choices of JDKs for Linux running on Intel x86 processors. Blackdown.org has released many different versions of JDK for Linux on this platform, including both Java1 and Java2. You can download them by locating the closest FTP mirror site of http://www.blackdown.org, one of the popular download sites in US is ftp://metalab.unc.edu/pub/linux/devel/lang/java/blackdown.org/. Pick the JDK distribution that has the correct libc for your platform.

Sun also distributes JDK-1.2 and JDK-1.3 for Linux. Here are the URLs for download.

http://www.javasoft.com/products/jdk/1.2/download-linux.html
http://java.sun.com/j2se/1.3/download-linux.html.
http://java.sun.com/j2se/1.4/download.html.

As soon as the package is unpacked, it should be ready to compile Jumpshots.

Linux/alpha: Linux running on alpha processors has a limited choice of JDK. The only versions that have been tested to be able to compile Jumpshots is JDK-1.1.8 from alphalinux.org. Here are the URL:

ftp://ftp.alphalinux.org/pub/java/java-1.1/r2/jdk118\_RH60\_alpha\_bin\_21164\_v2.tgz

or

ftp://ftp.alphalinux.org/pub/java/java-1.1/r3/jdk118\_RH60\_alpha\_bin\_21164\_v3.tgz

Since the distribution does not come with the classes file, you need to download the classes file separately. The URL is

ftp://ftp.alphalinux.org/pub/java/java-1.1/r2/jdk118\_alpha\_classes\_v2.tgz

Since Jumpshots need file classes.zip, so after unzipped the file, be sure to do the following to generate the classes.zip.

        cd jdk118/classes 
        zip -0 ../lib/classes.zip * 

As opposed to JDK for Linux, libawt.so is dynamically linked instead of statically linked. So when running Jumpshot, it will complain about missing file libXm.so if your system doesn't have Motif installed. We installed Lesstif which seems to resolve this issue.

Bugs: The ``nesting'' of states in Jumpshot-3 does not yet work.

Solaris: We have tested JDKs as old as JDK-1.1.6 under Solaris, e.g. Solaris_JDK_1.1.6_03. *

IRIX64: We have tested JDK-1.1.6, JDK-1.1.7 and JDK-1.1.8 from SGI, they all seem to work fine with Jumpshots. JDK-1.1.8 seems to work best with Jumpshot on IRIX. You can download them at

http://www.sgi.com/developers/devtools/languages/java.html.

AIX: Only JDK-1.1.8 for AIX has been tested with Jumpshot. But newer JDK for AIX should work with Jumpshot. You can download it at

http://www.ibm.com/java/jdk/aix/index.html

HP-UX: HP distributes JDK for its HP-UX OS. None of JDK for HP-UX has been tested with Jumpshots because of lack of access to the platform. The URL for HP's JDK is:

http://www.unixsolutions.hp.com/products/java/index.html

Windows and X11: MPE has been ported (at least the logging part of it) to Windows, the Java requirement for running Jumpshot on Windows isn't an issue and the installation of Java on Windows is straight forward as well. However, many users use Windows desktops to access UNIX servers to run their MPI programs. They run Jumpshot remotely and display it back to their desktops through running X11 server locally. Let's assume SSH is used to connect to the UNIX servers. We notice that there are some incompatibilities between various X11 servers and different versions of JDKs. In particular, some versions of Exceed X11 servers when used with SecureCRT (a version of SSH) will crash when displaying Jumpshot-2 compiled with JDK-1.1.7 from Blackdown. Using SuperX instead of Exceed causes Jumpshot-2 to hang in this situation. We notice that using Cygwin's OpenSSH and XFree86 seems to avoid hangs and crashes. XFree86 has its strengths and weakness when compared to other commerical X servers. XFree86 seems to be slower when the desktop hardware is old and especially when Java 2 (JDK 1.3.1) is used. XFree86 performs remarkablely well when used with JDK 1.1 instead of JDK 1.3. The combination being tested is OpenSSH 3.0.1p1-4 and XFree86 4.1.