Rational TestManager migration overview

With Rational® TestManager, users can plan and run tests. Rational TestManager assets are stored in a project-based format. The migration tool transfers the test assets in the project from a Rational TestManager client system to the IBM® Rational Quality Manager server. The client computer must have a recent Rational TestManager installation that also has access to the desired Rational TestManager project.

Before running the Rational TestManager migration, be sure to run the Datastore Doctor tool, which is available with Rational TestManager, and resolve any issues that are reported. At the end of the migration process, be sure to review the log contents for any failures that may have occurred.

Migrating Rational TestManager projects with associated manual tests

If your Rational TestManager projects are integrated with test scripts from Rational Manual Tester, you must migrate your manual test scripts before migrating Rational TestManager projects. In addition, Rational TestManager and Rational Manual Tester must be installed on the same computer so that the linkage between the test case and test script is preserved.

Before migrating the manual test scripts, be sure that the scripts to be migrated are in the same location as the test scripts that are associated to the test cases in Rational TestManager.

Migrating Rational TestManager projects and Rational RequisitePro requirements

If your Rational TestManager projects are integrated with requirements from Rational RequisitePro®, be sure to obtain the RAProject record, which contains the Rational RequisitePro database information for Rational ClearQuest®. One of the fields in this record is the ReqWeb server URL. This is the same URL used in Rational Quality Manager to connect to RequisiteWeb. You must use this exact URL in Rational Quality Manager so that the requirement information in Rational TestManager migrates correctly. You will be prompted to supply this URL during the migration process.

Also, be sure that you have Rational RequisitePro version 7.1 or later installed and the Rational RequisitePro client for the Web.

Migrating defect records

If you use Rational ClearQuest for tracking defects, you must set up the Rational ClearQuest Connector before migrating test assets from Rational TestManager. Otherwise, links to defects will no longer be available.

You can then use the synctool command to migrate the defects Rational Quality Manager into Rational Quality Manager. You must migrate the defects before performing the Rational TestManager migration.

With the Connector, defects that are created in Rational ClearQuest are visible in Rational Quality Manager and vice-versa.

See The IBM Rational ClearQuest Connector for details.

Rational TestManager asset types

The following Rational TestManager asset types can be migrated to Rational Quality Manager:

Rational TestManager asset Rational Quality Manager asset
Test plans Test plans
Test cases Test cases
Configured test cases Test execution records
Manual test scripts Manual test scripts
Test suites Test suites
Test inputs Requirements
Iterations Test schedules
Configurations Test environments
Computers Lab resources
Computer lists Test cells
Datapools Test data tables
TestCase logs Execution results
Association to automated scripts Test scripts (references to external scripts)

Feedback