Purpose

This tool mentor describes how to update development work areas with work that has been integrated, tested, and approved for general use. 

This section provides links to additional information related to this tool mentor.


Overview

The following diagram illustrates the UCM workflow. Shaded areas are discussed in this tool mentor. 

UCM Workflow Diagram

In the UCM model, activities (work) delivered from multiple sources are integrated and organized into baselines. Usually, baselines go through a cycle of testing and bug fixing until they reach a satisfactory level of stability. When a baseline reaches this level, your project manager designates it as a recommended baseline for the stream.

To work with the set of versions in the recommended baseline, rebase your development work area. To minimize the amount of merging necessary while you deliver activities, rebase your development work area with each new recommended baseline as it becomes available. 

This tool mentor is applicable when running Microsoft Windows.

Tool Steps

A rebase operation involves the following tasks:
  1. Prepare your development view
  2. Start the rebase operation
  3. Merge files
  4. Test your development work area
  5. Complete the rebase operation

Refer to the following ClearCase online Help topics for detailed information on the steps for this procedure: 

  • Comparing files, directories, and versions
  • Merging files, directories, and versions

1. Prepare your development view To top of page

  1. Check in all work before beginning a rebase operation. ClearCase updates only checked-in files and directories. The ClearCase Find Checkouts utility finds checked out versions in your view.
  2. Navigate to your development work area. In the left pane, right-click the view directory, and click ClearCase > Find Checkouts.

Refer to the topic titled Finding checked out elements in ClearCase online Help for detailed instructions on finding and checking out work.

2. Start the rebase operation To top of page

  1. Begin the rebase operation from a view attached to your development stream. 
  2. The Rebase Stream Preview dialog box displays the project's recommended baselines for rebasing. When the rebase operation begins, it performs file merges and informs you of file conflicts that must be resolved manually. 

Refer to the topic titled  To start a rebase operation in ClearCase online Help for detailed instructions on this procedure.

3. Merge files To top of page

  1. ClearCase merges the work in your development stream with the work from the integration stream, completing trivial merges automatically.  
  2. If non-trivial merge conflicts occur, the rebase operation starts the DiffMerge utility and prompts you to resolve the conflicts. 

Refer to the topic titled Merging files, directories, and versions in ClearCase online Help for detailed information on the steps in this procedure.

4. Test your development work area To top of page

  1. Build and test the source files in your development view to verify that your undelivered activities were built successfully with the versions in the baseline. 
  2. After you rebase, build and test the source files in your development view to verify that your undelivered activities were built successfully with the versions in the baseline.

5. Complete the rebase operation To top of page

Completing a rebase operation consists of two tasks: checking in any merge results and changing the state of the operation to complete. 

  1. After testing your work, click Complete in the Rebase Status dialog box. 
  2. ClearCase checks in any versions checked out to your development view and notifies your development stream that the rebase operation is complete.
  3. Click Close to dismiss the dialog box.

See "Rebasing Your Work Area" in the ClearCase manual Developing Software for detailed information on each step. 



Rational Unified Process   2003.06.13