Get started with the Rational ClearQuest Synchronizer
This tutorial walks you through the process of configuring the ClearQuest® Synchronizer so that you can synchronize Rational® ClearQuest records with IBM® Engineering Workflow Management work items. This tutorial assumes that you are performing the steps on a Windows environment.
Learning objectives
In this tutorial, you learn how to perform the following tasks:- Assign a role with necessary permissions to an administrative user in the Jazz® repository.
- Start the ClearQuest Gateway.
- Use the ClearQuest Synchronizer Setup Wizard to configure your ClearQuest and Jazz environments.
- Modify synchronization rules in the Synchronization Rules Editor.
- Enable outgoing synchronization for a Jazz Team Server.
- Modify properties of an external repository connection.
- Test the configured environment.
Time required
You should plan on spending two to three hours on this tutorial.- Module 1: Setting up your Rational ClearQuest environment
To complete this tutorial you need to create a sample ClearQuest schema repository, schema, and user database. - Module 2: Setting up your Jazz environment
To complete this tutorial, you need to create a sample Jazz project area and an administrative user account, and assign the administrative user account a role that has the necessary permissions for the ClearQuest Synchronizer. - Module 3: Using the ClearQuest Synchronizer Setup Wizard
The ClearQuest Synchronizer Setup Wizard walks you through the steps that are required to configure your ClearQuest user database and Jazz project area. - Module 4: Editing synchronization rules
In this module, you will learn how to edit synchronization rules to specify additional mapping details. After you finish using the Rational ClearQuest Synchronizer Setup Wizard, you need to edit the generated synchronization rules to specify additional mapping details. - Module 5: Enabling outgoing synchronization
In this module, you will learn how to enable outgoing synchronization for the Jazz Team Server and for the external repository connection. You need to perform these tasks so that changes that users make to work items are propagated to the ClearQuest user database. - Module 6: Testing the configuration
In this module, you will learn how to test the configuration of your IBM Rational ClearQuest and Jazz environments by submitting Project and Defect records. - Summary
The lessons in this tutorial were designed to provide an overview of the steps required to configure your IBM Rational ClearQuest and Jazz environments to use the ClearQuest Synchronizer.