Setting up integration using the Rational ClearQuest Bridge

You can integrate with IBM® Rational® ClearQuest® Web so that you can use Rational ClearQuest for tracking defects.

Before you begin

Integration with Rational ClearQuest has the following requirements:

Note: Rational ClearQuest defects that are associated with Rational Quality Manager tests are not included in defect reports.
Note: If you have been using the Rational ClearQuest Connector and want to start using the Rational ClearQuest Bridge, you must first turn off synchronization with Rational ClearQuest. For details, see Permanently Decommissioning the RTC/CQ Synchronizer.

About this task

To integrate with Rational ClearQuest:

Procedure

  1. In Rational Quality Manager, configure the Rational ClearQuest bridge.
    1. Log on as a user with JazzAdmins repository permissions.
    2. Click Admin, and then click Jazz Server Administration.
    3. Under Configuration, click Advanced Properties.
    4. Scroll to the ClearQuest Bridge section and click Edit.
    5. Optionally, specify the default ClearQuest schema repository and ClearQuest user database.

      The options that you specify here are available to users when they log in to ClearQuest. If you specify the schema in the Advanced Properties page, all project areas will use that same schema. If you do not specify a schema repository or user database, users must select them when they log in, but this allows each project area to use a different schema and database.

      Important: The schema repository and user database names are case-sensitive and must match the names that you entered in the ClearQuest Maintenance tool.
    6. Specify the host name of the ClearQuest Web remote server, for example, cqserver.domain.com.
    7. Unless you need to change them, accept the default numbers, 80 for the HTTP Port and 443 for the HTTPS Port.
    8. Set the Enable ClearQuest Bridge Webui property to true. You must enable this setting for the ClearQuest bridge to function properly.
    9. Depending on your preferences, enable or disable the ClearQuest full-text search functionality by setting the Is Full Text search enabled? property. Note that you must also enable full-text search on your ClearQuest schema to use it with the ClearQuest bridge.
    10. Search for Public URI Root and set the Current Value field to your public root URI, for example https://myserver:9443/jazz.
      Note: Whatever value you set as the Public URI Root must be exactly the same as the URL that users type to access the Jazz™ server.
    11. Click Save.
  2. In Rational Quality Manager, set up the Rational ClearQuest bridge as a "friend" of Rational Quality Manager. You establish this relationship by setting up cross-server communication.
    1. In Rational Quality Manager, click Admin, and then click Jazz Server Administration.
    2. Click Cross-Server Communication.
    3. For Title, type the name that you want to use to identify the Rational ClearQuest Web server.
    4. For Root Services URI, type the concatenation of the public URI and the Rational ClearQuest discovery context information, for example, https://myrqm1:9443/jazz/cqrest/repo/cqrepo/discovery, where cqrepo is the name of the repository on the remote Rational ClearQuest server.
    5. For OAuth Secret, enter a code of your choice to be associated with the new OAuth consumer key of the server.
      Note: In this step you do not enter the key itself; you enter a shorter phrase that will be associated with the actual key.
    6. Retype the OAuth Secret code phrase.
      Note: To improve support for OAuth in a WebSphere® Application Server environment, see "Security Settings in WebSphere Application Server" in Setting up a WebSphere Application Server.
    7. Click Trusted to designate this as a Trusted consumer.

      Trusted consumers can share authorization with other trusted consumers and do not require user approval to access data.

    8. Click Request Access.
  3. In Rational Quality Manager, set up a link between the Rational ClearQuest user database and the Rational Quality Manager project area.
    1. Click Admin, and then click Jazz Project Administration.
    2. Click to open the project area to configure.
    3. Scroll to the bottom of the page and in the Links section, click Add.
    4. On the Add Link page select the name of the Rational ClearQuest Target Server.
    5. Set the Link Type to Tests and click Finish.
    6. Click Save to save the changes to the project area.
  4. Initialize the connection.
    1. Point to the Defects icon (Defect) and click Create Defect.

      A window opens saying that more than one change management provider is configured.

    2. Select Rational ClearQuest as your change management provider.

      A connection window opens.

    3. Type the User ID and password of the Rational ClearQuest repository and database.
    4. Click Log In.

      A Defect work item is displayed.

    5. Complete the Defect work item and click Save to submit the defect.

Feedback