Build MASON Toolkit

Build Core MASON Only

Inside the folder mason/mason:

mvn install

The output should say:

[INFO] BUILD SUCCESS

Build Everything

Inside the folder mason:

make -f makefile

The output of the package phase should be something like:

[INFO] Reactor Summary:
[INFO]
[INFO] mason 19 ........................................... SUCCESS [ 0.861 s]
[INFO] mason 19 ........................................... SUCCESS [ 6.339 s]
[INFO] distributed 1.0 .................................... SUCCESS [ 0.849 s]
[INFO] socialnets 1.0 ..................................... SUCCESS [ 0.259 s]
[INFO] Archetype - distributed-mason-project-archetype 1.0 SUCCESS [ 0.758 s]
[INFO] Archetype - mason-project-archetype 1.0 ............ SUCCESS [ 0.037 s]
[INFO] geomason 1.0 ....................................... SUCCESS [ 18.783 s]
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS\

Moreover, the building phase install in your local Maven registry two Maven archetype:

• mason-project-archetype, a MASON example project that execute the Flocker simulation.
• distributed-project-archetype, a Distributed MASON example project that execute the D-Flocker simulation.

Import in Eclipse

1. Clone the project on your local machine, and import the Maven project.

File-> Import -> Existing Maven Projects -> Root Directory

2. Build and Install on the mason-build project.

Run as -> Maven install

MASON/Distributed MASON Maven archetypes

We provide two different archetypes:

• mason-project-archetype, a simple MASON simulation project with all dependencies included.
• distributed-mason-project-archetype, a simple Distributed MASON simulation project with all dependencies included.

Create new MASON/Distributed MASON simulation in Eclipse

1. Create new Maven project.

File -> New -> Other -> Maven Project -> Next

2. Select the desired archetypes:

   • cs.gmu.edu.eclab.mason-project-archetype, for a new MASON simulation.
   • cs.gmu.edu.eclab.distributed-mason-project-archetype, for a new Distributed MASON simulation.

3. Continue following the instructions.

Execute MASON/Distributed MASON simulation

You can build your simulation using Maven. In your project folder:

$ mvn clean install 

The output of the build phase should be a jar-with-dependencies in the target folder.

You can run MASON simulation using:

$ java -jar sim-jar-with-dependencies.jar

While, you can run distributed simulation using MPI (OpenMPI, version greater than 4.0), with Java biding enabled. However, for debug purposes you can use a pre-configured Docker container: spagnuolocarmine/docker-mpi-java. Inside your project folder you can run:

$ docker run -v target:/data -it -t spagnuolocarmine/docker-mpi-java mpirun --allow-run-as-root -np 4 java -Xmx3G -jar /data/sim-jar-with-dependencies.jar

Know bugs

• The MPIUtil.java use a large pre-allocated buffer of 128 MB. In order to run in a docker container your applications you have to ensure a large amount of memory to your Docker demon, or you can reduce the size of this buffer.