Setting up defect management in Rational Team Concert

This topic describes how to set up communication between Rational® Quality Manager and Rational Team Concert so your users can create and track defects in Rational Team Concert. After you set this up, users can create and track defects using the Rational Quality Manager user interface, even though the defects themselves are maintained in Rational Team Concert.
Note: Before you begin, verify that you can log in to Rational Quality Manager from the machine hosting the Rational Team Concert server. Likewise, verify that you can log in to the Rational Team Concert Admin Web UI from the machine hosting the Rational Quality Manager server.
To set up defect tracking in Rational Team Concert:
  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.

      Note: This path must be the same one that users use to access Rational Quality Manager.
    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. Type the host name of the Rational Team Concert server.
    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 Adapter for RTC Component, go to the com.ibm.rqm.adapter.rtc.service.internal.RTCDefectsCollector 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 and also have a Client Access License assigned to it.
      • 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.

      • If necessary, update the Draft Link Lifespan value or accept the default.

        This is the time before a draft defect expires automatically. The default is set to 1000 seconds. If a user creates a new defect or associates an existing defect, the user must save the defect before the Draft Link Lifespan times out.

    4. Also under Adapter for RTC Component, go to the com.ibm.rqm.adapter.rtc.service.internal.rest.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 and also have a Client Access License assigned to it.
    5. Scroll to the com.ibm.team.repository.servlet.internal.ServletConfigurationService component.
    6. Type the host name of the Rational Quality Manager server.
    7. Set Use Canonical Host Name to false.
    8. Click Save.
  3. Set up the linkage between the Rational Team Concert project area and the Rational Quality Manager project area. After you set up this linkage, the defects that users create in Rational Quality Manager will be stored in the corresponding Rational Team Concert project area.
    1. In the Rational Quality Manager user interface, click Admin, and then click System Properties.
    2. Click Defects Provider.
    3. For the Provider, select Rational Team Concert (Defects).
    4. Click Configure.

      This starts a wizard for setting up Rational Team Concert as the defect provider.

    5. In the URL field, type the full URL of the Rational Team Concert server, for example, https://rtc_server1:9443/jazz.
    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. In the next wizard page, select the Rational Team Concert project area for which the defects will be created. By default, this is the QM Defects project area.
    10. Click Finish.

      After you complete the wizard, the Defects Provider page will be updated to show a successful status and summary.

After you complete these steps, users will be able to create and track defects that are saved in Rational Team Concert.
Related tasks
Starting Rational Quality Manager

Feedback