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:

Go to the directory IBM\JazzTeamServer\server.
Make a backup copy of the server startup configuration file server.startup.bat on Windows™ or server.start on Linux™ and UNIX™.
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\Java\jre\
```
On Linux™
Add this line to server startup:
```
JRE_HOME=/opt/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

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.
Rename the copied driver directory to cq-report-driver-update-site.
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.
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.
Remove the directory /opt/IBM/JazzTeamServer/server/tomcat/work.
Restart the Rational® Team Concert server.