Tool Mentor: Setting Up the Implementation Model with UCM Using Rational ClearCase
This tool mentor describes how to set up a configuration management environment with Rational ClearCase Unified Change Management (UCM).
Tool: Rational ClearCase
Main Description


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

UCM Workflow Diagram

This tool mentor is applicable when running Microsoft Windows. It describes features available in full ClearCase.


There are some differences between RUP terminology and  that used by ClearCase. The following definitions of tool-specific terminology should help clarify the differences.

  • Activity: A ClearCase activity maps closely to a RUP Work Order.  Do not confuse it with the RUP concept of an Term Definition: activity.
  • Configuration Management: ClearCase's use of the term Configuration Management refers to Version Control and Build Management. RUP uses the IEEE and ISO definitions of Term Definition: configuration management (CM), which also includes Change Management as part of CM. 
  • Configuration and Change Management: Both ClearCase and Rational ClearQuest refer to Configuration and Change Management, which is similar to the RUP definition of Term Definition: configuration management.  RUP uses these terms synonymously.
  • Project: A ClearCase project maps to the RUP Project Repository.

Tool Steps

To set up a UCM project:

  1. Create a repository for storing project information
  2. Create components that contain the set of files the developers work on
  3. Create baselines that identify the versions of files with which the developers start their work
  4. Create the UCM project

1. Create a repository for storing project information

ClearCase projects require a project VOB (PVOB), which is used to store UCM objects and related information.

  1. To start the VOB Creation Wizard, from the Windows task bar, click Start > Programs > Rational Software > Rational ClearCase > Administration > Create VOB.
  2. At the first screen, be sure that the UCM project data check box is selected. 
  3. Select Help, which provides guidance for completing the wizard.  

helpbook icon Refer to the topic VOB Creation Wizard in ClearCase online Help for detailed information.  

2. Create components that contain the set of files the developers work on

Components are used to group a set of related directory and file elements within a UCM project. Typically, you develop, integrate, and release the elements that make up a component together. A project must contain at least one component, and it can contain multiple components. Projects can share components.

You can create a component with the VOB Creation Wizard:

  1. Click Start > Programs > Rational ClearCase Administration > Create VOB
  2. At the first step of the wizard, check Create VOB as a UCM component. The new VOB can be used as a component by UCM projects. 

You can also migrate existing data stored in VOBs to UCM projects by converting existing VOBs into components:

  1. Navigate to ClearCase Project Explorer. From the Windows task bar, click Start > Programs > Rational Software > Rational ClearCase > Project Explorer.
  2. Select the root folder of the PVOB. 
  3. Click Tools > Import VOB. The Import VOB dialog box appears. In the Available VOBs list, select the VOB that you want to make into a component. 
  4. To move the VOB to the VOBs to Import list, click Add.  
  5. When you are finished, click Import.

book icon See the section titled "Creating Components" in the ClearCase manual titled Managing Projects.

3. Create baselines that identify the versions of files with which the developers start their work

Baselines identify one version of every element of a component, representing a stable source configuration from which to start work. Their use is required by the UCM model to access files and directories of a component.

When ClearCase components are created from scratch, they are created with an initial baseline.;

If you are converting a base ClearCase VOB into a component, you can make baselines from existing labeled versions. Check whether the latest stable versions are labeled. If they are not, you need to create a label type and apply it to the versions that you plan to include in your project.

helpbook icon For detailed information, refer to the topic Using the Apply Label Wizard in ClearCase online Help.

To create a baseline from the set of versions identified by a label type:

  1. In ClearCase Project Explorer, select the root folder for the PVOB. Click Tools > Import Label. The Import Label Wizard appears.
  2. In the Available Components list, select the component that contains the label from which you want to create a baseline.
  • To move the component to the Selected Components list, click Add.
  • Click Next when finished. 
  1. In Step 2 of the Import Label Wizard, select the label type that you want to import. Enter the name of the baseline that you want to create for the versions identified by that label type. Select the baseline's promotion level. Click Finish.

This procedure creates one of the project's foundation baselines, which identify the versions of files with which the developers start their work.

helpbook icon Refer to the Create and manage baselines topics in ClearCase online Help.

4. Create the UCM project

After creating a project VOB and the components you will use, you are ready to create the UCM project. To do this, you must supply a project name, and identify project components and baselines for the project. ClearCase provides a Create New Project Wizard that walks you through the steps of this procedure.

  1. In the ClearCase Project Explorer, select the root folder of the PVOB. Click Create New Project from the pop-up menu to start the wizard.
  2. Follow the steps presented by the wizard. Help for each step is available by clicking the Help button on each screen.
  3. At Step 3 of the wizard, Add the component baselines to be used in this project, specify the baselines you created in procedure 3 above.
  4. The next two steps of the wizard ask you to specify detailed configuration information for your project, including development policies, and whether to enable the project to work with a Rational Change Request database. Configuration can be tailored to meet your project's specific needs. See the online Help for a description of all available options.

helpbook icon Refer to the following topics in ClearCase online Help for an overview of this procedure:

  • Workflow for creating projects 
  • New Project Wizard