Upgrade auf Version 2.0 (WebSphere Application Server-Umgebung)

In diesem Abschnitt wird die Installation von IBM® Rational Quality Manager 2.0 in einer WebSphere Application Server-Umgebung beschrieben, wenn Sie bereits eine frühere Version des Produkts installiert haben.
Warum und wann dieser Vorgang ausgeführt wird
Anmerkung: Es handelt sich dabei nicht um ein tatsächliches Upgrade auf Rational Quality Manager 2.0. Stattdessen exportieren Sie Ihre Daten aus der früheren Version, installieren die Version 2.0 und importieren die Daten in Version 2.0.

Das Standardinstallationsverzeichnis für Version 1 ist C:\Program Files\IBM\RQM. Das Standardinstallationsverzeichnis für Version 2 ist C:\Program Files\IBM\RQM20. In einer WebSphere Application Server-Umgebung wird empfohlen, den Installationspfad in einen Pfad zu ändern, der keine Leerzeichen enthält. Beispiel: C:\IBM\RQM20.

So führen Sie ein Upgrade auf v2.0 in einer WebSphere Application Server-Umgebung durch:

  1. Stoppen Sie WebSphere Application Server.
  2. Exportieren Sie die Daten aus Ihrem vorhandenen Repository mithilfe des Befehls repotools -export und sichern Sie die TAR-Datei außerhalb der Rational Quality Manager-Verzeichnisstruktur wie im folgenden Beispiel gezeigt:
    repotools -export toFile=c:\export.tar teamserver.properties=c:\Program%20Files\IBM\RQM\server\teamserver.properties

    toFile gibt dabei den Namen der TAR-Datei an, in die das Repository exportiert wird, und teamserver.properties steht für den Pfad zur Datei teamserver.properties.

    Anmerkung: Anweisungen zur Verwendung des Tools repotools finden Sie unter https://jazz.net/learn/LearnItem.jsp?href=content/docs/repo-migration/index.html. Achten Sie darauf, dass Sie die Version von repotools verwenden, die im vorhandenen Produkt enthalten ist.
  3. Sichern Sie Ihre Datenbank und die Datei teamserver.properties in einem temporären Verzeichnis außerhalb des Installationsverzeichnisses Rational Quality Manager.

    Die Datei teamserver.properties enthält den Speicherort der Datenbank, die Rational Quality Manager benötigt, um die Verbindung zur Datenbank herzustellen. Standardmäßig befindet sich diese Datei an der Position installationsverzeichnis\server\conf\jazz\teamserver.properties.

  4. Sichern Sie das Verzeichnis installationsverzeichnis\server\conf\jazz\provision_profiles.
  5. Wenn Sie ein Upgrade von v1.0.0.x durchführen, stellen Sie sicher, dass Sie alle Benutzer notieren, die Zugriff auf den Quality Manager-Standardprojektbereich hatten. Sie müssen diese wieder manuell zum Quality Manager-Projektbereich in v2.0 hinzufügen. Ist Ihre bisherige Version 1.0.1 oder höher, wird dies bei der Installation vorgenommen.
  6. Starten Sie WebSphere Application Server.
  7. Deinstallieren Sie die Dateien jazz.war und help.war.
  8. Stoppen Sie WebSphere Application Server.
  9. Löschen Sie die Verzeichnisse jazz_war und help_war unter C:\Program Files\IBM\WebSphere\AppServer\profiles\AppSrv01\temp\<server>Node01\server1.
  10. Klicken Sie in Installation Manager auf Installieren und befolgen Sie die Installationsanweisungen zum Installieren der aktuellen Version von Rational Quality Manager.

    Ist bereits eine andere Version von Rational Quality Manager installiert, wird eine Benachrichtigung eingeblendet. Klicken Sie auf Continue, um das Paket in eine neue Gruppe zu installieren.

    Anmerkung: Sie können v2.0 nicht in dieselbe Paketgruppe und an derselben Position wie die vorherige Version installieren.
  11. Nach der Installation kopieren Sie die Datei teamserver.properties, die Sie in einem früheren Schritt gesichert haben, an die neue Installationsposition.

    Standardmäßig befindet sich diese Datei an der Position installationsverzeichnis\server\conf\jazz\teamserver.properties.

  12. Stellen Sie das Verzeichnis provision_profiles, das Sie zuvor gesichert haben, wieder her und aktualisieren Sie die Bereitstellungsprofile nach Bedarf, um sicherzustellen, dass diese für diese Version von Rational Quality Manager geeignet sind.

    Zu den Bereitstellungsdateien gehören profile.ini, nlprofile.ini, rqm-license-profile.ini und rqm-profile.ini. In den meisten Fällen müssen die Verzeichnispfade in diesen Dateien aktualisiert werden.

  13. Starten Sie WebSphere Application Server neu.
  14. Aktualisieren Sie die JVM-Argumente im Abschnitt "Generic JVM Arguments" auf der Java™ Virtual Machine-Seite und geben Sie die neuen Verzeichnispfade an.
    Anmerkung: Der Abschnitt mit den JVM-Argumenten wurde in v2.0 um neue Parameter ergänzt. Achten Sie zudem darauf, dass die WAS-Sicherheitseinstellung "Use available authentication data when an unprotected URI is accessed" markiert ist. Weitere Details siehe WebSphere Application Server konfigurieren.
  15. Installieren Sie die neuen Dateien jazz.war und help.war.
  16. Aktualisieren Sie die Benutzer- und Gruppenzuordnungen zur jazz_war-Anwendung.

    Diese Zuordnungen geben die Repositoryberechtigungen für jeden Benutzer und jede Gruppe an.

  17. Importieren Sie die Daten aus dem exportierten Repository mithilfe des Version 2.0-Befehls repotools -import wie im folgenden Beispiel gezeigt:
    repotools -import fromFile=c:\export.tar teamserver.properties=c:\Program%20Files\IBM\RQM20\server\conf\jazz\teamserver.properties

    fromFile gibt dabei den Namen der TAR-Datei an, aus der das Repository importiert wird, und teamserver.properties steht für den Pfad zur Datei teamserver.properties.

    Anmerkung: Achten Sie darauf, dass Sie die Version von repotools verwenden, die im neu installierten Produkt enthalten ist.
  18. Starten Sie die Dateien jazz.war und help.war .
  19. Führen Sie ein Upgrade für Ihre Lizenzen durch.
  20. Starten Sie den Rational Team Concert-Client und aktualisieren Sie die Berichte.
  21. Öffnen Sie Ihren Browser, löschen Sie den Inhalt des Browser-Cache und stellen Sie die Verbindung zum Rational Quality Manager-Projektbereich wieder her.
  22. Überprüfen Sie, ob der importierte Inhalt vorhanden ist.

Feedback