Introduction

This readme describes functionality that is associated with using the IBM® Rational® ClearCase® tools in Eclipse™. After installing the ClearCase SCM Adapter, you can refer to the online help for more information about using this product. To view the online help for the Rational ClearCase SCM Adapter:

1. In Eclipse, select Help > Help Contents.
2. In the Help dialog, select Rational ClearCase SCM Adapter.

Note: The online help frequently refers to the IBM Rational Application Developer product (RAD). For the purposes of this help, you can interpret references to RAD in the online help as references to Eclipse.

Supported software and specifications

The ClearCase SCM adapter requires the following software:

• One of the following platforms: Windows 98, Windows ME, Windows NTR 4.0, Windows 2000, Windows XP Professional, SLES 9, Red Hat Enterprise Linux 2.1, Red Hat Enterprise Linux 3.0, Red Hat Enterprise Linux 4.0, or Sun Solaris 8
• Eclipse 3.0 or later
• ClearCase 5.0 or later (ClearCase or ClearCase LT) with the latest patches. The following table lists the patches required for each version of Rational ClearCase:

To obtain ClearCase releases and patches, go to the Rational ClearCase product support page on ibm.com and and click on All Rational ClearCase downloads.

To download the latest Rational ClearCase SCM Adapters and MVFS plug-ins, click here.

Installing the ClearCase SCM adapter

To install the Rational ClearCase SCM Adapter, take the following steps:

1. Download the file com.r.cc.win32-20061206.zip if you are running on Windows or the com.r.cc.linux-20061107.zip file if you are running on Linux or Solaris. Extract the contents of the file to a directory in your file system.
2. In Eclipse, select Help > Software Updates > Manage Configuration. In the Product Configuration window, click the Add an Extension Location link in the Eclipse platform pane.
3. The Browse for Folder dialog prompts you to choose an extenstion location, expand the My Computer entry and navigate to the directory that contains the contents of the extracted zip file. Expand the Eclipse folder and click OK.
4. The Install/Update dialog prompts you to restart the workbench. Click Yes.
5. In the Eclipse window, click Window > Customize Perspective.
6. In the Customize Perspective dialog box, click the Commands tab, ensure that the ClearCase option under the Available command groups column is checked, and click OK.

Note: This installation procedure will NOT disable previous versions of the ClearCase SCM Adapter feature. You MUST disable the earlier versioned features manually in the Manage Configuration sheet in order to ensure proper functionality.

Following this procedure, the ClearCase menu option appears in the main menu of your Eclipse window, the ClearCase icons appear, and the installation of the ClearCase SCM Adapter is complete.

Summary of changes from the previous release

The following options are new in the current version of the ClearCase SCM Adapter:

• The 7.0.0.x version of the ClearCase SCM Adapter will better coexist with the ClearCase Remote Client (aka CCRC). When both are installed, with each capability enabled, the user, when importing team project sets now has the option to import to a specific view type serviced by each plugin eg. web views for CCRC and snapshot/dynamic views for the ClearCase SCM Adapter.
• Team & Share now will recall the last 5 VOB storage locations used when putting Eclipse projects under source control.

The following problem has been addressed in the current version of the ClearCase SCM Adapter:

• When using Eclipse 3.2 and later with the MVFS Adapter and the ClearCase SCM Adapter installed, the prompt for workspace selection fails to appear on workbench start after the first use of a workspace.

Support for the following platforms is new in the current version of the ClearCase SCM Adapter:

• Red Hat Enterprise Linux 4.0 and later
• Sun Solaris 8 and later

ClearCase MVFS support

MVFS support is provided by the ClearCase MVFS Refresh plug-in (a separate download).

This Team preference option refreshes the Eclipse file system when it detects changes made to ClearCase elements outside your dynamic view after the changes have been checked in to ClearCase. The ClearCase SCM Adapter works in concert with the MVFS plug-in, however the SCM Adapter can still function as previously without this plug-in installed. To take full advantage of the MVFS support for source control status refreshing requires the SCM Adapter version 6.0.48 or later.

• Enable ClearCase dynamic view file system support: Select this option to automatically update the Eclipse file structure with changes to ClearCase elements. By default, this option is inactive. To activate this option, you must select the Window > Preferences > Workbench > Refresh workspace automatically option in Eclipse.
• Refresh polling interval (seconds): Enter the time in seconds that the ClearCase SCM Adapter should wait before polling the ClearCase view server for VOB events. The minimum time is 10 seconds. By default, this interval is set to 20 seconds.

About the author

Comments (Undergoing maintenance)

Back to top

Trademarks  |  My developerWorks terms and conditions

Table of contents

• About the author
• Comments