This information is for planning purposes only. The information herein is subject to change or removal without notice before the products described may become available.
The CE/CLM products were renamed in version 7.0. As the help is updated to reflect the changes, the topics might contain inconsistencies. For details on the name change, see Renaming the IBM Continuous Engineering Portfolio.

Integrating the Requirements Management application and Rational ClearQuest

When IBM® Rational ClearQuest is integrated with the Requirements Management (RM) application in the IBM Engineering Lifecycle Management (ELM), you can associate requirements with defects, tasks, requests for enhancements, and other record types. The capabilities that are provided by the RM application in ELM are licensed as IBM Engineering Requirements Management DOORS® Next (DOORS Next).

Before you begin

  • Install the RM application and configure Jazz® Team Server.
  • Install the compatible version of the Rational ClearQuest web server component. You can install the Rational ClearQuest web server on the same computer as the RM application or on a remote computer. For more information, see Deploying and installing Rational ClearQuest in the Installing section of the Rational ClearQuest documentation.
  • Configure the integration in Rational ClearQuest. For instructions, see Rational ClearQuest documentation. This configuration requires that you apply the OSLCLinks package to your Rational ClearQuest schema. Optionally, you can apply the RequirementsChangeRequest package to the schema.
  • Obtain an Analyst Client Access License or a license with similar requirements management capabilities.
  • Create or access a requirements management project to integrate with a Rational ClearQuest schema repository. You must have project administrator permissions in the requirements management project. If a requirements management project does not exist, see Creating requirements projects.
  • Use public host names rather than aliases or proxies for the Rational ClearQuest web server and Jazz Team Server.
  • Disable any software that blocks pop-up windows in your browser.


  1. Set up cross-server communication with Rational ClearQuest.
    1. In a web browser, go to https://fully qualified hostname:9443/jts/admin.
    2. On the Server Administration page, click the Server tab.
    3. In the Communication section, click Friends (Outbound). The Friends page opens.
    4. Click Add. The Add Friend window opens.
    5. Type the name to use to identify the Rational ClearQuest web server.
    6. For the root services URI, type the concatenation of the public URI and the Rational ClearQuest discovery context information.
      For example, https://cq-hostname/cqweb/oslc/repo/schema-repository/discovery, where cq-hostname is the name of your Rational ClearQuest web server and schema-repository is the name of your Rational ClearQuest schema repository.
    7. For the OAuth secret, enter a code to associate with the new OAuth consumer key of the server.
      Note: Do not enter the key itself; enter a shorter phrase to associate with the actual key.
    8. In the Re-type Secret field, retype the OAuth Secret code phrase.
    9. Select Trusted to designate the Rational ClearQuest web server as a Trusted consumer. Trusted consumers can share authorization with other trusted consumers and do not require user approval to access data.
    10. Click Create Friend. If the connection to the root services URI was successful, a message confirms that the friend was added and that a provisional key was generated. Click Next.
    11. Click the Grant access for the provisional key link.
    12. Enter an administrator user ID. Click Continue and log in to the Rational ClearQuest web server.
    13. Click Yes to approve the consumer key. Click Finish.
  2. Complete the steps in Configuring ClearQuest Web server for cross-server communication, which is in the Integrating section of the Rational ClearQuest documentation. If you already completed those steps, skip to the next step.
  3. In the RM application, create a link between the Rational ClearQuest user database and the requirements management project area.
    1. In the RM application, from the Administration menuAdministration menu item click Manage Project Areas.
    2. Click the project area to configure.
    3. Scroll to the Associations section, and then click Add.
      The Add Association page opens.
    4. From the Application list, select your Rational ClearQuest web server and log in to the server when you are prompted.
    5. From the Association list, select an association type to use for the integration.
      For example, Uses - Implementation Requests or Uses - Requirements Change Requests.
    6. In the Artifact Container section, click the Rational ClearQuest databases.
    7. Click OK and then save the changes to the project area. If needed, add another association type.

What to do next

Team members in your project can now start creating links between requirement artifacts and Rational ClearQuest records.

video icon Video channel
Software Education channel

learn icon Courses

IoT Academy
Skills Gateway

ask icon Community forums library

support icon Support

IBM Support Community
Deployment wiki