Configuring the Rational ClearQuest Client for Eclipse

The Rational® ClearQuest® Client for Eclipse is supported on Eclipse version 3.2.x, 3.3.x, 3.4.x, and 3.5.x.

To download Eclipse, go to http://eclipse.org/downloads/index.php.

Before you can install the Rational ClearQuest Client for Eclipse, there are additional dependencies that must be installed. These dependencies do vary depending on whether you are installing Rational ClearQuest Client for Eclipse into a base Eclipse shell, or an existing Rational product built on Eclipse such as Rational Application Developer. Consult the documentation for those other Rational products to determine if they already meet the Rational ClearQuest Client for Eclipse dependencies.

That standard Rational ClearQuest Client for Eclipse feature only requires the Eclipse Modeling Framework (EMF) Project. However, other features packaged with the installation do require additional projects from the Eclipse community.

In addition to EMF, the IBM Rational ClearQuest Common Base Event Log Handler feature also requires the Eclipse Test & Performance Tools Platform (TPTP) Project.

The Rational ClearQuest Reporting Driver Feature requires the Business Intelligence and Reporting Tools (BIRT) Project.
Note: BIRT is only supported in Eclipse 3.3.x with Rational ClearQuest. If you are installing into Eclipse 3.2.x, you must uncheck the Rational ClearQuest Reporting Driver Feature when installing Rational ClearQuest into Eclipse.

If you are also installing the Rational ClearQuest Test Manager feature, see Configuring Rational ClearQuest Test Manager.

The following tables breaks down these dependencies.

Table 1. Standard Rational ClearQuest Client for Eclipse feature
Eclipse EMF
3.2.x 2.2
3.3.x 2.3
3.4.x 2.4
3.5.x 2.5
To install EMF, visit http://www.eclipse.org/modeling/emf/downloads/?project=emf
Table 2. Rational ClearQuest Client for Eclipse with the IBM Rational ClearQuest Common Base Event Log Handler feature
Eclipse EMF TPTP
3.2.x 2.2 4.3.x
3.3.x 2.3 4.4.x
3.4.x 2.4 4.5.x
3.5.x 2.5 4.6.x
To install TPTP, visit http://www.eclipse.org/tptp/home/downloads/
Table 3. Rational ClearQuest Client for Eclipse with the Rational ClearQuest Reporting Driver Feature
Eclipse EMF BIRT
3.3.x 2.3 2.2.2
3.4.x 2.4 2.3
3.5.x 2.5 2.5
To install BIRT, visit http://download.eclipse.org/birt/downloads/index2.2.2.php
Note: BIRT has additional dependencies. The BIRT download page goes into details of these requirements, but to provide a quick summary, BIRT also requires the following projects:

Installing the plug-ins

  1. In Eclipse, click Help > Software Updates > Find and Install.
  2. In the window that opens, select Search for new features to install and clickNext.
  3. Click New Local Site.
  4. Navigate to Program Files\IBM\RationalSDLC\ClearQuest\cqecUpdateSite and click OK.

    On Linux® and the UNIX® system, navigate to /opt/ibm/RationalSDLC/clearquest/cqecUpdateSite/.

    Note: If you did not accept the default installation location, navigate to the directory in which you installed Rational ClearQuest.
  5. Select the check box next to the local site that you just created and click Finish.
    Note: After clicking Finish, a window opens in which you can modify the display name for the site if you choose.
  6. Verify that the check box next to Rational ClearQuest is selected.
  7. Click Next after you have selected your plug-ins.
  8. Click to Accept the terms in the license agreement and click Next. If you do not accept the license agreement, the installation terminates.
  9. Verify the optional plug-ins and clear any that you do not want to install. Click Next.
  10. Accept the default installation location and add any additional install locations if necessary. Click Finish.
  11. If you receive any warnings about installing an unsigned feature during the installation process, select Install.
  12. After the installation finishes, restart Eclipse for the changes to take effect.
  13. After Eclipse restarts, switch to the ClearQuest perspective. Select Window > Open Perspective > Other and select ClearQuest from the window that opens.

Feedback