migrate Command (VSSConverter)
Use the migrate command of the VSSConverter command-line utility to migrate Visual SourceSafe databases to Team Foundation version control.
Required Permissions
To use the VSSConverter tool, you must be a member of the Service Accounts security group. For more information, see Team Foundation Server Permissions. Also, you must be a member of the Database Administrators group for the Visual SourceSafe database. For more information, see "Managing Your Team Using Visual SourceSafe" at the Microsoft Web site (https://go.microsoft.com/fwlink/?LinkId=99134).
VSSConverter migrate settings_file
Parameters
Parameter |
Description |
|---|---|
settings_file |
XML file specifying analysis or migration settings. |
Remarks
The VSSConverter.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.
Before running the Visual SourceSafe (VSS) converter, you must do the following:
Create a settings file that contains the following information:
The location of the Visual SourceSafe database.
The location and file name for an output report file (optional).
The location and file name for a user mapping file (optional).
For more information, see How to: Create a Settings File for Source Control Analysis and Migration.
The default file name for the migration report is VSSMigrationReport.xml. This file is created in the same directory in which the converter is run.
If you specify an output file that already exists, the converter exits, and you receive the following error message:
Error: Output file VSSMigration.xml already exists
Limitations
You can only run one instance of the VSS Converter on a computer.
Example
In this example, the migrate command performs a migration on a Visual SourceSafe database using the configuration in the settings.xml file.
>VSSConverter migrate settings.xml
See Also
Tasks
Walkthrough: Preparing to Migrate from Visual SourceSafe to Team Foundation
Walkthrough: Migrating from Visual SourceSafe to Team Foundation
How to: Create a Settings File for Source Control Analysis and Migration
How to: Create a Settings File for Source Control Analysis and Migration