Installing Repast Simphony in Linux – Step by Step

24 Mar

Published on: March 24, 2013
Last Modification: April 28, 2013

Unfortunately the IT department of my University decided to change my Operating System from a Gnome 32-bits to a 64-bits version. Thanks to that Eclipse did not work anymore and I had to install all the software again in the corresponding 64-bits version. As a revision of the process I am going to show step by step how to do it based on the information given in the official page of Repast Simphony.

First of all we should find the proper version of Eclipse. In my case I know that Helios works fine. Since is an older version I am going to run it locally and not to install it from the package manager. I downloaded and decompressed the corresponding package for linux (in my case the 64-bits version) in a folder where I store all the software installed locally.


Once this is done, we should install the following plug-ins and libraries:

  • Groovy
  • Eclipse XML Editors and Tools

In order to do that we need to start Eclipse: open the terminal and write ./eclipse. We can go to help/Check for updates to check if there is some piece of software to be updated.

We start with Groovy. If we try to download the plug-in directly from help/Eclipse Marketplace, we find that the only two available versions of this plug-in are for Eclipse Juno and Indigo (it is logic, the Helios version is rather old). Then we should install the code with the option help/Install new software, that it is a little bit more complicated because we need to provide to Eclipse the repository of Groovy for the Helios version. This information is given in the web page of Groovy:

We should copy this address, go to help/Install new software/Add and paste it into the location, as it is shown in the next image:


Once Eclipse retrieve the information of this repository, we should select two of these elements:

  • Extra Groovy compilers
  • Groovy-Eclipse


The next element to install in the same way is Eclipse XML Editors and Tools. In this case the repository is the following:

We add the repository Helios Update Site and we search the category Web, XML and Java EE Development and there we have the option searched. We click on it and we install the plug-in. Now we can install Repast Simphony with the same procedure. We take the link given in the instructions:

Go to Help/Install new Software and add the repository:


Apart from all of these plug-ins, we need to install three more components:

  • JOGL
  • Java3D
  • JAI

The JOGL library should be downloaded from . in this address they locate a series of zip files. We select the appropriate file according to our operating system (in my case and unzip the file in our file system. The next step is to include the files into the Repast project. This process can be done in different ways. I will show you the one that I normally use.

Go to the project/properties. In the section Java Build Path, we find several tabs. In the tab Libraries we are going to include our new library JOGL. In order to do that we should press the option add Library and select User Library as the type of new library to include in Eclipse.


and there we add a new library with the name JOGL.


Now a new empty library is included into the project. The next step consisted of adding the jar and the source files. In order to do that, we should select our new library and press the edit option, select user libraries and add jars button. Search for all the jar files (gluegen-rt.jar and jogl.jar) and add them.


Now we can see our library with the two jars included. In the next step the sources files are added to the library. In the same window, we can see the option Native Library Location (one in each jar file). We should edit both and inform Eclipse about the folder where the files with extension .so are located. Remember do this process for both jar files. 


The same procedure should be followed for the rest of libraries.  Java3D should be downloaded from:

We should create a user library and add the three jars (j3dcore.jar, j3dutils.jar, vecmath.jar) and include the location of its native library

Additionally to that, the last library to include is called JAI. The link to the library is the following one:

where we should select the file (in my case, unzip it and add the single jar file called jai_linux-amd64.jar to the project.

Once all the plug-ins and libraries have been added, we should add all the information to the classpath. We can access to the configuration of this environment variable through the menu Run/Run configurations.


Within the window we can distinguish some tabs. One of them is called Classpath. We select it and in User Entries we should press the button Add External JARs and add all the jars that we had add to the project before. One last thing, before running the project, remember refresh it.

Error: Repast Simphony Development Libraries is empty.

Once I tried to install Repast Simphony in my new laptop Ubuntu 12.04 64-bits as I did in other machines with similar configurations and surprisingly all the libraries of repast in the Java Build Path were missing. At the beginning I thought that was a problem of the classpath container (REPAST_SIMPHONY_SUPPORT) but at the end I found out that it was a problem of Groovy. More concretely about the refresh of the DSLD scripts.

In the case this happens to you, you only have to recompile the scripts:

Menu Window/Preferences/Groovy/DSLD and click “Recompile Scripts”

and be careful because if you work managing different workspaces you should do it again in each.


Posted by on March 24, 2013 in Agent-Based System, Eclipse, Repast, Repast Simphony


Tags: , ,

2 responses to “Installing Repast Simphony in Linux – Step by Step

  1. Aydar

    April 11, 2013 at 4:31 am

    Thank you for this tutorial, it was very helpful. I have something to add, after struggling some time I’ve found out that groovy have to be installed to the system via “sudo apt-get” first. I thought that it is just another plugin for Eclipse and couldn’t understand why it gives mistakes, took me a while to realise what I was doing wrong. I know it sounds stupid, but maybe this will help to save some time to someone =) Also Repast does not work with latest eclipse classic because it relies on different version of that bloody Groovy. Cheers!

    • Mato

      August 27, 2013 at 9:17 pm

      > after struggling some time I’ve found out that groovy have to be installed to the system
      Thank you. Turns out this was my problem as well.


Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Google+ photo

You are commenting using your Google+ account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )


Connecting to %s

%d bloggers like this: