Downloading pi4soa

The pi4soa tools suite can be downloaded as a set of plugins for installation into an existing Eclipse environment:

• by downloading the plugins as a zip from the downloads area, and extracting the zip into the root of the Eclipse environment, or
• by using the pi4soa update site (see notes below): http://pi4soa.sourceforge.net/updates

Current development builds are available from: http://pi4soa.sourceforge.net/dev/updates. The working in progress release notes for the development build are here.

Dependencies

The principles dependencies are:

• JDK1.5+
• Eclipse Galileo(from http://www.eclipse.org) [ download the Eclipse Classic edition ]
• GEF (available from the Modeling category on the Galileo update site)
• EMF (available from the Modeling category on the Galileo update site)

Additional features may also require other dependencies:

• UML export feature requires the Eclipse UML2 plugins (available from the Modeling category on the Galileo update site)
• BPMN export feature requires the Eclipse SOA plugins (available from the SOA Development category on the Galileo update site)

Setting up a new Eclipse environment

To setup a new Eclipse environment, download the Classic edition of the Galileo version of Eclipse. Start the Eclipse environment, and go to the Help->Install New Software menu item. From the top level drop down list, select the Galileo update site. Then tick the top level 'Modeling' category, and the BPMN feature at the top of the 'SOA Development' category. Once these are selected, press the Install button and follow the instructions.

Using the pi4soa Update Site

An Eclipse update site is provided to enable existing Eclipse environments to update their pi4soa plugins directly, without having to manually download and install new versions of the plugins. To setup the pi4soa update site, go to Help->Install New Software, enter the URL (http://pi4soa.sourceforge.net/updates) and press the "return" key. This will cause the list of categories to be displayed.

Each category should be selected, and then press the "Next" button. When the list of features are displayed, the "Next" button should be pressed again to list the licenses. The 'I accept' radio button should be pressed followed by the "Finish" button. The features will then be installed. Follow the instructions when prompted to restart your Eclipse environment.

NOTE: If you select a component that has a dependency that is not present within your Eclipse environment, then an error message will be displayed preventing you from proceeding. You will need to install the required component before being allowed to install the new pi4soa feature.