Stages Process Management for Rational Team Concert
(c) Method Park Software AG, Erlangen, Germany

This document describes the installation procedure of the Stages Process
Management for Rational Team Concert plug-in.


I. Installation Package Contents
================================

de.methodpark.rtc                    - the update site
build.xml                            - the Ant installation script
de.methodpark.rtc.profile.ini        - the provision profile template
README.TXT                           - this installation guide


II. Manual Installation
=======================

To install the Stages Process Management for Rational Team Concert plug-in, do
the following steps:

1) Unzip the installation package to your local file system.

2) Copy the update site into the desired installation directory.

NOTE: The installation directory of the update site should not be within
your Jazz Team Server installation directory. Otherwise, the update site
will be deleted when the Jazz Team Server is upgraded or reinstalled. In
this case you have to repeat this procedure.

3) Copy the properties from the log4j.properties file to the log4j.properties
file located in the jazz server installation. The file can be found at:
<JazzTeamServerRoot>/server/conf/ccm/log4j.properties

4) Write the absolute path of the installed update site folder into the
provision profile:
url=file\:///<InstallationDirectory>/de.methodpark.rtc

5) Copy the provision profile into the following folder:
<JazzTeamServerRoot>/server/conf/ccm/provision_profiles

6) Enforce the re-provisioning of the plug-in by opening the following URL:
https://<jazz server host>:<jazz port>/<application URI>/admin?internal#action=com.ibm.team.repository.admin.serverReset

7) Restart your Jazz Team Server to complete the installation.

III. Ant Installation Script
============================

If you have Apache Ant available, you can use the included Ant script for automatic
installation of the Stages Process Management for Rational Team Concert plug-in. This script
copies the update site into the desired installation directory and generates a provision profile
that contains the correct path of the installation directory.

The scribt takes the following parameters:

target.dir
    REQUIRED. The installation directory of the update site.

target.server
    REQUIRED. The installation directory of the Jazz Team Server.

target.provisionProfile
    optional. The absolute file name of the provision profile. Use this parameter if you
    do not want to automatically write the provision profile into the installation directory
    of the Jazz Team Server.

Use the following steps for installation using the Ant script:

1) Unzip the installation package to your local file system.

2) Execute the installation script using Apache Ant.
Example:
ant -Dtarget.dir=<InstallationDirectory> -Dtarget.server=<JazzTeamServerDirectory>

NOTE: The installation directory of the update site should not be within
your Jazz Team Server installation directory. Otherwise, the update site
will be deleted when the Jazz Team Server is upgraded or reinstalled. In
this case you have to repeat this procedure.

3) Enforce the re-provisioning of the plug-in by opening the following URL:
https://<jazz server host>:<jazz port>/<application URI>/admin?internal#action=com.ibm.team.repository.admin.serverReset

4) Restart your Jazz Team Server.


IV. Contact Information
=======================

For further information, you may contact the Stages support.

Email: stages-support@methodpark.de (preferred)
Phone: +49 9131 97206 550
