contents

software

data

java models

Java

To run java programs you must first install a java interpreter for your hardware. There are local copies of interpreters for windows and linux. For ports to other platforms consult www.javasoft.com.

Java comes either as the Java Development Kit (JDK) which includes everything for developing your own software or as the Java Runtime Environment (JRE) which is for running java programs but does not include a compiler. Only the JRE versions are included here.

Linux

Your distribution of linux may well have java installed already. if which java and which jre return a blank, you don't have it. If you do have it, but it is an older version than 1.1.7 (type java -version) you should also install an more recent one. There are so many problems running catacomb with pre-1.1.7 interpreters that it is not worth the trouble. However, tests with a more recent release of version 1.2 for linux showed it to be painfully slow running catacomb (ten times slower than the 1.1.7 interpreter). All in all, for running catacomb the 1.1.7 port from www.blackdown.org seems hard to beat. The only possible problem is that it requires libc2.1 or later. You can check your version with ls /lib/libc-2.*. To use this version of the JRE it should say /lib/libc2.1...

To install it: copy the file jdk_1.1.7-v3-glibc-x86.tar.gz to the directory in which you want it installed, say /usr/local; change to that directory and unpack it -
cd /usr/local
gunzip jdk_1.1.7-v3-glibc-x86.tar.gz
tar xvf jdk_1.1.7-v3-glibc-x86.tar

Then read the usage instrucions (README.Linux) in the newly created jdk117_v3 directory. In general, this should amount to changing to the directory with the .jar file of the java program you want to run, putting the .jar file in your CASSPATH variable and running java. For example, to run catacomb try
CLASSPATH="./ccmb.jar"; /usr/local/jdk117_v3/bin/java catacomb.modeler"
or
setenv CLASSPATH ./ccmb.jar; /usr/local/jdk117_v3/bin/java catacomb.modeler"

For convenience, you can put the /usr/local/jdk117_v3/bin directory in your path.

In general, it is easiest to use a simple script to set the environment and run a java program - see the catacomb installation instructions for examples.

Windows 95/98/NT

The JRE comes as a self extracting archive. There are two versions here: 1.3 and 1.1.8. The 1.3 one is more recent but either will run catacomb and cvapp fine. One or the other may work better with any other java programs you use. If in doubt, try the first one (1.3).

Install either   j2re1_3_0-win.exe   or   jre-1_1_8_003-win.exe

After extracting the archive you will have an executable called java somewhere. To run cvapp, open a dos box, change to the directory where the cvapp.jar file is and run
  java -jar cvapp100.jar cvapp
or
  java -cp cvapp100.jar cvapp

In general, it is easiest to use a simple batch file to set the environment and run a java program - see the catacomb installation instructions for examples.