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

Xtext

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:

xtext_dl

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

Xtext_select

OSATE

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:

OSATE_dl_updatesite

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

OSATE_dl_plugins

ATL and EMFTVM

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:

ATL_install

Git

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

git_install

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.

git_clone

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”.

Image:Menu_File_Import.png

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

Image:Select_Import_Existing_Project.png

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

Select all existing projects and click on “Finish”.

Image:Select_All_Projects.png

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:

create_run

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

product_choose

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”:

plugins_selection

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.