Installing Rational ClearCase Remote Client for Eclipse

The IBM Rational ClearCase Remote Client (CCRC) version 7.1.x client can replace the previous 7.0.x installation or coexist on a machine with the older version. This feature lets users work with multiple servers that are running different versions.

Before you begin

Before installing Rational ClearCase Remote Client for Eclipse, you must install GEF to your Eclipse environment if it is not already installed. See Installing GEF to determine if GEF is already installed and, if it is not, to install GEF.

About this task

If you are using the IBM Rational Software Delivery Platform (version 7.0 or greater) or Eclipse (version 3.2 or greater) for your integrated development environment (IDE) and would like to use Rational ClearCase Remote Client for Eclipse to provide Team services in the Eclipse environment, follow the instructions for installing with Eclipse 3.2.x through 3.3.x orinstalling with Eclipse 3.4.

Note: You must be logged in as a local Administrator with sufficient privileges for updating your installation of Eclipse or the Rational Software Delivery Platform.

Procedure

• Installing with Eclipse 3.2.x and 3.3.x
  
  1. If Eclipse is not running, start Eclipse.
  2. On the Eclipse main menu, click Help > Software Updates > Find and install.
  3. On the Feature Updates page, select Search for new features to install and then click Next.
  4. On the Update sites to visit page, click New Remote Site.
  5. In the New Update Site dialog:
     1. In the Name field specify a name for this site.
     2. In the URL field specify a URL of the form http://<computer-name>/ccrc/update where <computer-name> is the name of the computer that has Rational® ClearCase® and the CM Server for Rational ClearCase Remote Client installed on it.
        Note: Rational ClearCase may be installed on this computer or on a remote computer.
     3. Click OK.
  6. Select the new update site in the Sites to include in search list and then click Finish.
  7. On the Search Results page, expand the tree under the new update site name, select Rational ClearCase Remote Client and then click Next.
     Note: If you see an error about Rational ClearCase Remote Client for Eclipse requiring the "org.eclipse.draw2d" plug-in, follow the instructions in Installing GEF to install the GEF Runtime plug-in.
  8. On the Feature License page, read the license agreement carefully. If you accept the terms, select I accept the terms in the license agreements... and then click Next. If you do not accept the terms, select Cancel to end the installation.
  9. On the Installation page, verify that the Install Location is where you want to install Rational ClearCase Remote Client for Eclipse. Click Change Location... to specify a new install location.
  10. Click Finish. You may be presented with a dialog box prompting you to verify that you trust the signer of the jar files in which the client is packaged. After this step, the Eclipse update manager installs Rational ClearCase Remote Client for Eclipse into the selected Eclipse installation directory and then prompts you to restart Eclipse.
  11. Restart Eclipse. To validate the installation after Eclipse restarts, go to the Eclipse main menu, clickWindow > Open Perspective > Other... and then select ClearCase Explorer to open the ClearCase perspective.
• Installing with Eclipse 3.4
  
  1. If Eclipse is not running, start Eclipse.
  2. On the Eclipse main menu, click Help > Software Updates.
  3. On the Available Software page, select Add Site.
  4. In the Add Site dialog:
     1. In the Location field specify a URL of the form http://<computer-name>/ccrc/update where<computer-name> is the name of the computer that has Rational ClearCase and the CM Server forRational ClearCase Remote Client installed on it.
        Note: Rational ClearCase may be installed on this computer or on a remote computer.
     2. Click OK.
  5. The new update site appears in the Available Software page. The site is expanded to display all available downloads. Select Rational ClearCase Remote Client and click Install.
     Note: If you see an error about Rational ClearCase Remote Client for Eclipse requiring the "org.eclipse.draw2d" plug-in, follow the instructions in Installing GEF to install the GEF Runtime plug-in.
  6. On the Install page, verify that all the features are selected, and click Next.
  7. On the Review Licenses page, read the license agreement carefully. If you accept the terms, select I accept the terms in the license agreement... and then click Finish. If you do not accept the terms, select Cancel to end the installation.
  8. On the Search Results page, expand the tree under the new update site name, select Rational ClearCase Remote Client and then click Next.
     Note: If you see an error about Rational ClearCase Remote Client for Eclipse requiring the "org.eclipse.draw2d" plug-in, follow the instructions in Step 1 to install the GEF Runtime plug-in.
  9. On the Feature License page, read the license agreement carefully. If you accept the terms, select I accept the terms in the license agreements... and then click Next. If you do not accept the terms, select Cancel to end the installation.
     Note: You may be presented with a dialog box prompting you to verify that you trust the signer of the jar files in which the client is packaged.
     After this step, the Eclipse update manager installs Rational ClearCase Remote Client for Eclipse into the selected Eclipse installation directory and then prompts you to restart Eclipse.
  10. Click Yes to restart Eclipse. To validate the installation after Eclipse restarts, go to the Eclipse main menu, click Window > Open Perspective > Other... and then select ClearCase Explorer to open the ClearCaseperspective.