Running instructions

After setting up your machine (see https://github.com/EMLab/emlab-generation/wiki/EMLab-and-Github), you can run EMLab-generation from within SpringSource or from a terminal. The basics are the same: the model is run using maven. SpringSource helps you to execute the necessary maven commands and view the output in the embedded console. The model is operated through the web browser either way.

From a terminal (linux, using shellscripts)

1. Open a terminal
2. Go to the emlab shellscript folder (e.g. cd ~/emlab-generation/shellscripts/)
3. ONLY ONCE AFTER INSTALLATION: create a "emlabConfig.cfg" file in the shellscripts-folder, based on the TEMPLATE_emlabConfig.cfg file (the file is commented by "#" at the beginning. For standard values if EMLab-Generation is installed in ~/emlab-generation remove these for the last 4 rows).
4. COMPILING: type "./compileModel.sh" and press enter in the terminal
5. Once per computer start-up: type "./makeRamdisk.sh" and press enter
6. RUNNING: type "./startModel.sh" and press enter. Wait until the terminal shows the following line "WARN Default agentspring url http://localhost:8080/agentspring-face/", than open a new terminal (or new terminal tab using CTRL+SHIFT+T) and type "./startAgentSpring.sh" to start Agentspring. Open your browser and go to "http://localhost:8080/agentspring-face/". The model (with ./startMode.sh can be stopped, compiled and restarted, without restarting Agentspring, as long as the process is running that was started using ./startAgentSpring.sh)
7. STOPPING: To stop any process in the terminal at any time press "CTRL+C"

From a terminal:

Setup and compile

1. Open a terminal.
2. Optional For fast runs you can use a ramdisk (mkdir /tmp/ramdisk and then sudo mount -t tmpfs -o size=512M tmpfs /tmp/ramdisk/). For Mac:

export MAVEN_OPTS="-d64 -server -Xmx2048m"
diskutil erasevolume HFS+ "ramdisk" `hdiutil attach -nomount ram://1165430`
ln -s /Volumes/ramdisk /tmp/ramdisk

1. Go into the emlab-generation folder. We assume the location is in the home folder. (cd ~/emlab-generation).
2. Compile and install AgentSpring (cd ~/emlab-generation/AgentSpring and mvn clean install). You only have to do this once.
3. Compile the model (cd ~/emlab-generation and mvn clean install).

Running

1. Start the model (cd ~/emlab-generation/emlab-generation and mvn exec:java). You should see a warning with the location to work with the model in your browser, which is http://localhost:8080/agentspring-face/
2. Open a second terminal
3. Run AgentSpring's interface (cd ~/emlab-generation/AgentSpring/agentspring-face and mvn jetty:run). You only have to do this again after restarting the computer. Leave this terminal running in the background.
4. Open your browser at http://localhost:8080/agentspring-face/ and have fun!
5. You can stop the model by pressing CTRL C (breaking the process) in the first terminal. Afterwards you can restart it there with mvn exec:java.

From within SpringSource:

Essentially, you need to start the same two processes as in the description above: one for the model and one for AgentSpring. I suggest to use SpringSource to run the model and a terminal to run AgentSpring and wrote the description accordingly.

Setup

1. Open a terminal.
2. Optional For fast runs you can use a ramdisk (mkdir /tmp/ramdisk and then sudo mount -t tmpfs -o size=512M tmpfs /tmp/ramdisk/)
3. Go into the emlab-generation folder. We assume the location is in the home folder. (cd ~/emlab-generation).
4. Compile and install AgentSpring (cd ~/emlab-generation/AgentSpring and mvn clean install). You only have to do this once.

Compile and run the model

1. Start SpringSource
2. Right-click on the EMLab-generation project in the package explorer, Run as, Maven build...
3. In Goals, type: clean install exec:java.
4. Optional once everything runs fine, you can select offline and skip tests to speed up the process.
5. Optional if you did not make changes to the code, you can omit the goals clean install to speed up the process even further. When doing the maven build, in Goals, type: exec:java.
6. You can break the process with the red stop button.

Run AgentSpring

1. Open a terminal
2. Run AgentSpring's interface (cd ~/emlab-generation/AgentSpring/agentspring-face and mvn jetty:run). You only have to do this again after restarting the computer. Leave this terminal running in the background.
3. Open your browser at http://localhost:8080/agentspring-face/ and have fun!