CQConverter Command-Line Utility for ClearQuest Database Migration

  • Article

The CQConverter command is used to convert ClearQuest databases for use with Team Foundation work item tracking.

CQConverter.exe is located in <drive>:\Program Files\Microsoft Visual Studio 9.0\Common7\IDE and is also available through the Visual Studio 2008 Command Prompt.

Required Permissions

To use the CQConverter tool, you must be a member of the Service Accounts security group. For more information, see Team Foundation Server Permissions. Also, you must have the Super User permission for the ClearQuest database. For more information, see the ClearQuest Administrator's Guide.

Syntax

**CQConverter [/?] {/c[ommand]:Analyze|Migrate} <cqconverterconfig.xml> /s[chema]: <**schemamap.xml /m[igration settings]:<migration settings>

  • /c[ommand]: analyze <cqconverterconfig.xml>
    Analyzes ClearQuest database as configured in cqconverterconfig.xml.

  • /c[ommand]: migrate <cqconverterconfig.xml>
    Migrates ClearQuest database as configured in cqconverterconfig.xml.

  • /s[chema]: < schemamap.xml >
    Migration schema mapping XML file.

  • /m[igration settings]: <migration settings>
    Migration settings XML file.

  • /?, /h, /help
    Displays help.

Examples

In the following example, the converter performs analysis using the configuration parameters defined in the cqconverterconfig.xml file.

**CQConverter /c:analyze /m:**cqconverterconfig.xml

In the following example, the converter performs migration using the configuration parameters defined in the cqconverterconfig.xml file and the mapping defined in the schemamap.xml file.

**CQConverter /c:migrate /m:cqconverterconfig.xml/s:**schemamap.xml

Remarks

The CQConverter configuration parameters are stored in an XML file. Specify this file at the command line using the option /m: or with its expanded form /migrationsettings:, for example: /m:cqconverterconfig.xml or /migrationsettings: cqconverterconfig.xml

Note

When connecting to ClearQuest or Team Foundation Server, the converter will prompt you for a password. The converter connects to Team Foundation Server using the log on credentials.

In This Section

Migrating from ClearQuest

Migrating from Visual SourceSafe

See Also

Concepts

Planning for Work Item Migration

Adding Integration Fields in Work Item Types

Other Resources

Migrating Work Items

After Migrating Work Items