Skip to main content

Support & downloads  >  

Installing or updating CCRC for Eclipse and RSA
 Technote (FAQ)
 
Question
How do I configure the IBM® Rational® ClearCase® Remote Client (CCRC) plug-in for Eclipse™ version 3.0 or later as well as for Rational Software Architect (RSA) 7.0 or later?
 
Answer

Install the CCRC Plug-in
Update the CCRC Plug-in
Errors without GEF plug-in installed
Updating Eclipse with GEF

Note: The steps below are only valid for Eclipse versions prior to 3.4. Refer to technote 1327758 for Eclipse 3.4 instructions.


Install the CCRC Plug-in

Follow this procedure to install the ClearCase Remote Client plug-in for Eclipse (including Rational Software Architect - RSA 7.0 or later).

Note: Starting with ClearCase version 7.0 (and later), the GEF Runtime is also required for CCRC. Attempts to load the CCRC plug-in without the required runtime will result in an error installing CCRC. See below for example errors.

Up-to-date installation instructions can be found on your Rational Web Platform (RWP) server, found at http://RWP-web-server/ccrc/update where RWP-seb-server is the name of your web server. An example has been provided below for your convenience.

Note: RSA 7.0 will require CCRC to be updated to CU02 or later. Review the steps to Update the CCRC Plug-in.


1. Open Eclipse or RSA 7.0 and click Help > Software Updates > Find and Install




2. On the Feature Updates page, select Search for new features to install and then click Next.




3. On the Update sites to visit page click one of the following buttons to configure RSA to download CCRC:

Option 1

- Click if ClearCase is not installed on the host.

In the New Update Site dialog:
  1. In the URL field specify the URL you used to access this page.
    For example, http://RWP-web-server/ccrc/update where RWP-seb-server is the name of your web server running the Rational Web Platform.

  2. In the Name field specify a name by which the update manager will refer to this site
    In this example we will name the site CCRC.

  3. Click OK



Option 2

- Click if ClearCase is installed on the host.

Browse to the %ClearCase Home%\web\update directory and select the update folder (by default C:\Program Files\Rational\ClearCase\web\update) and click OK.



The Edit Local Site window will appear.



Change the name from web/update to a more suitable name and click OK.

Note: In this example we will use the name CCRC.




4. The Update sites to visit window will appear with the new location, click Finish.




5. The Search Results page will appear, select IBM Rational ClearCase Remote Client and then click Next.



6. On the Feature License page, read the license agreement. If you accept the terms, select I accept the terms in the license agreement and then click Next.




7. On the Install Location page, verify that the location of the local Eclipse installation into which you want to install the ClearCase Remote Client and click Finish.



Note: The Update Manager will then download the plug-in if a Remote Site was used




8. Click Install All in the Verification window.



Note: The Update Manager will then install the plug-in.



9. Restart Eclipse or RSA to complete the installation process.




10. After the installation is complete, you can access the ClearCase Remote Client for Eclipse by opening the ClearCase perspective within Eclipse. On the Eclipse main menu, Click Window > Open Perspective > Other and then select ClearCase




Update the CCRC Plug-in

1. Open Eclipse or RSA 7.0 and click Help > Software Updates > Manage Configurations

2. Highlight Rational ClearCase Remote Client for Eclipse and click Scan for Updates.




3. The Search Results page will appear, select the ClearCase Remote Client update and then click Next.



4. On the Feature License page, read the license agreement. If you accept the terms, select I accept the terms in the license agreement and then click Next.





5. On the Install Location page, verify that the location of the local Eclipse installation into which you want to install the ClearCase Remote Client and click Finish.



Note: The Update Manager will then download the plug-in if a Remote Site was used




6. Click Install All in the Verification window.



Note: The Update Manager will then install the plug-in.



7. Restart Eclipse or RSA to complete the installation process.



Errors without GEF plug-in installed

One of the following errors may be seen while attempting to install the CCRC plug-in without the GEF runtime installed.

Rational ClearCase Remote Client for Eclipse (7.0.0) requires plug-in "org.eclipse.draw2d".

Example:



Rational ClearCase Remote Client for Eclipse (7.0.0) requires plug-in "org.eclipse.ui".

Example:



Updating Eclipse with GEF


Note: This section only applies to Eclipse. The Rational products (RSA, RSD, RAD, RSM, RFT, RTM) ship the GEF. Updating GEF in this fashion is not supported for these products.

Method 1: Download the GEF bits, create a Local Site on the Eclipse host and install the plug-in.

  1. Visit the GEF Project download page.
  2. Select and download the GEF bits for the version of Eclipse being used.
  3. Unzip the archive to a location on the local host.
  4. Following the steps above, create a New Local Site and point to the eclipse directory of the GEF plug-in and click Finish.

  5. Select the GEF feature to install
  6. Complete steps 6 - 9 above to finish installing the GEF plug-in.

Method 2: Create a Remote Site using a link that points to a location where the GEF plug-in can be downloaded and installed. Follow steps from Option 1 above to create a New Remote Site to install the GEF plug-in.

Note: Eclipse 3.2 provides an Update site out of the box that can be used to locate and download the GEF (Graphical Editing Framework) plugin.



Do you need more help?

For additional assistance, contact IBM Rational Client Support:
Submit an Electronic Service Request (ESR)
 
Related information
Uninstalling CCRC plug-in for Eclipse 3.0
Eclipse plug-in Matrix for ClearCase-ClearQuest
Updated Release Notes for the CCRC 7.0
Updated Release Notes for CCRC 2003.06.00
 
 
Cross Reference information
Segment Product Component Platform Version Edition
Software DevelopmentRational ClearCase LTClearCase Remote Client (CCRC)
Software DevelopmentRational ClearCaseIntegration: Eclipse plug-in
Software DevelopmentRational Software ArchitectClearCase Integration
 
 

Copyright and trademark information
IBM, the IBM logo and ibm.com are trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at "Copyright and trademark information" at www.ibm.com/legal/copytrade.shtml.
Rate this page
Please take a moment to complete this form to help us better serve you.
This material provides me with the information I need.




This material is clear and easy to understand.




Did the information help you to achieve your goal?
What updates, improvements, or related information would you like to see in this document?
Your response will be used to improve our document content. Requests for assistance, if applicable, should be submitted through your normal support channel as we cannot respond from this site.
Input the verification number to submit feedback:
Document information
 Product categories:
 Software
 Software Development
 Change, Configuration, & Release Management
 Rational ClearCase
 ClearCase Remote Client (CCRC)
 Operating system(s):
  Windows
 Software version:
  7.0, 2003.06.14, 2003.06.15, 2003.06.16
 Reference #:
  1215611
 IBM Group:
 Software Group
 Modified date:
 2005-08-29

Translate My Page
 
 

Rate this page

Help us improve this page. Your response will be used to improve our document content. Requests for assistance, if applicable, should be submitted through your normal support channel as we cannot respond from this site.