PCM Development/Getting Started

From SDQ-Wiki
Jump to: navigation, search

Useful hints on PCM development

Getting Started

This article gives initial information of how to change the PCM Bench implementation (Either develop new features for the PCM, fix bugs or change things).
The Palladio sources are managed in a Subversion system and we recommend to use the Subversive Eclipse plugin to access the sources. (Subversive Installation Guide)

The three basic option to work with Palladio code are:

  1. Working with a PCM Installation (recommended)
  2. Working with Source Code Only (Materialise Palladio Core using Buckminster Feature)

Working with a PCM Installation

  1. Install the PCM Nightly as described at PCM_Installation#PCM_Nightly
  2. Only check out and open projects (plugins) you want to change
    • Background information: Installed Eclipse plugins are overwritten by compiled plugins in the Eclipse workspace when compiling and running your changed project code (see below)
  3. Select "Run as Eclipse application"
    • All opened plugin projects will be compiled and integrated in the started Eclipse.
    • Switch to the Java perspective to see the run configuration.

Working with Source Code Only

The following description applies to working with the source code under Eclipse Luna.

As an alternative to installing the PCM and some source code (as described at PCM_Installation#PCM_Nightly), you might want to omit the PCM installation and check out the whole source code instead. This is useful if you want to avoid any incompatibilities between installed and checked out PCM plugins, or if you want a full overview over all source code affected by your change. Proceed as follows:

  1. Install Eclipse Mars Modeling Edition
  2. Install required Eclipse Projects features:
    1. Select Help -> Install new software -> Work with: "Mars - http://download.eclipse.org/releases/mars/"
    2. Install the following features (select "group items by category" first):
      • Collaboration/Subversive SVN Team Provider (minimum requirement to access the SVN Code Repository)
  3. TODO: Add details about Buckminster materialization

Instructions on how to "materialize" Buckminster components: [1]

The Palladio Core Buckminster Feature (incl. the required "CQUERY" file) is located in the following SVN: [2]


  1. Read-only checkouts from SVN are possible using anonymous / anonymous credentials.
  2. If you contribute new code or code changes you have to use your personal credentials for commits and you have to posess the corresponding rights.
  3. This checkout takes about 15-20 minutes, so you might want to do this during your lunch break
  4. If any of the projects reports an error after checkout try right click -> validate
  5. Ensure that your project is configured to UTF-8 file encoding

Creating PCM model elements from code

You can instantiate one of the model factories, and then use this factory to create model elements defined in the meta model. see Example PCM Model Factories for an example project.

  • de.uka.ipd.sdq.pcm.repository.RepositoryFactory (for repositories, components, interfaces, roles)
  • de.uka.ipd.sdq.pcm.resourcetype.ResourcetypeFactory (for abstract resource types, such as processing or communication resources)
  • de.uka.ipd.sdq.pcm.seff.SeffFactory (for resource demanding service effect specifications)
  • de.uka.ipd.sdq.pcm.system.SystemFactory (for system containers)
  • de.uka.ipd.sdq.pcm.usagemodel.UsagemodelFactory (for user behaviour)
  • ...

Code Overview

If you want to find specific PCM plugins, check the PCM_Code_Overview to find our in which folder in the SVN the plugin is located.


A list of the used Licenses in PCM.

See also

Background: Eclipse Plugins, Features and Extension Points