Jostraca version 0.4 is a Java application which should run without problems on all platforms with Java 1.2 or higher installed. Jostraca is made available under the terms and conditions of the GNU General Public License, see the file LICENSE.txt for details.

Quick Summary

1. Read README.txt
2. Unpack the distribution
3. cd into the distribution folder (jostraca-0.4.1)
   On Windows, run the command: setup
   On Unix, run the command: sh setup.sh
4. To check the installation, run the command: jostraca -check

Detailed Instructions

In these instructions, the term distribution folder refers to the root folder of the Jostraca distribution. This folder has the name jostraca-0.4.1 unless you have renamed it to say, jostraca.

1. Please read the README.txt file.
   
   
   
2. Unpack the distribution into a suitable folder on your system - somewhere that you store applications. For example, on Windows this might be C:\apps, on Unix this might be /usr/local. Avoid using awkward folder names like C:\Program Files that contain spaces and require quoting on the command line.
   
   To unpack the distribution,
   
   on UNIX:

   > tar -xvzf jostraca-0.4.1.tgz

   on Windows:

   Use WinZip or a similar utility to unzip jostraca-0.4.1.zip

   
   The distribution should now be located in a folder named jostraca-0.4.1. This is the root folder of the Jostraca distribution. You can rename this folder if you like.
   
   
   
3. At the command line, enter the distribution folder:

   > cd jostraca-0.4.1

   On Unix, run the setup.sh shell script:

   > sh setup.sh

   On Windows, run the setup.bat batch file:

   > setup

   This runs a setup program that tries to find a reasonable folder in your PATH for the jostraca.bat batch file or jostraca shell script. The output of the setup program shows what actions it performed.
   
   
   
4. Test the installation.

   > jostraca -check

   This should display the message:

   Jostraca Installation OK.

   if Jostraca is installed correctly.
   
   If your installation was not successful please refer to the documentation: doc/install-problems.htm.
   
   
   

Congratulations!

We hope you enjoy using Jostraca - for further resources, examples and help please visit the Jostraca web site: http://www.jostraca.org.

The best place to get started is the Getting Started Guide: doc/gettingstarted.htm

You can also find the FAQ here: doc/faq.htm