Import Rational ClearCase UCM project code into Rational Team Concert

IBM Rational Team Concert includes a Rational ClearCase connector, or synchronizer, that helps with importing code from ClearCase VOBs into Rational Team Concert. When you plan to move projects that currently use Rational ClearCase to Rational Team Concert, there is project source code in Rational ClearCase that you need to import into Rational Team Concert source control. Prachi Mittal shows you how.


Prachi Mittal (, Software Engineer, Rational Tools Administrator, IBM

Prachi Mittal is a software engineer in the IBM India Software Labs, in Pune, India. She works with the Rochester System and Technology group labs in the USA and supports their Rational tools environment, which includes ClearCase, ClearQuest, Focal Point, and Rational Team Concert. She has been working as a Rational tools administrator for more than three years.

22 May 2012

Also available in Chinese

IBM® Rational Team Concert™ includes IBM® Rational® ClearCase® connectors (synchronizers) that support operations between these two applications. This article describes the steps for importing code from ClearCase to Rational Team Concert. It also covers steps involved when there is UCM integration with ClearQuest.


  • A computer running Microsoft Windows that can be set up as synchronization host
  • Rational Team Concert Version 2 or 3.0.1
  • Rational ClearCase Version 7.1.2

Setup steps

First, you need to create the necessary IDs with the required privileges and set up a synchronized host.

Create user accounts with necessary privileges

Create a ClearCase user ID and a Jazz User ID with the necessary privileges.

ClearCase User ID permissions

Create a user ID on the ClearCase server.

  • This ID should have access to VOB with the data that needs to be migrated to Rational Team Concert.
  • If the versioned object base (VOB) storage directory is shared with a Samba application, make sure to create a Samba ID on the ClearCase server.

Jazz User ID license and permissions

The Admin account holder needs to create a Rational® Jazz™ user ID (use ccsync for this example).

The Jazz user ID needs to meet these criteria:

  • Has ClearCase Synchronizer Client Access License
  • Has JazzUser role access to the repository
  • Is designated as a member of Rational Team Concert project area where the code needs to be migrated

The Jazz user account must have process permissions in that team or project area to perform these tasks: create workspaces, create components, deliver to streams, add components to streams, create, and modify work items, or create and modify build engines and build definitions

Set up a synchronized host

  1. Decide on a synchronized host machine. It should have the Rational Team Concert Eclipse client, ClearCase Synchronizer, and ClearCase client installed on it.
  2. If there is UCM integration with Rational ClearQuest, make sure to install the Rational ClearQuest client on the synchronized host.
  3. Import the required ClearQuest schema repository connections by using the ClearQuest Maintenance Tool, and verify your login information for the ClearQuest client.
  4. Create a user account on the synchronized host machine. The login ID should have same credentials (user ID and password) as the ClearCase ID.
  5. Log in to the synchronized host using the same user account that you use for the ClearCase ID.
  6. Verify that your ClearCase user account is set up correctly:
    1. Click Start and then Run.
    2. Enter the path to the VOB storage location, typically either:
      \\clearcase server name\VOB Global path\
      \\clearcase server name\shared directory listed in smb.conf for the VOB Global path\

When you are connected, you should see the .vbs folder for your VOB.

Figure 1. Verify the connection to ClearCase VOBs
Screen segment shows two .vbs folders
  1. Create a new dynamic view on the stream or branch to be synchronized.
  2. Mount VOBs in that view.
  3. Check out or check in to create a version in that view.
  4. For a UCM user: Create a baseline in the stream for that view. The ClearCase ID must be the UCM stream owner.
  5. Lock and unlock the stream.

Migration steps

You will be starting the migration now. Migration includes setting up a ClearCase synchronized stream, a merge workspace, setting properties of the ClearCase synchronized stream, and the import action.

Set up a ClearCase synchronized stream and a merge workspace

  1. Log in to the Rational Team Concert Eclipse client, and select the Team Artifacts view.
  2. Create a new repository connection:
    1. In the Team Artifacts view, select Repository Connection.
    2. Then click New > Jazz Repository Connection in the drop-down menus.
Figure 2. Connect to the Jazz repository from the Eclipse client
Shows screen and drop-down menu selections
  1. In the Jazz Repository Connection dialog window, fill in the details:
    • Location: Fill in the URI. The name will be automatically populated as the Rational Team Concert server from URI.
    • Authentication: Select Authentication Type as Username and Password from drop-down menu, and then fill in the User ID and password.
  2. Click Finish.
Figure 3. Enter URL, login ID, and password
login window to connect to Jazz repository
  1. Connect to project areas within the connected Jazz repository (Figure 4):
    1. In the Team Artifacts view, go to Repository Connections and select the Repository Connection that you created in steps 2 and 3.
    2. Select Manage Connected Project Areas from the drop-down menu.
    3. Select the project area of interest by checking the box next to the project in the Manage Connected Project Areas window.
Figure 4. Manage connected project areas
Manage Connected Project Areas selected on menu
  1. Click Finish.
Figure 5. Select the project area
Check box selected next to Training Project
  1. If you already have a Jazz repository connection, log in:
    1. In the Team Artifacts view, go to Repository Connections and select the existing connection.
    2. Right-click the repository connection, and select Log In to connect.
Figure 6. Log in to the repository
Menu selections to connect to the Jazz repository
  1. Create new synchronized stream for importing the code by selecting File > New > Other.
Figure 7. Set up a new stream synchronized with ClearCase
File, New, Other selected
  1. In the Select a wizard view (Figure 8), under Jazz Source Control, select ClearCase Synchronized Stream, and then click Next.
Figure 8. Select appropriate option in Jazz source control
Screen labeled New, Select a wizard view
  1. In the ClearCase Stream Information view (Figure 9), select Import from an existing UCM stream.
  2. In the ClearCase stream selector field, enter the stream name.
  3. So that you can import the history along with the code, select the check box for Import with history from ClearCase.

For base ClearCase, select Import from existing Base ClearCase branch.

Figure 9. Enter the name of the ClearCase stream where the code resides
Enter ClearCase source code import information
  1. In the ClearCase Storage Information view (Figure 10), for the "UNC path to local share" field, enter \\hostname\viewstorage, where hostname is the synchronized machine hostname and viewstorage is a shared directory created for ClearCase view storage in the C: drive of the synchronized machine.
  2. Select a radio button for an appropriate line ending of text files in the VOB option.
  3. Click Next.
Figure 10. Enter the path to the shared folder on the synchronized machine
Enter shared folder path for view storage
  1. Select the project area or team area for which code is being imported, and click Next.
Figure 11. Select the owner of the new synchronized stream
Select Project or Team Area view

A new merge workspace will be created in this step, and you can change the default name. You can also associate an existing work item in Rational Team Concert for code import.

  1. In the "Jazz synchronization engine options" field, type the Jazz ID (ccsync), which was created for code import in the Jazz repository.

This ID has a ClearCase Synchronizer Client Access License assigned to it. The Install location is the location where ClearCase synchronizer is installed, and it ends with ccctools.

  1. Click Finish.
Figure 12. Enter Jazz Source control Information
Enter Jazz ID, Password, Install location

If your project is enabled for ClearQuest

After the synchronization stream is created, you will get prompted to import files. This step is required only if your ClearCase project is enabled for IBM® Rational® ClearQuest®. If the UCM project is not ClearQuest-enabled, skip this step, and just click OK. If your ClearCase project is ClearQuest-enabled, you need to add settings, so cancel the Import window for now.

Set ClearCase synchronized stream properties

There are two properties for the ClearCase synchronized stream that you need to set: ClearCase provider properties and Jazz provider properties.

  1. In the ClearCase Synchronized Streams view, right-click the synchronized stream that was created previously, and select Properties.
Figure 13. Open the properties of the synchronized stream
ClearCase synchronized stream properties

Set ClearCase provider properties

The ClearCase Provider Properties page includes filling the ClearQuest schema repository name, the ClearQuest database name that is integrated with ClearCase VOBs, and filling in the ClearQuest login ID.

  1. In the Properties window, select the ClearCase provider properties.
  2. Set the following property values:
    • Set CLEARQUEST_DBSET_NAME to the name of the Rational ClearQuest schema repository for the database that supports the UCM project. This repository must be accessible from the synchronization host.
    • Set CLEARQUEST_LOGIN_NAME to a Rational ClearQuest user name to use with the UCM project.
    • Set CLEARQUEST_USERDB_NAME to the name of the Rational ClearQuest user database used by the UCM project. This database must be accessible from the synchronization host.
Figure 14. Set ClearCase provider properties
ClearCase Provider Properties page

Set Jazz provider properties

  1. In Jazz Provider properties, look for the path listed against STREAM_SCRIPT_DIR (Figure 15), change the directory to the path (Figure 16), and fill in the ClearQuest password in the admin.cq_passwd file:
  2. Select Jazz provider properties. In the folder named STREAM_SCRIPT_DIR, create a text file named name.cq_password, where name is the value of the CLEARQUEST_LOGIN_NAME property. The file must contain a single line in this form:


    where xxxxxx is the password of the user named CLEARQUEST_LOGIN_NAME. The synchronization process ClearCase account must have permission to read this file. It should not be readable by others.
Figure 15. Jazz Provider Properties showing path for ClearQuest password file
STREAM_SCRIPT_DIR on Jazz Provider Properties
  1. Click OK.
Figure 16. Local path shown by STREAM_SCRIPT_DIR
The admin.cq_password file

Request synchronization or select what to synchronize

After the properties are set for the synchronization stream, you can either request synchronization or select files, folders, and baselines to synchronize (import).

  1. To request synchronization, right-click the ClearCase synchronized stream in the ClearCase Synchronized Streams view, and click Request Synchronization (Figure 17)
Figure 17. Submit the synchronization request
Request synchronization with ClearCase
  1. To select files to synchronize, right-click ClearCase synchronized stream in the ClearCase Synchronized Streams view, and click Select Files To Synchronize (or you can click the pencil icon on top right, see Figure 18).

You can update files that are already imported by using the Synchronize option. Use the Import option only for fresh files that are not in Jazz source control.

Figure 18. Select files and folders to be imported (synchronized)
Icon to select files and folders to synchronize

If you select the files, folders, and baselines to synchronize or import option (Figure 18), you will see mounted VOBs. Browse to select the appropriate component. In ClearCase terminology, mounted VOBs are the VOBs that are active, and users can read and modify data only if VOBs are mounted.

  1. Select files and folders inside VOB that need to be imported.
Figure 19. Browse to find files to import
Browse window for files to synchronize
  1. There are two options: either import all baselines or import only baselines that have specific attribute types associated with them (Figure 20).
  2. Click Finish.
Figure 20. Select whether to import all or only selected baselines
Radio button selected to import all baselines
Figure 21. Import window showing import is in progress
Progress bar during import of files

The remaining screen captures show the status of the import process as it progresses.

Figure 22. Status of the import is Pending
Status column shows Pending
Figure 23. Status of the Active
Status column shows Import Active
Figure 24. Refresh the view to see the latest status
Refresh Table option, far right
Figure 25. ClearCase Synchronized Streams view shows status
Status column shows import succeeded, date, time



Get products and technologies

  • Download Rational Team Concert from and try it, free, on up to 10 projects for as long as you want (requires registration).
  • Evaluate IBM software in the way that suits you best: Download it for a trial, try it online, use it in a cloud environment, or spend a few hours in the SOA Sandbox learning how to implement service-oriented architecture efficiently.



developerWorks: Sign in

Required fields are indicated with an asterisk (*).

Need an IBM ID?
Forgot your IBM ID?

Forgot your password?
Change your password

By clicking Submit, you agree to the developerWorks terms of use.


The first time you sign into developerWorks, a profile is created for you. Information in your profile (your name, country/region, and company name) is displayed to the public and will accompany any content you post, unless you opt to hide your company name. You may update your IBM account at any time.

All information submitted is secure.

Choose your display name

The first time you sign in to developerWorks, a profile is created for you, so you need to choose a display name. Your display name accompanies the content you post on developerWorks.

Please choose a display name between 3-31 characters. Your display name must be unique in the developerWorks community and should not be your email address for privacy reasons.

Required fields are indicated with an asterisk (*).

(Must be between 3 – 31 characters.)

By clicking Submit, you agree to the developerWorks terms of use.


All information submitted is secure.

Dig deeper into Rational software on developerWorks

Zone=Rational, DevOps
ArticleTitle=Import Rational ClearCase UCM project code into Rational Team Concert