Installing the client plug-in for Rational Team Concert

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

Before you begin

Prerequisites:

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.

Feedback