Upgrade auf Rational Quality Manager 3.0.1 mit dem Upgrade-Script

In diesem Artikel ist das Upgrade von Rational Quality Manager Version 2 auf Version 3 mit dem Script qm_upgrade 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.

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.

Vorgehensweise

  1. Informieren Sie sich bei Bedarf anhand der Artikel im Abschnitt Implementierung und Upgrade planen.
  2. Ü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
  3. Laden Sie die Software Rational Quality Manager von der entsprechenden Projektseite auf jazz.net herunter. Anweisungen finden Sie im Abschnitt Produktinstallationsmedien herunterladen.
  4. 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.
  5. 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:
  6. Exportieren Sie die Daten aus Ihrem Repository der Version 2.
    1. Rufen Sie das Verzeichnis RQM-2-Installationsverzeichnis\server von Version 2 auf.
    2. 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.

    Anmerkung: Ausführliche Anweisungen für die Verwendung von repotools finden Sie im Artikel Getting Started with Repository Migration sowie im Abschnitt Befehlszeilenreferenz für repotools. Sie müssen die Version von repotools verwenden, die zu Ihrem vorhandenen Produkt der Version 2 gehört.
  7. 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.

  8. Wählen Sie am Ende der Installation bei Anzeige der Frage Welches Programm möchten Sie starten? die Option Kein aus.
  9. 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.
  10. 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.

    Anmerkung: Wenn Sie eine Oracle- oder SQL-Server-Datenbank verwenden, vergewissern Sie sich, dass der Datenbanktreiber an die richtige Position kopiert wurde. Weitere Informationen hierzu enthalten die Artikel Oracle-Datenbank konfigurieren und SQL-Server-Datenbank konfigurieren.
  11. Ö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:

    1. 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.
    2. 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.
    3. Es exportiert die Benutzer- und Lizenzierungsdaten aus der Quality-Management-Datenbank (QM).
    4. Es importiert die QM-Benutzerdaten und -Lizenzierungsdaten in Jazz Team Server.
    5. 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.
  12. 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.

    1. 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.
    2. Ö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.
  13. Prüfen Sie Ihre Konfigurationsdateien. Ausführliche Informationen hierzu enthalten die Artikel Konfigurationsdateien während des Upgrades überprüfen und -migration_qm_updateConfigurationFiles.
  14. 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.
  15. 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.
  16. 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.
  17. 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.
  18. 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).

  19. 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.
  20. Öffnen Sie Ihren Browser, löschen Sie den Browsercache und stellen Sie eine neue Verbindung zu Ihrem Projekt her.
  21. 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.
  22. 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.
  23. 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.

  24. Aktualisieren Sie Ihre Berichte.
    1. Beginnen Sie mit der Migration des Data Warehouse von Version 2. Ausführliche Informationen hierzu enthält der Artikel Berichtsdaten von Version 2 migrieren.
    2. 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.
    3. 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.
  25. 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.

Feedback