dmmckinn 1200006SCS Visits (1114)
Integrations between Rational Team Concert and Rational ClearQuest
There are various types of integration capabilities between IBM Rational Team Concert (RTC) and Rational ClearQuest: the bridge, the synchronizer, and the importer. If you are looking for help in deciding which integration capability best suits your current deployment or your future deployment plan, read on to get a better understanding about the technologies that are available to you, as well as some of the deployment considerations.
Note: Additional "Getting Started" information and "Quick Tour" videos are available in the Rati
Rational ClearQuest Bridge
The Rational ClearQuest Bridge provides a bi-directional traceability link from records in Rational ClearQuest to work items in Rational Team Concert. It is a linked-data type integration based on the Open Services for Life-cycle Collaboration (OSLC). It provides a seamless user experience with rich hover UI preview, and delegated dialogs including advanced selection dialogs, and fully functional creation dialogs. These dialogs support ClearsQuest record form layout and hooks. The bridge integration also enables ClearQuest live data on a Rational Team Concert dashboard.
Rational ClearQuest Bridge is primarily for users who want to continue to use Rational ClearQuest as a change management system, but also want to take advantage of other features of Rational Team Concert, such as agile planning and dashboards. You do not have to change your current usage of Rational ClearQuest, but you can enhance your Rational ClearQuest deployment by using Rational Team Concert in a complementary fashion. It provides a ClearQuest shop with a fast path to realize the value of Rational Team Concert.
It is implemented as a function of the ClearQuest Web and uses the ClearQuest OSCL REST API interface. ClearQuest is an OSLC Change Management(CM) provider and a consumer. It provides OSLC CM v1 and v2 interfaces, and also consumes OSLC CM services provided by other tools. ClearQuest OSCL REST API is also a desired interface if you want to integrate your own application to ClearQuest. Since it is HTTP-based, you can call it from any program that supports HTTP, and it does not require the ClearQuest client to be installed on the machine where you execute your application.
Through the same bridge integration technology, you can also integrate ClearQuest with other Rational tools, such as Rational Quality Manager (RQM), Rational Requirement Composer (RRC), and Rational DOORS, and with 3rd party tools, such as HPALM and Git.
Rational ClearQuest Synchronizer
The Rational ClearQuest Synchronizer is a data replication between Rational ClearQuest records and Rational Team Concert work items. It supports flexible bi-directional or one-directional synchronization between a Rational ClearQuest record and a Rational Team Concert work item. Changes in one application are applied to another using synchronization rules, which provide the mapping and transformation information.
It is primarily for the customers that want to incrementally adopt Rational Team Concert by having different teams use different tools. Some projects/teams (for instance, a development team) can choose to start using Rational Team Concert while other teams (for instance, a support team) continue to use ClearQuest. The teams using Rational Team Concert and the teams using ClearQuest have access to the same data (duplicated by the Synchronizer based on the configured sync rules). Reports can also be run in either system since the data is consolidated.
The ClearQuest Synchronizer is implemented as an application of the general Jazz item connector framework. It is a separate component of the Rational Team Concert offering, and requires setting up a Gateway service. It uses ClearQuest CM API interface to communicate with ClearQuest. It can also be used between Rational Qualify Manager (RQM) and ClearQuest.
Please note that there is a high maintenance and support cost associated with the Rational ClearQuest Synchronizer. Conflicts can occur when two users make nearly simultaneous changes to a ClearQuest record and its corresponding work item, and an administrator needs to constantly monitor these conflicts and resolve them manually by selecting the appropriate value. It is highly recommend that you evaluate the Rational ClearQuest Bridge integration before jumping into the Synchronizer integration.
Rational ClearQuest Importer
The Rational ClearQuest Importer provides a one-way data migration from Rational ClearQuest records to Rational Team Concert work items. It imports ClearQuest records based on a user specified query, and uses a mapping file to declare how fields and values are mapped from a ClearQuest scheme to a Rational Team Concert process definition. It supports importing stateful record types, Users, Notes, Attachments, Work Item Relationships (duplicates, parent / child, blocks / depends on, and related), and creates missing objects, such as Contributors, categories, and iteration, on the fly.
The Rational ClearQuest Importer is primarily for the customers that want to move from using ClearQuest to Rational Team Concert as the change management system instead of maintaining both applications, and want to bring over certain ClearQuest records to Rational Team Concert.
It is implemented as a function in the Rational Team Concert eclipse client. It is based on the Bugzilla Importer, and uses the ClearQuest CM API to communicate to ClearQuest. You must install ClearQuest client on the machine you run the ClearQuest Importer.
dmmckinn 1200006SCS Visits (1189)
Guidance for deploying Rational Team Concert into an existing Rational ClearCase environment
IBM Rational Team Concert (RTC) provides various types of integration capabilities: the synchronizer, the importer, and the bridge. The integration is not a one-size-fits-all and you may need help with deciding which integration capability best suits your current deployment or your future deployment plan. The information below provides a brief overview about the integration capabilities. Additional "Getting Started" information and "Quick Tour" videos are available in the Rational Team Concert and Rational ClearCase integration cookbook topic in the deployment wiki on Jazz.net.
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.
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.
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.
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.
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.
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.
kellypuffs 06000168YK Visits (1497)
Have you been following our 2011 Jazz Open Mic Series? We've got a few under our belt now and the response has been enthusiastic.
Tomorrow's Jazz Open Mic is on the ClearCase Synchronizer, with Masa Koinuma, software developer: Rational Software Configuration Management.
To check out all upcoming open mics, please visit our Rational Support Technical Exchange Open Mics & Webcasts document.
Hope to see you there!
Image credit: Some rights reserved by p_a_h
kellypuffs 06000168YK Visits (1843)
Please join us today at 10am EDT for our latest session in the 2011 Jazz Open Mic Series: