Exemplarische Vorgehensweise: Migrieren von Visual SourceSafe zu Team Foundation

Artikel
08/20/2008

Aktualisiert: November 2007

In dieser exemplarischen Vorgehensweise wird die Migration von Visual SourceSafe nach Team Foundation mit dem VSS-Konvertierungstool VSSConverter.exe beschrieben. Weitere Informationen zum Vorbereiten der Datenbank auf die Migration finden Sie unter Exemplarische Vorgehensweise: Vorbereiten der Migration von Visual SourceSafe zu Team Foundation. Sie finden in dieser exemplarischen Vorgehensweise ausführliche Informationen zur Vorbereitung einer SourceSafe-Datenbank und -Benutzerliste auf die Migration nach Team Foundation sowie zur 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 von Visual SourceSafe nach Team Foundation zu migrieren und einen Migrationsbericht zu erstellen.

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 leere Ordner in Team Foundation-Versionskontrolle 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 hierzu finden Sie unter Gewusst wie: Erstellen eines Teamprojekts.

Darüber hinaus benötigen Sie Folgendes:

Ein Team Foundation Server-Name.
Installieren Sie SQL Server Express auf dem Computer, auf dem Sie den Konverter ausführen möchten.

Bei der Installation von Microsoft Visual Studio Team System wird SQL Express standardmäßig 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 VSSConverter ausgeführt wird.

Erforderliche Berechtigungen

Um diese exemplarische Vorgehensweise durchführen zu können, müssen Sie über Administratorberechtigungen für die zu migrierende Visual SourceSafe-Datenbank verfügen. Weitere Informationen finden Sie unter "How to: Assign Project Rights" auf der Microsoft-Website (https://go.microsoft.com/fwlink/?linkid=99103). 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 unter "sysadmin" auf der Microsoft-Website (https://go.microsoft.com/fwlink/?LinkId=60405) in der SQL Server 2005-Dokumentation.

Migrieren von SourceSafe-Projektordnern

Bevor Sie mit der eigentlichen Konvertierung fortfahren, passen Sie die Einstellungsdatei an, damit diese die Zielordner für die bei der Vorbereitung der Konvertierung angegebenen SourceSafe-Projekte enthält. 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, um eine Migrationsdatei zu erstellen

Klicken Sie auf Start und auf Programme, zeigen Sie anschließend auf Microsoft Visual Studio 2008 und auf Visual Studio-Tools, und klicken Sie dann auf Visual Studio 2008-Eingabeaufforderung.
Geben Sie an der Eingabeaufforderung cd %Laufwerkbuchstabe%\VSS2TeamFoundation ein. Dieser Ordner wurde beim Analysieren der Visual SourceSafe-Datenbank für die Migration erstellt. Weitere Informationen finden Sie unter Exemplarische Vorgehensweise: Vorbereiten der Migration von Visual SourceSafe zu Team Foundation.

Hinweis:

Stellen Sie sicher, dass der auf dem Systemlaufwerk verfügbare Speicherplatz für die größte zu migrierende Datei ausreicht.
Speichern Sie die für die Analyse erstellte Einstellungsdatei (settings.xml) 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.

Die Datei settings.xml, die bei der Datenbankanalyse für die Migration erstellt wurde, wird in Editor angezeigt.

Hinweis:
Stellen Sie sicher, dass der auf dem Systemlaufwerk verfügbare Speicherplatz für die größte zu migrierende Datei ausreicht.

Ändern Sie die Einstellungsdatei wie folgt.

Fügen Sie im Abschnitt <ProjectMap> für alle Visual SourceSafe-Ordner, die migriert werden sollen, Zielordner in Team Foundation-Versionskontrolle 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 Visual SourceSafe-Datenbank zu migrieren, fügen Sie stattdessen den folgenden XML-Code ein.
```
<Project Source="$/" Destination="$/Team_Project/"></Project> 
```

Fügen Sie im Abschnitt <Settings> einen <TeamFoundationServer>-Abschnitt hinzu, und geben Sie Namen, Anschluss und Protokoll für den Team Foundation Server an, zu dem Sie migrieren. 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. Um dies zu vermeiden, können Sie für den Konverter stattdessen die Verwendung von SQL Server einrichten, indem Sie die folgende Zeile hinzufügen: <SQL Server="SQL_Server-Name"></SQL>

Entfernen Sie <Output file="Analysis.xml"></Output> aus dem <Settings>-Abschnitt, oder benennen Sie die Ausgabedatei in "migration_Analysis.xml" um.

Die Datei migration_settings.xml sollte etwa folgendermaßen aussehen:

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

Ersetzen Sie server name mit dem Servernamen und port number mit einer tatsächliche Anschlussnummer.

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 Analyse und Migration ausgeführt werden sollen. Sie können eine Visual SourceSafe-Datenbank auch in einem freigegeben Ordner auf einem Remotecomputer migrieren. Die Migration dauert dann allerdings wesentlich 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.

Tipp:
Verwenden Sie den /?-Schalter, um die verfügbaren Befehlszeilenoptionen anzuzeigen.

Wenn Sie dazu aufgefordert werden, geben Sie das Kennwort für den Visual SourceSafe-Benutzer "Admin" an.

Hinweis:
Versionskontrollbindungen für Visual Studio-Lösungen werden von VSSConverter nicht migriert. Sie müssen diese Bindungen manuell ändern. Weitere Informationen finden Sie unter Gewusst wie: Migrieren von Quellcodeverwaltungsbindungen von Visual SourceSafe.

Siehe auch

Freigeben über

Exemplarische Vorgehensweise: Migrieren von Visual SourceSafe zu Team Foundation

Vorbereitungsmaßnahmen

Migrieren von SourceSafe-Projektordnern

So ändern Sie die Einstellungsdatei, um eine Migrationsdatei zu erstellen

So führen Sie den Konverter aus

Siehe auch

Aufgaben

Konzepte

Weitere Ressourcen

Zusätzliche Ressourcen