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

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

(Install Stardust)
(111 intermediate revisions by 6 users not shown)
Line 1: Line 1:
== Introduction ==
+
== Installation Alternatives ==
  
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.
+
Installation of Stardust is performed by installing the corresponding Stardust Features and their required dependencies. These Eclipse Features include the  
  
You have several options to add the '''Stardust - Eclipse Process Manager''':
+
*Process Modeller,
 +
*the Rapid Application Development (RAD) environment and the
 +
*Report Designer Extension.
  
*'''Online Eclipse update site''' - This is a good choice if you:<br>- don't know what to choose<br>- have a reliable, fast internet connection<br>- only want to install on a single PC / environment<br>- want to check for updates frequently and intend to update to the latest and greatest version frequently<br>
+
You have several options to add the '''Stardust - Eclipse Process Manager''' Features and their dependencies to your Eclipse environment:
*'''Local Eclipse update site''' - This is a good choice if you:<br>- have a not so fast and reliable internet connection<br>- have an internet connection with high latency / response times<br>- want to install on multiple PCs / environments<br>- are going to check for updates less frequently or not via the built-in update mechanism<br>- may not always upgrade to the latest patch release<br>
+
*'''Install features as drop-ins''' - This is a good choice if you:<br>- know what you are doing<br>- are sure that you have the right Eclipse version with all required dependencies installed<br>- are familiar enough with the eclipse plug-in mechanism and know how to install missing dependencies if needed<br>- rather perform some steps in the file system than walk through the dialogs of the (local) Eclipse update site installation<br>- want to separate the new features from you Eclipse installation on file system level<br>- want to automate the installation for multiple environments
+
  
<br>
+
*'''Online Eclipse update site''' - This is a good choice if you:<br>- don't know what to choose<br>- have a reliable, fast internet connection<br>- only want to install on a single PC / environment<br>- want to check for updates frequently and intend to update to the latest and greatest version frequently<br>
 +
*'''Local Eclipse update site''' - This is a good choice if you:<br>- have a not so fast and reliable internet connection<br>- have an internet connection with high latency / response times<br>- want to install on multiple PCs / environments<br>- are going to check for updates less frequently or not via the built-in update mechanism<br>- may not always upgrade to the latest patch release<br>
 +
*'''Install features as drop-ins''' - This is a good choice if you:<br>- know what you are doing<br>- are sure that you have the right Eclipse version with all required dependencies installed<br>- are familiar enough with the eclipse plug-in mechanism and know how to install missing dependencies if needed<br>- rather perform some steps in the file system than walk through the dialogs of the (local) Eclipse update site installation<br>- want to separate the new features from you Eclipse installation on file system level<br>- want to automate the installation for multiple environments<br>
  
== Prerequisites ==
+
== Online Eclipse Update Site ==
  
What you need before '''Stardust - Eclipse Process Manager''' installation:
+
=== Install Eclipse IDE for Java EE Developers ===
  
#download and unpack to a location of your choice [http://www.eclipse.org/downloads/packages/eclipse-ide-java-and-report-developers/heliossr2 Eclipse IDE for Java and Report Developers]
+
*Go to [http://www.eclipse.org/downloads/ Eclipse download page] and download '''Eclipse IDE for Java EE Developers'''
#download and install local update site [http://subclipse.tigris.org/files/documents/906/49028/site-1.6.18.zip Subclipse 1.6.18]
+
*Download and unzip to your hard drive
  
If you need a step-by-step description on how to install eclipse and subclipse please continue&nbsp;'''here'''.
+
=== Install Stardust  ===
  
== Stardust - Eclipse Process Manager&nbsp;Feature Installation  ==
+
*'''Open''' context menu&nbsp;'''Help &gt; Install New Software...'''
 +
*Select '''"http://download.eclipse.org/releases/mars"''' from the dropdown box of "Work with"
 +
*'''Open '''the category '''SOA Development '''and '''Select&nbsp;'''all features for '''''"''Eclipse Process Manager ..."'''
 +
[[Image:Install-stardust-3.0.0.png]]
 +
*Select '''Next''' for the follow-up screens and accept the '''Eclipse License Agreement'''.
 +
*Select '''Finish''' - all Stardust components will be downloaded now. This may take 10-20 minutes depending on your network connection.
 +
*'''Restart''' Eclipse after installation has completed.
  
=== [[|]]Online Eclipse Update Site  ===
+
Congratulations! You are ready to use the Stardust Eclipse Process Manager.
  
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.<br>(See the introduction for other options).<br>
+
=== Next Steps  ===
  
#Go to: Help &gt; Install New Software...
+
Now you are ready to start the process modeler and configure the Rapid Application Development. Please consult the product documentation for further instructions.  
#Add a new remote update site named "Stardust" pointing to <u>''http://download.eclipse.org/stardust/nightly/''</u>
+
#Select the check box ''Eclipse Process Manager - Modeling''
+
#Confirm all possible follow-up screens
+
#Restart Eclipse after the installation has completed.
+
  
<br>
+
===== Product Documentation  =====
  
Screenshot: Selected plug-ins screen
+
Documentation for your first steps can be found under
  
[[Image:Update-site1.png]]  
+
*'''Help &gt; Help Contents''', select '''Stardust Online Documentation''' or
 +
*online at [http://help.eclipse.org/index.jsp?topic=/org.eclipse.stardust.docs.dev/html/toc.html http://help.eclipse.org/]
  
<br>
+
You may want to start with a first tutorial: the Support-Case Example&nbsp;[http://help.eclipse.org/index.jsp?topic=/org.eclipse.stardust.docs.dev/html/tutorial/support-case/support-case-preface.htm here].
  
Screenshot: Review screen
+
== Local Eclipse Update Site  ==
  
'''[[Image:Update-site2.png]]'''
+
=== Build Stardust from Source Code  ===
  
<br>
+
If you like to build Stardust, please download the source code and build Stardust as described [[Stardust/Source_Code|here]].
  
Screenshot: License Agreement screen
+
=== Install Local Eclipse Update Site (offline)  ===
  
'''[[Image:Installing Stardust via Eclipse update 07.png]]'''
+
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.&nbsp;The zipped complete Eclipse update site can be downloaded from the repository ([[Stardust/Download|see Downloads]]).&nbsp;Please note that the suffix of the archive name depends on the planned release version and a consecutively build number.
  
<br>
+
Or you want to install your locally build Stardust update.<br>  
  
Screenshot: Installation progress screen
+
#Open the context menu&nbsp;'''Help &gt; Install New Software...'''
 +
#Push '''Add''' button
 +
#Enter Name: Stardust local site and Location: &lt;YourLocalStardust.zipLocation&gt;
 +
#'''Select''' the check box '''Stardust - Eclipse Process Manager'''
 +
#Select '''Next''' for the follow-up screens and accept the '''Eclipse License Agreement'''.
 +
#Select '''Finish''' - all Stardust components will be downloaded now.
 +
#For your local builds, you may receive a warning that the software contains unsigned content, which you need to ignore.
 +
#'''Restart''' Eclipse after installation has completed.
  
'''[[Image:Update-site4.png]]'''
+
== Install Features as Drop-ins  ==
  
Once installation is finished, a dialog appears suggesting to restart, which you should do.<br>
+
Please refer to the Eclipse Platform Plug-in Developer Guide's section "[http://help.eclipse.org/index.jsp?topic=%2Forg.eclipse.platform.doc.isv%2Freference%2Fmisc%2Fp2_dropins_format.html The drop-ins folder and supported file layouts]".  
  
Turn to the integrated documentation or to the [https://infinity.sungard.com/documentation/stardust/index.jsp online documentation] to learn more about the Process Manager. The documentation for the Process Manager can be found under the '''Help &gt; Help Contents''' menu item and then selecting the chapter for '''Stardust Online Documentation'''.  
+
Remember start Eclipse using the parameter -clean after making modifications to the drop-ins folder.
  
Enjoy using Stardust Eclipse Process Manager!<br>
+
== Runtime Environment via Maven ==
 +
Please see [[Stardust/Knowledge_Base/Build_and_Change_Management/Maven/Basic_Setup|Maven section of the Knowledge Base]]
  
=== [[|]]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<br>[http://download.eclipse.org/stardust/nightly/stardust.zip http://download.eclipse.org/stardust/nightly/stardust.zip].<br>
+
== Product Documentation  ==
  
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.<br>
+
Documentation for your first steps can be found under
  
#Go to Help &gt; Install New Software...  
+
*'''Help &gt; Help Contents''', select '''Stardust Online Documentation''' or
#Add a new local update site "Stardust offline site" pointing to the location to which you have extracted the offlineSite.zip archive
+
*online at [http://help.eclipse.org/index.jsp?topic=/org.eclipse.stardust.docs.dev/html/toc.html http://help.eclipse.org/index.jsp?topic=/org.eclipse.stardust.docs.dev/html/toc.html]
#Select the created local update site and select Eclipse Process Manager
+
#Confirm all possible follow-up screens
+
#Restart Eclipse after installation
+
  
(see section "Online Eclipse Update Site" for more details)<br>
+
You may want to start with a first tutorial: the Support-Case Example [http://help.eclipse.org/index.jsp?topic=/org.eclipse.stardust.docs.dev/html/tutorial/support-case/support-case-preface.htm here].
 
+
=== [[|]]Install Features as Drop-ins (offline)<br> ===
+
 
+
Please refer to the Eclipse Platform Plug-in Developer Guide's section "[http://help.eclipse.org/helios/index.jsp?topic=%2Forg.eclipse.platform.doc.isv%2Freference%2Fmisc%2Fp2_dropins_format.html The drop-ins folder and supported file layouts]".<br>
+
 
+
Remember start Eclipse using the parameter -clean after making modifications to the drop-ins folder.
+
 
+
== <br>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:<br>
+
 
+
#In the main menu, select '''Help &gt; Check for Updates'''.
+
 
+
[[Image:Check-for-updates.png]]<br>
+
 
+
#The '''Available Updates''' dialog opens. Select the updates you like to install. In the '''Version''' column, the newest version to update to is displayed.
+
 
+
[[Image:Stardust Select-updates.png]]<br>
+
 
+
#Review and confirm your selected updates and click '''Next'''.<br>
+
#Accept the license and select '''Finish'''.
+
#Restart Eclipse.
+
 
+
<br>
+
 
+
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<br> ====
+
 
+
The Process Workbench is based on the [http://www.eclipse.org 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''' [http://www.eclipse.org/downloads/packages/eclipse-ide-java-and-report-developers/heliossr2 here] to avoid having to install additional missing plug-ins at a later point.<br>
+
 
+
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<br> ====
+
 
+
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 [http://subclipse.tigris.org/files/documents/906/49028/site-1.6.18.zip here], extract it to your local drive and install it into Eclipse from there.<br>
+
 
+
#In your Eclipse Go to: Help &gt; Install New Software...
+
#Add a new local update site named "Subclipse" pointing to the location to which you have previously extracted the Subclipse zip archive
+
#Select the newly created local update site "Subclipse" in the "Work with" selection<br>
+
#Select check the plug-ins as shown in the screenshot below
+
#Confirm all follow-up screens
+
#Restart Eclipse after installation
+
 
+
<br>
+
 
+
[[Image:Subclipse.png]]
+
 
+
<br>
+

Revision as of 04:58, 18 June 2015

Installation Alternatives

Installation of Stardust 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 Features 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

Online Eclipse Update Site

Install Eclipse IDE for Java EE Developers

  • Go to Eclipse download page and download Eclipse IDE for Java EE Developers
  • Download and unzip to your hard drive

Install Stardust

  • Open context menu Help > Install New Software...
  • Select "http://download.eclipse.org/releases/mars" from the dropdown box of "Work with"
  • Open the category SOA Development and Select all features for "Eclipse Process Manager ..."

Install-stardust-3.0.0.png

  • Select Next for the follow-up screens and accept the Eclipse License Agreement.
  • Select Finish - all Stardust components will be downloaded now. This may take 10-20 minutes depending on your network connection.
  • Restart Eclipse after installation has completed.

Congratulations! You are ready to use the Stardust Eclipse Process Manager.

Next Steps

Now you are ready to start the process modeler and configure the Rapid Application Development. Please consult the product documentation for further instructions.

Product Documentation

Documentation for your first steps can be found under

You may want to start with a first tutorial: the Support-Case Example here.

Local Eclipse Update Site

Build Stardust from Source Code

If you like to build Stardust, please download the source code and build Stardust as described here.

Install 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 (see Downloads). Please note that the suffix of the archive name depends on the planned release version and a consecutively build number.

Or you want to install your locally build Stardust update.

  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 Stardust - Eclipse Process Manager
  5. Select Next for the follow-up screens and accept the Eclipse License Agreement.
  6. Select Finish - all Stardust components will be downloaded now.
  7. For your local builds, you may receive a warning that the software contains unsigned content, which you need to ignore.
  8. Restart Eclipse after installation has completed.

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.

Runtime Environment via Maven

Please see Maven section of the Knowledge Base


Product Documentation

Documentation for your first steps can be found under

You may want to start with a first tutorial: the Support-Case Example here.

Back to the top