ClearCase-Protokoll aus einem UCM-Datenstrom importieren

Verwenden Sie den ClearCase Importer, um Rational ClearCase-Daten mit vollständigem oder partiellem Referenzkonfigurationsprotokoll aus einem UCM-Datenstrom in die Rational Team Concert-Quellcodeverwaltung zu importieren. Nach dem Import können Sie die Dateien in der Rational Team Concert-Quellcodeverwaltung ändern; der Export in ClearCase ist jedoch nicht möglich.

Bevor Sie ClearCase-Daten mit Referenzkonfigurationsprotokoll importieren können, müssen Sie einen Synchronisationshost konfigurieren und anschließend einen Synchronisationsprozessaccount erstellen und hinzufügen. Wenn Sie nur einen Teil des Referenzkonfigurationsprotokolls anstelle des gesamten Referenzkonfigurationsprotokolls aus einem UCM-Datenstrom importieren wollen, müssen Sie darüber hinaus die ClearCase-Daten vorbereiten.

Nachdem Sie alle Voraussetzungen erfüllt oder überprüft haben, führen Sie die folgenden Tasks aus, um einen UCM-Datenstrom zu importieren und anschließend die Dateien und Ordner auszuwählen, die mit Protokoll aus dem UCM-Datenstrom importiert werden sollen.

ClearCase UCM-Datenstrom importieren

Führen Sie die folgenden Schritte aus, um einen Synchronisationsdatenstrom für den Import des UCM-Referenzkonfigurationsprotokolls zu erstellen.
  1. Klicken Sie auf Datei > Importieren.
  2. Erweitern Sie im Fenster Importieren den Ordner Jazz-Quellcodeverwaltung, wählen Sie ClearCase-Datenstrom oder -Verzweigung aus und klicken Sie auf Weiter.
  3. Auf der Seite ClearCase-Datenstrominformationen wählen Sie Mit Protokoll aus ClearCase importieren aus. Da das ClearCase-Importprogramm keine in der Rational Team Concert-Quellcodeverwaltung vorgenommenen Änderungen in ClearCase exportiert, werden Verzweigungsinformationen nicht verwendet. Daher ist das Feld für den Verzweigungstyp inaktiviert. Klicken Sie auf OK, um das Informationsfenster Mit Protokoll importieren zu schließen.
  4. Geben Sie eine Konfiguration für die dynamische Rational ClearCase-Ansicht an, die der Assistent zur Unterstützung des Importprozesses erstellt:
    1. Zum Konfigurieren der Ansicht aus einem UCM-Datenstrom wählen Sie Aus vorhandenem UCM-Datenstrom importieren aus.
    2. Geben Sie den Namen eines vorhandenen Datenstroms im Format datenstromname@pvob-tag ein. Beispiel: Zur Angabe eines Datenstroms mit dem Namen my_stream in einer Projekt-VOB mit dem Tag \projects geben Sie den Wert my_stream@\projects ein. Verwenden Sie den Befehl 'cleartool lsstream' oder den Rational ClearCase-Projektexplorer, um nach Datenstromnamen zu suchen.
    Anmerkung: Sie können ein ClearCase-Protokoll nicht aus einem schreibgeschützten Datenstrom importieren. Sie können das Protokoll aus dem zugehörigen übergeordneten Datenstrom importieren, wenn der übergeordnete Datenstrom nicht schreibgeschützt ist. Alternativ können Sie einen neuen, beschreibbaren untergeordneten Datenstrom erstellen, der mit dem schreibgeschützten untergeordneten Datenstrom identisch ist, und anschließend das Protokoll aus dem neuen Datenstrom importieren.
    Der Assistent überprüft die Syntax des Datenstromnamens (jedoch nicht das Vorhandensein) und aktiviert anschließend die Schaltfläche Weiter.
  5. Klicken Sie auf Weiter.
  6. Geben Sie auf der Seite ClearCase-Speicherinformationen den Netzpfad zu einem Verzeichnis an, in dem der Assistent einen Ansichtspeicher für eine dynamische Rational ClearCase-Ansicht erstellen kann, um den Import aus Rational ClearCase in Jazz zu ermöglichen. Der Importer setzt diesen Eintrag vorab auf einen Netzpfad, der aus dem Namen des lokalen Hosts und der Zeichenfolge \VIEWSTORAGE besteht. Wenn dieses Verzeichnis auf dem lokalen Host vorhanden und eine gültige Speicherposition für Ansichten ist (es muss unter Windows® freigegeben bzw. auf UNIX®- oder Linux®-Systemen exportiert sein), können Sie es verwenden. Ansonsten geben Sie den Netzpfad zu einem anderen lokalen oder fernen Verzeichnis an, in dem der Ansichtspeicher erstellt werden kann. Der Assistent erstellt eine dynamische Ansicht mit Speicher in diesem Verzeichnis und einem distinktiven Tag (das Präfix DO_NOT_USE und ein UUID-Suffix). Diese Ansicht sollte von Rational ClearCase-Benutzern als nicht nutzbar betrachtet werden.

    Falls anwendbar, markieren Sie Zusätzliche Optionssetinformationen für die Erstellung von ClearCase-Ansichten eingeben und geben die korrekten Werte für 'Host', 'Hostpfad' und 'Globaler Pfad' ein: den Hostnamen, den lokalen Pfad des Hosts und den globalen Speicherpfad der Speicherposition auf dem ClearCase-Server.

  7. Klicken Sie auf Weiter. Der Assistent prüft den Ansichtspeicherpfad und, falls angegeben, den globalen Speicherpfad.
  8. Auf der Seite Projekt- oder Teambereich auswählen erweitern Sie den Repository-Eintrag und wählen den Projekt- oder Teambereich aus, dem Sie den Synchronisationsprozessaccount hinzugefügt haben (siehe Synchronisationsprozessaccount dem Teambereich hinzufügen). Falls das Repository keine Einträge enthält, überprüfen Sie, ob eine Verbindung zu dem Projektbereich besteht, und wiederholen Sie den Versuch. Klicken Sie auf Weiter.
  9. Die Seite Informationen zu Jazz-Quellcodeverwaltung zeigt den Namen eines Mischarbeitsbereichs an, der vom Assistenten erstellt wird. Sie können einen anderen Namen auswählen, wenn Sie dies wünschen. Wenn das Repository einen Arbeitsbereich mit dem Namen enthält, den Sie auswählen, erweitert der Assistent diesen durch eine Zeichenfolge, um den Namen eindeutig zu machen. (Ein Mischarbeitsbereich ist ein Repository-Arbeitsbereich, in dem Sie Konflikte auflösen, die auftreten, wenn eine Datei oder ein Ordner parallel in Rational ClearCase und in der Rational Team Concert-Quellcodeverwaltung geändert wird.)
  10. Eine standardmäßige Synchronisationsbenutzer-ID wird in diesem Feld angezeigt. (Die Standard-ID ist ccsync.) Wenn Sie eine andere Synchronisationsbenutzer-ID als den Standardwert verwenden, ersetzen Sie die ID durch den korrekten Wert. Geben Sie das Kennwort für die Synchronisationsbenutzer-ID ein. Weitere Informationen finden Sie unter Synchronisationsprozessaccount erstellen.
  11. Geben Sie den Namen des Pfads, in dem der ClearCase-Connector auf diesem Host installiert ist, in das Feld Connectorinstallationsposition ein oder klicken Sie auf Durchsuchen, um nach dem Pfadnamen zu suchen. Der ClearCase-Connector ist normalerweise im Rational Team Concert-Installationsverzeichnis installiert.
  12. Wählen Sie Nach Abschluss des Assistenten Jazz-Synchronisationsengineprozess starten aus und wählen Sie Assistenten 'Dateien auswählen' nach Beendigung dieses Assistenten starten aus.
  13. Klicken Sie auf Fertig stellen. Der ClearCase Importer erstellt einen synchronisierten Datenstrom in Rational Team Concert, startet im Hintergrund den Prozess für die Synchronisationsengine und öffnet anschließend den Assistenten Dateien auswählen.

Dateien und Ordner mit Protokoll importieren

Im Assistenten Dateien auswählen wählen Sie ClearCase-Dateien und -Ordner als synchronisierte Stammverzeichnisse aus und wählen aus, ob alle oder nur einige Referenzkonfigurationen für die Komponente importiert werden sollen, zu der die Ordner gehören.
  1. Auf der Seite Zu importierende Dateien auswählen führen Sie eine der folgenden Aktionen aus, um Dateien und Ordner in einer UCM-Komponente auszuwählen, deren Referenzkonfigurationen Sie importieren wollen.
    Einschränkung: Wählen Sie nur Ordner oder Dateien aus, die in allen Referenzkonfigurationen angezeigt werden, die Sie importieren. Bei den aufeinander folgenden Importoperationen für die Referenzkonfigurationen werden jeweils alle synchronisierten Stammverzeichnisse entfernt, die nicht in dieser Referenzkonfiguration angezeigt werden. Wenn ein Ordner einmal als synchronisiertes Stammverzeichnis entfernt wurde, werden keine weiteren Referenzkonfigurationsinformationen für diesen Ordner importiert, selbst wenn er in nachfolgenden Referenzkonfigurationen vorhanden ist.
    • Wenn Sie bereits Dateien und Ordner mit Protokoll importiert haben, wählen Sie Gegenwärtig importierte Objekte in der Tabelle anzeigen aus, um die synchronisierten Stammverzeichnisse im Feld Tabelle importieren anzuzeigen.
    • Wenn Sie Dateien und Ordner durch Durchsuchen der angehängten VOBs auswählen möchten, klicken Sie auf Durchsuchen, um eine Liste der VOBs anzuzeigen, die vom Synchronisationshost angehängt wurden. (Zur Beschleunigung des Durchsuchens können Sie alle VOBs abhängen, auf die Sie nicht zugreifen wollen.) Wenn im Fenster keine VOBs sichtbar sind, prüfen Sie, ob die VOBs, aus denen Sie importieren wollen, auf dem Synchronisationshost angehängt sind. Wenn Sie die gewünschten Dateien und Ordner ausgewählt haben, klicken Sie auf 'OK', um den Browser zu schließen und die ausgewählten Pfade in der Liste Tabelle importieren anzuzeigen.
    • Zur manuellen Auswahl von Dateien und Ordnern geben Sie einen Pfadnamen ein, der in dem Rational ClearCase-Datenstrom sichtbar ist, den Sie im Assistenten Importieren angegeben haben, und klicken anschließend auf Hinzufügen. Der Pfadname muss ein relativer Pfad zum Stammverzeichnis der Ansicht sein. Wenn Sie einen UCM-Datenstrom verwenden, muss der Pfadname am Stammverzeichnis einer UCM-Komponente enden. Alle Pfadnamen, die Sie für den Import angeben, müssen mit einem VOB-Tag (ohne führende Zeichen / oder \) beginnen und den vollständigen Pfad vom VOB-Stammverzeichnis zum Stammordner des Projekts enthalten. Zum Beispiel:

      sources\eclipse_projects\my_project

      Durch diese Angabe wird ein Ordner mit dem Namen my_project ausgewählt, der im Ordner eclipse_projects der VOB gespeichert ist, deren VOB-Tag den Wert \sources hat.
  2. Im Bereich Zu importierende Referenzkonfigurationen auswählen wählen Sie das Referenzkonfigurationsprotokoll aus, das Sie für jede Komponente importieren wollen, zu der die synchronisierten Stammverzeichnisse gehören:
    • Wählen Sie Alle Referenzkonfigurationen importieren aus, um das Protokoll aus allen Referenzkonfigurationen in dem Rational ClearCase-Datenstrom zu importieren.
    • Wählen Sie Alle Referenzkonfigurationen mit folgendem Attributtyp importieren aus, wenn Sie eine Untergruppe der Referenzkonfigurationen importieren wollen, denen ein bestimmter Attributtyp zugeordnet ist. Sie können Rational ClearCase verwenden, um den Attributtyp bestimmten Referenzkonfigurationen zuzuordnen. (Details können Sie dem obigen Abschnitt zu Vorbereitungen entnehmen.)
  3. Klicken Sie auf Fertig stellen, um den Assistenten Dateien auswählen zu schließen und den Import der angegebenen ClearCase-Dateien und -Ordner mit Referenzkonfigurationsprotokoll zu starten. Je nach Größe der Komponente, Anzahl der Referenzkonfigurationen der Komponente in dem Datenstrom und Volumen der in den Referenzkonfigurationen verfügbaren Protokolldaten kann der Import einige Minuten oder auch Stunden oder Tage dauern.
Nach dem ursprünglichen Import können Sie spätere Einträge des Referenzkonfigurationsprotokolls für die angegebenen Dateien und Ordner importieren, indem Sie eine Synchronisation für den synchronisierten Datenstrom ausführen. Wenn Sie nach dem ursprünglichen Import weitere Dateien und/oder Ordner als synchronisierte Stammverzeichnisse auswählen, werden diese nicht mit dem Protokoll aus der ursprünglichen Referenzkonfiguration importiert. Sie werden nur mit dem Protokoll aus Referenzkonfigurationen importiert, die nach dem letzten Import erstellt wurden.
Tipp: Wenn Sie weitere Dateien und Ordner mit demselben Protokoll wie die ursprünglich importierten Dateien und Ordner importieren wollen, müssen Sie einen neuen synchronisierten Datenstrom erstellen und dabei ein synchronisiertes Stammverzeichnis auswählen, das alle Dateien und Ordner enthält, die Sie mit Protokoll importieren wollen.

Feedback

War dies eine Hilfe? Sie können Ihr Feedback bei Jazz.net (Registrierung erforderlich) geben: Geben Sie Ihre Kommentare in den Foren oder senden Sie einen Bug.