1. Get the maxdSetup.jar file...

Create a new directory called maxdSetup in your home directory

Download the current version of maxdSetup.jar into this directory.

2. Make sure you have Java installed...

maxdView requires Java version 1.2.2 or better.

If you are lucky, Java will be already configured on your machine...

Into a shell window (i.e. xterm or winterm or equivalent) type:

  java -version

A response similar to "java version 1.2.2" means that Java has been found. A response along the lines of "Command not found" means that Java cannot be found.

If Java has been found, and the version number is at least 1.2.2 then the installer can be started by typing:

  java -jar maxdSetup.jar

If the Installer starts then proceed directly to "Using maxdSetup".

If the java program is found, but the Installer does not run, then double check that you have typed the command line exactly as above. Make sure that the current working directory contains the maxdSetup.jar file.

If the java program cannot be found automatically then either it is not installed, or it is not in the path. The path is a list of places that are searched when programs are needed. If java is not in the path, then you will have to locate it manually.

The Java binary directory is the directory in which the Java programs are found. This is the directory that you need to find.

The location of the Java binary directory depends on which Java environment you have installed. Normally it is somewhere within one of /home/java, /usr/java or /usr/local/java.

Sometimes these java directories will contain a directory called jdk1.x or jre1.x. If either exists, the bin directory is likely to be found within it.

If you are unable to locate the Java binary directory, then Java is not installed in your machine. Take a detour here.

Once you have located the Java binary directory, and confirmed that it contains an executable "java" file, you are ready to proceed.

4. Start maxdSetup 'by hand'...

The installer application can be run directly from the JAR file in which it is distributed.

To run a Java program you need to know where the Java binary directory is (see above).

• Go to the directory in which you have downloaded maxdSetup.jar

  ~ % cd ~/bio/maxdSetup

  ( substitute your download directory for the red text )

• Run java to start the application

  ~/bio/maxdSetup % /opt/java/jdk1.2.2/bin/java -jar maxdSetup.jar

  ( substitute the Java binary directory for the red text)

Once the Installer starts, proceed to "Using maxdSetup".