ModelJoin/Installation

Aus SDQ-Wiki

This pages describes how to install the ModelJoin plugin for plain usage. If you're developing the plugin, please refer to ModelJoin/Setup.

As of now, the update sites for dependencies of the Eclipse Luna version are offline, so you cannot install the plugin. Please refer to the Eclipse Mars version for plain installation or use the Project Setup (for development).

Eclipse Mars

This section describes how to install the plugin under Eclipse Mars. Please note that although Eclipse Luna is recommended by the authors, it is currently only possible to install this version because of missing updates sites for Eclipse Luna (below).

Requirements

  • The plugin requires Java 1.8 at minimum. Check your version with java -version on the command line.
  • We advise you to use a clean Eclipse Mars.2 installtion with pre-installed Eclipse Modeling Tools. This version can be downloaded at [1].
  • To install the plugin, please download the update site archive first. Datei:Palladio-modeljoin-feature-mars.zip

Installing the plugin

The following instructions will explain how to install the ModelJoin plugin. To start the installation, open Eclipse with a new workspace. To install a new plugin, click Help - Install New Software in the menu. In the opened window, press Add... to add a new software site that provides plugin installation files. Add the following update sites which allow Eclipse to resolve the dependecies of the plugin:

Afterwards, do not install Palladio but simply click add again to add the actual plugin update site. To to this, click on Local... this time and find the unzipped directory containing the downloaded update site (see above). Give the update site a name, for example "ModelJoin Local", and click on OK to add the update site. Afterwards, you should see the Palladio ModelJoin category in the central list containing the actual plugin. If not, try to play around with the checkboxes at the bottom to find out what's wrong. Select the ModelJoin Plugin and start the installation process by clicking Next >. Agree on the displayed terms and conditions and finish the installation process by restarting Eclipse.

If something fails, please log the errors by screenshot and open $your_workspace$/.metadata/.log to see what went wrong. When submitting bugs, please include the full log from an installation on a clean eclipse installation with a fresh workspace.

Eclipse Luna

This section describes how to install the plugin under Eclipse Luna which is the Eclipse version recommended by the ModelJoin authors.

Requirements

The plugin requires Java 1.7 at minimum. Check your version with java -version on the command line. We advise you to use a clean Eclipse Luna installtion with pre-installed Eclipse Modeling Tools. This version can be downloaded at [2]. To install the plugin, please download the update site archive first.

Installing the plugin

The following instructions will explain how to install the ModelJoin plugin. To start the installation, open Eclipse with a new workspace. To install a new plugin, click Help - Install New Software in the menu. In the opened window, press Add... to add a new software site that provides plugin installation files. Add the Palladio Plugin by entering "Palladio" as a name and "http://sdqweb.ipd.kit.edu/eclipse/workflowengine/releases/2.0.3/" as the location. Afterwards, do not install Palladio but simply click add again to add the actual plugin update site. To to this, click on Local... this time and find the unzipped directory containing the downloaded update site (see above). Give the update site a name, for example "ModelJoin Local", and click on OK to add the update site. Afterwards, you should see the Palladio ModelJoin category in the central list containing the actual plugin. If not, try to play around with the checkboxes at the bottom to find out what's wrong. Select the ModelJoin Plugin and start the installation process by clicking Next >. Agree on the displayed terms and conditions and finish the installation process by restarting Eclipse.

If something fails, please log the errors by screenshot and open $your_workspace$/.metadata/.log to see what went wrong. When submitting bugs, please include the full log from an installation on a clean eclipse installation with a fresh workspace.

Next steps

After the installation process, you should be able to use the ModelJoin plugin as described in the examples. In summary, make sure that you can create an .mj file containing a ModelJoin query over a set of models from modeling projects in your workspace.