PCM Installation

From SDQ-Wiki
Jump to: navigation, search

This page includes an detailled installation guide for the PCM tools. Note that our Eclipse-based tools currently support for Java EE and for the generation of prototype code skeletons only from PCM 4.0 onwards. Likewise, predictions with CAPRA (our process algebra) are so far not included in the downloadable PCM packages. In the Eclipse world, there is usually no separation between downloading a feature and installing it - all that is needed is a restart after features and their plugins have been downloaded.

Preconditions

Recent PCM releases need Java 1.8. Previous versions might work with older versions.

  • If Java is not yet on your computer: please visit http://www.oracle.com/technetwork/java/ and download the latest Java JDK release (SE aka Standard Edition) for your platform (install JDK and not the JRE, if possible)
  • Make sure ava is the default Java platform implementation on your platform (for example, on Windows, open a command-line window and type "java -version" into it, without the double quotes).

Installation Alternatives

Palladio is available in stable and unstable (nightly) versions:

We offer them as Eclipse Update Site as well as a drop bundled with Eclipse and the required dependencies. You can find installation instructions in the according sub-sections below.

All distributions are tagged with the date they have been compiled and packaged. Please pay attention to this versioning when downloading and installing PCM. Only one distribution of PCM should be installed into an Eclipse instance at the same time.

Install PCM Drop (Bundled with Eclipse)

After you have selected the PCM version you need, you can choose between two strategies for downloading PCM. The first "ready to go" strategy relies on drops, out-of-the-box installation packages of the PCM tools.

For versions before PCM 4.0, refer to Overview on Drops

Starting from PCM 4.0, there are nightly product builds available from Nightly PCM Product build. At the time of writing, the PCM product build is based upon Eclipse Neon the modelling edition.

Install from Update Site

PCM 4.1.0

The PCM 4.1.0 release is only available for Eclipse 4.6 (Neon) and Eclipse 4.7 (Oxygen).

  • Download the Eclipse Neon Modelling Package: http://www.eclipse.org/downloads/
  • Edit the eclipse.ini to change the memory settings to -Xms64m -Xmx2048m (optional)
  • Install Palladio from the update site: [1] (PCM 4.1.0 aggregated release update site)

PCM 4.0.0

The PCM 4.0.0 release is only available for Eclipse 4.4 (Luna) and Eclipse 4.5 (Mars).

  • Download the Eclipse Luna Standard or Modelling Package: http://www.eclipse.org/downloads/
  • Edit the eclipse.ini to change the memory settings to -Xms64m -Xmx2048m (optional)
  • Install Palladio from the update site: [2] (PCM 4.0.0 aggregated release update site)

PCM 3.5.0

This PCM 3.5.0 release is only available for Eclipse 4.3.

PCM 3.4.1

This PCM 3.4.1 release is only available for Eclipse 4.2.

PCM 3.4

This PCM 3.4 release is only available for Eclipse 4.2.

PCM 3.3.1

This PCM 3.3.1 release is only available for Eclipse 3.7.

PCM 3.3

This PCM 3.3 release is only available for Eclipse 3.7.

PCM Nightly

PCM nightly (currently > PCM 4.1.0) works only with Eclipse Neon

Other Update Sites

Depending on the version of the PCM, the requirements on the base Eclipse of the Update Site vary. Please consult the Release Sites or the extended overview on current and former Update Sites including old versions of the PCM to find out the requirements of each version.

Platform Specifics

Mac OS X

The PCM requires the usage a 64 bit version of Eclipse when used on Mac OS X systems (tested with 10.5.8).

  • Make sure that at least Java 1.6 is used to launch Eclipse
  • Later on, in the Workspace preferences sheet, you need to change the character encoding from MacRoman to ISO-88591 in order to make Xpand templates work.

Linux 64bit

Analogue to Mac OS X

Additional Packages

Installing R statistics tool for usage with PCM

The PCM tool suite with version 3.x and up supports further data visualization and analysis in conjunction with the statistics tool R. See R Statistics for PCM for detail.

Enabling LQN Solvers / LQN Simulations in PCM

For using LQN Solver or LQN Simulation in version >3.x, you need to install the corresponding plugins: cf. Install instructions for PCM2LQN

Example Files

Palladio provides a set of example projects to test and learn different aspects of the tooling. Detailed information about the available examples can be found here: Palladio Examples

Trouble Shooting

  • Check the PCM FAQ
  • update installed Eclipse features and plug-ins, especially PCM, EMF etc.
  • make a backup copy of the ".metadata" directory in your Eclipse workspace directory
  • try restarting Eclipse with -clean parameter
  • if clean restart did not help
    • delete the ".metadata" directory in your workspace and restart Eclipse
    • if that did not help, the problem is rather likely to be that of PCM; contact us and attach Java error stack, conditions, display screenshot(s) etc.
    • delete the .metadata directory and restore it to the backuped version
  • Install the latest stable version of the Java JDK