Installing as an Eclipse Extension

Apollo for Eclipse may also be added as an extension to the Eclipse IDE. It requires some features to be installed to Eclipse in addition to the Apollo for Eclipse extension. The simplest way to do this is using Eclipse Europa, although you may also choose to install each part manually.

Additionally, you will need to consult the Eclipse documentation for the prerequisites that match your usage scenario and computer setup. The exact list of requirements for running Apollo for Eclipse as an extension can be found later in the section the section called “Install Eclipse Components Manually”.

Install Eclipse Components through Update Services

This is the standard Eclipse way of installing features, and is also an easy way to complete the installation. Gentleware recommends using this method of installation.

  1. If it is not already installed, install the Eclipse SDK 3.3.x (the current version as of the publication of this document is 3.3.0).

  2. Start Eclipse. From the Help menu, select Software Updates -> Find and Install...

  3. Select 'Search for new features to install' and click 'Next'.

  4. If it does not appear already, add the Apollo for Eclipse Update Site as a New Remote Site:

    -> New Remote Site
    -> Name = "Apollo for Eclipse Update Site"
    -> URL = "http://apollo.gentleware.com/updatesite/"
  5. Check the remote site, check "Ignore features not applicable for this environment", and uncheck "Automatically select mirrors". Click "Finish".

    Note

    Some of the mirrors for Eclipse plug-ins don't offer the same content as the original update site. Please be sure to use the original site: http://apollo.gentleware.com/updatesite/

  6. Open Apollo for Eclipse Update Site -> Apollo for Eclipse -> Apollo 3.0.

  7. Click "Select Required", then click "Next".

  8. Carefully read the license texts, then accept the licenses. Click "Next".

  9. Check Locations and click "Finish".

Eclipse Europa

There are three main steps to install Apollo for Eclipse. First an update is made through Europa, then the UML2 Eclipse project is installed, and finally Apollo for Eclipse is installed. The method described here works, but will install many more features than are required by Apollo for Eclipse and take up much more disk space than using the method described in the section called “Install Eclipse Components through Update Services”.

  1. Europa Installation

    1. If it is not already installed, begin by installing Eclipse SDK version 3.3 or higher. The download is available from 'Eclipse downloads home' on the Eclipse website. Simply download the zip file and extract them to a directory on your system.

      Note

      On Windows systems, it is not recommended to extract the files to the 'Program Files' directory. The white space in the file name may cause problems with some extensions or compilers.

    2. Start Eclipse. From the Help menu, select Software Updates -> Find and Install...

    3. Select 'Search for new features to install' and click 'Next'.

    4. Select the 'Europa Discovery Site' and click 'Finish'.

    5. The Update Manager will search for a list of mirror sites.

      Select the mirror nearest you and click 'OK'.

    6. Select the 'Europa Discovery Site' and click 'Next'.

    7. Accept the license agreements and click 'Next'.

    8. Click 'Finish' to install the components.

      The Update Manager will install the components.

      Shut down Eclipse after the installation is complete.

    9. In the Eclipse installation folder, create the file eclipse.ini if it does not exist. Add or edit the following in eclipse.ini:

      -vmargs
      -Xms64m
      -Xmx512m
      -XX:MaxPermSize=128m
  2. Install the UML2 Project

    1. Download the UML2 project uml2-SDK-2.1.0.zip from the Eclipse site.

    2. Extract the zip file to the Eclipse installation.

  3. Install Apollo for Eclipse

    1. Download Apollo for Eclipse Apollo_3.0.0.zip from the Gentleware website.

    2. Extract the zip file to the Eclipse installation.

  4. Start Eclipse.

Install Eclipse Components Manually

The third and least recommended option for installing Apollo for Eclipse is to install the required features manually. The table below lists the necessary features:

Table 2.1. Minimum Eclipse features required for Apollo for Eclipse

FeatureVersion Number
eclipse-SDK3.3
EMF Service Data Objects (SDO) SDK2.3
OCL SDK1.1.0
EMF Model Query SDK1.1.0
EMF Model Transaction SDK1.1.0
EMF Validation Framework SDK1.1.0
Graphical Editing Framework SDK3.3.0
Graphical Modeling Framework SDK2.0.0
Apache Batik1.6.0 (included in GMF-SDK)
UML2 SDK2.1.0

  1. Install all of the Eclipse features listed above.

  2. Download the UML2 project uml2-SDK-2.1.0.zip from the Eclipse site.

  3. Extract the zip file to the Eclipse installation.

  4. Download Apollo for Eclipse Apollo_3.0.0.zip from the Gentleware website.

  5. Extract the zip file to the Eclipse installation.

  6. Start Apollo for Eclipse.

  7. In the Eclipse installation folder, create the file eclipse.ini if it does not exist. Add or edit the following in eclipse.ini:

    -vmargs
    -Xms64m
    -Xmx512m
    -XX:MaxPermSize=128m