Tasks for the IBM Rational ClearQuest adapter

You can create a library that is accessible in both IBM® Rational® Publishing Engine and IBM Rational ClearQuest® and associate the shared libraries with the data services profile.

Before you begin

You need the URL of the Rational ClearQuest adapter on the Rational Publishing Engine data services web application. To obtain the URL, refer to the section on the general tasks for configuring the data service.

Correct any firewall warnings or license errors, before configuring the Rational ClearQuest adapter. If you receive a 500 error when accessing the URL, opening the database in the Rational ClearQuest client might fix this problem.

About this task

The general tasks for configuring the Rational ClearQuest adapter are:

Procedure

  1. To create a shared library for the ClearQuest adapter:
    1. Click Environment > Shared Libraries to view the Shared Libraries page.
    2. To specify the scope setting, select the Node=RationalPublishingEngineNode01, Server=RationalPublishingEngineServer entry. RationalPublishingEngineNode01 is the default name of the node and RationalPublishingEngineServer is the default name of the server.
    3. To create the shared library reference, click New.
    4. Set the values for Name, Description, and ClassPath. Ensure that your classpath refers to the files in their correct locations.
      Description Values
      Name ClearQuest CM API.
      Description The shared library for the ClearQuest adapter.
      ClassPath

      C:\Program Files\IBM\RationalSDLC\ClearQuest\cqjni.jar

      C:\Program Files\IBM\RationalSDLC\ClearQuest\stpcq.jar

      C:\Program Files\IBM\RationalSDLC\Common\stpcmmn.jar

      C:\Program Files\IBM\RationalSDLC\Common\stpwvcm.jar

      Note: The default values listed under substep (d) are for the IBM Rational ClearQuest 7.1. The actual paths used for the classpath entries depend on where Rational ClearQuest is installed. Make sure that your classpath refers to the files in their correct locations. To see the installation location, open IBM Installation Manager by clicking Start > All Programs > IBM Installation Manager > View Installed Packages.
    5. Click OK, and then click Save.
  2. To associate ClearQuest shared libraries with the data services profile:
    1. Click Servers > Application Servers.
    2. Click the server on which you have deployed the data service. The default value is RationalPublishingEngineServer.
    3. Click Server Infrastructure > Java and Process Management > Class Loader.
    4. To create a class loader for the shared libraries, click New > OK.
    5. To associate the shared library references with the class loader, click the hyperlink of the new class loader created in substep (d).
    6. For each library to be associated, click Add, select the library, and click OK.
    7. Click Shared library references.
    8. For each library to be associated, click Add, select the library, and click OK.
    9. Click Save.
    10. Restart the DataServices profile.
    11. Verify that the IBM Rational ClearQuest adapter is installed correctly:
      • Open a web browser.
      • Enter the URL of the Rational ClearQuest adapter in the address bar of the browser. By default, the URL is http://host:port/DataServices/ClearQuest
      Note: You can find out the port number from the administrative console. If the installation is correct, you see an XML document that lists the schema repositories registered with the Rational ClearQuest administration tool.

Feedback