Export (0) Print
Expand All

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.

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

NoteNote:

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.

Analyze Command (CQConverter)

Describes the CQConverter analyze command syntax and usage.

Migrate Command (CQConverter)

Describes the CQConverter migrate command syntax and usage.

Community Additions

ADD
Show:
© 2014 Microsoft