Пошаговое руководство: миграция с Visual SourceSafe в Team Foundation

Статья
11/05/2008

Обновлен: Ноябрь 2007

В этом руководстве описано, как осуществить миграцию с Visual SourceSafe в Team Foundation с помощью VSS-преобразователя, VSSConverter.exe. Сведения о подготовке базы данных для миграции см. в разделе Пошаговое руководство. Подготовка к миграции с Visual SourceSafe на Team Foundation. В этом руководстве вы найдете подробную информацию о том, как подготовить базу данных и список пользователей SourceSafe для миграции в Team Foundation и станете лучше понимать, как работает процесс миграции.

В этом руководстве вы узнаете, как выполнить следующие операции:

изменить файл параметров, чтобы задать, какие папки должны быть перенесены;
запустить преобразователь для миграции исходных текстов из Visual SourceSafe в Team Foundation и сгенерировать отчет о миграции;

Обязательные компоненты

Прежде чем вы попытаетесь выполнить это пошаговое руководство:

выполните все этапы, приведенные в Пошаговое руководство. Подготовка к миграции с Visual SourceSafe на Team Foundation;
идентифицируйте пустые папки в Team Foundation (подсистема контроля версий), куда вы хотите перенести ваши папки Visual SourceSafe; если целевой каталог не существует, преобразователь создаст его автоматически. Единственное исключение — когда целевой каталог является командным проектом. Целевой каталог должен быть либо допустимым командным проектом, либо подкаталогом допустимого командного проекта. Дополнительные сведения см. в разделе Практическое руководство. Создание командного проекта.

Кроме того, вам требуется:

знать имя Team Foundation Server.
установить экспресс-выпуск SQL Server на компьютере, где вы планируете запустить преобразователь.

По умолчанию экспресс-выпуск SQL Server устанавливается при установке Microsoft Visual Studio Team System.

Для использования преобразователя у вас должны быть административные разрешения для соединения с базой данных SQLExpress
Visual SourceSafe 2005 на компьютере, где запускается VSSConverter.

Необходимые разрешения

Чтобы выполнить перечисленные здесь операции, вы должны иметь административные разрешения на базу данных Visual SourceSafe, с которой вы хотите осуществить миграцию. Дополнительные сведения см. в разделе о назначении прав проекта на веб-узле Майкрософт по адресу https://go.microsoft.com/fwlink/?LinkId=99103(на английском языке). Вы также должны быть членом серверной роли sysadmin на экспресс-выпуске SQL Server. По умолчанию вы являетесь членом серверной роли sysadmin, если вы являетесь членом группы безопасности Администраторы на компьютере, где установлен экспресс-выпуск SQL Server. Дополнительную информацию смотрите раздел "sysadmin" на веб-узле Майкрософт (https://go.microsoft.com/fwlink/?LinkId=60405) в документации по SQL Server 2005.

Перенос папок проекта SourceSafe

Перед тем, как вы начнете фактическое конвертирование, поменяйте ваш файл параметров, чтобы внести в него целевые папки для проектов SourceSafe, заданных вами при подготовке к конвертированию. Для выполнения этой задачи вы должны выполнить все этапы, перечисленные в Пошаговое руководство. Подготовка к миграции с Visual SourceSafe на Team Foundation.

Чтобы изменить файл параметров для создания файла миграции

Нажмите кнопку Пуск, выберите Программы, Microsoft Visual Studio 2008, Набор средств Visual Studio, затем щелкните по пункту Командная строка Visual Studio.

В командной строке введите следующую команду cd %Буква диска%\VSS2TeamFoundation. Эта папка создается при анализе базы данных Visual SourceSafe для миграции. Дополнительные сведения см. в разделе Пошаговое руководство. Подготовка к миграции с Visual SourceSafe на Team Foundation.

Примечание.
Убедитесь, что на системном диске достаточно места для хранения самого большого файла из тех, с которыми будет выполнятся миграция.

Сохраните файл параметров, который вы создали для анализа (settings.xml) под новым именем, например, migration_settings.xml.
В командной строке введите notepad migration_settings.xml, затем нажмите клавишу Enter.

Файл settings.xml, созданный вами при анализе базы данных для миграции, будет показан в Блокноте.

Измените файл параметров следующим образом.

В разделе <ProjectMap> для каждой папки Visual SourceSafe, которая участвует в миграции, добавьте целевые папки в Team Foundation (подсистема контроля версий). Используйте следующий формат для добавления раздела Destination, как показано в примере:
```
<Project Source="$/FolderA" Destination="$/Team_Project"></Project>
```
Для переноса всей базы данных Visual SourceSafe используйте следующий XML-фрагмент.
```
<Project Source="$/" Destination="$/Team_Project/"></Project> 
```

В раздел <Settings> добавьте раздел <TeamFoundationServer> и задайте имя, порт и протокол для Team Foundation Server, в который вы выполняете миграцию. Используйте следующий формат:

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

Например:

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

Примечание.
Если у вас большая база данных Visual SourceSafe, ваша миграция может завершиться неудачей из-за ограничения в 4 Гб сервера экcпресс-выпуска SQL Server. Чтобы решить данную проблему, настройте преобразователь для использования SQLServer, добавив следующую строку: <SQL Server="SQL_Server_name"></SQL>

Если у вас большая база данных Visual SourceSafe, ваша миграция может завершиться неудачей из-за ограничения в 4 Гб сервера экcпресс-выпуска SQL Server. Чтобы решить данную проблему, настройте преобразователь для использования SQLServer, добавив следующую строку: <SQL Server="SQL_Server_name"></SQL>

Удалите <Output file="Analysis.xml"></Output> из раздела <Settings>, или переименуйте выходной файл в "migration_Analysis.xml".

Ваш файл migration_settings.xml должен напоминать следующий:

<?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>

Не забудьте подставить имя вашего сервера вместо server name и реальный номер порта вместо port number.

Сохраните изменения и закройте Блокнот.

Для запуска преобразователя

Скопируйте вашу базу данных Visual SourceSafe в локальную папку на компьютере, на котором вы будете выполнять анализ и миграцию. Хотя вы можете выполнить миграцию базы данных Visual SourceSafe в общий каталог на удаленном компьютере, в этом случае миграция займет значительно больше времени.
Нажмите кнопку "Пуск", в меню "Все программы" выберите Visual Studio, затем выберите "Инструментарий Visual Studio", а затем щелкните пункте "Командная строка Visual Studio".
В командной строке введите следующее:

VSSConverter Migrate migration_settings.xml

Совет.

Используйте переключатель /? для просмотра всех доступных опций командной строки.
Нажмите Y для подтверждения миграции.

Преобразователь покажет состояние миграции. После завершения процесса преобразования утилита сохранит отчет о миграции в текущем каталоге. Дополнительную информацию вы можете получить, открыв файл в Internet Explorer.

Совет.
Используйте переключатель /? для просмотра всех доступных опций командной строки.

Когда потребуется, введите пароль административного пользователя Visual SourceSafe.

Примечание.
VSSConverter не переносит привязки системы управления версиями для решений Visual Studio. Вы должны изменить эти привязки вручную. Дополнительные сведения см. в разделе Практическое руководство. Миграция привязок управления версиями из Visual SourceSafe.

VSSConverter не переносит привязки системы управления версиями для решений Visual Studio. Вы должны изменить эти привязки вручную. Дополнительные сведения см. в разделе Практическое руководство. Миграция привязок управления версиями из Visual SourceSafe.

См. также

Поделиться через

Пошаговое руководство: миграция с Visual SourceSafe в Team Foundation

Обязательные компоненты

Перенос папок проекта SourceSafe

Чтобы изменить файл параметров для создания файла миграции

Для запуска преобразователя

См. также

Задачи

Основные понятия

Другие ресурсы

Дополнительные ресурсы