Installing the client plug-in for Rational Team Concert

Edit online

Install the client plug-in for Rational Team Concert from the Build Forge server.

Before you begin

Prerequisites:
  • Rational Team Concert version 1.x or version 2.x - a different plug-in is required for each.
  • The Build Forge Connector server extension must be installed on the Rational Team Concert server.
  • The Build Forge system must be running.
  • Each user should have two login IDs for the console. Build Forge limits a user to one login session. The same user name cannot be logged in through the Management Console and the RTC client at the same time. When a new session is started, any existing session is terminated. RTC client users should have two IDs:
    • UserRTC - used when they configure a build definition to run a build. This user name is used to access the Build Forge console to run the build.
    • UserBF - used when they check build results. A direct login to the Build Forge Management console is required within a window in the RTC client.

About this task

The client plug-in must be installed on every Rational Team Concert client that will access Build Forge.

To install the plug-ins, perform these steps from a Rational Team Concert client.

Procedure

  1. Select Help > Software Updates > Find and Install.
  2. Select Search for new features to install, and then click Next.
    The system displays the Update Sites to Visit dialog.
  3. Click New Remote Site.
    The system displays the New Remote Site dialog.
    1. Enter Build Forge Connector Update Site in the name field.
    2. Enter the update site URL in the URL field.
      The URL varies according to the version of Rational Team Concert that you are using. 
      Rational Team Concert version 1.x:
http://<console_host_name>/rtc/site.xml

Rational Team Concert version 2.x:
http://<console_host_name>/rtc2/site.xml
      • If you are running Rational Team Concert on the same system that Build Forge is running on, you can use localhost as the host name.
      • Include the port number if the console is running on a port other than 80. The following example works if you are using Rational Team Concert version 1.x and Build Forge is running on port 11812. http://myhostname:11812/rtc/site.xml
    3. Click OK.
  4. In the Update sites to visit dialog, select the Build Forge Connector Update Site check box, and then click Finish.
  5. The system displays a list of available features from the update site in the Search Results dialog. Select all the offered features, then click Next.
  6. Read the license agreements, then select I accept the terms in the license agreements, then click Next.
  7. Select the location where you want to install the features.
    To add a new location, click Change Location, then browse to the location you want.
  8. Click Finish.
  9. If a Feature Verification dialog is shown, click Install.
    The dialog appears because the plug-ins are unsigned features. The dialog is shown once for each feature installed unless you selected Install All.
  10. You are asked to restart Rational Team Concert to make the changes take effect. Click Yes.
  11. Restart Build Forge.

Results

When the integration is complete, you can use the plug-in to run jobs and examine job results. You must specify RationalBuildForgeConnector as the Build Engine for your builds.