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.
Stardust/Knowledge Base/Getting Started/Installation
Contents
Eclipse Update Site
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 which can be installed from the online update site. Currently the IPP plug-ins are only supported for the Eclipse version Eclipse Helios Sr2 (3.6.2). Please make sure to download exactly the version appropriate for your operating system.
After downloading, install Eclipse by unzipping 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.
Help > Install New Software...
In the dialog box, click Add ... to add the location of the update site. The URL is
[https://infinity.sungard.com/repository/ipp-eclipse-features/ https://infinity.sungard.com/repository/ipp-eclipse-features/]
Type the repository name you like it to be identified and click OK.
You will be asked for a login. Type in the credentials you used when registering at the Infinity Storefront: Your e-mail address and the password.
Select the components that you intend to use. If you are unsure, you can choose all. To be able to use the IPP Rapid Application Development environment feature, additionally select the category Web, XML and Java EE Development. Note: Select Engine Application Visual Rules Integration only if you need this functionality. In this case you have to select Visual Rules 5 RN36-201012152047 plug-in bundle as well, otherwise you will get an error. If you select IPP BPM Workbench 6.0.2, the Eclipse update mechanism installs all components. You then also have to
select Visual Rules 5 RN36-201012152047 plug-in bundle.
You see an overview of the selected plug-ins.
You have to accept all licenses to be able to continue.
The installation starts.
Once installation is finished, a dialog appears suggesting to restart, which you should do. The Process Workbench requires a license file to be present. To load it, select Preferences and go to the Infinity section. Type the path to the license file or click Browse to locate it. Click Apply or OK.
Turn to the integrated documentation to learn more about the Process Workbench. The included documentation for the Process Workbench can be found under the Help > Help Contents menu item and then selecting the chapter for Infinity Process Platform Documentation.
Enjoy using Infinity Process Workbench until you can use it as Stardust as an even more integral part of the Eclipse project!
Receiving Artifacts from the Maven Repository
Additionally to the Workbench Artifacts, Infinity provides the following artifacts and scripts:
- Runtime artifacts
- Client scripts
- Spring configurations
- Web artifacts like deployable archives and configuration snippets
- Infinity Scan
These components are available by the ipp-tools artifact. You can download this artifact directly from the artifactory from the following location:
https://infinity.sungard.com/repository/ipp-libs/com/infinity/bpm/ipp-tools/
or by an Ivy integrated Ant task as described in the following section.
- Retrieving the Artifacts via Ivy Integrated Ant Tasks
- Building your Work Environment via Ivy Integrated Ant Tasks
- Including Thirdparty Libraries
Retrieving the Artifacts via Ivy Integrated Ant Tasks
You can use Apache Ivy ant tasks to receive the artifacts and build your work environment. For details on using Ivy, please refer to the Apache Ivy Site.
You can use the following code snippets for the files needed to be configured:
ivy.xml
<?xml version="1.0" encoding="UTF-8"?>
<ivy-module version="2.0" xmlns:m="http://ant.apache.org/ivy/maven" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="http://ant.apache.org/ivy/schemas/ivy.xsd">
<info organisation="<organisation.name>" module="<ipp-client-tool>" revision="<x.y.z>" />
<configurations>
<conf name="ipp-tools" />
</configurations>
<dependencies>
<dependency org="com.infinity.bpm" name="ipp-tools" rev="" conf="ipp-tools->default">
<artifact name="ipp-tools" type="zip"/>
</dependency>
</dependencies>
</ivy-module>
|ivy-settings.xml
<?xml version="1.0" encoding="UTF-8"?>
<ivysettings>
<property name="ipp.m2.repository" value="https://internal.csa.sungard.com/artifactory" override="false"/>
<property name="default.ivy.cache" value="/.cache" override="false"/>
<caches>
<cache name="ipp-tools-ivy-cache" basedir="" useOrigin="true" />
</caches>
<resolvers>
<ibiblio name="ipp-releases" root="/ipp-libs" m2compatible="true" cache="ipp-tools-ivy-cache"/>
</resolvers>
<settings defaultResolver="ipp-releases"/>
</ivysettings>
build.xml
<?xml version="1.0" encoding="UTF-8"?>
<project name="retrieve-ipp-tools" default="retrieve-ipp-tools" xmlns:ivy="antlib:org.apache.ivy.ant">
<property name="ivy.install.version" value="2.2.0" />
<property name="ivy.jar.dir" value="/ivy" />
<property name="ivy.jar.file" value="/ivy.jar" />
<property name="ivy.settings.file" value="ivy-settings.xml" />
<property name="m2.server.host" value="internal.csa.sungard.com" />
<property name="m2.server.auth.realm" value="Artifactory Realm" />
<property name="m2.server.auth.username" value="<i>username</i>" />
<property name="m2.server.auth.password" value="<i>password</i>" />
<property name="ipp.version" value="latest.integration" />
<!-- Downloading ivy -->
<target name="download-ivy" unless="skip.download" description="Downloading ivy">
<mkdir dir=""/>
<get src="http://repo1.maven.org/maven2/org/apache/ivy/ivy//ivy-.jar" dest="" usetimestamp="true"/>
</target>
<!-- Installing ivy -->
<target name="install-ivy" depends="download-ivy" description="Installing ivy">
<path id="ivy.lib.path">
<fileset dir="" includes="*.jar"/>
</path>
<taskdef resource="org/apache/ivy/ant/antlib.xml" uri="antlib:org.apache.ivy.ant" classpathref="ivy.lib.path"/>
</target>
<!-- Setting up ivy -->
<target name="setup-ivy" depends="install-ivy" description="Setting up ivy">
<ivy:settings id="ivy.instance" file="">
<ivy:credentials host="" realm="" username="" passwd="" />
</ivy:settings>
</target>
<!-- Retrieving IPP Tools -->
<target name="retrieve-ipp-tools" depends="setup-ivy" description="Retrieving IPP Tools">
<ivy:resolve/>
<ivy:retrieve conf="ipp-tools" pattern="[artifact].[ext]" type="zip"/>
<unzip dest="." src="ipp-tools.zip"/>
</target>
</project>
Run the build file to retrieve the ipp-tools.zip archive. Please take care to use the right proxy settings in your Java environment.
Building your Work Environment via Ivy Integrated Ant Tasks
Unzip the downloaded or created ipp-tools.zip file.
After doing so, you find a ipp-ivy-cred.properties file in the etc folder. Open this file and set the appropriate user and password, e.g.:
m2.server.host = internal.csa.sungard.com m2.server.auth.realm = Artifactory Realm m2.server.auth.username = <i>username</i> m2.server.auth.password = <i>password</i>
All needed Ivy files are downloaded as well:
- ivy.xml - to declare the project's modules and dependencies.
- ivy-settings.xml - to configure artifact resolution.
- build.xml - to execute the ANT tasks for artifact resolution.
Now execute the ANT target retrieve-ipp-tools, which you find in the provided build.xml file.
All artifacts like documentation, runtime, client scripts etc., will be downloaded. To get an overview about the runtime dependencies, you can execute the ANT target report of the build.xml file. Per default, the latest integration is used to retrieve the appropriate version. Thus, you always get the latest version, that can be found in the repository. If you are interested in a specific version, you can either pass the version via a parameter, e.g.
<tt>-Dipp.version=6.0.2</tt>
or you can permanently store this parameter in the etc/build.properties file.
Including Third party Libraries
You need to set up a custom repository to include the following third party libraries:
- jai-imageio-1.1.jar - javax.media.group-id
- stax-ex-1.0.jar - org.jvnet.staxex
- streambuffer-0.4.jar - com.sun.xml.stream.buffer
In your ivy-settings.xml, add your custom repository in the resolvers section, e.g.:
<ibiblio name="ipp-nondistributable" root="/ipp-3rd-party-nondistributable" m2compatible="true" cache="ipp-tools-ivy-cache"/>
In the chain section, add a reference to this repository:
<chain name="pull-ipp-deps"> ... <resolver ref="ipp-nondistributable" /> ... </chain>
Upgrading and Downgrading Installed Features
You have the option to upgrade or downgrade installed features. The following sections describe the necessary steps to be performed:
Upgrading Features
To upgrade your installed features to a later version provided in the repository, perform the following steps:
- In the main menu, select Help > Check for Updates.
- The Available Updates dialog opens. Select the updates you like to install. In the Version column, the newest version to update to is displayed.
- Review and confirm your selected updates and click Next.
- Accept the license and select Finish.
- Restart Eclipse.
If upgrading to a new version in an already configured environment, also take care to perform the necessary steps to upgrade your Web project and model accordingly, as described in chapter Upgrading to Later Versions.