1.0 Introduction
2.0 Supported software and specifications
3.0 Installing the ClearCase SCM Adapter
4.0 Changes from the previous major release
5.0 Known problems and limitations
5.1
Dynamic views and silent checkouts
5.2
Using ClearCase tools to modify source files
5.3
"File has been removed from the file system" error
5.4 Dynamic views not starting automatically
This readme describes functionality changes, known problems, limitations, and workarounds that are associated with using the ClearCase tools in Eclipse.
For more information about the Rational ClearCase SCM Adapter, refer the online Help. To view the online Help for the ClearCase SCM Adapter:
Note: The online Help frequently refers to WebSphere Studio. For the purposes of the Help, you can interpret references to WebSphere Studio in the online Help as references to Eclipse.
The ClearCase SCM adapter requires the following software:
ClearCase Version Patch Required 4.2 (Full ClearCase) clearcase_p4.2.NT-14 or later 4.2 (ClearCase LT) clearcase_lt_p2001A.04.00.NT-8 or later 2002.05.00 (Full ClearCase) clearcase_p2002.05.00.NT-7 or later 2002.05.00 (ClearCase LT) ClearCase LT 2002.05.20 or later To obtain ClearCase releases and patches, go to www.ibm.com and click on the Support and downloads link.
Note: Rational Software does not support the use of Windows XP Pro with ClearCase LT 4.2.
Applications built on top of Eclipse 2.x are supported, such as WebSphere Studio Workbench 2.x and WebSphere Studio 5.x.
To install the ClearCase SCM Adapter, take the following steps:
- Download the ClearCase cc_scmadapter-win_2.3.1.09.zip file and extract the contents of the file to a directory in your file system.
- In Eclipse, choose Help > Software Updates > Update Manager. In the Feature Updates window, expand the My Computer entry, navigate to the directory that contains the contents of the scm_adapter.zip file, expand the ClearCaseSCMadapter folder, right-click on the eclipse folder, and choose Link Product Extension.
- The Install/Update dialog prompts you to restart the workbench. Choose Yes.
- In the Eclipse window, click Window > Customize Perspective.
- In the Customize Perspective dialog box, expand the Other entry, check the ClearCase option, and click OK.
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.
The following ClearCase options have changed or are no longer supported in the current version of the ClearCase SCM Adapter:
The following options are new in the current version of the ClearCase SCM adapter:
For more information about these topics, refer to the online Help for the ClearCase SCM adapter.
In Eclipse, a few non-interactive editors may not check out files when first modified. If one of these editors edits a checked-in file that is under ClearCase control in Eclipse, these editors silently check the file out of ClearCase automatically when they save the file. If you are using a shared branch within a dynamic view, the automatic check out process could create a potential problem. If you begin to edit a file that is not checked out, another user might check the file out, edit it, and check in a new version in the meantime. In this case, your changes will then overwrite the other user's changes when you save the file. Therefore, if you are using a shared branch within a dynamic view, you must check out files before editing them.
JavaTM .class files can get out of synch, since the incremental compiler is not run when the user changes a file from any tool outside of Eclipse (such as Notepad or ClearCase merge tools). If you modify a file outside of the workbench, you must perform a "Refresh" (from the context menu).
Under certain circumstances, when attempting to add a "view private" file to source control, Eclipse posts an error message which reads: "File has been removed from the file system." This problem only occurs when the file is open in an editor. The file has not actually been deleted and this error message can be safely ignored.
When using ClearCase 2003.06.00, dynamic views do not automatically start after rebooting your machine. When you try to open a project in WebSphere Studio after rebooting, you may see an error message that states that the .project file is missing. The workaround is to start your views manually in ClearCase after rebooting.