ClearCase Integration

To enable the integration:

1. Start GUI Client.

2. Click Add to create a new SCM configuration.

3. In the subsequent SCM Configuration dialog, specify the local source code location.

4. Select ClearCase in the SCM drop-down list.

5. Several options will become available. These are specifically tailored to configure ClearCase integration.

   Option	Description
   CCRC Server URL	An URL of the ClearCase server. Required for remote connections.
   CCRC User Name	A username you want to use to authorize on the ClearCase server. Required for remote connections.
   CCRC Password	A password you want to use to authorize on the ClearCase server. Required for remote connections.
   Cleartool Executable	A full path to the cleartool command line client (clearcase.exe).
   Update Snapshot View	If selected, updates ClearCase snapshot views before uploading files to a Collaborator review.

   

6. Once ready, click Validate to make sure the integration is operational.

After that, a new configuration for ClearCase will appear on the main screen of the GUI Client.

Select it, then click on the corresponding button depending on what you want to do next:

• Add Changes – Upload files that you have checked out to the Collaborator server and add these to a review.

  

• Add My Activities – Upload files from selected activities that you own to the Collaborator server and add these to a review.

  

• Add Activities – Upload changes from a specific named ClearCase activity to the Collaborator server and add these to a review.

  Note:

  You cannot upload activities that have CHECKEDOUT versions, if you do not own these activities.

  

• Add Versions – Upload versions of files in your working copy of ClearCase repository and add these to a review on the Collaborator server.

  1. Specify a name for a review or select the existing review.

  2. Click Next.

  3. In the dialog, you need to select one or more files in your checkout, which you have specified during the configuration.

     

  4. Click Next.

  5. On the next page, there are files you have selected. You need to select versions of these files you want to add to the review.

     Enter the ClearCase versions of each file to the Before and After columns.

     Tip:	To specify versions, you can use the local and LATEST keywords. To learn about ClearCase keywords, please see the ccollab addversions command description.

     

     To fill the before and after versions for all files automatically, specify the needed version in the Autofill After versions and Autofill Before versions edit boxes, then click apply.

     To clear previously specified versions, enter an empty string to these edit boxes, then click Apply.

     

  6. (Optional) Specify a branch you want to use:

     

     You can input the absolute branch version path (for instance, \main\branch_new_1\sub_branch_new_1\1) or relative path (\sub_branch_new_1\1).

In the Command-Line Client, you can create a review for various activities and files contolled by ClearCase.

For example, to create a new review and add all changes in the add_new_scm_support activity, you can use the following command:

Commands recommended for ClearCase

ccollab addchanges - Attaches locally-modified files to a review.

ccollab addchangelist - Attaches an atomic changelist to a review.

ccollab addversions - Attaches any 2 given versions to a review.

ccollab addactivity - Attaches file versions in a ClearCase activity to a review.

ccollab commit - Commit changes in the review.

There is an option for the addchanges command that allows local changes to be uploaded with a predecessor version in another branch as the previous version. For this purpose, use the --diffbranch option:

For example, to create a new review and add all changes in the current directory and below, and compare them to the predecessor versions in the \main branch, you would use:

You can also use the special branch name pre to refer to the predecessor branch. For example, to add the local changes to hello.c compared to the most recent predecessor version in the previous branch to review 45, you would use:

• The addversions command will upload arbitrary versions of ClearCase files after they are checked in.

• The addactivity command will upload UCM change sets for review.

In most cases, the Command-Line Client can automatically detect your ClearCase configuration. Try testing your configuration to verify the configuration is detected correctly.

If the Command-Line Client is unable to detect your ClearCase configuration or you want to override the detected settings, you can manually specify ClearCase settings using global options.

To manually configure the Command-Line Client to use ClearCase, execute the following command:

ClearCase-specific Options

Eclipse Plug-in seamlessly integrates with the IBM Rational ClearCase SCM Adapter plugin or with the open source ClearCase plugin for Eclipse. With this, you can upload locally modified files to a review directly from your preferred plugin.

To learn more, please see Add to Review Wizard.

Collaborator administrator can configure the Collaborator server to communicate directly with ClearCase repositories. Server-side integration allows users to upload commited atomic changelists (activities in terms of ClearCase) from the Web Client without having to install and configure client-side tools.

To upload changelists:

• Log in to Web Client.

• Create a new review, or open an existing one.

• Scroll to the Review Materials section of the Review Screen.

• Click Upload button and then select the item corresponding to the desired repository.

  Note:

  Item titles are specified by your Collaborator administrators and they will vary from those in the image below.

  

• In the ensuing dialog, specify the IDs of desired changelists. Separate multiple IDs by space character.

  

• Click Attach to upload the specified changelists to the review.

Configure Server-Side Integration