Freigeben über

Exemplarische Vorgehensweise: Vorbereiten der Migration von Visual SourceSafe zu Team Foundation

  • Artikel

Mithilfe des Team Foundation-Visual SourceSafe-Konvertierungstools werden Dateien, Ordner, Versionsgeschichten sowie Benutzerinformationen von einer Visual SourceSafe-Datenbank zu einem Server für die Quellcodeverwaltung in Team Foundation übertragen. Analysieren Sie die Datenbank vor dem Verschieben von Dateien und Versionsgeschichtsinformationen zu Team Foundation, und erstellen Sie eine Sicherungskopie. Checken Sie außerdem so viele Dateien wie möglich ein, und informieren Sie sich darüber, welche Informationen nicht von Visual SourceSafe zu Team Foundation verschoben werden können.

In dieser exemplarischen Vorgehensweise wird beschrieben, wie Sie Ihre Visual SourceSafe-Datenbank für die Konvertierung vorbereiten und wie Sie VSSConverter verwenden, um die tatsächliche Migration der Quelle effizient zu planen.

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

  • Erstellen einer Sicherungskopie der Visual SourceSafe-Datenbank.

  • Identifizieren und Lösen von Datenintegritätsproblemen in der vorhandenen Datenbank mithilfe des Visual SourceSafe-Analysetools.

  • Ausführen des Konvertierungstools, um potenzielle Quellen für Datenverluste zu identifizieren.

  • Angabe der Visual SourceSafe-Migrationsordner.

  • Erstellen einer Benutzerzuordnungsdatei, um Team Foundation-Benutzern Visual SourceSafe-Benutzer zuzuordnen.

Vorbereitungsmaßnahmen

Um diese exemplarische Vorgehensweise auszuführen, muss die folgende Software auf dem Computer installiert sein, auf dem VSSConverter.exe ausgeführt werden soll:

  • Team Explorer

  • Melden Sie sich mit Administratorrechten am Computer an.

  • SQL Server Express

    Hinweis

    SQL Server Express wird standardmäßig während der Installation von Visual Studio 2005 installiert.

  • Visual SourceSafe 2005 oder höher

  • Die Visual SourceSafe-Datenbank, die Sie analysieren möchten. Das Datenbankformat muss Version 6.0 oder höher sein. Sie müssen den Konverter auf dem gleichen Computer wie die Visual SourceSafe-Datenbank ausführen, um diese exemplarische Vorgehensweise abzuschließen.

    Darüber hinaus benötigen Sie Folgendes:

    • Das Administratorkennwort für die Visual SourceSafe-Datenbank, die die Projekte enthält, die Sie analysieren möchten.

      Hinweis

      Während des Analyseprozesses sollten keine anderen Benutzer auf die Visual SourceSafe-Datenbank zugreifen. Verwenden Sie keine Sperre für die Datenbank, da der Konverter andernfalls nicht auf die Datenbank für die Migration zugreifen kann.

Vorbereiten der Visual SourceSafe-Datenbank

Führen Sie die folgenden Aufgaben in Visual SourceSafe aus, bevor Sie die der Quellcodeverwaltung unterliegenden Dateien von Visual SourceSafe zu Visual Studio 2005 übertragen.

  • Bitten Sie alle Datenbankbenutzer, ihre Dateien einzuchecken.

  • Erstellen Sie eine Sicherungskopie der Visual SourceSafe-Datenbank, die Sie migrieren möchten. Weitere Informationen erhalten Sie unter "How To Back Up a Visual SourceSafe Database" (https://go.microsoft.com/fwlink?linkid=51358).

  • Verwenden Sie das Visual SourceSafe-Dienstprogramm Analyze, um Datenintegritätsprobleme in der Datenbank zu suchen und zu lösen. Weitere Informationen über die Verwendung dieses Tools finden Sie unter ANALYZE-Dienstprogramm und unter "How to: Detect and Fix Database Corruption Errors in Visual SourceSafe" (https://go.microsoft.com/fwlink/?linkid=51357).

Analysieren von Projekten

VSSConverter.exe ist ein Befehlszeilentool, das folgende Eingaben erfordert:

  • Den Pfad des Ordners, der die Datei srcsafe.ini für die Visual SourceSafe-Datenbank enthält, die migriert wird.

  • Eine XML-basierte Datei mit Einstellungen.

In dieser exemplarischen Vorgehensweise wird davon ausgegangen, dass sich die Visual SourceSafe-Datenbank unter c:\VSSDatabase befindet.

Legen Sie fest, welche Projekte Sie analysieren möchten, und erstellen Sie eine Datei, die die Einstellungen enthalten soll. In dieser Datei sind die Projekte aufgelistet, die vom Konverter analysiert werden sollen.

So erstellen Sie die Einstellungsdatei für die Analyse

  1. Klicken Sie auf Start, zeigen Sie auf Alle Programme, auf Microsoft Visual Studio 2005 und auf Visual Studio-Tools, und klicken Sie anschließend auf Visual Studio 2005-Eingabeaufforderung.

  2. Geben Sie an der Eingabeaufforderung mkdir %Laufwerkbuchstabe%\VSS2TeamFoundation ein, wobei %Laufwerkbuchstabe% für das aktuelle Laufwerk steht. Drücken Sie die EINGABETASTE.

  3. Geben Sie an der Eingabeaufforderung cd %Laufwerkbuchstabe%\VSS2TeamFoundation ein. Drücken Sie die EINGABETASTE.

  4. Geben Sie notepad settings.xml ein, und drücken Sie dann die EINGABETASTE.

  5. Klicken Sie auf Ja, um die Datei zu erstellen.

  6. Kopieren Sie den nachfolgenden XML-Code, wobei $/FolderA und $/FolderB für die Namen der Ordner stehen, die die Projekte enthalten, die Sie migrieren möchten.

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

    Tipp

    Wenn Sie die gesamte Datenbank migrieren möchten, verwenden Sie <Project Source="$/"></Project>.

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

Führen Sie anschließend wie in den nachfolgenden Schritten beschrieben das Konvertierungstool über die Visual Studio-Befehlszeile aus, um das Projekt zu analysieren.

Der Benutzer, der die Analyse ausführt, muss Systemadministrator für SQLExpress sein. In der Standardeinstellung erhält der Benutzer, der Visual Studio installiert, die erforderlichen Berechtigungen für SQLExpress.

Nachdem Sie die Datei mit den Migrationseinstellungen erstellt und Systemadministratorrechte gewährt haben, können Sie das Konvertierungstool ausführen, um das Projekt zu analysieren.

So analysieren Sie das Projekt mit dem Konverter

  1. Geben Sie an der Eingabeaufforderung Folgendes ein:

    VSSConverter Analyze settings.xml

  2. Geben Sie das Visual SourceSafe-Administratorkennwort ein, wenn Sie dazu aufgefordert werden.

    Das Konvertierungstool zeigt den Status der Analyse vor der Konvertierung an. Wenn die Konvertierung abgeschlossen ist, werden ein Bericht (VSSAnalysisReport.xml) sowie eine Benutzerzuordnungsdatei (usermap.xml) generiert und im aktuellen Verzeichnis gespeichert.

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.

Nächste Schritte

Sie können nun die Informationen in der Visual SourceSafe-Datenbank auf den Server für die Quellcodeverwaltung in Team Foundation migrieren. Weitere Informationen finden Sie unter Exemplarische Vorgehensweise: Migrieren von Visual SourceSafe zu Team Foundation.

Siehe auch

Aufgaben

Exemplarische Vorgehensweise: Migrieren von Visual SourceSafe zu Team Foundation
Gewusst wie: Erstellen einer Einstellungsdatei für Quellcodeverwaltungsanalyse und Migration

Weitere Ressourcen

Dokumentation zu Team Foundation
Befehlszeilendienstprogramm VSSConverter für die Quellcodeverwaltungsmigration