In diesem Abschnitt sind die Schritte für das Upgrade eines früheren Releases des
ClearQuest Synchronizer auf das aktuelle Release beschrieben.
Vorgehensweise
- 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.
- 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.
- Stoppen Sie das ClearQuest Gateway.
- Stoppen Sie Jazz Team Server.
- 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.
- 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.
- 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.
- Navigieren Sie zum Verzeichnis Installationsverzeichnis/ClearQuest
Synchronizer/gateway und starten Sie ClearQuest Gateway.
- Stoppen Sie das ClearQuest Gateway. Durch das Starten und Stoppen des ClearQuest Gateway
wird das Verzeichnis Installationsverzeichnis/ClearQuest Synchronizer/gateway/tomcat/webapps/cqconnector
erstellt.
- 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.
- 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.
- Starten Sie ClearQuest Gateway.
- Ü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.
- Aktivieren Sie die abgehende Synchronisation für die externe Repository-Verbindung.
- Aktivieren Sie die abgehende Synchronisation für den Server.
- 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.
- 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