r16 - 2014-07-28 - 20:08:59 - MasabumiKoinumaYou are here: TWiki >  Deployment Web > DeploymentIntegrating > RationalTeamConcertAndRationalClearCaseIntegrationCookbook

new.pngupdated.png Rational Team Concert and Rational ClearCase integration cookbook

Authors: Masa Koinuma
Build basis: Rational Team Concert 3.0.1.x, 4.0.x, 5.0, Rational ClearCase 7.1.2.x, 8.0.0.x, 8.0.1.x

Summary

This page provides guidance for deploying Rational Team Concert into an existing Rational ClearCase environment. Rational Team Concert provides various types of integration capabilities: the synchronizer, the importer, and the bridge. The goal of this document is to help you decide which integration capability best suits your current deployment or your future deployment plan. After reading this page, you will have a better understanding about the technologies that are available to you, as well as some of the deployment considerations.

The integration of Rational ClearCase and Rational Team Concert is not a one-size-fits-all integration. Each user can have a unique integration deployment. It is beyond the scope of this document to discuss every possible type; therefore, this document also provides detailed information resources and videos on extended topics.

Rational ClearCase Bridge

The Rational ClearCase Bridge provides a traceability link from Rational ClearCase artifacts to work items in Rational Team Concert. This is primarily for a customer who wants to continue to use Rational ClearCase as a source control system, but also wants to take advantage of Rational Team Concert features such as agile planning, dashboards, etc. You do not have to change your current usage of Rational ClearCase, but you can enhance your Rational ClearCase deployment by using Rational Team Concert in a complementary fashion.


Rational ClearCase

Lifecycle integration link
Planning Transparency
Work Item Build SCM
Jazz Team Server
Rational Team Concert

Developers can associate UCM activities or base Rational ClearCase versions to Rational Team Concert's work items. You can then navigate from one to the other in the developer IDE. Because a Rational Team Concert work item is used as the "glue" for all development lifecycle artifacts, it provides end-to-end traceability throughout the development life-cycle, from project planning to source code changes.

Quick Tours

Using Rational Team Concert 4.0 with Rational ClearTeam Explorer: how Rational ClearCase users can take advantage of Rational Team Concert 4.0 while using Rational ClearTeam Explorer to manage their source-controlled artifacts with the ClearCase UCM.


Using Rational Team Concert with Rational ClearTeam Explorer: how to use Rational Team Concert with Rational ClearTeam Explorer.


Using Rational ClearCase with Rational Team Concert 3.0: how Rational ClearCase users can take advantage of the Build, Work Items, and Planning features in Rational Team Concert 3.0, while using Rational ClearCase to manage their source-controlled artifacts. In addition, this video demonstrates how to link Rational ClearCase artifacts to Rational Team Concert work items using the Rational ClearCase Bridge.


Getting Started

The ClearCase Bridge supports various client types, and the deployment step varies by the client.

Eclipse Client

The deployment of the ClearCase Bridge to the Eclipse client is straight-forward. There are no pre-configurations for administrators. The setup requires that you only need to install the Rational ClearCase Eclipse client (Rational ClearTeam Explorer, CCRC, or SCM Adapter) into the Rational Team Concert Eclipse client. The following articles provide step-by-step instructions of how to set them up: In addition to the developer setup, administrators can configure UCM streams for integration and can enforce the linkage of UCM activities with work items. Refer to the "Cleartool Command-Line Client" section below for configuring a UCM stream. When you configure a UCM stream, the link enforcement is applicable to any client types.

Visual Studio Client

The ClearCase Bridge integration is now available to Visual Studio users. The minimum supported version is Rational ClearCase 8.0.0.7. You first need to set up the Eclipse client integration and select the eclipse instance from the Visual Studio IDE options page. This technote provides step-by-step instruction:

Cleartool Command-Line Client

You can associate UCM activities or file versions to work items while you work cleartool commands. The administrator or the project lead needs to configure the UCM stream or the branch-type for integration, and developer's makeactivity, checkout, or checkin operations associate Rational ClearCase artifacts with work items automatically. These technotes provide the setup instruction for administrators and also describes end-user new commands:

ClearCase Native GUI Client

(new in Rational ClearCase 8.0.0.9 / 8.0.1.2)
Follow the set-up instruction above for the Cleartool Command-Line Client.

Learn More

You can also browse discussions on future releases. The Rational ClearCase Bridge enhancement items are tracked by ClearCase Bridge Open Stories and Enhancements.

Rational ClearCase Version Importer

The Rational ClearCase Version Importer (new in Rational Team Concert 4.0.5) is a one-way data replication tool from Rational ClearCase to Rational Team Concert source control. You can migrate all the versions in any branches in Rational ClearCase in a single operation, and the version branching is also replicated in Rational Team Concert source control. The importer also preserves the checked-in user information.


Rational ClearCase

one-way data migration
Planning Transparency
SCM Work Item Build
Jazz Team Server
Rational Team Concert

It can also import Rational ClearCase view configurations as Rational Team Concert baselines since the version 4.0.6.

You can use the version importer for both Base ClearCase and UCM ClearCase, but it does not import UCM metadata.

Quick Tour

ClearCase Version Importer features for Rational Team Concert 5.0: demonstrates enhanced migration capability in the 5.0 release such as filtering options and migration of CC/CQ UCM integration.

ClearCase Version Importer features for Rational Team Concert 4.0.6: demonstrates enhanced migration capability in the 4.0.6 release such as multiple configurations import, and incremental migration.

ClearCase Version Importer in Rational Team Concert: demonstrates how Rational ClearCase users can migrate the ClearCase version data to Rational Team Concert 4.0.5.


Getting Started

It is important that an administrator experienced with both the Jazz SCM system and the Rational ClearCase system performs the setup tasks for the synchronization or the import. The following article helps Rational ClearCase administrators to understand the Jazz SCM system: The recording/slides of the webinar session is available at ALM community : Reading the following help topic is recommended before beginning setup: If you are interested in large-scale migration and performance consideration, read the following document:

Learn more

Rational ClearCase Synchronizer and Baseline Importer

The Rational ClearCase Synchronizer is a two-way data replication between Rational ClearCase and Rational Team Concert source control. You can choose a UCM stream or a Rational ClearCase branch to set up synchronization with a stream of Rational Team Concert source control. It leverages the Jazz Team Build, and you can run the synchronization on a scheduled basis or by request. This provides flexibility to enterprise customers by allowing a subset of teams to choose SCM tools to work with, while letting you manage all of the latest source code through a single SCM repository.

The Rational ClearCase Baseline Importer is a one-way data replication from Rational ClearCase to Rational Team Concert source control. Like the synchronizer, you can choose a UCM stream where all baselines or only selected baselines are imported, or you can choose to import label types for base Rational ClearCase. It also leverages the Jazz Team Build, so you can run the import of new baselines/label types on a scheduled basis or by request.


Rational ClearCase

Two-way synchronization or
one-way data migration
Planning Transparency
SCM Work Item Build
Jazz Team Server
Rational Team Concert

Version Importer or Baseline Importer ?

There are two migration tools available - the Version Importer and the Baseline Importer. You can choose either of the technology that fits to your requirements to migrate the data from Rational ClearCase to Rational Team Concert source control.
  • The Version Importer is a new tool to allow you to import all the version histories from Rational ClearCase. You can import versions in all branches by a single operation and can import ClearCase view configurations as Rational Team Concert baselines. It has been available since Rational Team Concert 4.0.5.
  • The Baseline Importer migrates only the interested version ( versions selected by label types or UCM Baselines ). You have to set up the synchronized stream for branch-by-branch or stream-by-stream because it is based on the synchronizer technology. It has been available since Rational Team Concert 2.0.

Getting Started

It is important that an experienced administrator for both the Jazz SCM system and the Rational ClearCase system performs the setup tasks for the synchronization or the import. The following page will help a Rational ClearCase administrator to understand the Jazz SCM system: A variety of documents are available to help you prepare the synchronizer or the baseline importer deployment. Reading the following documents is recommended before beginning setup: The following documents also provide step-by-step instruction to deploy the Rational ClearCase Synchronizer and Baseline Importer:

If you are interested in large-scale deployment and performance consideration, read the following documents. While this is not a benchmark, because the performance largely depends on both the Rational ClearCase deployment and the Rational Team Concert deployment, it gives you an idea of what to expect when using the synchronizer or the baseline importer.

Learn more

Edit | Attach | Printable | Raw View | Backlinks: Web, All Webs | History: r16 < r15 < r14 < r13 < r12 | More topic actions
 
This site is powered by the TWiki collaboration platformCopyright © by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Contributions are governed by our Terms of Use. Please read the following disclaimer.
Ideas, requests, problems regarding the Deployment wiki? Create a new task in the RTC Deployment wiki project