Eine Subversion-Speicherauszugsdatei (SVN-Speicherauszugsdatei) umfasst den gesamten
Inhalt eines Subversion-Repositorys. Sie können die gesamte Subversion-Speicherauszugsdatei oder
Teile dieser Datei in eine neue oder eine vorhandene Komponente importieren.
Sie müssen ein
Jazz-Repository-Administrator
sein, um Benutzernamen zuordnen zu können. Wenn Sie keine Benutzernamen zuordnen, ist der Eigner aller importierten
Dateien und Ordner der Benutzer, der den Import ausgeführt hat.
Zur Erstellung einer Subversion-Speicherauszugsdatei verwenden Sie den Subversion-Befehl
svnadmin dump. Speicherauszugsdateien können gefiltert werden, um Repository-Inhalte
zu entfernen, die nicht in die
Rational Team Concert-Quellcodeverwaltung
importiert werden sollen.
Weitere Informationen zur Erstellung und Filterung von Subversion-Speicherauszugsdateien finden
Sie unter der Adresse http://svnbook.red-bean.com/en/1.1/re31.html oder
in der Subversion-Dokumentation unter der Adresse http://subversion.tigris.org/.
Der
Import einer Subversion-Speicherauszugsdatei erfolgt in zwei Phasen. In der ersten Phase geben Sie die Importquelle (eine
Subversion-Speicherauszugsdatei) und das Importziel (eine Komponente in einem Repository-Arbeitsbereich) an. In der zweiten Phase
öffnet das Importprogramm die Speicherauszugsdatei und zeigt eine Liste von Ordnern an, die für den Import ausgewählt werden
können, sowie eine Liste von Subversion-Benutzernamen, die Sie
Jazz-Benutzern zuordnen
können.
Gehen Sie wie folgt vor, um eine Subversion-Speicherauszugsdatei zu importieren:
- Klicken Sie im Hauptmenü der Jazz-Quellcodeverwaltung auf
.
- Erweitern Sie auf der Seite Auswählen den Eintrag Jazz-Quellcodeverwaltung
und wählen Sie SVN-Speicherauszugsdatei aus.
Klicken Sie auf Weiter.
- Klicken Sie auf der Seite SVN-Speicherauszugsdatei importieren auf Durchsuchen. Navigieren Sie zu der Speicherauszugsdatei, die Sie importieren wollen, und klicken Sie auf Öffnen.
- Optional: Zum Speichern einer komprimierten Speicherauszugsdatei wählen Sie
Komprimierte Version der Speicherauszugsdatei für zusätzliche Importe speichern aus.
- Klicken Sie auf Weiter.
- Gehen Sie auf der Seite In Arbeitsbereich und Komponente importieren wie folgt vor,
um einen Zielarbeitsbereich und eine Zielkomponente für den Import anzugeben:
Tipp: Wenn Sie den Hauptzweig importieren wollen, erstellen Sie für diesen eine neue Komponente. Wenn Sie eine Verzweigung importieren wollen, wählen Sie eine Komponentenreferenzkonfiguration
aus, die beim vorherigen Import des Hauptzweiges erstellt wurde.
- Zum Importieren in einen vorhandenen Repository-Arbeitsbereich und eine vorhandene Komponente
wählen Sie Komponente in vorhandenem Repository-Arbeitsbereich auswählen und anschließend
den Arbeitsbereich und die Komponente aus.
- Zum Importieren in eine neue Komponente in einem vorhandenen Repository-Arbeitsbereich wählen Sie
Komponente in vorhandenem Repository-Arbeitsbereich auswählen aus und klicken auf
Neue Komponente. Geben Sie einen Namen für die neue Komponente ein.
- Zum Erstellen eines neuen Repository-Arbeitsbereichs und einer neuen Komponente zur Aufnahme des
Imports wählen Sie Neuen Repository-Arbeitsbereich mit folgendem Namen erstellen aus
und geben einen Namen für den neuen Arbeitsbereich ein. Der Import erstellt einen neuen Arbeitsbereich und
eine neue Komponente. Die Komponente erhält denselben Namen wie der Arbeitsbereich.
- Klicken Sie auf Weiter.
- Optional: Führen Sie auf der Seite Import aus SVN in Jazz konfigurieren die gewünschten der
folgenden Schritte aus:
- Zum Angeben eines Namens für die Referenzkonfiguration geben Sie in das Feld Namen der
importierten Referenzkonfiguration angeben einen neuen Namen für die Referenzkonfiguration ein.
- Zum Generieren von Referenzkonfigurationen für Verzweigungs- und Tagpunkte wählen Sie
Referenzkonfigurationen für Verzweigungs- und Tagpunkte erstellen aus.
- Zum Angeben einer Textdateicodierung wählen Sie im Teilfenster Codierung der
Textdatei die Option Andere und anschließend in der Dropdown-Liste einen
Codierungstyp aus.
- Zum Abgleich der vorhandenen und importierten Dateien wählen Sie die Option Überschneidungen
zwischen vorhandenen und importierten Dateien/Ordnern ausgleichen aus.
- Zum Angeben des Bereichs der zu importierenden Überarbeitungen wählen Sie im Teilfenster Zu
importierende Überarbeitungen die Option Alle Überarbeitungen im angegebenen Bereich
importieren aus und geben in den Feldern Beginn bei Überarbeitung und
Ende bei Überarbeitung den Überarbeitungsbereich an.
- Klicken Sie auf Weiter.
- Optional: Führen Sie auf der Seite Benutzerzuordnung die gewünschten der
folgenden Schritte aus:
- Wenn die Zuordnung von Benutzern aufgeschoben werden soll, bis die SVN-Speicherauszugsdatei gelesen
wurde und die Liste der enthaltenen Benutzer angezeigt wird, wählen Sie die Option Jazz-Benutzer
nach Erkennung der SVN-Benutzer-IDs anfordern aus.
- Wenn Sie keine Benutzer zuordnen wollen, wählen Sie die Option
SVN-Benutzer nicht zu Jazz-Benutzern zuordnen aus.
- Wenn Benutzernamen mit derselben Benutzer-ID automatisch zugeordnet und fehlende Benutzer automatisch
erstellt werden sollen, wählen Sie die Option SVN-Benutzer automatisch Jazz-Benutzern mit
identischer ID zuordnen und fehlende Benutzer erstellen aus.
- Optional: Wenn Sie SVN-Benutzer manuell Jazz-Benutzern zuordnen wollen, wählen Sie auf der Seite
Benutzerzuordnungen die Option Unten eingegebene Zuordnungen verwenden
aus und führen Sie die gewünschten der folgenden Schritte aus:
- Zum Hinzufügen eines SVN-Benutzers klicken Sie auf SVN-Benutzer hinzufügen.
Geben
Sie in das Dialogfenster SVN-Benutzer-ID hinzufügen einen Benutzernamen in das Feld
ein und klicken Sie auf OK.
- Zum Erstellen eines neuen Jazz-Benutzers mit derselben Benutzer-ID wie die eines Subversion-Benutzers
wählen Sie in der Spalte 'SVN-Benutzer-ID' einen Namen aus und klicken anschließend auf
Jazz-Benutzer erstellen.
- Zum Zuordnen einer SVN-Benutzer-ID zu einem vorhandenem Jazz-Benutzer wählen Sie einen Namen in der
Spalte 'SVN-Benutzer-ID' aus und klicken auf Jazz-Benutzer ändern aus.
Geben im Dialogfenster Benutzer auswählen einen Jazz-Benutzernamen in das Feld
ein und klicken Sie auf OK.
- Zum Entfernen eines Subversion-Benutzers klicken Sie auf den Benutzernamen und anschließend auf
Entfernen.
- Zum Speichern der aktuellen Zuordnungen in einer Datei, die Sie für künftige Importoperationen
wiederverwenden können, klicken Sie auf Speichern.
- Zur Wiederverwendung einer Zuordnungsdatei, die Sie bei einem vorherigen Import erstellt haben,
klicken Sie auf Laden.
- Klicken Sie auf Weiter.
- Führen Sie einen der folgenden Schritte auf der Seite Projektpfade aus,
um die Pfade der zu importierenden Projekte anzugeben:
- Wenn Sie sich nicht sicher sind, wie die Struktur des Subversion-Repositorys aussieht, wählen Sie
Bestimmung zu importierender Ordner bei bekannter Ordnerstruktur des SVN-Repositorys
anfordern aus.
- Zum Importieren eines Pfads als Ordner der höchsten Ebene in der Zielkomponente wählen Sie
Unten angegebene Pfade als Ordner der höchsten Ebene in Zielkomponente importieren aus. Zum Hinzufügen eines Pfads klicken Sie auf Pfad hinzufügen. Geben Sie im Dialogfenster
Pfad hinzufügen den Pfadnamen in das Feld ein und klicken Sie auf OK.
Zum Laden einer Gruppe von Pfaden, die in einer Datei gespeichert wurden, klicken Sie auf Laden
und navigieren zur betreffenden Datei. Zum Speichern der Datei an einer angegebenen Position klicken Sie auf
Speichern.
- Zum Importieren eines unten angegebenen Pfads als Komponentenstammverzeichnis wählen Sie
die Option Unten angegebenen Pfad als Stammelement der Komponente importieren
aus.
Zum Bearbeiten eines Pfads wählen Sie diesen aus und klicken auf Bearbeiten.
Ändern
Sie im Dialogfenster Pfad bearbeiten den Pfad im Feld
Pfad und klicken Sie auf OK.
- Klicken Sie auf Fertig stellen, um den Inhalt (Ordner und Benutzer) der
ausgewählten Subversion-Speicherauszugsdatei anzuzeigen.
- In dieser Phase des Importprozesses wählen Sie die zu importierenden Ordner aus und geben an, wenn Sie
ein Repository-Administrator sind, wie SVN-Benutzernamen Jazz-Benutzernamen zugeordnet werden. Wählen auf der Seite Zu importierende SVN-Ordner auswählen im Bereich
In SVN-Repository gefundene Ordner die Ordner aus, die Sie importieren wollen,
und führen Sie die gewünschten der folgenden Schritte aus:
- Zum Durchsuchen der Datei nach Eclipse-Projekten klicken Sie auf Projekte
hinzufügen oder verwenden die Schaltflächen Hinzufügen und
Entfernen, um eine Liste der Ordner zu erstellen, die Sie importieren wollen.
- Wenn Sie die aktuelle Liste der Ordner in einer Datei speichern wollen, die Sie für künftige Importoperationen
wiederverwenden können, klicken Sie auf Speichern.
- Wenn Sie eine Liste von Ordnern wiederverwenden wollen, die Sie bei einem früheren Import erstellt haben,
klicken Sie auf Laden.
- Zum Zuordnen von Benutzernamen klicken Sie auf Weiter.
- Geben Sie auf der Seite Benutzerzuordnung die Benutzernamenzuordnungen an, die
das Importprogramm herstellen soll, oder klicken Sie auf SVN-Benutzern nicht zu Jazz-Benutzern
zuordnen, wenn der Jazz-Benutzer, der das Importprogramm ausführt, Eigner aller importierten
Dateien und Ordner werden soll.
- Klicken Sie auf einen Namen in dieser Liste und anschließend auf Jazz-Benutzer ändern,
um eine Liste der Jazz-Benutzernamen anzuzeigen, denen der Subversion-Benutzer zugeordnet werden kann.
- Zum Erstellen eines neuen Jazz-Benutzers, dem ein Subversion-Benutzer zugeordnet werden kann, klicken
Sie auf Jazz-Benutzer erstellen.
- Wenn Sie Zuordnungen, die Sie angegeben haben, widerrufen wollen, klicken Sie auf Zurücksetzen.
- Zum Speichern der aktuellen Benutzerzuordnungen in einer Datei, die Sie für künftige Importoperationen
wiederverwenden können, klicken Sie auf Speichern.
- Zur Wiederverwendung einer Benutzerzuordnungsdatei, die Sie bei einem vorherigen Import erstellt haben,
klicken Sie auf Laden.
- Zum Starten des Imports klicken Sie auf Fertig stellen.
Nach Abschluss des Imports können Sie die neue Komponente einem Datenstrom hinzufügen oder, wenn in eine
vorhandene Komponente importiert wurde, die importierten Änderungssets übergeben, sodass sie von anderen
Teammitgliedern verwendet werden können.