Installing Rational Team Concert client using IBM Installation Manager


This version was built 24 Oct 2008.

The latest version of this installation procedure, along with helpful planning information, can be found online at http://publib.boulder.ibm.com/infocenter/rtc/v1r0m1/index.jsp.

Contents

Installing the client using the IBM Installation Manager
Upgrading to Rational Team Concert 1.0.1
Installing Rational Team Concert with Security-Enhanced Linux

Installing the client using the IBM Installation Manager

The client is distributed as a downloadable file via the IBM(R) Installation Manager.

Note:
If you want to install the client into an existing Eclipse workbench, use the IBM Installation Manager. The IBM Installation Manager install prompts you for the workbench you want to extend and takes care of managing future workbench updates, rollbacks, and modifications
Note:
If Security-Enhanced Linux(R) (SELinux) is enabled, you must disable it or change the security context of the Java Runtime Environment (JREs) to allow text relocation in order to install and run Rational Team Concert. For more information, see Installing Rational Team Concert with Security-Enhanced Linux.
  1. Download one of the following installation packages.

    There are three methods to install theRational(R) Team Concert client.

  2. Start the launchpad program.

    If the Installation Manager is not already running, complete the following steps to start it.

    Note:
    You must have administrator privileges to run the launchpad program.
    To start the launchpad program file on:
  3. Click the Rational Team Concert client link to start the client installation.
  4. Start the client. Start the client by clicking the Rational Team Concert shortcut created by the installation.
  5. Connect to the server The easiest way to connect to a server is using the Team Invitation. If you do not have an invitation you can connect manually.
    1. From the Welcome Screen click on Accept an invitation to join a Jazz(TM) team area. The wizard guides you through the process.
      Note:
      If you do not have an invitation you need the URI from your server admin. (an example format is: https://example.com:9443/jazz). Click on the connecting to an existing project area hyperlink that appears in the bottom right corner of the Accept Team Invitation window.
    2. Follow the instructions in the wizard to set up your connection.

Trouble Shooting: Here are some suggested problem management techniques.

After you have successfully installed the client, you should refer to the following topics to help you get started with Rational Team Concert.

Upgrading to Rational Team Concert 1.0.1

You can upgrade Rational Team Concert clients and servers by either performing a zip or Installation Manager install.

Upgrading 1.0 Rational Team Concert Eclipse Clients

If you have 1.0 clients, we recommend that you obtain the 1.0.1 client to connect to your new 1.0.1 server. You can install these using a zip file, or you can update your prior Installation Manager installs.

Upgrading a Server from a Trial or Early Access release to a Permanent release

If you are running an Early Access release of Rational Team Concert, first upgrade to the 1.0 Trial release, or directly to the purchased 1.0.1 Server product. The 1.0 server keys do not make an Early Access server Permanent.

From the 1.0 Trial release, you can make your server Permanent by purchasing and installing the Server Activation Kit for your edition which is available here: http://www-306.ibm.com/software/awdtools/rtc/. The activation kit consists of a JAR file containing the Permanent server key. It is installed using the License Key Management page of your server's administrative Web interface.

Upgrading a Server from 1.0

You can upgrade directly to the 1.0.1 release of Rational Team Concert from the 1.0 release. You can re-use your 1.0 database; there is no database migration required.

If you are running an earlier milestone or Beta, follow the upgrade instructions for 1.0 https://jazz.net/downloads/rational-team-concert/releases/. First, perform any necessary database migration.

If you installed the 1.0 release from a zip file, then there is no intersection with the previous install. You can install 1.0.1 release from a zip in a new location, or you can use the Installation Manager to install an instance of 1.0.1.

If you used Installation Manager to install the 1.0 release, you can either install 1.0.1 as a separate instance or update the 1.0 instance to 1.0.1. If you install a separate instance of the server for the 1.0.1 release, select Create a new package group on the Install Packages page of the installation wizard.

Note:
To upgrade a Websphere Application Server, remove the 1.0 jazz.war file and deploy the 1.0.1 jazz.war file.

To complete the upgrade, see Copying the required configuration files from a previous server installation and Installing 1.0.1 Activation Keys.

Upgrading a Server from One Rational Team Concert Edition to Another

You can upgrade between Rational Team Concert editions. Typical upgrades include moving from Express-C to Express(TM), or Express to Standard. You can also downgrade in the opposite direction by following the same process.

Because all Rational Team Concert 1.0.1 editions support Derby databases, you do not need to migrate from Derby to DB2(R) or Oracle if you are moving from Express-C to Express or Standard. We recommend that you migrate your server edition first, make sure things work smoothly with the existing database, and then perform a database migration if required. For information on performing a database migration..

If you have installed a Rational Team Concert 1.0.1 edition and want to upgrade to another, download and install the new edition, alongside the existing edition, and then copy the required configuration files to run the new edition. The section below describes the configuration files that you require.

If you installed your previous edition from a zip file, then there is no intersection with the previous install. You can install the new edition from a zip in a new location, or you can use the Installation Manager install for the new edition. We recommend that the Installation Manager be used for production servers to enable future updates to be applied.

If you used Installation Manager to perform your previous server install, and want to use Installation Manager to install your new edition, during the new Installation Manager install, do not to overlay the previous edition. On the Install Packages page of the installation wizard, select Create a new package group.

This will install the new edition in a different location and create program shortcuts using the new package group name.

If you do not perform this task, the installation will fail with a file collision. This occurs if you see an error dialog titled Installation Failed, and the details show the following text: 

Installation failed.
  Error during "install" phase:
    Failed to extract zip standard 1.0.1.I20081018-1820.  File
    D:\JazzTeamServer\server\license-update-site\site.xml already exists.

If this occurs, it is not fatal; you can restart the installation and correctly create a new package group.

Copying the required configuration files from a previous server installation

Copy the following files from the source server to the target server. First, rename the original files in the upgraded server install to create backups. If you used the Installation Manager to update from 1.0 to 1.0.1, a backup directory containing your 1.0 configuration files was created with a name, such as backup-config-timestamp in the server subdirectory of the installation location.

If you are upgrading to Standard edition, and you have purchased the Developer Client Activation Kit for Express, purchase and install the Developer Client Activation Kit for Standard Edition, so that you can use those client licenses. Your Developer license assignments will still be in effect, but the Developer licenses will be deactivated until the correct activation kit is installed.

Installing 1.0.1 Activation Keys

If you had installed the permanent Server Activation Key and Client Activation License Keys onto the 1.0 server installation, obtain and install the 1.0.1 versions of these keys. The server reverts to a trial license after the upgrade to 1.0.1. Obtain the 1.0.1 activation keys from Passport Advantage(R). Below are the names of the applicable keys for each server edition:

Express edition keys:

Standard edition keys:

Installing Rational Team Concert with Security-Enhanced Linux

If Security-Enhanced Linux (SELinux) is enabled, you must either disable it or change the security context of the Java(TM) Runtime Environments (JREs) used for installing and running Rational Team Concert to allow text relocation.

If you have setup a machine for the sole purpose of evaluating Rational Team Concert and the SELinux features are not important to you, then the easiest way to proceed is to disable SELinux.

Note:
Feedback

Did this help? You can provide feedback at Jazz.net (registration required): Comment in the forums or submit a bug