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

Статья
11/05/2008

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

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

Перед созданием файла настроек необходимо:

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

Формат файла настроек несколько отличается при запуске анализа от используемого для миграции. В следующих разделах указаны различия.

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

Создайте XML-файл в любом редакторе, например в «Блокноте».
Скопируйте текст из подраздела «Формат файла настроек для анализа» раздела Пример файла параметров преобразователя VSS в XML-файл.
В разделе <VSSDatabase> укажите расположение базы данных Visual SourceSafe, для которой выполняется анализ.
Можно (необязательно) также указать имя и расположение файла сопоставления пользователей в разделе <UserMap>. Если не указать имя файла, преобразователь создает файл с именем UserMap.xml в текущей папке.
В разделе <ProjectMap> укажите папки Visual SourceSafe для анализа.
В разделе <Settings>, в подразделе <Output>, можно указать имя и расположение файла отчета об анализе. Если не указать имя файла, преобразователь создает файл с именем VSSAnalysisReport.xml.
Сохраните файл настроек в виде XML-файла (с расширением .xml).

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

Скопируйте файл настроек, созданный для анализа, и сохраните его под новым именем. Для справки см. подраздел «Формат файла настроек для миграции» раздела Пример файла параметров преобразователя VSS.

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

В разделе <ProjectMap> для каждой папки Visual SourceSafe, подлежащей миграции, добавьте целевые папки в Team Foundation (подсистема контроля версий). Добавьте раздел Destination, используя следующий формат:

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

Примечание.
Если исходный код проекта находится в папке $/FolderA, а папка назначения —$/TeamProjectB/ProjectB, то проект Visual SourceSafe$/FolderA/ProjectA в Team Foundation (подсистема контроля версий) будет расположен в папке $/TeamProjectB/ProjectB/ProjectA, а не $/TeamProjectB/ProjectB/FolderA/ProjectA.

Если исходный код проекта находится в папке $/FolderA, а папка назначения —$/TeamProjectB/ProjectB, то проект Visual SourceSafe$/FolderA/ProjectA в Team Foundation (подсистема контроля версий) будет расположен в папке $/TeamProjectB/ProjectB/ProjectA, а не $/TeamProjectB/ProjectB/FolderA/ProjectA.

В раздел <Settings> добавьте раздел <TeamFoundationServer> и задайте имя, порт и протокол для Team Foundation Server, на который выполняется миграция. Используйте следующий формат:
```
<TeamFoundationServer name="TFS_server_name" port="port_number" protocol="http"></TeamFoundationServer>
```
Пример:
```
<TeamFoundationServer name="My_TFS_server" port="8080" protocol="http"></TeamFoundationServer>
```

В разделе <Settings>, в подразделе <Output>, можно (необязательно) указать имя и расположение файла отчета об анализе. Если не указать имя файла, преобразователь создает файл с именем VSSMigrationReport.xml.

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

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

<Source name="VSS">
   <VSSDatabase name="c:\VSSDatabase"></VSSDatabase>
   <SQL Server="MySQLServer"></SQL>
</Source>

Сохраните файл настроек в виде XML-файла (с расширением .xml).

См. также

Задачи

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

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

Практическое руководство. Создание командного проекта

Практическое руководство. Добавление проекта или решения в систему управления версиями

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

Пример файла параметров преобразователя VSS

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

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