GAMA 1.7 comes in 5 different versions (32 & 64 bits for Windows & Linux, and 64 bits for MacOS X). You first need to determine which version to use (it depends on your computer, which may, or not, support 64 bits instructions, but also on the version of Java already installed, as the number of bits of the two versions must match). GAMA 1.8 only comes in 3 versions for the 3 environments (by default in 64 bits).
Table of contents
GAMA 1.7/1.8 requires that Java 1.8 be installed on your machine, approximately 200MB of disk space and a minimum of 4GB of RAM (to increase the portion of memory usable by GAMA, please refer to these instructions). Please note that GAMA is not considered as compatible with Java 1.9 and Java 1.10 as it has not been tested under these environments.
In some cases, "Archive utility.app" in MacOS may damage the files when extracting them from the zip or tar.gz archive files. This problem manifests itself by a dialog opening and explaining that the application is damaged and cannot be launched (see Issue 2082 and also this thread. In that case, to expand the files, consider using a different utility, like the free Stuffit Expander or directly from the command line.
MacOS Sierra has introduced a series of issues linked to the so-called "quarantine" mode (where applications downloaded from Internet prevent to use and update their internal components, such as the models of the library or the self-updating of the application). See this page for background information. To be certain that Gama will work, and until we find an easier solution, the installation should follow these steps:
- Download the GAMA zip file
- Unzip it (possibly with another archive utility, see above)
- Copy and paste
cd /Applicationsand hit return.
xattr -d -r com.apple.quarantine Gama.app/and hit return to remove the quarantine attribute
From now on, Gama should be fully functional.
Installation of Java
On all environments, the recommended Java Virtual Machine under which GAMA has been tested is the one distributed by Oracle (http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html). Please make sure to install the JDK (Java Development Kit) and not the JRE (Java Runtime Environment). GAMA may work with the standard JRE, although it will be slower and may even crash (esp. under MacOS X).
The latest version of GAMA requires a JVM (or JDK or JRE) compatible with Java 1.8 to run.
Note for GAMA 1.6.1 users: if you plan to keep a copy of GAMA 1.6.1, you will need to have both Java 1.6 (distributed by Apple) and Java 1.8 (distributed by Oracle) installed at the same time. Because of this bug in SWT (https://bugs.eclipse.org/bugs/show_bug.cgi?id=374199), GAMA 1.6.1 will not run correctly under Java 1.8 (all the displays will appear empty). To install the JDK 1.6 distributed by Apple, follow the instructions here : http://support.apple.com/kb/DL1572. Alternatively, you might want to go to https://developer.apple.com/downloads and, after a free registration step if you're not an Apple Developer, get the complete JDK from the list of downloads.
Please notice that, by default, Internet Explorer and Chrome browsers will download a 32 bits version of the JRE. Running GAMA 32 bits for Windows is ok, but you may want to download the latest JDK instead, in order to both improve the performances of the simulator and be able to run GAMA 64 bits.
- To download the appropriate java version, follow this link: http://www.java.com/en/download/manual.jsp
- Execute the downloaded file
- You can check that a Java\jre8 folder has been installed at the location C:\Program Files\
In order for Java to be found by Windows, you may have to modify environment variables:
- Go to the Control Panel
- In the new window, go to System
- On the left, click on Advanced System parameters
- In the bottom, click on Environment Variables
- In System Variables, choose to modify the Path variable
- At the end, add ;C:\Program Files\Java\jre8\bin (or jre8\bin)
On Ubuntu & Linux
To have a complete overview of java management on Ubuntu, have a look at:
- Ubuntu Java documentation
- for French speaking users: http://doc.ubuntu-fr.org/java#installations_alternatives
The Oracle JDK License has changed for releases starting April 16, 2019. The result is that it's now more complicated to install Oracle JDK on Unix system than before.
If you want to simplify the process, you can download GAMA with an embarked JDK. But keep in mind that this JDK should only be used to run GAMA-Platform.
Install the Oracle JDK 8
If you still want to install Oracle JDK 8 on your machine, heres some workaround :
See the troubleshooting page for more information on workaround for problems on Ubuntu.
Install the OpenJDK 8
/!\ WARNING /!\
OpenJDK is not the recommended way to run GAMA and is not (and won't be) supported.
We won't help you if you run in any trouble using this JDK.
Another solution will be to install OpenJDK, the free implementation under GNU General Public License.
If you use a Debian based OS (Ubuntu, Linux Mint, ...), you need to do:
sudo apt-get install openjdk-8-jdk
If you use an Arch based OS (Manjaro, Antergos, ...), you need to do:
sudo pacman -S jdk8-openjdk
If you use a Red Hat based OS (CentOS, Fedora, Scientific Linux ...), you need to do:
su -c "yum install java-1.8.0-openjdk"
You can then switch between java version using:
sudo update-alternatives --config java