Mesquite installation for UNIX/LINUX

(Please email us at ) with questions or comments about downloading Mesquite).

Requirements: JRE or JDK 1.4 or better (java.sun.com). (It is best to get Sun's Java VM; Mesquite does not run on some third-party virtual machines.) See notes on the support page, especially regarding issues with window and dialog size and placement.

Instructions:

Download and decompress this file:

It will create a directory called "Mesquite_Folder" in which all the relevant files reside. To start Mesquite, execute the run_mesquite.sh script from the command line:

     ./run_mesquite.sh
This should automatically identify your java installation. If you have trouble, you may need to set your JAVA_HOME environment variable. In the uncommon case that you want a java VM to run Mesquite that is different from the VM identified in JAVA_HOME, you may set the MESQUITE_JAVA_HOME environment variable.

Once Mesquite has finished loading, go to the File menu to open a file.

If the current user directory is not the Mesquite_Folder, and Mesquite has not been run before, Mesquite may ask you to find the file "manual.html" which resides in the Mesquite_Folder/docs/mesquite/ directory. This will help Mesquite find and remember where its files are.

If run_mesquite.sh fails

In the event that the shell script fails, it may still be posible to run Mesquite manually. The main class file is mesquite.Mesquite. To start Mesquite you can use jre or java. For instance you could use:

     java -cp /home/myuser/Mesquite_Folder mesquite.Mesquite

where /home/myuser/Mesquite_Folder could be replaced by whatever is the path to the Mesquite_Folder. On some systems the java virtual machine is started by "jre" instead of "java", and thus the command would be:

     jre -cp /home/myuser/Mesquite_Folder mesquite.Mesquite

Depending on your configuration, you may need to give the explicit path to the java virtual machine, as in:

/usr/java/jre1.4.2/bin/java -cp /usr/local/Mesquite_Folder mesquite.Mesquite

If you've changed the name of Mesquite_Folder to, for instance, "Mesquite2", you may need to use a command like:

/usr/java/jre1.4.2/bin/java -cp /usr/local/Mesquite2 mesquite.Mesquite

If you've had to do all this because the shell script isn't working, please let us know what happened, and what you did to make Mesquite work. That way, we can make it easier for the next person.

Window Managers

Mesquite attempts to place windows in particular places on the screen for ease of use, using standard Java calls. Some window managers override this, resulting in haphazard placement of windows. You may need to change your window manager if this sort of thing is happening.

Virtual Machines & Ubuntu

If you are running Ubuntu 8.10 (other versions have not been tested but may have the same issue), your default JVM may be Open Java, which has some problems with font rendering/spacing. It is recommended that you use Sun's virtual machine. Java 6 can be installed with the Synaptic Package Manager (sun-java6-jre for running Mesquite, sun-java6-jdk if you are programming in Mesquite) or via the command line "apt-get install" process.

If you have multiple JVMs installed, you may need to edit the run_mesquite.sh file to instruct Mesquite where to look for the virtual machine. To do this, open run_mesquite.sh in a text editor and find the line:

     java="java"

Replace it (or comment it out, as below, using "#" and append it) with the absolute path to Sun's JVM (which may be different than the path listed below):

     #java="java"
     java="/usr/lib/jvm/java-6-sun-1.6.0.10/bin/java"

making sure to pay attention to spacing; the script may have problems if there is extra whitespace between "java" & "=". Alternatively, if you don't use the script, but would like to run Mesquite from the Terminal command line, just use the absolute path to the Java VM you prefer when starting Mesquite, as above:

     /usr/lib/jvm/java-6-sun-1.6.0.10/bin/java -cp /home/myuser/Mesquite_Folder mesquite.Mesquite

More details of issues of using Mesquite under Linux/UNIX are described in the Support page.


Copyright 2002-2009 W. & D. Maddison, T. Wheeler