Installation requirements: node.js

• First and foremost, Gama Server Middleware based on Node.js technology. It is imperative to install the latter via this link: https://nodejs.org/.

[!TIP] After installation, if the node command is not recognized in your environment variables, please run the commands below in the node.js console.

This step only needs to be carried out once during the first installation. After this step, you can launch the Middleware.

There are two comonents to launch: Gama Server and Gama Server Middleware

Launching Gama Server Middleware

• To start the middleware:

  • If you're using Windows: run start.bat, located in the project root directory.

  • If you're using MacOS: run start.sh, located in the project root directory.

  • If you're using Linux, for now the middleware doesn't work. Developers are working on this issue.

This execution also open a webpage localhost:app_port/monitor. If there is no display, please refresh this page. app_port is by default 8000.

[!CAUTION] When the middleware is launched, it opens several internet ports. If these ports are already occupied by another program, you'll see this in the console. To remedy this problem, you need to change the ports used in settings.json, and in particular change the problematic port.

[!TIP] In general, I suggest you take a look at settings.json to understand the global variables used by the middleware.

Launching Gama Server

You will also need to load Gama Server:

• If you have a recent version of Gama wich includes Gama Server GUI (GAMA 1.9.3+), you only need to launch GAMA.
• If you have an older version of GAMA, you will need to launch Gama Server. For more information see this documentation.

[!NOTE] To install Gama Server, go to Gama Platform

[!WARNING] You must have Gama 1.9.3+ version if you want to run Gama Server easily by just launching Gama. To check the version of Gama, go to Support > About Gama.

You can start Gama before or after the middleware

Launching an experiment

Before going further, you have tu understand how the launching simulation process works. This flowchart shows you the steps in order to launch a simulation in Gama Server using Gama Server Middleware. To get more information about the buttons of the monitor see the monitor webpage section