Convert base ClearCase VOB to a UCM Component

Answer

Scenario:

The existing project is using a base ClearCase VOB. However, as the project requirements have changed, the project is being moved to a UCM environment in order to use the features UCM provides.

Yes, the following steps can be used to convert a base ClearCase VOB to a UCM component.

Refer to the IBM Rational ClearCase Command Reference Manual for details regarding the command line syntax used in the steps below.

1. Create a UCM project VOB
   
   M:\>cleartool mkvob -tag \eric5_pvob -ucmproject -stgloc vob
   
   Comments for "C:\cc_storage\vob\eric5_pvob.vbs":
   Project VOB.
   .
   Created versioned object base.
   Host-local path: mylaptop:C:\cc_storage\vob\eric5_pvob.vbs
   Global path: \\mylaptop\cc_storage\vob\eric5_pvob.vbs
   VOB ownership:
   owner DOMAIN1\patrick
   group DOMAIN1\user
   
   VOBs have special data backup considerations. For more information on how to
   back up your VOB properly, see the documentation for administering ClearCase.
   If the backups aren't done properly, you are putting your data at risk!
   
   
2. Create a UCM project
   
   M:\>cleartool mkproject -in RootFolder@\eric5_pvob project:Project_1@\eric5_pvob
   Created project "Project_1".
   
   
3. Attach version labels to latest versions of all elements in the Base VOB to be imported as a component.
   
   Example:
   
   M:\dview\basevob1> cleartool mklbtype –nc LABEL1
   Created label type "LABEL1".
   M:\dview\basevob1>cleartool checkin -nc .
   Checked in "." version "\main\5".
   M:\dview\basevob1>cleartool mklabel -r LABEL1 .
   Created label "LABEL1" on "." version "\main\4".
   Created label "LABEL1" on ".\aj.txt" version "\main\1".
   Created label "LABEL1" on ".\b.txt" version "\main\1".
   Created label "LABEL1" on ".\f.txt" version "\main\1".
   Created label "LABEL1" on ".\lost+found" version "\main\0".
   Created label "LABEL1" on ".\new folder" version "\main\1".
   Attempted to apply labels to 6 versions.
          6 newly applied
          0 moved
          0 already in place
          0 failed
   
   
4. Import VOB as component in ClearCase Project Explorer:
   
   
1. Right click Component in Project Explorer
2. Select Import
3. Select VOB as Component
   
   
   
   
   
4. Select the VOB to be imported
5. Click Add
6. Click Import
   
   
   
   
   
5. Import the label as a baseline
   
   
1. Right click the base vob listed under Component (basevob1 in the example below)
2. Select Import Label
3. Select the label to import.
4. Click OK
   
   Example:
   
   
   
   
   
6. Change the configuration of the stream
   
1. Right Click an Integration stream
2. Select properties -> configuration tab -> add -> Component (basevob1) -> change -> all streams
3. Select the label to be imported (LABEL1_basevob1_IMPORT in this example)
4. Click OK -> Rebase Stream preview: to complete the rebase
5. Click OK -> complete -> OK -> close
   
   
   
   
   
   
7. Recommend baselines and then rebase
   
1. Right click the Integration stream -> recommend baselines ->
2. Select the baseline (LABEL1_basevob1_IMPORT in this example)
3. Right click the development stream
4. Select Rebase Stream