Migrating Source Control and Defect or Change Tracking to Team Foundation

  • Article

You can migrate the data you have stored in some other version control or change tracking systems into Team Foundation using converters. TheseTeam Foundation includes converters so you can migrate Visual SourceSafe and ClearQuest source control files and defect or change tracking work items into Team Foundation. Use one of the following converters include: to migrate data into Team Foundation.

  • **VSSConverter   **Converts Visual SourceSafe source control projects to Team Foundation version control.

  • CQConverter   Converts ClearQuest schema, defects, and change tracking work items to Team Foundation work item tracking.

The Migration Process

Source control and defect or change tracking data migration follows the process shown in the following figure:

Migration Process image

To Prepare for Migration

To prepare for migration:

  • Select a time to migrate   Schedule the migration for a time when users do not need access to the data that you are migrating.

  • Set up a Team Foundation Team Project   Create a team project to which to migrate the data. For more information, see How to: Create a Team Project.

  • Create a work item type definition   If you are migrating work items, you might need to create a work item type that lets you migrate all the data that you want to preserve from your previous change tracking software. For more information, see Customizing Work Item Types for Team Foundation.

To Prepare the Data for Migration

To prepare the data for migration:

  • Archive or Back up the data   Follow the instructions for the source control software for backing up your data.

  • Analyze the data   Analyze how the data will be migrated. You can use both VSSConverter and CQConverter to analyze how your data will be migrated and you can make any necessary adjustments prior to migrating any data. During the analysis, the converters create files that contain the settings that are used to control the migration.

  • Make any changes that are required for a successful migration   If you notice issues during the analysis, you can change settings as needed.

To Migrate Source Control Data

To migrate source control data:

  • Edit settings files to control the migration   There are several files created during analysis that you might need to modify. For example, you must change the user map file, the field map file, and the schema map file.

  • Migrate the data   Use VSSConverter to migrate the data.

  • Verify the migration   Check your data in Team Foundation to make sure that it has successfully transferred.

The following topics can help you migrate to Team Foundation version control:

The following topics provide additional information about migrating to Team Foundation version control:

  • Planning for Source Control Migration   Describes how to plan a migration from Visual SourceSafe to Team Foundation version control.

  • Migrating Source Control   Describes how to migrate from Visual SourceSafe to Team Foundation version control.

  • After Migrating Source Control   Describes the tasks to complete after the migration to ensure that the migration has been successful. Provides additional information that might be helpful in troubleshooting migration problems.

To Migrate Defect or Change Tracking Data

To migrate defect of change tracking data:

  • Configure the migration process   Modify the configuration files to guide the process.

  • Analyze your ClearQuest database   Run CQConverter to analyze your ClearQuest database. The analysis produces a report and a set of files that describes the ClearQuest defects or change tracking items.

  • Define the migration mapping   Modify the XML files generated during ClearQuest database analysis to customize the migration process.

  • Migrate the data   Use the configuration and mapping files generated during the analysis of the database to migrate your data.

  • Review the migration report   Review any errors and warnings that occurred during the migration and review the migration status.

The following topics can help you migrate to Team Foundation work item tracking:

The following topics provide additional information about migrating to Team Foundation work item tracking:

  • Planning for Work Item Migration   Describes how to plan a migration from ClearQuest to Team Foundation.

  • Migrating Work Items   Describes how to migrate from ClearQuest to Team Foundation.

  • After Migrating Work Items   Describes the tasks to complete after the migration to ensure that the migration has been successful. Provides additional information that might be helpful in troubleshooting migration problems.

Reference

VSSConverter Command-Line Utility for Source Control Migration

CQConverter Command-Line Utility for ClearQuest Database Migration

See Also

Concepts

Migrating from Visual SourceSafe

Migrating from ClearQuest