In diesem Artikel ist das manuelle Upgrade von Rational Quality Manager Version
2 auf Version 3 beschrieben.
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.
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 für den Server der Version 2 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.
Vorgehensweise
- 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 Sie den Import der Daten von Version 2 in die Datenbank von Quality Management Version 3 abgeschlossen haben. Dann müssen Sie
Jazz Team Server stoppen.
Sie können den Server neu Starten, nachdem Sie die Benutzer- und Lizenzdaten in
Jazz Team Server (
14) importiert haben.
- Sichern Sie Ihre Datenbank und die Datei teamserver.properties von Version 2 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 vorhandenen Repository der Version 2 mit dem Befehl repotools
-export 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:
repotools -export toFile=c:\export.tar teamserver.properties=c:\Program%20Files\IBM\RQM201\server\conf\jazz\teamserver.properties
Hier steht toFile für den Namen der
TAR-Datei, in die das Repository exportiert wird, und teamserver.properties für den Pfad zur Datei
teamserver.properties.
- Falls Sie Jazz Team Server noch nicht installiert haben, installeiren Sie jetzt den Server,
die Anwendung Quality Management und Required Base License Keys 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 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 Version 3.0.1 ein neues Befehlsfenster (RQM-301-Installationsverzeichnis/server)
und geben Sie repotools-jazz -migration_qm_updateConfigurationFiles
oldApplicationHome=RQM-2-Installationsverzeichnis/server/conf ein, um die Jazz-Konfigurationsdateien
von Version 2 mit denen von Version 3 zusammenzuführen.
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), gehen Sie wie folgt vor:
- Hängen Sie das Laufwerk oder Dateisystem mit dem installierten Jazz Team Server an.
- Geben Sie die Position von Jazz Team Server 3.0.1 an.
Verwenden Sie dazu den Befehl -migration_qm_updateConfigurationFiles in der Befehlszeile mit dem Argument
-newJTSHome.
Der Befehl führt die folgenden
Schritte aus:
- Er aktualisiert die Datei teamserver.properties von Version 3 der Anwendungen und von
JTS ausgehend von den Informationen in der Jazz-Datei teamserver.properties von Version 2.
- Er kopiert den Inhalt der Tomcat-Benutzerdatei (XML-Datei).
- Er kopiert die Datei friendsconfig.rdf mit einer Liste der Server, die für eine Repository-übergreifende Integration konfiguriert
sind.
- Er mischt den Inhalt der Dateien server.xml und web.xml (LDAP-Einstellungen) mit dem der Dateien aus Version 3.
- Prüfen Sie Ihre Konfigurationsdateien. Ausführliche Informationen hierzu enthalten die Artikel Konfigurationsdateien während des Upgrades
überprüfen und -migration_qm_updateConfigurationFiles.
- 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.
- Importieren Sie die Daten von Rational Quality Manager aus dem exportierten Repository der Version 2 in das
neue Quality-Management-Repository der Version 3.
Verwenden Sie den Befehl repotools-jazz -import wie im folgenden Beispiel
gezeigt:
repotools-jazz -import fromFile=c:\export.tar
Hier steht fromFile für den Namen der
TAR-Datei, aus der das Repository importiert wird.
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.
- Erstellen Sie die neue Datenbank für Jazz Team Server (JTS)
und übertragen Sie die Benutzer- und Lizenzierungsdaten aus der Quality-Management-Datenbank.
- Exportieren Sie die Benutzerdaten aus der Anwendung Quality Management mit
folgendem Befehl repotools-jazz:
repotools-jazz -migration_exportJTSData toFile=jtsData.tar
- Importieren Sie die Benutzer- und Lizenzierungsdaten in die Datenbank von Jazz Team Server.
Verwenden Sie dazu den folgenden Befehl repotools-jts.
Wichtig: Falls es sich hier um eine Neuinstallation von Jazz Team Server und einem der Collaborative Lifecycle Management-Produkte handelt, kann der Befehl repotools-jts den Parametere createTables enthalten, der eine neue JTS-Datenbank erstellt. Ist bereits eine JTS-Datenbank vorhanden, dann dürfen Sie den Parameter createTables in der Befehlszeile nicht verwenden, denn damit würde die vorhandene DAtenbank überschrieben werden.
repotools-jts -migration_importJTSData fromFile=jtsData.tar createMappingFile=mapping-qm.txt createTables
- Importieren Sie die Benutzerzuordnungsdaten in die QM-Datenbank. Verwenden Sie dafür den folgenden
Befehl repotools-jazz. Die Zuordnung benötigt die Anwendung
QM für die Kommunikation mit der JTS-Datenbank.
repotools-jazz -migration_importUserMapping fromMappingFile=mapping-qm.txt
- 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, Rational Quality Manager) 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.
- 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).
- Rufen Sie jazz/admin auf und vergewissern Sie sich, dass keine Fehler vorliegen.
- 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 finden Sie unter 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.