Migrate Command (CQConverter)
Use the migrate command of the CQConverter command-line tool to migrate ClearQuest databases to Team Foundation Server.
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.
CQConverter /c[ommand]:Migrate /m[igrationsettings]:Configuration XML file /s[chemamap]:Schema Map XML file
Parameters
Argument |
Description |
|---|---|
Configuration XML file |
The XML file that specifies the CQConverter configuration parameters. For more information, see How to: Generate the Converter Configuration File. |
Schema Map XML file |
Migration schema mapping XML file. For more information, see How to: Edit the Schema Map File. |
Option |
Description |
|---|---|
/c[ommand]:Migrate |
Migrate ClearQuest database. |
/m[igrationsettings]: |
Specifies the configuration XML file that is used for migrating the ClearQuest database. For example, cqconverterconfig.xml. |
/s[chema]: |
Specifies the migration schema mapping XML file. |
Remarks
The CQConverter migration parameters are specified in the configuration XML file. Specify this file at the command line using the command-line option /m: or /migrationsettings: as the expanded form. For example: /m:cqconverterconfig.xml.
Note
When CQConverter connects to ClearQuest the converter prompts you for a password. The converter connects to Team Foundation using the log on credentials.
Example
In this example, the converter performs a migration using the configuration parameters that are defined in the cqconverterconfig.xml file and the mapping defined in the schemamap.xml file.
>CQConverter /c:migrate /m:cqconverterconfig.xml /s:schemamap.xml
See Also
Tasks
Walkthrough: Migrating ClearQuest Work Items to Team Foundation