Setting up build integration with Rational Team Concert

You can set up communication between IBM® Rational® Quality Manager and IBM Rational Team Concert so that you can use Rational Team Concert as your build provider and synchronize build information with Rational Quality Manager. After you set up this communication, users can track builds in the Rational Quality Manager user interface, even though the build information is maintained in Rational Team Concert.

Before you begin

To enable build integration, you must meet the following requirements:

About this task

To set up build integration with Rational Team Concert:

Procedure

  1. Set up Rational Team Concert to accept cross domain requests from Rational Quality Manager.
    1. In the Rational Team Concert Admin Web UI, click the Server tab.
    2. In the Configuration pane, click Advanced Properties.
    3. Under Core Repository Component, scroll to the com.ibm.team.repository.service.internal.xdomain.DynamicProxyFrameService component.
    4. For the Current Value of the Cross Domain Host Whitelist property, type the various URLs that can be used to access the Rational Quality Manager Jazz server. Separate each path with a comma, and try to include all of the possible paths, for example:
      https://myserver:9443/jazz, https://myserver.ourdomain.mycompany.com:9443/jazz, https://9.12.345.67:9443/jazz

      The previous examples include the simple host name, the host name along with the domain name, and the IP address.

      If you need to configure multiple Rational Quality Manager servers, you can also use commas to separate each server URL.

    5. For the Enable Cross Domain Communication property, change the Current Value to true.
    6. Scroll to the com.ibm.team.repository.servlet.internal.ServletConfigurationService component.
    7. In the Host Name field, type the host name of the Rational Team Concert server, for example, myrtcserver.ourdomain.mycompany.com.
    8. Set Use Canonical Host Name to false.
    9. Click Save.
  2. Set up Rational Quality Manager so that it can communicate with Rational Team Concert.
    1. In the Rational Quality Manager user interface, click Admin, and then click Jazz Server Administration.
    2. Click Advanced Properties.
    3. Under Build Integration Framework, go to the com.ibm.rqm.buildintegration.service.asynctask.RTCBuildInformationCollector component and modify the properties as necessary.
      • If necessary, under Current Value, type the correct User Name and Password for the Rational Team Concert Jazz Server administrator. At minimum, the User Name must have JazzUsers repository permissions.
      • If necessary, update the Delay value or accept the default.

        The Delay value determines how frequently the Rational Quality Manager server synchronizes with the Rational Team Concert server. The default is set to 500 seconds. If you want to see changes more frequently, decrease the delay frequency. If this produces too great a load on the Rational Quality Manager server, you can increase the delay frequency.

    4. Under Integration Provider Component, go to the com.ibm.rqm.integrationprovider.service.rest.internal.ConnectionRestService component and modify the properties as necessary. Under Current Value, type the correct User Name and Password for the Rational Team Concert Jazz Server user. This User Name must have JazzUsers repository permissions.
    5. Under Core Repository Component, scroll to the com.ibm.team.repository.servlet.internal.ServletConfigurationService component.
    6. Type the host name of the Rational Quality Manager server, for example, myrqmserver.ourdomain.mycompany.com.
    7. Set Use Canonical Host Name to false.
    8. Click Save.
  3. Set up the link between the Rational Team Concert project area and the Rational Quality Manager project area. After you set up this link, the build information that gets created in Rational Team Concert will be stored in the corresponding Rational Quality Manager project area.
    1. In the Rational Quality Manager user interface, click Admin, and then click System Properties.
    2. Click Build Provider.
    3. For the Provider, select RTC Integration Provider.
    4. Click Configure.

      A wizard starts for setting up Rational Team Concert as the build provider.

    5. In the URL field, type the full URL of the Rational Team Concert server, for example, https://rtc_server1:9443/jazz.
      Note: The hostname in the URL must be the same that you used in Step 1g.
    6. In the Name field, type a name for this particular Rational Team Concert server.
    7. Optional: In the Description field, type a description of the server.
    8. Click Next.
      Note: If you see a warning message, Security Error: Domain Name Mismatch, simply click OK. If you are asked to Verify the Logged in User click Continue or click Log in as different user.
    9. On the next wizard page, select the Rational Team Concert project area for the builds. By default, this is the QM Builds project area.
    10. Click Finish.

      After you complete the wizard, the Builds Provider page is updated to show a successful status and summary.

Results

After you complete these steps, users can track builds that are created in Rational Team Concert.

Feedback