MEGAF v1.0.0 Readme

This document is about MEGAF v1.0.0: an Eclipse-based tool providing
an infrastructure for realizing architecture frameworks and architecture descriptions.

MEGAF v1.0.0 is a prototype supporting the definition of a megamodel for defining architecture framework and
architecture descriptions. It allows inter-model navigation at both the model and model-element level,
checking architect-defined OCL constraints.
The set of generic OCL constraints (such as the one checking if an architecture framework conforms to the
ISO/IEC 40210 standard) and the customized AM3 editing pages for architectural elements are still work-in-progress.
Next MEGAF release will provide these features.   


MEGAF is based on the Eclipse platform (http://www.eclipse.org).
An already packaged Eclipse platform with all the plug-ins required by MEGAF can be found here:

http://docatlanmod.emn.fr/Eclipse_Bundles/AMMA_Prototype/AMMAPrototypeEclipse.zip

MEGAF can be installed either from its binaries or directly from its source code. Please, take
a look below for more details. 

---------------------------------------------------------------------

MEGAF Eclipse Plugin Binaries:

The installation of the MEGAF plug-in consists in the copy of the "org.eclipse.gmt.am3.platform.extension.gmm4sa_1.0.0.jar"
folder into the 'plugins' directory of your Eclipse platform.

The required plugins are:

ATL 2.0.0.v200806101117
AMW October 15th, 2007
AM3 0.4.0
AM3 Extension for Global Model Management 0.4.0
AM3 Extension for AMW 0.4.0
AM3 Navigability Extension 0.4.0


-------------------------------------------------------------------------------------------------------

MEGAF Eclipse Plugin sources:

This is a zipped archive of the Eclipse plug-in project of MEGAF. 

This project can be imported into an Eclipse framework performing the following steps:

1) extract the archive in any directory (say C:\downloads);
2) run Eclipse;
3) click on File->import...->Existing project into workspace and select the directory C:\downloads;
4) select the listed Plug-in project and click OK.

The required plugins are listed in the plugin.xml definition file stored into this archive.

-------------------------------------------------------------------------------------------------------
-------------------------------------------------------------------------------------------------------

How to run a MEGAF case study:

Each MEGAF use case can be downloaded from the Downloads section of the MEGAF website: http://megaf.di.univaq.it/downloads.html

For the sake of simplicity, in the following we will refer to a very basic case study we developed
as a testing artifact while developing MEGAF: SBSCS.
Anyway, the procedure to run a MEGAF case study is the same for every case study.

The provided zip archive (let's call it SBSCS.zip) contains all the required artifacts to experiment the MEGAF infrastructure.
In order to try the case study, a software architect has to:

1) install MEGAF (see above in this document) and launch the corresponding Eclipse platform
2) import all the projects contained into the SBSCS zip archive:
  a) extract the archive in any directory (say C:\downloads);
  b) run the Eclipse platform with MEGAF;
  c) click on File->import...->Existing project into workspace and select the directory C:\downloads;
  d) select all the listed projects and click OK.
3) copy the “megamodel.xmi” file of the “it.univaq.megamodel” project into the “.am3” folder of your workspace
4) restart Eclipse with this workspace.

Now all the needed artifact have been loaded into Eclipse and can be navigated, created, upadted, and so on.
First of all, the "AM3 Megamodeling" perspective must be open and all the required metamodels should be registered into
the EMF package registry; for doing this you have to:

1) for each “.ecore” file, right-click on the file and select “Register metamodel”.
2) click on Window->Open Perspective->Other...->AM3 Megamodeling

Now you can navigate the SBSCS megamodel by using the Megamodel Navigator view in the left-side view.

If you wish to navigate among architecture models and model-elements, you have to Activate Model Element Traceability
by clicking on its corresponding button. For further information on such a feature, please refer to its AM3 use case:
http://www.eclipse.org/gmt/am3/useCases/PetStoreNavigability/

OCL constraints are defined by means of ATL queries, so please refer to ATL documentation if you wish to evaluate OCL constraints in MEGAF:
http://www.eclipse.org/m2m/atl/doc/

------------------------------------------------------------------------------------------------------

More details and informations about MEGAF can be found in its web-site:
http://megaf.di.univaq.it/