Click Start, click Programs, point to Microsoft Visual Studio 2005, point to Visual Studio Tools, and then click Visual Studio 2005 Command Prompt.

At the command prompt, type cd %DriveLetter%\VSS2TeamFoundation. This folder was created when you analyzed the Visual SourceSafe database for migration. For more information, see Walkthrough: Preparing to Migrate from Visual SourceSafe to Team Foundation.

Note
Ensure that the system drive has sufficient space to hold the largest file size under migration.

Save the settings file that you created for the analysis, settings.xml, with a new name, for example, migration_settings.xml.

At the command prompt, type notepad migration_settings.xml, and then press Enter.

The settings.xml file you created when you analyzed your database for migration is displayed in Notepad.

Change the settings file as follows.

• In the <ProjectMap> section, for each Visual SourceSafe folder that you are migrating, add the destination folders in Team Foundation source control. Use the following format, adding the Destination section as shown in the following example.

  <Project Source="$/FolderA" Destination="$/Team_Project"></Project>

  To migrate everything in your Visual SourceSafe database, insert the following XML instead.

  <Project Source="$/" Destination="$/Team_Project/"></Project>

• Under the <Settings> section, add a <TeamFoundationServer> section, and specify the name, port, and protocol for the Team Foundation Server to which you are migrating. Use the following format.

  <TeamFoundationServer name="TFS_server_name" port="port_number" protocol="http"></TeamFoundationServer>

  For example,

  <TeamFoundationServer name="AdventureWorks" port="8080" protocol="http"></TeamFoundationServer>

  Note
  If you have a large Visual SourceSafe database, your migration may fail because of the 4-GB limit of SQLExpress. To resolve this, you can either migrate a partial history as described in How to: Migrate a Partial History Using Archives in Visual SourceSafe, or set the converter to use SQLServer instead by adding the following line: <SQL Server="SQL_Server_name"></SQL>

Remove <Output file="Analysis.xml"></Output> from the <Settings> section, or rename the output file to "migration_Analysis.xml".

Your migration_settings.xml file should resemble the following:

<?xml version="1.0" encoding="utf-8"?>
<SourceControlConverter>
      <ConverterSpecificSetting>
            <Source name="VSS">
                  <VSSDatabase name="c:\VSSDatabase"></VSSDatabase>
                  <UserMap name="c:\Migrate\Usermap.xml"></UserMap>
            </Source>
            <ProjectMap>
                  <Project Source="$/FolderA" Destination="$/TeamProjectA"></Project>
                  <Project Source="$/FolderB" Destination ="$/TeamProjectB/ProjectB"></Project>
            </ProjectMap>
      </ConverterSpecificSetting>
      <Settings>
            <TeamFoundationServer name="server_name" port="port_number" protocol="protocol"></TeamFoundationServer>
      </Settings>
</SourceControlConverter>

Be sure to substitute your server name for server name and an actual port number for port number.

Save your changes and close Notepad.

Copy your Visual SourceSafe database to a local folder on the computer on which you want to run analysis and migration. Although you can migrate a Visual SourceSafe database in a shared folder on a remote computer, the migration takes much longer to finish.

Click Start, click All Programs, point to Microsoft Visual Studio, point to Visual Studio Tools, and then click Visual Studio Command Prompt.

At the command prompt, type the following.

VSSConverter Migrate migration_settings.xml

Tip
Use the /? switch to view the available command-line options.

Type Y to confirm the migration.

The converter tool displays the migration status. When the conversion process is finished, the tool saves a migration report in the current directory. You can use Internet Explorer to view the file for more information.

When you are prompted, provide the password for the Visual SourceSafe admin user.

Note   VSSConverter does not migrate version control bindings for solutions. You must change these bindings manually. For more information, see How to: Migrate Source Control Bindings from Visual SourceSafe.