CQConverter Command-Line Utility for ClearQuest Database Migration
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
Analyze Command (CQConverter)
Describes the CQConverter analyze command syntax and usage.Migrate Command (CQConverter)
Describes the CQConverter migrate command syntax and usage.
Related Sections
Migrating from Visual SourceSafe
See Also
Concepts
Planning for Work Item Migration
Adding Integration Fields in Work Item Types