VSSConverter.exe is a command-line tool that requires the following input:
-
A path of the folder that contains the srcsafe.ini file for the Visual SourceSafe database under migration.
-
An XML-based file that contains settings.
-
VSSConverter.exe is stored in <root>:\Program Files\Microsoft Visual Studio 8\Common7\IDE, but it is invoked from the Visual Studio command prompt.
This walkthrough assumes that your Visual SourceSafe database is in c:\VSSDatabase.
After you have decided which projects you want to analyze, create a file to contain the settings. This file lists the projects that you want the converter to analyze.
To create the settings file for analysis
-
Click Start, click All 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 mkdir %DriveLetter%\VSS2TeamFoundation, where %DriveLetter% is the current drive. Press ENTER.
-
At the command prompt, type cd %DriveLetter%\VSS2TeamFoundation. Press ENTER.
-
Type notepad settings.xml, and then press ENTER.
-
Select Yes to create the file.
-
Copy the following XML, where $/FolderA and $/FolderB represent the names of folders that contain the projects that you want to migrate.
<?xml version="1.0" encoding="utf-8"?>
<SourceControlConverter>
<ConverterSpecificSetting>
<Source name="VSS">
<VSSDatabase name="c:\VSSDatabase"></VSSDatabase>
</Source>
<ProjectMap>
<Project Source="$/FolderA"></Project>
<Project Source="$/FolderB"></Project>
</ProjectMap>
</ConverterSpecificSetting>
<Settings>
<Output file="Analysis.xml"></Output>
</Settings>
</SourceControlConverter>
.gif) Note |
|---|
| To migrate the whole database, use <Project Source="$/"></Project>. |
-
Save your changes and close Notepad.
Next, run the converter tool from the Visual Studio command prompt to analyze the project, as shown in the following steps.
The user who is performing the analysis must be a system administrator for SQLExpress. By default, the user who installs Visual Studio will receive the required permissions for SQLExpress.
After you have the migration settings file and granted system administrator rights, you can run the converter tool to analyze the project.
To analyze the project with the converter
-
At the Visual Studio command prompt, type the following.
VSSConverter Analyze settings.xml
-
When you are prompted, provide the Visual SourceSafe administrator password.
The converter tool displays the status of the preconversion analysis. When it is completed, it generates a report (VSSAnalysisReport.xml) and a user mapping file (usermap.xml), and saves them in the current directory. You can use the user mapping file to map Visual SourceSafe users to Team Foundation users. For more information, see How to: Edit the Source Control Migration User Mapping File.