ClearQuest plugin installation

Overview:

This page describes how to install the ClearQuest plug-in for Eclipse into your CCSv4 environment.  Note that this page just covers the plug-in installation, it assumes that you already have a ClearQuest server setup within your company that you wish to connect to and that you have the necessary ClearQuest client software installed.  Note that these instructions show how to install version 6.15 of the ClearQuest plug-in.  There are newer versions of this plug-in available you may need to obtain the one that matches with the version of ClearQuest you are using, these plug-ins can be obtained from IBM's website.

Dependencies:

1. JDT (JAVA Development Toolkit) runtime.  The ClearQuest plug-in requires that you have the JDT installed. 
2. EMF (Eclipse Modelling Framework) runtime.  The ClearQuest plug-in makes use of components from the EMF runtime. 

Installation Procedure:

1. Close CCS

Since the first two components that we are going to install are going to be unzipped into your CCS installation it is recommended that you close CCS.

2. Install JDT

Unzip the JDT 3.2 runtime into the \eclipse folder in your CCSv4 installation.  The zip file contains plugins and features folders that need to be merged with the same folders in your CCSv4\eclipse folder so say yes to the prompts from windows to do this.

3. Install EMF

Unzip the EMF 2.0.2 runtime into the \eclipse folder in your CCSv4 installation. The zip file contains plugins and features folders that need to be merged with the same folders in your CCSv4\eclipse folder so say yes to the prompts from windows to do this.

4. Start CCS

As we are going to use the Eclipse update manager inside CCS we need CCS to be running.

5. Install the ClearQuest plug-in

Download the zip file containing the plug-in from here and unzip it into a folder on your computer, say C:\ClearQuest.

In CCS go to Help -> Software Updates -> Find and Install.

 

Select the option to "Search for new features to install" and click Next.

Click on the "New Local Site..." button.  Specify the path where you extracted the ClearQuest plug-in and click Ok.

You may change the name of the update site if you want, otherwise click ok.

Click on "Finish" to check this site for updates.

Check the box beside ClearQuest to select to install the ClearQuest plug-in and click "Next".

Follow the plug-in wizard, review and accept the license terms.  You may be prompted that some of the files are unsigned, select "Install All".

6. Restart CCS

It may ask you to restart the workbench say yes to close CCS and restart it.

Done!