The target audience for this article is users who are already using Rational TestManager and would like to explore the enhanced features of the test management solutions by ClearQuest, coupled with the capabilities of ClearQuest itself, without losing their assets.

Benefits of migrating to ClearQuest test management

• IBM Rational TestManager supports only a native client, while ClearQuest test management supports Eclipse, as well as native and Web clients
• The logging mechanism of ClearQuest test management contains a TPTP log that can be imported easily into any standard test management solution, which is lacking in Rational TestManager.
• ClearQuest test management supports integration with Rational Performance Tester apart from the usual integration with Rational Functional Tester, Rational Robot, and so on provided by Rational TestManager
• The test management solution provided by ClearQuest test management supports geographically distributed teams through the IBM® ClearQuest MultiSite® feature, which can't be accomplished with Rational TestManager

Back to top

Prerequisites

• ClearQuest 7.0 or later version installed. The executable for the Migration wizard is bundled along with ClearQuest.
• A ClearQuest schema with ClearQuest test management package applied on it.
• If Rational project contains manual scripts, then all manual scripts should be imported using IBM Rational Manual Tester before migration.
• If the test scripts location is not a UNC path, then an asset registry and file location must be created in Rational ClearQuest test management prior to migration.
• ClearQuest users and groups must be created.

Step-by-step guidelines for migration

To start the wizard, run cqtmmigration from the \Program\Rational\Clearquest folder:

1. In the first screen of IBM Rational ClearQuest test management wizard, enter the name and location of the Rational Administrator Project source (the project to be migrated), and click Next (Figure 1).

2. As shown in Figure 2, select a target ClearQuest schema repository, provide the authentication details of the associated user database, and click Next.

Figure 3 shows the test scripts associated with the Rational project and their locations.

Note: If the test script's location is not a UNC path, then an asset registry and file location must be created in Rational ClearQuest test management prior to migration. The file location name must be "Manual - (Rational Test Datastore)" for Rational Manual Tester, and "GUI - (Rational Test Datastore)" for IBM Rational Robot, and it must be associated with an asset registry record that is named the same as the selected Rational project. The same is required for file locations under IBM® Rational® ClearCase® control. It is not recommended to use local paths, because they cannot be easily shared.

3. Click Next.

4. Define a UNC location for storing external files, as shown in Figure 4. Some test asset properties like test case design steps, are exported to external files and then migrated to Rational ClearQuest test management using the references to these files. Click Next.

The step shown in Figure 5 details migration of manual and GUI scripts of the Rational project. Prior to migration, all manual scripts should be imported using IBM Rational Manual Tester. Then the location of the imported Rational Manual Tester test scripts must be specified as UNC paths. In addition, locations of GUI scripts are specified as a UNC path to store all of the scripts that need to be migrated.

Note: If the test script location is not a UNC path, then an asset registry and file location must be created in Rational ClearQuest test management prior to migration. The file location name in Rational ClearQuest test management must be "Manual - (Rational Test Datastore)" for Rational Manual Tester, and "GUI - (Rational Test Datastore)" for IBM Rational Robot, and it must be associated with an asset registry record that is named the same as the selected Rational project. The same is required for file locations under ClearCase control. It is not recommended to use local paths as they cannot be easily shared.

5. Specify the locations for these scripts and click Next.

This step defines the Group mapping between the Rational test project and the ClearQuest database. The Migration wizard lists all current Rational TestManager and Rational ClearQuest user groups. The following defaults apply:

• A default user group, TMDefaultGroup, is always added in the Rational ClearQuest database in addition to the existing ones.
• All Rational project user groups are mapped to ClearQuest user groups with the same name. For a group in Rational TestManager that doesn't exist in ClearQuest, a new ClearQuest user group is created by the same name and mapping is established.
• Every group comes over with no privileges. The administrator will need to set up privileges for migrated groups after migration.

Default mapping can be over-ridden by selecting the appropriate group from the Target Group drop-down list. To do this, the ClearQuest groups must be created prior to migration.

6. Click Save to save the mapping of the file, and then click Next

On subsequent runs of the Migration wizard, the same mapping can be used by clicking Open and selecting that file (Figure 6).

The following step explains user mapping between the Rational project and the ClearQuest database. The Migration wizard lists all current Rational TestManager and Rational ClearQuest users. The following defaults apply:

• A default user, TMDefaultUser, is always added in the Rational ClearQuest database in addition to the existing ones.
• All Rational project users are mapped to ClearQuest users with the same name. For a user in Rational TestManager that doesn't exist in ClearQuest, a new ClearQuest user is created by the same name and mapping is established.
• Every user comes over with no privileges. The administrator will need to set up privileges for migrated users after migration.

Default mapping can be over-ridden by selecting appropriate user from the Target User drop-down list. To do this, the ClearQuest users must be created prior to migration (Figure 7)

7. Click Save to save the file mapping, and click Next.

On subsequent runs of the Migration wizard, the same mapping can be used by clicking on Open and selecting that file.

Figure 8 displays the two options that can be used in cases of re-migration: Overwrite existing records and reassociate Rational Robot scripts to existing test cases. If the user wants to re-migrate all of the previous assets, then Overwrite existing records must be selected. If only migration of Robot test scripts association is requiredm then the user should check the Reassociate Robot scripts to existing testcases checkbox.

8. Make the selections appropriate for the project, and click Next.

Figure 9 provides a summary of the selections and settings for the migration of the project, including these elements:

• Rational Administrator project name
• Rational ClearQuest repository and user database
• Storage location for external files
• Location for converted Rational Manual Tester scripts
• Location for converted Rational Robot GUI scripts
• Migration overwrite option

9. Click Next to start the migration (or Back to make any modifications before the migration starts).

The final screen of the Migration wizard is updated with the progress of the migration until it finishes. When migration completes, the Finish button is enabled; click it to exit the wizard

Welcome to the world of ClearQuest test management. After completion, you can see all of the migrated assets in the ClearQuest test management perspective, as shown in Figure 11.

Resources

Learn

• Run and Analyze Software Tests with Rational ClearQuest test management, a developerWorks tutorial (October 2006)
  
  
• IBM Rational tester eKit to download the ClearQuest test management tool
  
  
• FAQ: Enterprise Test Management with IBM Rational ClearQuest, Version 7
  
  
• Enterprise Test Management with IBM Rational ClearQuest: Demo
  
  
• Understanding the IBM Rational ClearQuest Client for Eclipse, IBM developerWorks article (December 2004)
  
  
• Understanding the Rational ClearQuest Client, available in the Rational Software Information Center
  
  
• IBM internal training course, Instructor Prep (requires password): TST 290 Essentials of Test Management with IBM Rational ClearQuest
  
  
• Browse the technology bookstore for books on these and other technical topics.
  
  

Get products and technologies

• Download IBM product evaluation versions, and get your hands on application development tools and middleware products from DB2®, Lotus®, Rational®, Tivoli®, and WebSphere®.
  
  

Discuss

• Participate in the discussion forum.
  
  
• Check out the ClearQuest discussion forum on developerWorks Rational.
  
  
• Check out developerWorks blogs, and get involved in the developerWorks community.
  
  

About the author

Comments

Back to top

Trademarks  |  My developerWorks terms and conditions

Table of contents

• Benefits of migrating to ClearQuest test management
• Prerequisites
• Step-by-step guidelines for migration
• Resources
• About the author
• Comments

Next steps from IBM

• Try: Rational ClearQuest
• Demo: Create customized queries with IBM Rational ClearQuest
• Briefing: Quality driven software delivery
• Buy: Rational ClearQuest

My developerWorks community

Dig deeper into Rational on developerWorks

Rational offerings on the IBM Cloud

Quickly scale develop & test environments

Special offers