Upgrade von ClearQuest Synchronizer durchführen

In diesem Abschnitt sind die Schritte für das Upgrade eines früheren Releases des ClearQuest Synchronizer auf das aktuelle Release beschrieben.

Vorgehensweise

  1. Inaktivieren Sie die abgehende Synchronisation für die externe Repository-Verbindung. Rufen Sie im Client für Eclipse IDE von Rational Team Concert die Ansicht 'Synchronisationsregeln' auf. Erweitern Sie die Anzeige für den Knoten 'Externe Repository-Verbindungen'. Klicken Sie doppelt auf die externe Repository-Verbindung, um sie zu öffnen. Wählen Sie Automatische abgehende Synchronisation inaktivieren aus. Klicken Sie auf OK.
  2. Inaktivieren Sie die abgehende Synchronisation für den Jazz Team Server. Klicken Sie auf der Seite 'Administration' des Webclients auf Erweiterte Eigenschaften. Blättern Sie zur Komponente Interoperation zwischen Elementen. Klicken Sie für com.ibm.team.interop.service.internal.InteropService auf Bearbeiten. Wählen Sie für Abgehende Synchronisation aktiviert die Option falsch in der Drop-down-Liste aus. Klicken Sie auf Speichern.
  3. Stoppen Sie das ClearQuest Gateway.
  4. Stoppen Sie Jazz Team Server.
  5. Führen Sie das Serverupgrade durch. Lesen Sie hierzu den Artikel Upgrade für Version 2 (Prozess mit zwei Schritten) oder Upgrade auf Version 4.0 durchführen.
  6. Starten Sie den Server und prüfen Sie Folgendes:
    • Sie können sich mit dem vom ClearQuest Connector verwendeten Jazz-Benutzeraccount anmelden und eine Verbindung zum Projektbereich herstellen.
    • Die externe Repository-Verbindung ist vorhanden. Schauen Sie sich dazu die Ansicht 'Synchronisationsregeln' an.
    • Die Synchronisationsregeln sind vorhanden. Schauen Sie sich dazu die Ansicht 'Synchronisationsregeln' an.
    • Die Arbeitselemente, die Sie zuvor erstellt und mit ClearQuest-Datensätzen synchronisiert haben, sind vorhanden.
    • In Jazz Team Server ist die abgehende Synchronisation noch immer inaktiviert.
  7. Installieren Sie die neue Version von ClearQuest Synchronizer. Informationen hierzu finden Sie im Abschnitt Rational Team Concert ClearQuest Synchronizer mit IBM Installation Manager installieren.
    Anmerkung: Bei einem Upgrade von Version 3.X können Sie die Aktualisierungsoption in Installation Manager nutzen. Bei einem Upgrade von Version 2.X müssen Sie die Option Installieren auswählen und dann die Version 2.X deinstallieren (siehe Schritt 17). Ab Version 3.0 heißt das Standardinstallationsverzeichnis ClearQuest Synchronizer anstelle von ClearQuest Connector.
  8. Navigieren Sie zum Verzeichnis Installationsverzeichnis/ClearQuest Synchronizer/gateway und starten Sie ClearQuest Gateway.
  9. Stoppen Sie das ClearQuest Gateway. Durch das Starten und Stoppen des ClearQuest Gateway wird das Verzeichnis Installationsverzeichnis/ClearQuest Synchronizer/gateway/tomcat/webapps/cqconnector erstellt.
  10. Wenn Sie ein Upgrade von Version 2.X durchführen, kopieren Sie alle vom Benutzer konfigurierbaren Dateien, die Sie modifiziert haben, aus dem Installationsverzeichnis von ClearQuest Connector 2.0.0.2x in das Installationsverzeichnis von ClearQuest Synchronizer. Namentlich sind folgende Dateien zu kopieren:
    • cqconnector.properties von Installationsverzeichnis/ClearQuestConnector/gateway in Installationsverzeichnis/ClearQuestSynchronizer/gateway
    • log4j.properties von Installationsverzeichnis/ClearQuestConnector/gateway in Installationsverzeichnis/ClearQuestSynchronizer/gateway
    • tomcat-users.xml von Installationsverzeichnis/ClearQuestConnector/gateway/tomcat/conf in Installationsverzeichnis/ClearQuestSynchronizer/gateway/tomcat/conf
    • web.xml von Installationsverzeichnis/ClearQuestConnector/gateway/tomcat/webapps/cqconnector/WEB-INF in Installationsverzeichnis/ClearQuestSynchronizer/gateway/tomcat/webapps/cqconnector/WEB-INF
    Bei einem Upgrade von Version 3.X und ausgewählter Aktualisierungsoption in Installation Manager, werden Ihre geänderten Konfigurationsdateien in einem eigenen Verzeichnis gesichert. Kopieren Sie die geänderten Konfigurationsdateien aus dem Sicherungsverzeichnis in das neue Installationsverzeichnis.
    Anmerkung:

    Die Datei server.xml wird in älteren Releases verwendet und ist nicht mit Release 4.0 kompatibel. Sie können sie daher nicht aus dem Verzeichnis Installationsverzeichnis/ClearQuestConnector/gateway/tomcat/conf oder aus dem Sicherungsverzeichnis in das Verzeichnis Installationsverzeichnis/ClearQuestSynchronizer/gateway/tomcat/conf kopieren. Bearbeiten Sie stattdessen die Datei server.xml von Version 4.0 im neuen Installationsverzeichnis (Installationsverzeichnis/ClearQuestSynchronizer/gateway/tomcat/conf) so, dass sie alle an der früheren Version vorgenommenen Änderungen enthält.

  11. Optional. Wenden Sie die neueste Version des JazzInterop-Pakets auf Ihr ClearQuest-Schema an. Führen Sie dann mit der neuen Schemaversion das Upgrade für die ClearQuest-Benutzerdatenbank durch. Einzelheiten hierzu enthält der Abschnitt Upgrade für die Benutzerdatenbank mit neuer Version des JazzInterop-Pakets durchführen.
  12. Starten Sie ClearQuest Gateway.
  13. Überprüfen Sie den Status des Gateways. Rufen Sie dazu die Statusseite unter http://Hostname.example.com:8081/cqconnector/gateway auf. Auf der Seite sollte angegeben sein, dass das Gateway alle Anforderungen akzeptiert.
  14. Aktivieren Sie die abgehende Synchronisation für die externe Repository-Verbindung.
  15. Aktivieren Sie die abgehende Synchronisation für den Server.
  16. Prüfen Sie mit folgenden Schritten, ob die Synchronisation funktioniert:
    • Erstellen Sie in der ClearQuest-Benutzerdatenbank einige Datensätze. Überprüfen Sie, ob im Projektbereich von Rational Team Concert entsprechende Arbeitselemente erstellt wurden.
    • Erstellen Sie im Projektbereich einige Arbeitselemente. Prüfen Sie, ob in der ClearQuest-Benutzerdatenbank die entsprechenden Datensätze erstellt werden.
    • Bearbeiten Sie einige Arbeitselemente, die im früheren Release synchronisiert wurden. Überprüfen Sie, ob die Änderungen in den entsprechenden ClearQuest-Datensätzen repliziert werden.
    • Bearbeiten Sie einige ClearQuest-Datensätze, die im früheren Release synchronisiert wurden. Überprüfen Sie, ob die Änderungen in den entsprechenden Arbeitselementen repliziert werden.
  17. Bei einem Upgrade von Version 2.X, oder wenn Sie die Aktualisierungsoption im Installation Manager nicht ausgewählt haben, müssen Sie das frühere Release von ClearQuest Connector deinstallieren. Während der Deinstallation müsste im Verzeichnis Installationsverzeichnis/ClearQuestConnector ein Verzeichnis mit dem Namen backup-config-Zeitmarke erstellt werden. Prüfen Sie, ob dieses Verzeichnis die folgenden Verzeichnisse und Dateien enthält:
    • gateway/cqconnector.properties
    • gateway/log4j.properties
    • gateway/tomcat/conf (Verzeichnis mit mehreren Dateien und einem Unterverzeichnis Catalina)
    • gateway/tomcat/webapps/cqconnector/WEB-INF/web.xml

Feedback