Configuring Rational Team Concert for Rational ClearQuest reporting

To run and share Rational® ClearQuest® reports created with Business Intelligence and Reporting Tools (BIRT), configure the Rational Team Concert with the Rational ClearQuest Reporting Driver.

Before you begin

The Rational ClearQuest Reporting Driver requires version 6 Java™ Runtime Environment. By default, your Jazz™ Team Server might be using an older Java Runtime Environment (JRE) which does not support the Rational ClearQuest Reporting Driver. To update the JRE, complete these steps:
  1. Go to the directory IBM\JazzTeamServer\server.
  2. Make a backup copy of the server startup configuration file server.startup.bat on Windows or server.start on Linux and UNIX.
  3. Edit the server startup configuration to set the JRE_HOME parameter with the path to the Java Runtime Environment (JRE).

    If Rational ClearQuest is installed on the same server as the Jazz Team Server, you can start the Jazz Team Server with the JRE included with Rational ClearQuest.

    On Windows
    Edit server.startup.bat to add this line:
    set JRE_HOME=D:\Program Files\IBM\RationalSDLC\common\Java5.0\jre\
    On Linux
    Add this line to server startup:
    JRE_HOME=/opt/rational/common/java/jre
    Note: If you use the JAVA 6 Virtual Machine provided with Rational ClearQuest, comment out this line:
    # JAVA_OPTS="$JAVA_OPTS -Xmx4000M"

About this task

These instructions apply to configuring the Rational Team Concert web client and the Rational Team Concert Eclipse client with the Rational ClearQuest Reporting Driver. In these environments, the reports to be managed and run must be deployed on the Rational Team Concert server. To create or modify reports by using the Rational Team Concert Eclipse client, see Configuring an Eclipse Workbench for Rational ClearQuest reporting activities.

Procedure

  1. Copy the Rational ClearQuest Reporting Driver update site from /clearquest/reports/driver to the appropriate Jazz Team Server directory.
    For Rational Team Concert 2.x:
    <rtc home>/jazz/server
    For Rational Team Concert 3.x:
    rtc home/JazzTeamServer/server/conf/ccm/sites.
  2. Rename the copied driver directory to cq-report-driver-update-site.
  3. Create a provision profile for the Rational ClearQuest Reporting Driver.
    For Rational Team Concert 2.x:
    In the directory <rtc home>\jazz\server\conf\jazz\provision_profiles, copy the file profile.ini and save it as cq-report-driver-profile.ini
    For Rational Team Concert 3.x:
    In the directory <rtc home>\JazzTeamServer\server\conf\jts\provision_profiles, copy the file profile.ini and save it as cq-report-driver-profile.ini.
  4. Edit cq-report-driver-profile.ini and update the url and featureid parameters with these values: 
    url=file:../cq-report-driver-update-site
featureid=com.ibm.rational.clearquest.oda.jdbc.base.feature
    Note: Tip: On Windows systems, edit the file with WordPad rather than Notepad.
  5. Remove the directory /opt/IBM/JazzTeamServer/server/tomcat/work.
  6. Restart the Rational Team Concert server.
Parent topic: Configuring the Rational ClearQuest Reporting Driver