Integrate Rational ClearCase with Rational Team Concert 3.0

Get an overview of the IBM Rational ClearCase and Rational Team Concert integration setup to integrate ClearCase UCM VOB source code data into Rational Team Concert source control management, using the ClearCase Importer. This article explains how to import files and folders from UCM streams to Rational Team concert and use of the Change Flow Target feature.

Murali Dhandapani (muralindia@in.ibm.com), IT Specialist, IBM

author photoMurali Dhandapani is part of the ISL Operations Software Engineering Service team at IBM Software Labs, India. He is an IBM Certified IT Specialist in System Management and works as a technical lead for Rational Jazz products infrastructure deployment. Murali has a master’s degree in computer science and is an IBM Certified Specialist in System p administration and IBM eServer Certified Systems Expert - pSeries HACMP.


developerWorks Contributing author
        level

10 January 2012

Also available in Chinese

Introduction

This article gives an overview of how to set up an IBM® Rational® ClearCase® client and the IBM® Rational Team Concert™ Eclipse client with the synchronization tool to integrate Rational ClearCase with Rational Team Concert. The systematic instructions help you import ClearCase UCM versioned object base (VOB) source codes into the Rational Team Concert source control management system by using the ClearCase Importer.


ClearCase prerequisites

Note:
This article is based on the assumption that the ClearCase server is already with a UCM VOB with proper user/group access.

Be sure that you have the following ready on the ClearCase client machine to access the UCM VOB from the ClearCase server:

  1. Install the appropriate release area on the ClearCase client machine that is running Microsoft Windows, and make sure that the desired VOBs are accessible through a dynamic view.
  2. Identify the development stream to be imported.

Rational Team Concert prerequisites

The Rational Team Concert server used while preparing this article was an AIX machine installed and configured with Rational Team Concert Enterprise, Version 3.0.1. JTS.WAR and CCM.WAR files were installed on an IBM® WebSphere® Application Server, Version 7.0, with Fix Pack 7.0.0.17.

Rational Team Concert server

Configure these on the Rational Team Concert server:

  1. Create a Project Area using the scrum template.
  2. Include the members (users) in the Project Area (the user who is creating the synchronization stream, and the ClearCase synchronizer account).
  3. Assign Team Member or Scrum Master roles as needed.

Rational Team Concert Eclipse client machine

You need these configurations on the Rational Team Concert Eclipse client machine:

  1. On the same ClearCase client Windows machine, install the Rational Team Concert Eclipse client software.
  2. Install the ClearCase Synchronizer software and make a note of the ccctools path.
  3. The Rational Team Concert user ID should have a Developer license.
  4. The ClearCase Synchronizer account should have a ClearCase Synchronizer license.

Rational ClearCase and Rational Team Concert setup architecture

ClearCase and Rational Team Concert integration requires software configuration on appropriate hardware. The diagram in Figure 1 shows the setup used as the basis for this article.

Figure 1. ClearCase and Rational Team Concert setup
Flow diagram of setup

Import ClearCase data from the UCM stream

This section explains how to import files or folders from ClearCase UCM stream to Rational Team Concert.

  1. Open Rational Team Concert Eclipse client, and click File > Import.

The screen shown in Figure 2 will prompt you for input.

Figure 2. Import data from an existing UCM stream
Selection typed in ClearCase stream selector field
  1. Select Import from an existing UCM stream, enter the steam name along with project VOB (PVOB) name (Stream Name@\PVOB), and click Next.
  2. In the Import ClearCase Stream view, below ClearCase Storage Information, enter the storage path in the field labeled UNC path to a local share, and click Next.
Figure 3. ClearCase storage information
UNC path field shows \\xtest17\shareCC entered
  1. In the Select Project or Team Area view, select the Rational Team Concert project from the directory shown, and then click Next.
Figure 4. Select project or team area
WebSphere Adapter 7501 (Main Development) selected
  1. In the Jazz Source Control Information section, update these fields:
    • New Merge Workspace name
    • Jazz synchronization user ID and password
    • Rational Team Concert-ClearCase Connector software ccctools path (install location)
    • Leave the remaining fields and check boxes with default values.
Figure 5. Update synchronization of the user ID and tool path
Jazz Source Control Information dialog window

Tip:
The Jazz user ID (Rational Team Concert user) must not be same as the Jazz synchronization user ID mentioned in Figure 5. The Jazz synchronization user ID should have a Rational Team Concert ClearCase Synchronizer license for Rational Team Concert.

  1. Select the files and folders from ClearCase and click Finish.

Importing the files and folders will take some time.

Figure 6. Select files to synchronize
Select files to import from ClearCase or Jazz

Note:
The synchronization root in a UCM component VOB must be within a component.

  1. After the import is finished, click the Pending Changes tab, right-click the component, and accept the changes.
Figure 7. The Pending Changes tab with components
Screen displays incoming component

Deliver files from the workspace to a different Rational Team Concert stream

During import, the ClearCase development stream name reflects in the Rational Team Concert source control as the stream name by default. In addition, importing is a continuous process, and the same synchronization stream can be used until all of the required ClearCase data gets migrated to the Rational Team Concert source control management system. In case you delete the existing synchronization stream and are later required to import files and folders, create a new synchronization stream and complete the import. To avoid having multiple Rational Team Concert streams using the change flow target, you can select the desired Rational Team Concert stream to deliver the ClearCase data, as appropriate.

Note:
Every synchronization stream generates a new Rational Team Concert stream with the same ClearCase development stream name, appended with a time stamp.

Figure 8. Use the Change Flow Target option to select the stream
Change Flow Target selected on the drop-down menu

Summary

This article explained how to configure the Rational ClearCase and Rational Team Concert environments to integrate ClearCase data with Rational Team Concert. It covered how to import ClearCase data from UCM stream to a Rational Team Concert source control stream by using the ClearCase importer and how to move the imported component to the desired stream in Rational Team Concert.

Resources

Learn

Get products and technologies

Discuss

Comments

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


static.content.url=http://www.ibm.com/developerworks/js/artrating/
SITE_ID=1
Zone=Rational, DevOps
ArticleID=782845
ArticleTitle=Integrate Rational ClearCase with Rational Team Concert 3.0
publish-date=01102012