RAMSES: Setting up a RAMSES Development Environment

Install Eclipse Oxygen

Install Eclipse Oxygen by following the instructions here: https://www.eclipse.org/downloads/packages/release/oxygen/3a/eclipse-modeling-tools.

Unzip and run the Eclipse executable.

Install necessary components


We need first to install Xtext. The version used by OSATE is 2.12, whereas the one provided by Eclipse Modeling Tools is currently 2.10. Click menu “Help >> Install New Software” and add the update site http://download.eclipse.org/modeling/tmf/xtext/updates/composite/releases/ as illustrated in the screen capture below:


Only select the feature called “Xtext Complete SDK” from Xtext repository :



Then, add the OSATE update site by clicking menu “Help >> Install New Software” and adding the update site http://aadl.info/aadl/osate/stable/latest/updates as illustrated in the screen shot below:


Select the following features in the screen shot below and complete the wizard using the defaults options.



We now install ATL and EMFTVM, which are used to transform aadl language. Go in the menu “Help >> Eclipse Marketplace…”. Research ATL, and install ATL and ATL/EMFTVM like following:



Click menu “Help >> Install New Software”, choose the Neon link, and select the plug-ins beginning with “Git Integration for Eclipse”:


Get the source code of RAMSES from git

Open the Git perspective by clicking “Window >> Perspective >> Open Perspective >> Other…” and select Git. On the left, you should have in a tab the option “Clone a git repository”. Click on it. In the URI area, add this address: https://gitlab.telecom-paristech.fr/mbe-tools/RAMSES.git.


Click on “Next”. Then, you can choose the branches to clone. There is two main branches in RAMSES: master for the stable version, and develop for the development.

Click again on “Next”. You can change the location of the git repository in your system by changing the “Directory” field. Click on “Finish”.

Now, import the Git project by clicking “File >> Import”.


Select “General >> Existing Projects into Workspace” and click on “Next”.


Select the folder where you cloned the repository, and click on open.

Select all existing projects and click on “Finish”.


Wait until « build workspace » finishes.

Launch an Eclipse Application with RAMSES

To run a test of the Eclipse Application, go in “Run >> Run Configurations…”. Create a new Eclipse Application:


We will rename this application “Test_RAMSES_Application”. Choose the osate product to launch:


Go in the “Plug-ins” tab. Select”plug-ins selected below only”. Remove the “Target Platform” selection and then click on “Add Required Plug-ins”:


Click on “Validate Plug-ins”. If there are missing plug-ins, add them manually in the “Target Platform” list until “Validate Plug-ins” doesn’t get any error.

Note: If there is the plug-in “org.eclispe.e4.ui.workbench.swt” which needs “osgi.extender”, just select the plug-in “org.eclipse.equinox.ds”. It should resolve this problem

Click on “Run”. It launches a new Eclipse Application but with OSATE and RAMSES installed on it.

To verify if the installation worked, test an example by following instructions on this link.