Exemplarische Vorgehensweise: Migrieren von Visual SourceSafe zu Team Foundation

Artikel
08/20/2007

In dieser exemplarischen Vorgehensweise wird das Migrieren von Visual SourceSafe zu Team Foundation mithilfe des VSS-Konvertertools VSSConverter.exe beschrieben. Weitere Informationen zum Vorbereiten der Datenbank für die Migration finden Sie unter Exemplarische Vorgehensweise: Vorbereiten der Migration von Visual SourceSafe zu Team Foundation. Sie finden in dieser exemplarischen Vorgehensweise detaillierte Informationen über das Vorbereiten einer SourceSafe-Datenbank und einer Benutzerliste auf die Migration zu Team Foundation und Einblicke in die Funktionsweise des Migrationsvorgangs.

Im Verlauf dieser exemplarischen Vorgehensweise führen Sie folgende Aufgaben aus:

Ändern Sie die Einstellungsdatei, um die zu migrierenden Ordner anzugeben.
Führen Sie den Konverter aus, um die Quelle aus Visual SourceSafe zu Team Foundation zu migrieren und einen Migrationsbericht zu generieren.

Vorbereitungsmaßnahmen

Schritte vor dem Ausführen dieser exemplarischen Vorgehensweise:

Führen Sie alle in Exemplarische Vorgehensweise: Vorbereiten der Migration von Visual SourceSafe zu Team Foundation beschriebenen Schritte aus.
Geben Sie in der Quellcodeverwaltung in Team Foundation leere Ordner an, in die die Visual SourceSafe-Ordner migriert werden sollen. Wenn der Zielordner nicht vorhanden ist, wird er vom Konverter erstellt. Dies gilt nur dann nicht, wenn der Zielordner ein Teamprojekt darstellt. Der Zielordner sollte ein gültiges Teamprojekt oder der Unterordner eines gültigen Teamprojekts sein. Weitere Informationen finden Sie unter Gewusst wie: Erstellen eines Teamprojekts.

Darüber hinaus benötigen Sie Folgendes:

Einen Team Foundation Server-Namen.
Sie müssen Mitglied der Gruppe Team Foundation-Administratoren sein.
Installieren Sie SQL Server Express auf dem Computer, auf dem Sie den Konverter ausführen möchten.

Standardmäßig wird SQL Express zusammen mit Visual Studio 2005 installiert.

Sie müssen über Administratorberechtigungen für das Herstellen einer Verbindung mit einer SQL Express-Datenbank verfügen, um das Konvertierungstool verwenden zu können.
Visual SourceSafe 2005 auf dem Computer, auf dem Sie VSSConverter ausführen.

Migrieren von SourceSafe-Projektordnern

Bevor Sie mit der eigentlichen Konvertierung fortfahren, passen Sie die Einstellungsdatei an, damit diese die Zielordner für die SourceSafe-Projekte enthält, die Sie bei der Vorbereitung der Konvertierung angegeben haben. Zum Abschließen dieser Aufgabe müssen Sie alle in Exemplarische Vorgehensweise: Vorbereiten der Migration von Visual SourceSafe zu Team Foundation beschriebenen Schritte ausführen.

So ändern Sie die Einstellungsdatei

Klicken Sie auf Start und auf Programme, zeigen Sie anschließend auf Microsoft Visual Studio 2005 und auf Visual Studio-Tools, und klicken Sie dann auf Visual Studio 2005-Eingabeaufforderung.
Geben Sie an der Eingabeaufforderung cd %Laufwerkbuchstabe%\VSS2TeamFoundation ein. Erstellen Sie diesen Ordner, sofern er noch nicht vorhanden ist.

Hinweis

Stellen Sie sicher, dass der auf dem Systemlaufwerk verfügbare Speicherplatz für die größte zu migrierende Datei ausreicht.
Kopieren Sie die für die Analyse erstellte Einstellungsdatei, und speichern Sie sie unter einem neuen Namen, z. B. migration_settings.xml.
Geben Sie an der Eingabeaufforderung notepad migration_settings.xml ein, und drücken Sie anschließend die EINGABETASTE.
Ändern Sie die Einstellungsdatei wie folgt.
- Fügen Sie im Abschnitt <ProjectMap> für jeden zu migrierenden VSS-Ordner die Zielordner in der Quellcodeverwaltung in Team Foundation hinzu. Verwenden Sie das folgende Format, und fügen Sie den Abschnitt Destination wie im folgenden Beispiel hinzu.
```
<Project Source="$/FolderA" Destination="$/Team_Project"></Project>
```
  Um den gesamten Inhalt der VSS-Datenbank zu migrieren, fügen Sie stattdessen den folgenden XML-Code ein.
```
<Project Source="$/" Destination="$/Team_Project/"></Project> 
```
- Fügen Sie unterhalb des Abschnitts <Settings> den Abschnitt <TeamFoundationServer> hinzu, und geben Sie Namen, Anschluss und Protokoll für den Team Foundation Server für die Migration an. Verwenden Sie folgendes Format.
```
<TeamFoundationServer name="TFS_server_name" port="port_number" protocol="http"></TeamFoundationServer>
```
  Beispiel:
```
<TeamFoundationServer name="AdventureWorks" port="8080" protocol="http"></TeamFoundationServer>
```
  Hinweis
  
  Wenn die Visual SourceSafe-Datenbank sehr umfangreich ist, kann die Migration fehlschlagen, da SQL Express auf 4 GB beschränkt ist. Zum Lösen dieses Problems können Sie, wie in Gewusst wie: Migrieren einer teilweisen Versionsgeschichte mithilfe der Archivfunktion in Visual SourceSafe beschrieben, eine teilweise Versionsgeschichte migrieren oder den Konverter auf die Verwendung von SQL Server festlegen, indem Sie die folgende Zeile hinzufügen: <SQL Server="SQL_Server_name"></SQL>
Speichern Sie die Änderungen, und schließen Sie Editor.

So erstellen Sie eine neue Einstellungsdatei

Klicken Sie auf Start und auf Programme, zeigen Sie anschließend auf Microsoft Visual Studio 2005 und auf Visual Studio-Tools, und klicken Sie dann auf Visual Studio 2005-Eingabeaufforderung.
Geben Sie an der Eingabeaufforderung cd %Laufwerkbuchstabe%\VSS2TeamFoundation ein.
Kopieren Sie die für die Analyse erstellte Einstellungsdatei, und speichern Sie sie unter einem neuen Namen.
Geben Sie notepad migration_settings.xml ein, und drücken Sie dann die EINGABETASTE. Klicken Sie auf Ja, um eine neue Datei zu erstellen.

Kopieren Sie den folgenden XML-Code in die Datei 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>

Ändern Sie die Einstellungsdatei für die Migration wie folgt.

Ersetzen im Abschnitt <ProjectMap> für jeden zu migrierenden VSS-Ordner FolderA durch die VSS-Quellordner und TeamProjectA durch die Zielordner in der Quellcodeverwaltung in Team Foundation. Fügen Sie einen <Project>-Eintrag für alle zu migrierenden Ordner hinzu.

Um den gesamten Inhalt der VSS-Datenbank zu migrieren, fügen Sie stattdessen den folgenden XML-Code ein.
```
<Project Source="$/" Destination="$/Team_Project/"></Project> 
```
Hinweis

Der Konverter verwendet SQL Express während der Migration. Wenn die Migration aufgrund der 4 GB-Beschränkung von SQL Express fehlschlägt, können Sie den Konverter für die Verwendung von SQL Server konfigurieren, indem Sie im Abschnitt <Source name="VSS"> die folgende Zeile hinzufügen: <SQL Server="SQL_Server_name"></SQL>
Speichern Sie die Änderungen, und schließen Sie Editor.

So führen Sie den Konverter aus

Kopieren Sie die Visual SourceSafe-Datenbank in einen lokalen Ordner auf dem Computer, auf dem Sie die Analyse und die Migration ausführen möchten. Sie können eine Visual SourceSafe-Datenbank auch in einen freigegeben Ordner auf einem Remotecomputer migrieren, die Migration dauert dann allerdings erheblich länger.
Klicken Sie auf Start und dann auf Alle Programme, zeigen Sie auf Microsoft Visual Studio und auf Visual Studio-Tools, und klicken Sie anschließend auf Visual Studio-Eingabeaufforderung.
Geben Sie an der Eingabeaufforderung Folgendes ein:

VSSConverter Migrate migration_settings.xml

Tipp

Verwenden Sie den /?-Schalter, um die verfügbaren Befehlszeilenoptionen anzuzeigen.
Geben Sie Y ein, um die Migration zu bestätigen.

Im Konvertertool wird der Migrationsstatus angezeigt. Nach Abschluss des Konvertierungsprozesses speichert das Tool einen Migrationsbericht im aktuellen Verzeichnis. Sie können die Datei in Internet Explorer anzeigen, um weitere Informationen zu erhalten.
Geben Sie, wenn Sie dazu aufgefordert werden, das Kennwort für den Visual SourceSafe-Administrator an.

Sicherheit

Sie müssen über Administratorberechtigungen für die zu migrierende Visual SourceSafe-Datenbank verfügen, um diese exemplarische Vorgehensweise auszuführen. Weitere Informationen finden Sie unter Gewusst wie: Zuweisen von Projektrechten. Sie müssen außerdem Mitglied der Sicherheitsgruppe Team Foundation-Administratoren auf Team Foundation Server sein. Weitere Informationen finden Sie unter Team Foundation Server-Berechtigungen. Sie müssen außerdem Mitglied der sysadmin-Serverrolle für SQL Express sein. In der Standardeinstellung sind Sie automatisch Mitglied der sysadmin-Serverrolle, wenn Sie Mitglied der Sicherheitsgruppe Administratoren auf dem Computer sind, auf dem SQL Express installiert wurde. Weitere Informationen finden Sie in der SQL Server 2005-Dokumentation unter "sysadmin" (https://go.microsoft.com/fwlink/?LinkId=60405).

Siehe auch

Freigeben über

Exemplarische Vorgehensweise: Migrieren von Visual SourceSafe zu Team Foundation

Vorbereitungsmaßnahmen

Migrieren von SourceSafe-Projektordnern

So ändern Sie die Einstellungsdatei

So erstellen Sie eine neue Einstellungsdatei

So führen Sie den Konverter aus

Sicherheit

Siehe auch

Aufgaben

Konzepte

Weitere Ressourcen

Zusätzliche Ressourcen