Requirements: JRE or JDK 1.6 or better (java.com/download). (It is best to get the Sun-Oracle Java VM; Mesquite does not run on some third-party virtual machines.)
Instructions:
If you have an older version of Mesquite, you may want to delete it (by deleting Mesquite_Folder), so as to avoid getting confused as to what version of Mesquite is starting up. First, however, you may want to take from Mesquite_Folder/mesquite any third party packages (e.g., PDAP, TreeSetViz) before deleting the directory.
Extract all of the files from the tgz. You will see a Mesquite_Folder. Place this Mesquite_Folder where you want on your hard drive, though if it is in a folder that requires a password for you to modify, you may have problems updating in the future. The contents of Mesquite_Folder should be approximately as follows:
Mesquite_Folder
com/
corejava
documentation.html
edu/
examples/
images/
jars/
lesser.txt
lib/
mesquite/
org/
mesquite.sh
settings/
README-Starting Mesquite on Linux.txt
To start Mesquite, execute the mesquite.sh script from the command line:
./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 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:
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:
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:
Mesquite installation for UNIX/LINUX
Requirements: JRE or JDK 1.6 or better (java.com/download). (It is best to get the Sun-Oracle Java VM; Mesquite does not run on some third-party virtual machines.)Instructions:
To start Mesquite, execute the mesquite.sh script from the command line:
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 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: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:
Depending on your configuration, you may need to give the explicit path to the java virtual machine, as in:
If you've changed the name of Mesquite_Folder to, for instance, "Mesquite2", you may need to use a command like:
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:
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):
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:
More details of issues of using Mesquite under Linux/UNIX are described in the Bugs and Troubleshooting page.
(Please email us at info {at} mesquiteproject.org) with questions or comments about downloading Mesquite).