Freigeben über

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

  • Artikel

Aktualisiert: November 2007

Das Team Foundation-Konvertierungstool für Visual SourceSafe überträgt Dateien, Ordner, Versionsverlauf und Benutzerinformationen von einer Visual SourceSafe-Datenbank zu einem Team Foundation-Versionskontrolle-Server. Bevor Sie Dateien und Versionsinformationen zu Team Foundation verschieben, sollten Sie eine Analyse durchführen und eine Sicherungskopie der Datenbank erstellen. Checken Sie möglichst viele Dateien ein und ermitteln Sie, welche Informationen nicht von Visual SourceSafe an Team Foundation übertragen werden können.

In dieser exemplarischen Vorgehensweise wird beschrieben, wie eine Visual SourceSafe-Datenbank für die Konvertierung vorbereitet wird und wie Sie VSSConverter verwenden, um die eigentliche 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 Beheben von Problemen mit der Datenintegrität in der vorhandenen Datenbank mithilfe des Visual SourceSafe-Analysetools.

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

  • Angeben, welche Visual SourceSafe-Ordner migriert werden sollen.

  • Erstellen einer Benutzerzuordnungsdatei, um Visual SourceSafe-Benutzer Team Foundation-Benutzern 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 oder von Visual Studio 2008 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 zu analysierenden Projekte enthält.

      Hinweis:

      Während des Analyseprozesses dürfen 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.

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 "Gewusst wie: Zuweisen von Projektrechten" auf der Microsoft-Website (https://go.microsoft.com/fwlink/?LinkId=99103).

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 an Microsoft Visual Studio Team System übergeben.

  • Bitten Sie alle Datenbankbenutzer, ihre Dateien einzuchecken.

  • Erstellen Sie eine Sicherungskopie der zu migrierenden Visual SourceSafe-Datenbank. Weitere Informationen finden Sie unter "How To Back Up a Visual SourceSafe Database" auf der Microsoft-Website (https://go.microsoft.com/fwlink?linkid=51358).

  • Mit dem Visual SourceSafe-Dienstprogramm Analyze können Sie Datenintegritätsprobleme in der Datenbank erkennen und beheben. Weitere Informationen zur Verwendung dieses Dienstprogramms finden Sie unter "ANALYZE-Dienstprogramm" (https://go.microsoft.com/fwlink/?LinkId=99129) und "Gewusst wie: Erkennen und Beheben von Datenbankfehlern 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 zu migrierende Visual SourceSafe-Datenbank enthält.

  • Eine XML-basierte Datei mit Einstellungen.

  • VSSConverter.exe ist in <root>:\Programme\Microsoft Visual Studio 9.0\Common7\IDE gespeichert, wird jedoch über die Visual Studio-Eingabeaufforderung aufgerufen.

In dieser exemplarischen Vorgehensweise wird davon ausgegangen, dass sich die Visual SourceSafe-Datenbank in 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 2008 und auf Visual Studio-Tools, und klicken Sie anschließend auf Visual Studio 2008-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>
      <Settings>
       <Output file="Analysis.xml"></Output>
     </Settings>
</SourceControlConverter>
    Hinweis:

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

    Geben Sie für das <VSSDatabase name>-Tag den Pfad zur Visual SourceSafe-Datenbank ein.

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

Führen Sie anschließend wie in den folgenden Schritten beschrieben das Konvertierungstool über die Visual Studio-Eingabeaufforderung 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 Visual Studio-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. Sie können Visual SourceSafe-Benutzer mithilfe der Benutzerzuordnungsdatei Team Foundation-Benutzern zuordnen. Weitere Informationen finden Sie unter Gewusst wie: Bearbeiten der Benutzerzuordnungsdatei für die Quellcodeverwaltungsmigration.

Nächste Schritte

Sie können nun die Informationen in der Visual SourceSafe-Datenbank auf den Team Foundation-Versionskontrolle-Server migrieren. Weitere Informationen hierzu 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

Konzepte

Befehlszeilendienstprogramm VSSConverter für die Quellcodeverwaltungsmigration

Weitere Ressourcen

Dokumentation zu Team Foundation