Configuring the Eclipse IDE for Java and Report Developers with Rational ClearQuest

ClearQuest® supports the Business Intelligence and Reporting Tools (BIRT) v4.x.

About this task

Note: The Rational® ClearQuest Reporting Driver BIRT 4.x requires the IBM® Java™ Runtime Environment (JRE) version 1.8, or higher.

Rational ClearQuest supports the following:

BIRT Reporting Engine: The deployment of BIRT Reporting Engine (BIRT Runtime) did not change and to deploy it, use the Rational ClearQuest deployBIRT script that is found in <CQ_Home>/reports/launcher/birt/. The BIRT Reporting Engine can be found and downloaded from BIRT's official download website at: http://download.eclipse.org/birt/downloads/.
BIRT RCP Report Designer: Starting with BIRT v4.x, the BIRT RCP Report Designer is no longer recommended as the tool to use for designing BIRT reports. The BIRT v4.x RCP Report Designer is no longer available as 32-bit. The 32-bit is required to use the CQJNI database connection profiles to Rational ClearQuest for your reports. Also, the BIRT v4.x RCP Report Designer is no longer available on Linux.

The alternative is to use the Eclipse IDE for Java and Report Developers, which can be downloaded from http://www.eclipse.org/downloads/packages/.

Note: Rational ClearQuest strongly recommends the use of the Eclipse IDE for Java and Report Developers in place of BIRT RCP Report Designer.

To use the Eclipse IDE for Java and Report Developers with Rational ClearQuest to design ClearQuest reports, follow those steps:

Download Eclipse IDE for Java and Report Developers from http://www.eclipse.org/downloads/packages/, and extract the compressed file into a directory such as C:\BIRT_for_CQ or onUNIX /opt/BIRT_for_CQ.
Copy the Rational ClearQuest JDBC driver for BIRT from the directory <CQ_HOME>/reports/launcher/birt/ to C:\BIRT_for_CQ\\dropins\ directory, or on UNIX to /opt/BIRT_for_CQ/\dropins/.
Edit the file C:\BIRT_for_CQ\eclipse.ini or on UNIX /opt/BIRT_for_CQ/eclipse.ini and add the following two lines to the top of the file:
For Windows
```
 -vm
        <32bit_IBM_JRE>/jre/bin/javaw.exe
```
For UNIX
```
 -vm
        <32bit_IBM_JRE>/jre/bin/javaw
```
Note:
The 32bit_IBM_JRE is the path where you extracted the IBM JRE.
Start Eclipse to open existing reports, or create new ones.
Note: You can use the 64-bit IBM JRE with Eclipse, but you will not be able to create Rational ClearQuest reports using the CQJNI connection. You are limited to using CM Server connections.