Rational ClearQuest to VSTS Work Item Tracking Migration Tool will migrate existing ClearQuest work items (schema and data) to VSTS work item tracking system. Team Foundation includes this conversion utility, CQConverter.exe, that you can use to perform this migration.

To understand more about the usage of this tool to migrate your existing ClearQuest work items to VSTS work item tracking, please refer the walk through: Walkthrough: Migrating ClearQuest Work Items to Team Foundation

Supported ClearQuest Versions for Migration

·         ClearQuest Standalone client Versions 2003.06.00 / 2003.06.12. We have tested these two versions. Ideally Versions 2003.06.XX should work. We have recently tried 2003.06.13 also.

·          Versions 2002.05.20 and 2003.05.00 may also work, but have not been tested.

Even with supported versions, we may encounter the following issue if we don’t have proper ClearQuest registry path set on the migration client under the account used for migration:

{Total Errors 1} ERROR: TF61103: The converter could not find a supported version of the ClearQuest client. Please refer to CQConverter help for a list of supported versions.

One of the possible scenarios where it can happen is: We installed ClearQuest client using one account1 say “user1” and later logging in using account2 say “user2”. Converter will check for the existence of key HKEY_CURRENT_USER\SOFTWARE\Rational Software\ClearQuest before proceeding with migration. But since the installation was done using “user1” account, the registry key will not be present under current user when you login with “user2”. This happens if you are trying migration directly even before opening ClearQuest client once from the account used for migration.

How to fix this issue?

Before starting migration process, open ClearQuest client from the same account where you are running migration and connect to the ClearQuest database from where you want to migrate work items. When you open ClearQuest client, it will create the registry key under HKEY_CURRENT_USER\SOFTWARE\Rational Software\ClearQuest. Hence converter check for this key will succeed and migration will start for the supported versions.