Vorbereitende Schritte
Stellen Sie vor dem Upgrade
mit dem Network Time Protocol (NTP) sicher, dass die Systemzeit auf allen Maschinen
synchron ist.
Zeit ist ein kritisches Element, mit dem ein Ereignis auf einem Netzknoten einem entsprechenden Ereignis
auf einem anderen Knoten zugeordnet werden kann. Durch eine Unternehmensimplementierung des NTP-Service können Sie Probleme durch die Systemzeit
vermeiden. Weitere Informationen zu
NTP finden Sie unter http://www.ntp.org/. Alle Server müssen außerdem
dieselbe Methode der Benutzerauthentifizierung verwenden.
Falls Sie für mehrere Produkte ein Upgrade durchführen wollen,
lesen Sie den Artikel Upgradereihenfolge. Die dort enthaltenen Informationen helfen Ihnen bei der Entscheidung,
welches Produktupgrade zuerst durchgeführt werden muss.
Wichtig: Wenn Sie das Upgrade-Script in einer verteilten Umgebung verwenden möchten,
in der Sie
Quality Management unabhängig vom Jazz Team Server installieren,
muss das Upgrade-Script auf das Laufwerk oder Dateisystem mit
dem installierten Jazz Team Server zugreifen
können. Unter Windows muss die Zuordnung beispielsweise das Format Buchstabe des zugeordneten
Laufwerks:\server\conf haben. Ein absoluter Pfad (\\Maschinenname\Installationsverzeichnis\server\conf)
funktioniert nicht. Das angehängte Laufwerk muss mit Lese-, Schreib- und Ausführungsrechten für den Administratoraccount konfiguriert sein.
In einer Umgebung mit WebSphere Application Server sollten Sie einen Installationspfad ohne
Leerzeichen verwenden, z. B.
C:\IBM\JazzTeamServer.
Wenn ein Parameter für einen Dateinamen oder einen Dateipfad ein Leerzeichen enthält, müssen Sie ihn
in Anführungszeichen setzen.
Wenn Sie ein Upgrade für
Version 2.0.1 mit iFix02 oder eine aktuellere Version auf Version
2.0.1.1 oder eine neuere Version durchführen wollen, tun Sie dies vor dem Export Ihrer Daten. Führen Sie dann den folgenden
repotools-Befehl aus, um mögliche Fehler beim Export-/Importprozess zu vermeiden.
Windows: repotools
-repairRequests
UNIX/Linux: ./repotools.sh
-clean -repairRequests
Benutzer der Vorversionen von Version 2.0.1
mit iFix02 können diesen Schritt ignorieren.
- Informieren Sie sich bei Bedarf anhand der Artikel im Abschnitt Implementierung und Upgrade planen.
- Überprüfen Sie in der vorhandenen Datei teamserver.properties von Version 2 die Eigenschaft mit dem öffentlichen
URL (com.ibm.team.repository.server.webapp.url) und die Angaben für die Verbindung
zu Ihrem Datenbankserver (normalerweise com.ibm.team.repository.db.vendor, com.ibm.team.repository.db.jdbc.location
und com.ibm.team.repository.db.jdbc.password).
In Version 3.0.1 müssen Sie denselben öffentlichen URL verwenden. Wenn kein öffentlicher URL definiert ist, rufen Sie die Webschnittstelle für Administration von Version 2
auf und legen Sie (unter Erweiterte Eigenschaften)
den URL mit qualifiziertem Hostnamen (https://hostname.example.com:port) fest, bevor Sie das Upgrade durchführen.
Die Zeile mit dem öffentlichen URL in der Datei teamserver.properties
müsste etwa wie folgt aussehen:
com.ibm.team.repository.server.webapp.url=https\://<hostname.example.com>\:9443/jazz
- Laden Sie die Software Rational Quality Manager von der entsprechenden Projektseite auf
jazz.net herunter. Anweisungen finden Sie im Abschnitt
Produktinstallationsmedien herunterladen.
- Stoppen Sie den Server der Version 2.
Anmerkung: Wenn Sie in einer verteilten Umgebung arbeiten und
Jazz Team Server 3.0.1 bereits installiert haben, können Sie die Ausfallzeit von
Jazz Team Server auf ein Minimum reduzieren, indem Sie den
Server online lassen, bis das Upgrade-Script den Import der Daten von Version 2 in die Datenbank von Quality Management Version 3 abgeschlossen hat. Dann müssen Sie
Jazz Team Server stoppen.
Sie können den Server neu Starten, nachdem das Script die Benutzer- und Lizenzdaten in
Jazz Team Server importiert hat.
- Sichern Sie Ihre Datenbank und die Datei teamserver.properties an einer temporären Position. In Version 2 befindet sich die Datei teamserver.properties standardmäßig
unter Installationsverzeichnis\server\conf\jazz\teamserver.properties. Anweisungen für das Erstellen einer Sicherung enthalten die folgenden Artikel:
- Exportieren Sie die Daten aus Ihrem Repository der Version 2.
- Rufen Sie das Verzeichnis RQM-2-Installationsverzeichnis\server von Version 2 auf.
- Führen Sie den Befehl repotools -export aus und speichern Sie die Datei außerhalb der Verzeichnisstruktur von
Rational Quality Manager.
Sehen Sie sich dazu das folgende Beispiel für Version 2.0.1 an:
Windows: repotools -export toFile=c:\tmp\export.tar
UNIX/Linux: ./repotools.sh
-export toFile=/tmp/export.tar
Hier steht toFile für den Namen der
TAR-Datei, in die das Repository exportiert wird.
- Falls Sie Jazz Team Server noch nicht installiert haben, laden Sie jetzt den Server,
die Anwendung Quality Management und Required Base License Keys herunter und installieren Sie sie an einer neuen Position auf Festplatte. Sollten Sie den Server bereits installiert haben, installieren Sie jetzt die Anwendung
Quality Management. Anweisungen finden Sie im Abschnitt
Installation mit IBM Installation Manager.
Wichtig: In der Anwendung Quality Management werden keine Anforderungen, Defects und anderen Arbeitselemente mehr erstellt, wie es in Version 2 der Fall war.
Testteams, die diese Funktionen nutzen möchten, müssen
Requirements Management und Change
and Configuration Management ebenfalls installieren. In einer dezentralen Umgebung können diese Anwendungen separat installiert werden.
Wählen Sie während der Installation Kontextstammverzeichnis von Rational Quality Manager 2.x verwenden aus.
Die Anwendung
QM wird dann mit dem Kontextstammverzeichnis /jazz und nicht mit /qm installiert. Diese Option ist erforderlich, damit die Links
zu QM-Artefakten erhalten bleiben.
Wählen Sie diese Option nicht aus, schlägt Ihr Upgrade fehl. Einzelheiten finden Sie im Artikel Basisinformationen zum Implementierungs- und Upgradeprozess.
- Wählen Sie am Ende der Installation bei Anzeige der Frage Welches Programm möchten Sie starten? die Option Kein aus.
- Wenn Sie die Implementierung in WebSphere Application Server durchführen, stoppen Sie die Anwendungen
jazz.war und help.war von Version 2 und deinstallieren Sie sie.
- Wenn Sie nicht die Derby-Standarddatenbank verwenden, erstellen Sie die Datenbank für Version 3.
Datenbanken werden für Jazz Team Server, Quality Management, Change and Configuration
Management und das Data Warehouse benötigt. Sie müssen für Requirements Management
keine Datenbank erstellen, weil diese Anwendung die Datenbank von Jazz Team Server als Datenspeicher nutzt. Die Artikel in Konfiguration der Datenbank enthalten Details zu den einzelnen
Datenbanken.
- Öffnen Sie in Ihrer Installation der Version 3 ein neues Befehlsfenster, navigieren Sie zum Verzeichnis Jazz-Installationsverzeichnis\server und führen Sie das
Script upgrade\qm_upgrade.bat (unter Windows) oder das Script upgrade/qm_upgrade.sh (auf
UNIX-Systemen) aus.
Anmerkung: Sie können für die Script-Ausführung alle Argumente in der Befehlszeile
angeben. Wenn Sie das Script mehrere Male ausführen müssen, können Sie alternativ die Datei mit den Script-Parametern bearbeiten und
dann eine entsprechend kürzere Befehlszeile eingeben. Anweisungen für die Parameterdatei enthält der Artikel
12.
Wichtig: Die Script-Datei befindet sich im Verzeichnis upgrade, muss jedoch im Verzeichnis server ausgeführt werden. Falls Ihr Pfad Leerzeichen enthält, müssen Sie ihn in Anführungszeichen setzen.
Wenn Sie
Jazz Team Server Version 3.0.1 zusammen mit der Anwendung QM
installiert haben und dies die erste oder einzige Anwendung ist, für die Sie ein Upgrade durchführen möchten,
gilt die folgende Befehlssyntax:
Windows:
upgrade\qm_upgrade.bat -oldApplicationHome RQM-201-Installationsverzeichnis\server\conf -importFromFile c:\tmp\export.tar -createJTSTables
UNIX/Linux:
./upgrade/qm_upgrade.sh -oldApplicationHome RQM-201-Installationsverzeichnis/server/conf -importFromFile /tmp/export.tar -createJTSTables
Anmerkung: Der Parameter -createJTSTables ist nur anwendbar, wenn Sie
Jazz Team Server 3.0.1
zum ersten Mal installieren.
Wenn Sie
Jazz Team Server Version 3.0.1 unabhängig von der Anwendung
QM installiert haben (wie es bei einer dezentralen Implementierung der Fall sein kann), müssen Sie die Position von Jazz Team Server 3.0.1
angeben und das Script im Installationsverzeichnis von
QM 3.0.1 ausführen. Nehmen Sie in dem Fall das Argument
-newJTSHome auf.
Windows:
upgrade\qm_upgrade.bat -oldApplicationHome RQM-201-Installationsverzeichnis\server\conf -importFromFile c:\tmp\export.tar -newJTSHome JTS-301-Installationsverzeichnis\server\conf
UNIX/Linux:
./upgrade/qm_upgrade.sh -oldApplicationHome RQM-201-Installationsverzeichnis/server/conf -importFromFile /tmp/export.tar -newJTSHome JTS-301-Installationsverzeichnis\server\conf
Anmerkung: - Wenn Sie eine verteilte Implementierung durchführen und Jazz Team Server Version
3.0.1 noch nicht konfiguriert haben, können Sie im obigen Beispiel den Parameter -createJTSTables zur Befehlszeile
hinzufügen.
- Der Parameter -jtsURL gibt den öffentlichen URI von
Jazz Team Server an.
Standardmäßig wird der öffentliche URI von Jazz Team Server aus
dem öffentlichen URI der Anwendung abgeleitet. Bei einer verteilten Implementierung, in der Jazz Team Server
in einer anderen Serverinstanz als die Anwendung QM ausgeführt wird, muss dieser Parameter angegeben sein.
- Wenn Jazz Team Server 3.0.1
noch aktiv ist, müssen Sie den Server stoppen, bevor das Script mit der Migration von Benutzer- und Lizenzinformationen
beginnt. Jazz Team Server und alle von ihm abhängigen
Anwendungen sind dann offline.
Falls Sie weitere Informationen zu den Befehlszeilenoptionen benötigen, geben Sie den folgenden Befehl ein:
Windows: upgrade\qm_upgrade.bat -help
UNIX/Linux: ./upgrade/qm_upgrade.sh
-help
Das Script führt die folgenden
Schritte aus:
- Es aktualisiert wie folgt die Konfigurationsdateien von Version 3:
- Es führt den Befehl -migration_qm_updateConfigurationFiles aus und aktualisiert die Konfigurationsdateien und die
Tomcat-Dateien. Geben Sie [E] für die Ausführung des Befehls oder [S] zum Überspringen des Schritts ein oder brechen Sie die Script-Ausführung mit [Eingabetaste] ab.
Anmerkung: Falls Sie
Jazz Team Server Version
3.0.1 noch nicht installiert haben, müssen Sie jetzt die Eigenschaft für die Datenbankposition der neuen Datenbank von
Jazz Team Server angeben, die Sie vorher in
Schritt
10 erstellt haben.
Wenn Sie Ihre Datenbank von
Quality Manager Version 2 weiterverwenden, prüfen Sie, ob eine Sicherung der Datenbank für den Fall, dass Sie den Server von Quality Manager Version 2 erneut starten müssen, vorhanden ist.
Wichtig: Ändern Sie
nicht die Eigenschaften für die Verbindung zur Data-Warehouse-Datenbank, auch dann nicht, wenn diese zurzeit auf Derby gesetzt sind. Modifizieren Sie diese Eigenschaften nur mit dem
Konfigurationsassistenten für den Server.
- Geben Sie nach erfolgreicher Zusammenführung der Konfigurationsdateien zum Fortfahren [C] ein. Ein Editorfenster (oder auf AIX- bzw. Linux-Systemen ein Editor vi) wird geöffnet, in dem Sie
die Datei teamserver.properties
von Jazz Team Server prüfen können. Prüfen Sie, ob das von der Eigenschaft com.ibm.team.repository.server.webapp.url angegebene Stammelement des öffentlichen URI stimmt. Prüfen Sie außerdem, ob die Datenbankeigenschaften korrekt sind.
Speichern Sie ggf. vorgenommene Änderungen. Schließen Sie dann den Editor und fahren Sie mit der Script-Ausführung fort.
- Es kopiert die Tomcat-Benutzerdatei (XML-Datei).
- Es führt die Datei friendsconfig.rdf von Version 2 mit den für die Repository-übergreifende Integration konfigurierten Servern
mit der Datei von Version 3 zusammen.
- Es mischt den Inhalt der Dateien server.xml und web.xml (LDAP-Einstellungen) mit dem der Dateien aus Version 3.
- Es importiert die exportierten Daten aus der TAR-Datei von Version 2 mit dem Befehl
repotools-jazz
-import in die QM-Datenbank (Quality Management) von Version 3.
Anmerkung: Wenn Sie umfangreiche Repositorys für
Quality Management 3.0.1 importieren, können Fehler des Typs OutOfMemoryException
auftreten. Kunden mit einer großen Anzahl von Projekten und Artefakten sollten im Script
repotools-jazz.bat oder repotools-jazz.sh den Wert des Parameters -Xmx
auf einen höheren Wert als den Standardwert (1500M) setzen. Wenn der Arbeitsspeicher der Maschine ausreicht und ein 64-Bit-Betriebssystem
verwendet wird, wird der Wert 4096M empfohlen.
- Es exportiert die Benutzer- und Lizenzierungsdaten aus der Quality-Management-Datenbank
(QM).
- Es importiert die QM-Benutzerdaten und -Lizenzierungsdaten in Jazz Team Server.
- Es importiert die Benutzerzuordnungsdaten in die QM-Datenbank.
Die Zuordnung benötigt die Anwendung
QM für die Kommunikation mit der Datenbank von Jazz Team Server.
Anmerkung: Eine ausführliche Liste der Änderungen, die an den Konfigurationsdateien von
Rational Quality Manager
vorgenommen werden, enthält der Artikel
Änderungen in Rational Quality Manager.
- Optional: Alternativ zum vorherigen Schritt können Sie die Parameterdatei des Scripts öffnen, die Standardwerte
modifizieren und für die Ausführung dann eine verkürzte Befehlszeile verwenden.
Die englische Version und übersetzte Versionen der Parameterdatei sind im Verzeichnis
Jazz-Installationsverzeichnis\server\upgrade\params\qm_params.bat
(Windows) oder ./params/qm_params.sh (UNIX) enthalten.
- Wenn Sie den genauen Namen der in Ihre Sprache übersetzten Parameterdatei abrufen möchten, führen Sie im Verzeichnis
Jazz-Installationsverzeichnis\server\upgrade den Befehl
locale.bat -qm -showParamFileName (unter Windows)
oder ./locale.sh -qm -showParamFileName (auf UNIX-Systemen) aus.
- Öffnen Sie qm_params oder eine landessprachliche Version zur Bearbeitung und geben Sie Werte für alle Parameter an. Einer der zu setzenden Parameter ist der Verzeichnispfad für
OLD_APPLICATION_HOME. Falls Ihr Pfad Leerzeichen enthält, müssen Sie ihn in Anführungszeichen setzen. Informationen zu den einzelnen Parametern finden Sie in der Datei Jazz-Installationsverzeichnis\server\upgrade\doc\qm_help.txt.
- Prüfen Sie Ihre Konfigurationsdateien. Ausführliche Informationen hierzu enthalten die Artikel Konfigurationsdateien während des Upgrades
überprüfen und -migration_qm_updateConfigurationFiles.
- Falls Sie für das vorherige Release ein Sicherheitszertifikat erstellt haben, kopieren Sie das Zertifikat aus dem Release oder erstellen Sie ein neues
Zertifikat. Details hierzu finden Sie unter Sicherheitszertifikate konfigurieren.
- Falls Sie Tomcat Application Server als Windows-Dienst ausführen, müssen Sie den Dienst entfernen und neu installieren. Die Befehlssyntax ist im Abschnitt
Ausführung in Apache Tomcat als Windows-Dienst (32 Bit) beschrieben.
- Wenn Sie die Implementierung in WebSphere Application Server durchführen,
müssen Sie die WAR-Dateien von Version 3.0 implementieren und dem Benutzer oder der Gruppe Sicherheitsrollen zuweisen.
Einzelheiten hierzu finden
Sie in den Artikeln WebSphere Application Server für das Upgrade auf Version 3 konfigurieren und CLM-Anwendungen in WebSphere Application Server implementieren.
- Starten Sie Ihren Anwendungsserver, d. h. Jazz Team Server Version 3
oder WebSphere Application Server.
Anmerkung: Falls die Anwendung QM separat installiert ist, müssen Sie die CLM-Anwendung
auch starten.
- Konfigurieren Sie den Server und alle installierten CLM-Anwendungen.
Führen Sie den Konfigurationsassistenten für den Server aus, wenn Sie das Upgrade für Jazz Team Server zusammen mit
Quality Management
oder anderen CLM-Anwendungen durchführen (siehe Konfigurationsassistenten ausführen). Wenn Sie
Quality Management zu einem etablierten
Jazz Team Server hinzufügen, verwenden Sie die Webschnittstelle für Administration (siehe Anwendungen bei Jazz Team Server registrieren).
- Verlagern Sie Ihre Anforderungen aus Version 2 in die Anwendung Requirements
Management (RM). Ausführliche Informationen hierzu enthält der Artikel Auf Arbeitselementen basierende Anforderungen migrieren.
Anmerkung: Dieser Schritt ist erforderlich, wenn Sie Anforderungen in Version 2 intern in
Rational Quality Manager verwaltet haben.
Sie müssen diesen Schritt nicht ausführen, wenn Sie einen externen Anforderungsprovider verwendet haben.
- Öffnen Sie Ihren Browser, löschen Sie den Browsercache und stellen Sie eine neue Verbindung zu Ihrem Projekt her.
- Aktualisieren Sie Ihre Lizenzen. Eine kurze Übersicht hierzu finden Sie im Artikel Erläuterungen zur Lizenzierung.
Führen Sie dann
die Schritte im Artikel Lizenzschlüssel
installieren und verwalten aus.
Anmerkung: Lizenzen für Quality Manager
und Lab Manager der Version 2 heißen jetzt in Version 3 Quality Professional-Lizenzen. Es gibt keine getrennten Lab Manager-Lizenzen mehr.
Connector-Lizenzen aus Version 2 heißen immer noch Connector-Lizenzen,
während Viewer-Lizenzen aus Version 2 nun als Contributor-Lizenzen bezeichnet werden.
- Falls sich Ihre Hilfeanwendung (clmhelp.war) auf einem anderen Server als die aktuelle Anwendungen befindet, konfigurieren Sie die Position der Hilfeanwendung. Ausführliche Informationen hierzu enthält der Artikel Position der Hilfetexte in einer dezentralen Umgebung konfigurieren.
- Führen Sie ein Upgrade für Ihre Dashboards durch.
Melden Sie sich als Benutzer mit Verwaltungsaufgaben bei Ihrer Anwendung an und navigieren Sie zu einer Seite mit einem Dashboard.
Klicken Sie dann auf Migrieren, um ein Upgrade
für alle Dashboards durchzuführen.
- Aktualisieren Sie Ihre Berichte.
- Beginnen Sie mit der Migration des Data Warehouse von Version 2. Ausführliche Informationen hierzu enthält der Artikel Berichtsdaten von Version 2 migrieren.
- Starten Sie dann Rational Team Concert Client
und bringen Sie die Berichtsschablonen auf den neuesten Stand. Ausführliche Informationen hierzu enthält der Artikel Vordefinierte Berichtsschablonen aktualisieren.
- Wenn Sie in Version 2 Rational Common
Reporting verwendet haben, müssen Sie die Berichte in Rational Reporting for Development Intelligence verlagern.
Einzelheiten hierzu enthält der Artikel Migration auf Rational Reporting for Development Intelligence.
- Prüfen Sie, ob das Upgrade vollständig ist. Ausführliche Informationen hierzu enthält der Artikel Upgrade überprüfen.
Nächste Schritte
Fahren Sie nach Abschluss des Upgrades mit dem Artikel
Jazz Team Server und die erste Anwendung nach dem Upgrade konfigurieren fort.
Anmerkung: Wenn Sie eine Migration für
Rational Common Reporting durchführen, erstellen Sie eine Sicherungskopie ihrer vorhandenen Data-Warehouse-Datenbank von
Rational Common Reporting, bevor Sie den Server konfigurieren. Anweisungen für das Erstellen einer Sicherungskopie finden Sie in der
Dokumentation zu dem Managementsystem für relationale Datenbanken, das Ihr Data Warehouse bereitstellt.