Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

Stardust/Knowledge Base/Getting Started/Installation

If you like to build Stardust, please download the source code and build Stardust as described here. Then follow the installation instructions for a local update site.

Prerequisites

Before you start the Stardust - Eclipse Process Manager installation you need to download and unpack Eclipse IDE for Java and Report Developers to a location of your choice.

If you need more information on eclipse installation please continue here.

Installation Alternatives

Installation of Stardust on Eclipse Helios is performed by installing the corresponding Stardust Features and their required dependencies. These Eclipse 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 Feaures and their dependencies to your Eclipse environment:

  • 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 - 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 - 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


Stardust - Eclipse Process Manager Feature Installation

Online Eclipse Update Site

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

  1. Open context menu Help > Install New Software...
  2. PushAdd button
  3. Enter Name: Stardust Online Site and Location: http://download.eclipse.org/stardust/nightly/
  4. Select the check box Eclipse Process Manager - Modeling
  5. Confirm all follow-up screens
  6. Restart Eclipse after installation has completed.


Screenshot: Selected plug-ins screen

Update-site1.png


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

Enjoy using Stardust Eclipse Process Manager!

Product Documentation

You can start with a first tutorial: Support-Case Example here.

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 Stardust - Eclipse Process Manager 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.

The installation of the right Eclipse version and of Subclipse as described in the section "Eclipse Installation" is still a pre-condition.

  1. Open the context menu Help > Install New Software...
  2. Push Add button
  3. Enter Name: Stardust local site and Location: <YourLocalStardust.zipLocation>
  4. Select the check box Eclipse Process Manager - Modeling
  5. Confirm all follow-up screens
  6. Restart Eclipse after installation has completed.
Product Documentation

You can start with a first tutorial: Support-Case Example here.

Install Features as Drop-ins

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.


Upgrading Installed Features

The installed Stardust - Eclipse Process Manager 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.

Check-for-updates.png

  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.

Stardust Select-updates.png

  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 "Upgrading to later Versions".

Eclipse Installation

The right Eclipse Version

The Stardust - Eclipse Process Manager 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.

Copyright © Eclipse Foundation, Inc. All Rights Reserved.