Setting up and Using the Rational Rose integration with ClearCase

Answer

Setting the SourceCodeControlProvider key if you have ClearCase installed

Configuring Rational Rose

Starting the integration

Sharing the model

Performing ClearCase Functions

Model Merges with Integration

Change History

Setting the SourceCodeControlProvider key if you have ClearCase installed

1. Click Start > Run...
2. Type regedit
3. Click OK
4. Navigate to HKEY_LOCAL_MACHINE\SOFTWARE
5. Select SourceCodeControlProvider
6. Set the value of the ProviderRegKey to Software\Atria\ClearCase
   
   
7. Close the Registry Editor

Configuring Rational Rose

1. Launch Rose
2. Click Add-Ins > Add-In Manager...
3. Disable the Version Control Add-In
4. Enable the ClearCase Add-in
   
   
5. Click Apply
6. Click OK
7. Click File > Edit Path Map...
8. Type CURDIR in the Symbol field
9. Type & in the Actual Path field
10. Click Add
    
    
11. Click Close

Starting the integration

Note: These steps will take place after the model has been created

1. Click File > Save As...
2. Navigate to the desired ClearCase view
3. Click Save
4. Right-click on the model
5. Click Add to Version Control
   
   
6. Select the files to be added to source control
7. Click OK
   
   
8. Click OK
   

Sharing the model (subsequent users)

1. Launch Rose
2. Click File > Open...
3. Navigate to model through a ClearCase view
4. Select the model
5. Click Open

Performing ClearCase Functions

All ClearCase functions will be performed at the file level and not the element level. To perform a ClearCase function such as Check Out, follow these steps:

1. Select the file
   example: *.mdl,*.cat,*.sub
2. Right-click
3. Click the desired ClearCase function

OR

1. Click Tools -> ClearCase
2. Click the desired ClearCase function

Model Merges with Integration

1. Click Yes
   
   
   
   Note: DO NOT enable Merge the file graphically. If user input is needed due to a nontrivial merge, Rose will bring up the Rose Model Integrator.
   
2. In the Rose Model Integrator use the 1, 2, or 3 button to accept the change
   
   
   
   
   Note: Contributor 1 is the base, Contributor 2 is the remote (repository) version, and Contributor 3 is the local version. The arrows can be used to navigate through the conflicts.
   
3. Once the conflicts have been resolved, close the merge editor by clicking the "x"
4. Click Yes to save the merge result
   
   
   
5. Click Yes to check in the model
   
   
   
6. Click OK
   
   
   

NOTE: This solution contains information about modifying the system registry. Before making any modifications to the Microsoft® Registry Editor, it is strongly recommended that you make a backup of the existing registry. For more information describing how to back up the registry, refer to the Microsoft Knowledge Base article 256986 http://support.microsoft.com/kb/256986.