Migrating Source Control and Defect or Change Tracking to Team Foundation
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.
Source control and defect or change tracking data migration follows the process shown in the following figure:
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:
Walkthrough: Preparing to Migrate from Visual SourceSafe to Team Foundation Provides step-by-step instructions about how to prepare a Visual SourceSafe database for migration to Team Foundation version control.
Walkthrough: Migrating from Visual SourceSafe to Team Foundation Provides step-by-step instructions about how to migrate a Visual SourceSafe database 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:
Walkthrough: Migrating ClearQuest Work Items to Team Foundation Describes step-by-step how to migrate from ClearQuest 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.