Carto Installation Instructions

Install Java using the instructions from Sun. The Java version number must be at least 1.4. Carto will not work with older versions.

Download the .zip file from the Download page. Unzip it into the directory where you want to install Carto.

Get a shell prompt (for windows this is a DOS window).
Go to the carto directory and type
java -Xmx64m -jar carto.jar
In place of the number 64 you can use the amount of actual memory installed on your computer.

The first time Carto runs it will create several files and directories.

version.txt - used by carto to keep track of which version was last installed, do not delete except when uninstalling carto.
persist.sta - a binary file containing your preferences. Delete this file to revert to defaults.
error.txt - Used to collect error messages for debugging.
gpl.txt - the licence under which carto is distributed.
symbol - directory for user defined symbols.
stamp - directory for mor user defined symbols.
fill - directory for user defined fills.
help - help window entries.

If you want to give the command from a different directory, use the appropriate path for the jar file, and add the arguments "-b basedirectory" where basedirectory is the directory where carto's files should be installed (you need to use the same directory each time carto is run). You may also add the name of a .cto file as the last argument. Carto will start with the named file open.

To upgrade to a newer verion, simply unzip the into the same directory.

When upgrading from versions older than 0.7.0 you may delete all .class files, the "icons" directory, fill.gif, and calibrate.smb.

The most common problem is for Java not to be instaled correctly. Make sure your PATH includes the java "bin" directory. Note that Carto requires Java2 (Version 1.2) or higher. Also note that Java2 is version 1.2 (but version 1.3 is not Java3). Some features may only work with version 1.4.

Versions older than 0.9.4 only have a carto.jar file. You just place that file in your carto directory.

Versions older than 0.7.0 have a different installation procedure.