Freigeben über


Exemplarische Vorgehensweise: Migrieren von Visual SourceSafe zu Team Foundation

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:

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

  1. 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.

  2. 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.

  3. Speichern Sie die für die Analyse erstellte Einstellungsdatei (settings.xml) unter einem neuen Namen, z. B. migration_settings.xml.

  4. 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.

  5. Ä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>

  6. 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.

  7. Speichern Sie die Änderungen, und schließen Sie Editor.

So führen Sie den Konverter aus

  1. 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.

  2. 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.

  3. Geben Sie an der Eingabeaufforderung Folgendes ein:

    VSSConverter Migrate migration_settings.xml

    Tipp:

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

  4. 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.

  5. 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

Aufgaben

Gewusst wie: Erstellen einer Einstellungsdatei für Quellcodeverwaltungsanalyse und Migration

Konzepte

Befehlszeilendienstprogramm VSSConverter für die Quellcodeverwaltungsmigration

Weitere Ressourcen

Dokumentation zu Team Foundation