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

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

  • Статья

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

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

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

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

  • Создать резервную копию базы данных Visual SourceSafe.

  • Идентифицировать и разрешить проблемы целостности данных в существующей базе данных с помощью средства Visual SourceSafe Analyze.

  • Запустить преобразователь для идентификации потенциальных источников потери информации.

  • Указать, какие папки Visual SourceSafe подлежат миграции.

  • Создать файл сопоставления пользователей Visual SourceSafe с пользователями Team Foundation.

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

Для выполнения этого пошагового руководства вам понадобится установить на компьютер, где планируется запустить VSSConverter.exe, следующее программное обеспечение:

  • Сред. Командный обозреватель

  • Войдите на компьютер, используя административные учетные данные

  • SQL Server Express

    ms181246.alert_note(ru-ru,VS.90).gifПримечание.

    По умолчанию SQL Server Express устанавливается в процессе установки Visual Studio 2005 или Visual Studio 2008

  • Visual SourceSafe 2005 или более поздние версии

  • База данных Visual SourceSafe, которую нужно проанализировать. База данных должна иметь формат 6.0 или более поздней версии. Для выполнения этого руководства преобразователь необходимо запустить на том же компьютере, где расположена база данных Visual SourceSafe.

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

    • Пароль администратора базы данных Visual SourceSafe, которая содержит анализируемые проекты.

      ms181246.alert_note(ru-ru,VS.90).gifПримечание.

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

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

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

Подготовка базы данных Visual SourceSafe

Перед переносом файлов системы управления версиями из Visual SourceSafe в Microsoft Visual Studio Team System следует выполнить в Visual SourceSafe следующие задачи.

  • Попросите всех пользователей базы данных вернуть свои файлы.

  • Создайте резервную копию базы данных Visual SourceSafe для миграции. Дополнительные сведения см. в разделе "Создание резервной копии базы данных Visual SourceSafe" на веб-узле Майкрософт (https://go.microsoft.com/fwlink?linkid=51358).

  • С помощью программы Visual SourceSafe Analyze найдите и устраните проблемы целостности данных в базе данных. Дополнительные сведения об использовании этого инструмента см. в разделах "Программа ANALYZE" (https://go.microsoft.com/fwlink/?LinkId=99129) и "Практическое руководство. Выявление и устранение ошибок повреждения базы данных Visual SourceSafe" (https://go.microsoft.com/fwlink/?linkid=51357).

Анализ проектов

VSSConverter.exe — это средство командной строки, требующее следующих входных данных:

  • Путь к папке, содержащей файл srcsafe.ini для базы данных Visual SourceSafe, подлежащей миграции.

  • XML-файл, содержащий настройки.

  • Программа VSSConverter.exe хранится в папке <корень>:\Program Files\Microsoft Visual Studio 9.0\Common7\IDE, но вызывается из командной строки Visual Studio.

В этом пошаговом руководстве предполагается, что база данных Visual SourceSafe расположена в папке c:\VSSDatabase.

После решения о том, какие проекты следует проанализировать, создайте файл с настройками. В этом файле перечисляются проекты, которые должен проанализировать преобразователь.

Создание файла настроек для анализа

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

  2. В командной строке введите mkdir %DriveLetter%\VSS2TeamFoundation, где %DriveLetter% — текущий диск. Нажмите клавишу ВВОД.

  3. В командной строке введите следующую команду cd %Буква диска%\VSS2TeamFoundation. Нажмите клавишу ВВОД.

  4. Введите notepad settings.xml и нажмите клавишу ВВОД.

  5. Выберите Да, чтобы создать файл.

  6. Скопируйте следующий XML-код, где $/FolderA и $/FolderB представляют имена папок с проектами, подлежащими миграции.

    <?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>
    ms181246.alert_note(ru-ru,VS.90).gifПримечание.

    Для миграции всей базы данных воспользуйтесь командой <Project Source="$/"></Project>.

    В теге <VSSDatabase name> введите путь к базе данных Visual SourceSafe.

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

Затем запустите преобразователь из командной строки Visual Studio, чтобы проанализировать проект, как показано на следующих шагах.

Пользователь, выполняющий анализ, должен быть системным администратором в SQLExpress. По умолчанию пользователь, устанавливающий Visual Studio, получает необходимые разрешения для SQLExpress.

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

Анализ проекта с помощью преобразователя

  1. В командной строке Visual Studio введите следующее:

    VSSConverter Analyze settings.xml

  2. При запросе введите пароль администратора Visual SourceSafe.

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

Следующие действия

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

См. также

Задачи

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

Практическое руководство. Создание файла параметров для анализа и миграции системы управления версиями

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

Программа командной строки VSSConverter для перемещения системы управления версиями

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

Team Foundation