Skip to main content
Jump to: navigation, search

ATL/How Install ATL From CVS

Revision as of 03:25, 7 February 2008 by (Talk | contribs) (Import team project set)

Installation of ATL from CVS

Install Eclipse and EMF

In order to use ADT (ATL Development Tools), you need Eclipse and EMF. ADT has been developed with and for Eclipse 3.2.x. ADT may be compatible with other versions (we are currently testing it with Eclipse 3.3 and we do not find any specific issue for the moment). You can download Eclipse here: and EMF here:

Unzip the Eclipse zip file; this will create an eclipse directory with every Eclipse files in it.

Unzip the EMF zip file from the same directory (it also contains an eclipse directory, with the EMF additional files to Eclipse).

When you have finished to install Eclipse and EMF, you can run it.

Import team project set

ATL provides team project sets in order to simplify access to the source code. You have to download an atl.psf file on your local disk, and then you can import projects in Eclipse using : File > Import > Team > Team Project Set

Anonymous access

Anonymous access use pserver to connect on CVS. Hereare the two psf files.

Commiter access

Commiter access use extssh to connect on CVS. Hereare the two psf files.

ANTLR installation

In Eclipse, antlr is managed by the Orbit project. To checkout this plugin, follow those steps :

  • Open an anonymous/commiter CVS connection to, repository /cvsroot/tools
  • Right-click on the repository location, then choose "Refresh branches"
  • In the wizard, check the org.eclipse.orbit project
  • In the branches, select the one named v3_0_0
  • Checkout org.antlr.runtime

Note that the download of this plugin is embedded into atl.psf files.

MDR installation

In each psf/ subdirectory there are two .psf files :

  • atl.psf
  • mdr4atl.psf

The last one provides a project set which only contains the mdr4atl driver, you can use it as for atl.psf.

Now, you need to go to the Plug-in perspective. Some external libraries are required for the plug-in org.eclipse.m2m.atl.drivers.mdr4atl but not available on the CVS repository (a README file is available in this plug-in). You need to download the jar files into the lib/ directory of this project.

Download from and put the included jar files into lib/ of plugin org.eclipse.m2m.atl.drivers.mdr4atl.

Note that is updated more often on the MDR website than in our development source. As a consequence, bugs may appear when using the last-in-date mdr-standalone version of MDR.

When you have finished this operation, there is normally no error left.


ATL is ready to be tested. There are two ways to use it:

  • In the "Plug-in Development perspective", you can launch a Run-time workbench (Click on Run -> Run as -> Run-time workbench).
  • You can install ATL in your copy of Eclipse. Go in the Plug-in perspective and select all the plug-in projects. In the context menu choose Export -> Deployable Plug-ins and Fragments.

In the screen Export Plug-ins and Fragments, check if all the projects are selected and choose the output folder.

ATL PluginsExport.PNG

Now you need to close Eclipse. Enter the "eclipse" directory (which contains plug-ins and features directories) then copy the created Jar files into the "plugins" directory. After that you can restart Eclipse.

You are ready to use ATL.

Back to the top