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
- Select .
- Select Search for new features to install,
and then click Next. The system
displays the Update Sites to Visit dialog.
- Click New Remote Site. The
system displays the New Remote Site dialog.
- Enter Build Forge Connector Update Site in
the name field.
- 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
- Click OK.
- In the Update sites to visit dialog,
select the Build Forge Connector Update Site check
box, and then click Finish.
- 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.
- Read the license agreements, then select I accept
the terms in the license agreements, then click Next.
- 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.
- Click Finish.
- 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.
- You are asked to restart Rational Team Concert to make
the changes take effect. Click Yes.
- 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.