Difference between revisions of "Stardust/Knowledge Base/Getting Started/Installation"

Revision as of 04:59, 10 October 2012

Introduction

To get started you need to install an Eclipse Helios including the required dependencies, Subclipse and the Stardust - Eclipse Process Manager features. These features include the process modeller, the rapid application development (RAD) environment and the report designer extension.

You have several options to add the Stardust - Eclipse Process Manager:

• Online Eclipse update site - This is a good choice if you:
  - don't know what to choose
  - have a reliable, fast internet connection
  - only want to install on a single PC / environment
  - want to check for updates frequently and intend to update to the latest and greatest version frequently
  
• Local Eclipse update site (offline) - This is a good choice if you:
  - have a not so fast and reliable internet connection
  - have an internet connection with high latency / response times
  - want to install on multiple PCs / environments
  - are going to check for updates less frequently or not via the built-in update mechanism
  - may not always upgrade to the latest patch release
  
• Install features as drop-ins (offline) - This is a good choice if you:
  - know what you are doing
  - are sure that you have the right Eclipse version with all required dependencies installed
  - are familiar enough with the eclipse plug-in mechanism and know how to install missing dependencies if needed
  - rather perform some steps in the file system than walk through the dialogs of the (local) Eclipse update site installation
  - want to separate the new features from you Eclipse installation on file system level
  - want to automate the installation for multiple environments

Prerequisites

What you need before Stardust - Eclipse Process Manager installation:

• download and unpack to a location of your choice Eclipse IDE for Java and Report Developers
• download and install local update site Subclipse 1.6.18

If you need a step-by-step description on how to install eclipse and subclipse please continue here.

Process Workbench Eclipse Feature Installation

Online Eclipse Update Site

After the installation of Eclipse and the Subclipse plug-ins the Process Workbench Eclipse features can be installed. This section describes how to do this using the online Eclipse update site.
(See the introduction for other options).

1. Go to: Help > Install New Software...
2. Add a new remote update site named "Stardust" pointing to http://download.eclipse.org/stardust/nightly/
3. Select the check box Eclipse Process Manager - Modeling
4. Confirm all possible follow-up screens
5. Restart Eclipse after the installation has completed.

Screenshot: Selected plug-ins screen

Screenshot: Review screen

Screenshot: License Agreement screen

Screenshot: Installation progress screen

Once installation is finished, a dialog appears suggesting to restart, which you should do.

Turn to the integrated documentation or to the online documentation to learn more about the Process Manager. The documentation for the Process Manager can be found under the Help > Help Contents menu item and then selecting the chapter for Stardust Online Documentation.

Enjoy using Stardust Eclipse Process Manager!

Local Eclipse Update Site (offline)

For one of the reasons mentioned in the introduction you may prefer to download the complete update site so you can use it as a local Eclipse update and install the Process Workbench Eclipse Features offline, possibly to multiple environments. The zipped complete Eclipse update site can be downloaded from the repository
http://download.eclipse.org/stardust/nightly/stardust.zip.

Download the zip file and extract it to your local disk. The installation of the right Eclipse version and of Subclipse as described in the section "Eclipse Installation" is still a pre-condition.

1. Go to Help > Install New Software...
2. Add a new local update site "Stardust offline site" pointing to the location to which you have extracted the offlineSite.zip archive
3. Select the created local update site and select Eclipse Process Manager
4. Confirm all possible follow-up screens
5. Restart Eclipse after installation

(see section "Online Eclipse Update Site" for more details)

Install Features as Drop-ins (offline)

Please refer to the Eclipse Platform Plug-in Developer Guide's section "The drop-ins folder and supported file layouts".

Remember start Eclipse using the parameter -clean after making modifications to the drop-ins folder.

Retrieving Artifacts from the Maven Repository

If you just want to get started quickly, create a process model and possibly use the rapid application development
(RAD) environment to execute it then you don't need this. In that case please continue with the 
"Where to go from here" section.

Additionally to the Process Workbench Eclipse features the following artifacts and scripts can be found in the Maven repository:

• Maven Archetypes - Generate Maven projects for different engine runtime, reporting runtime and client environments as well as for the administrative command line tools
  
• Runtime artifacts Used by Maven, Ivy or other rebuild tools to build runtime environments (WARs / EARs)
  
• Client scripts Used by Maven or Ivy to generate client environments for the command line tools
  
• Spring configuration files - Used by Maven, Ivy or other build tools to build Spring client and runtime environments
  
• Web artifacts like deployable archives and configuration snippets
• Infinity Scan component

The Maven archetype is defined in the archetype-catalog.xml.

The other artifacts can be download directly from the repository location https://infinity.sungard.com/repository/ipp-libs/com/infinity/bpm/ipp-tools 
or using Ivy integrated Ant tasks as described here.

We recommend to install the M2 Eclipse plugin which allows you to work comfortably with Maven from inside Eclipse. Starting with Eclipse 3.7 this plugin may already be shipped with your Eclipse installation.

Where to go from here

We suggest to have look at the training videos and the Tutorial in the product documentation.

Also go to the Stardust Knowledge Base to find How-Tos, API Cookbook, articles, advanced tutorials and more material that will help you to get your project running quickly.

Upgrading Installed Features

The installed Process Workbench Eclipse Features can be upgrade to a new version or downgraded to previously installed version. To upgrade your installed features to a later version provided via an update site perform the following steps:

1. In the main menu, select Help > Check for Updates.

1. The Available Updates dialog opens. Select the updates you like to install. In the Version column, the newest version to update to is displayed.

1. Review and confirm your selected updates and click Next.
   
2. Accept the license and select Finish.
3. Restart Eclipse.

If upgrading to a new version in an already configured environment you also need to perform the necessary steps to upgrade your Web project and process model(s) as described in the product documentation chapter "Upgarding to later Versions".

Eclipse Installation

The right Eclipse Version

The Process Workbench is based on the Eclipse Platform and consists of the combination of the basic Eclipse platform and a number of plug-ins. Currently only Eclipse Helios Service Release 2 (Eclipse 3.6 SR2, build 20110218-0911) is supported. Please make sure to download the appropriate version for your operating system. It’s strongly recommended to download the bundle Eclipse IDE for Java and Report Developers here to avoid having to install additional missing plug-ins at a later point.

After downloading, install Eclipse by extracting it into a target folder of your choice. Start the Eclipse application. When the Eclipse IDE opens for the first time you are presented with a Welcome screen, which you may close.

The Subclipse Plug-ins

The Collaborative Modeling feature requires Subclipse 1.6.18. The fastest and most stable way to install Subclipse plug-ins is to download the local update site from here, extract it to your local drive and install it into Eclipse from there.

1. In your Eclipse Go to: Help > Install New Software...
2. Add a new local update site named "Subclipse" pointing to the location to which you have previously extracted the Subclipse zip archive
3. Select the newly created local update site "Subclipse" in the "Work with" selection
   
4. Select check the plug-ins as shown in the screenshot below
5. Confirm all follow-up screens
6. Restart Eclipse after installation