Tasks for the Rational ClearQuest adapter in Apache Tomcat

You can make the IBM® Rational® ClearQuest® shared libraries available to the IBM Rational Publishing Engine Data Services application so that the Rational ClearQuest API is can be used from Rational Publishing Engine.

Before you begin

  • You must have Rational ClearQuest installed on the same computer as your application server.
  • Deploy the Rational Publishing Engine Data Services application and the Reporting Data Services Adapters.
  • Correct any firewall warnings or licensing issues before configuring the Rational ClearQuest shared libraries.

Procedure

  1. Copy the Rational ClearQuest shared libraries from the Rational ClearQuest application files:

    application_files\IBM\RationalSDLC\ClearQuest\cqjni.jar
    application_files\IBM\RationalSDLC\ClearQuest\stpcq.jar
    application_files\IBM\RationalSDLC\Common\stpcmmn.jar
    application_files\IBM\RationalSDLC\Common\stpwvcm.jar

    Note: The default values listed are for Rational ClearQuest 7.1. The actual paths to use depend on where and which version of Rational ClearQuest is installed. Make sure that you are referring to the files in their correct locations. To view the location of your Rational ClearQuest installation, check in IBM Installation Manager by clicking Start > All Programs > IBM Installation Manager > View Installed Packages.
  2. Paste the Rational ClearQuest shared libraries into the Apache Tomcat %CATALINA_HOME%\lib directory.
  3. Linux icon If you are using Linux, configure the generic JVM argument:
    1. Open the file used to start the Apache Tomcat server. Example: %CATALINA_HOME%/bin/startup.sh
    2. Add the following command to the end of the file:
      export JAVA_OPTS="-Djava.library.path=/opt/ibm/RationalSDLC/clearquest/linux_x86/shlib"
  4. Linux icon If you are using Linux, configure the LD_LIBRARY_PATH environment variable:
    1. In the file used to start the Apache Tomcat server, add the following command to the end of the file:
      export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/opt/ibm/RationalSDLC/clearquest/linux_x86/odbc/lib:/usr/local/ibm/gsk7/lib
    2. Save the changes to the file used to start the Apache Tomcat server.
  5. Restart the Data Services application.
  6. Verify that the IBM Rational ClearQuest adapter and libraries are configured correctly. Enter a URL for the Rational ClearQuest adapter in a browser.
    • Enter http://host:port/DataServices/ClearQuest. If the installation is correct, you see a list of Rational ClearQuest connections as displayed in the Rational ClearQuest Maintenance Tool.
    • Enter http://host:port/DataServices/ClearQuest/version. If the installation is correct, you see a list of a list of Rational ClearQuest user databases.
    • Enter http://host:port/DataServices/ClearQuest/version/database_name. If the installation is correct, you see a list of queries.

What to do next

Copy a query URL to add to a template or document specification.
Note: The Data Services application supports only queries with static result sets. Dynamic queries are not supported.

Example

With the URL for the All Defects query, you see a result set with the number of hits the query would return for the Rational ClearQuest client. Each result is a unique DBID for a particular record type. You can continue with this process until you get a return for the data of a specific record. Retain the query URL for use in Rational Publishing Engine report authoring.

Remove arguments including and after the question mark:

Before: http://localhost:9081/DataServices/ClearQuest/7.0.0/SAMPL/Public+Queries/All+Defects?Type=Query
After: http://localhost:9081/DataServices/ClearQuest/7.0.0/SAMPL/Public+Queries/All+Defects


Feedback