Integrate Rational Team Concert with Rational Build Forge

Consolidate build records and artifacts yet still use Build Forge automation

Veena H. Balakrishnaiah gives an overview of how to configure various components of Rational Team Concert to integrate with Rational Build Forge. Then you can launch Build Forge projects from Rational Team Concert Team Build and publish information into the associated build result.


Veena H. Balakrishnaiah (, Build and Release Engineer, IBM

Veena H. Balakrishnaiah is part of the Operations Software Engineering Service team at the IBM Software Labs in India, where works on various product builds. Veena has a master's degree in software systems. She is experienced with SCM and automation tools, including IBM Rational ClearCase. IBM Configuration Management Version Control (CMVC), Rational Team Concert, and Rational Build Forge.

19 June 2012

Also available in Chinese Russian Portuguese


This article explains how to configure various components of IBM® Rational Team Concert™ (RTC) to integrate with Rational Build Forge, so you can launch IBM® Rational® Build Forge® projects from RTC Team Build and have information published back into the associated RTC build result. This makes the RTC build result the place of record for builds and build artifacts, but you can still use the automation capabilities of Build Forge, which is a goal of the integration.

You can use Build Forge to break up your larger scripts into smaller steps within a project or to create reusable libraries that can be called from other projects. RTC Team Build has very nice interface for configuring build-specific tools, such as Apache Maven, Apache Ant, and Microsoft Build. Team Build includes a Jazz™ Build Engine that pulls requests from a build definition queue to build these configurations.

Rational Team Concert and Rational Build Forge setup architecture

The diagram in Figure 1 shows the setup used as the basis for this article.


This article is based on these assumptions:

  • Rational Build Forge enterprise edition 7.1.2 is installed and that: The server is already configured, and that Build Forge agents are installed on the client machines.
  • The required server, selector, administration, and project settings are created to successfully run a project.
  • The Rational Team Concert server is already set up, and you have access to the RTC server using the RTC Eclipse client.
Figure 1. Rational Build Forge and Rational Team Concert setup
Flow diagram of setup

Configure Rational Team Concert

This section explains how to configure components of Rational Team Concert (RTC) to use the Rational Build Forge Engine so that you will be able to access the Build Forge projects from the RTC Eclipse client.

Create a new project area

  1. Launch the RTC Eclipse client.
  2. Log in and connect to the existing repository connection, based on your team invitation.
  3. Create a new project area by using the Scrum template.
    1. Go to the Create Project Area wizard shown in Figure 2.
    2. Choose the Scrum template, as Figure 3 shows.

If you are not the administrator and not able to create the project area, send a request to the RTC project admin to create a project area with the default Scrum template.

Figure 2. Project Area dialog window
Fields for Name, Summary, Team Repository
Figure 3. Create Project Area view, Choose Process Template screen
Scrum selected under Available Process Templates
  1. To work on the existing project areas, right-click the repository connection, click Manage Connected Project Areas, select the existing project area, and click Finish.
Figure 4. Manage the project area that you are connected to
Manage Connected Project Areas view
  1. Expand the created project area, and you will be able to view Builds component and Build Engines has sub-component as listed in Figure 5.
Figure 5. Project area expanded to list the Builds component
Build Engines folder selected under Builds

Create a new build engine

  1. Create a new build engine by right-clicking on Build Engines and then selecting New Build Engine.
  2. In the New Build Engine dialog window (Figure 6), select Create a new build engine if that is what you want to do. If you want to reuse the existing build engine listed in drop-down menu instead, select Create a build engine by copying existing one.
  3. Click Next.
Figure 6. Creating a new build engine
New Build Engine dialog window
  1. From Available Build engine types (Figure 7), choose Rational Build Forge, and then click Finish
Figure 7. Available build engine types
Rational Build Forge selected

After the build engine is created, it gets displayed under Builds in the Build Engine view of the project area.

  1. Open the Build Engine, and you will be able see the Overview and Build Forge tabs shown in Figure 8.
  2. Click the Build Forge tab, and enter the Rational Build Forge server hostname and login details.
  3. Test the connection to the Build Forge server by clicking Test Connection (see Figure 8).
  4. When the connection is successful, click Save. For now, ignore the warning that states that the build engine is not running.

Enter your intranet credentials if Build Forge is LDAP-configured. If you are already connected with the login credentials that you used in RTC, then you are logged out of Build Forge

Figure 8. Testing the Build Forge connection
Build Engine tab view

Create a new build definition

  1. To create new build definition, right-click on Builds and select New Build Definition from the context menu. From the available build templates, choose Rational Build Forge, and click Finish.
Figure 9. Creating a build definition with the Rational Build Forge template
New Build Definition dialog window
  1. In the Build Definition window (Figure 10), create a new build engine if it is not already created, or use Edit to choose the one that you created earlier. Figure 10 shows using the build engine, which you created earlier in Overview tab.
Figure 10. Overview tab to choose the supporting build engines
ID, Project or Team Area: RTC-BF Integration build

The Properties tab is for defining properties of the build definition that will override the property values of Rational Build Forge if the name of the property is the same. The Schedule tab is to automatically run the build according to a schedule.

  1. Still in the Build Definition window, click the Build Forge tab, and then click Get Projects button (Figure 11) to filter the available projects created on the configured Build Forge server.
  2. Under Build Forge Projects, select the one that you want to run, and then click Save.

The build definition is then created automatically.

Before you click the Get Projects button, the Available Build Projects section will be empty. Get Projects will retrieve all Build Forge projects visible to the configured user.

Figure 11. Build Forge tab view with Build Forge projects list
Build Definition screen
  1. To request a build, right-click on the build definition that you created, and select Request Build from the drop-down menu.
Figure 12. Requesting a build
requesting build
  1. Choose the supported build engine under Build Options by using the Browse option, as shown in Figure 13.
  2. Click the Submit button to proceed with the build.

The build will be executed, using the project environment defined in Build Forge. If you want to customize or override the property values, you need to add build properties with Name and Value accordingly, and submit the request.

Figure 13. Requesting build with a supported build engine
Request Build dialog window

After you click the Submit button, Build Forge starts the build project. You can check the logs and status of the build that was executed.

  1. Right-click on the Build Result and open it.

When the build is finished, the result will show it as completed, as Figure 14 shows.


  • Build Forge will generate a detailed log file.
  • You can also explore Rational Team Concert features, such as creating a new work item or associating an existing work item, based on the requirement
Figure 14. Rational Team Concert summary of the build status
Green area with check mark shows Completed

Check results on the Build Forge management console

You can also view the status of the build that was executed from RTC build definition by logging into the Build Forge management console. To see the results, click the Jobs tab, and filter the tag name, as shown in Figure 15.

Figure 15. Build result displayed in Rational Build Forge
Result column shows Passed

Larger view of Figure 15.



Get products and technologies

  • Download Rational Team Concert from and try it free on up to 10 projects for as long as you want (requires registration).
  • Check the Trials and Demos page for Rational software.
  • Evaluate IBM software in the way that suits you best: Download it for a trial, try it online, use it in a cloud environment, or spend a few hours in the SOA Sandbox learning how to implement service-oriented architecture efficiently.



developerWorks: Sign in

Required fields are indicated with an asterisk (*).

Need an IBM ID?
Forgot your IBM ID?

Forgot your password?
Change your password

By clicking Submit, you agree to the developerWorks terms of use.


The first time you sign into developerWorks, a profile is created for you. Information in your profile (your name, country/region, and company name) is displayed to the public and will accompany any content you post, unless you opt to hide your company name. You may update your IBM account at any time.

All information submitted is secure.

Choose your display name

The first time you sign in to developerWorks, a profile is created for you, so you need to choose a display name. Your display name accompanies the content you post on developerWorks.

Please choose a display name between 3-31 characters. Your display name must be unique in the developerWorks community and should not be your email address for privacy reasons.

Required fields are indicated with an asterisk (*).

(Must be between 3 – 31 characters.)

By clicking Submit, you agree to the developerWorks terms of use.


All information submitted is secure.

Dig deeper into Rational software on developerWorks

Zone=Rational, DevOps
ArticleTitle=Integrate Rational Team Concert with Rational Build Forge