Tasks for the Rational ClearQuest adapter

You can create a library that is accessible in both IBM® Rational® Publishing Engine and IBM Rational ClearQuest®, and then associate the shared library with a 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, open the database in the Rational ClearQuest client.

Procedure

  1. Create a shared library for the Rational ClearQuest adapter:
    1. To open the Shared Libraries window, click Environment > Shared Libraries.
    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 class path refers to the files in their correct locations.
      Description Values
      Name ClearQuest CM API.
      Description The shared library for the ClearQuest adapter.
      Class path

      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 Save.
  2. Associate the Rational ClearQuest shared libraries with the data services profile:
    1. Click Servers > Application Servers.
    2. Click the server on which you deployed the data service. The default server name 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. Enter the URL of the Rational ClearQuest adapter in a browser. By default, the URL is http://host:port/DataServices/ClearQuest
      Note: You can find the port number in 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