Manuelles Upgrade auf Rational Quality Manager und Jazz Team Server 3.0.1 durchführen

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

  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 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.
  5. 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:
  6. 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.

    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, 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.

  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 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.
  10. Ö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.
  11. Prüfen Sie Ihre Konfigurationsdateien. Ausführliche Informationen hierzu enthalten die Artikel Konfigurationsdateien während des Upgrades überprüfen und -migration_qm_updateConfigurationFiles.
  12. 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.
  13. 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.
  14. Erstellen Sie die neue Datenbank für Jazz Team Server (JTS) und übertragen Sie die Benutzer- und Lizenzierungsdaten aus der Quality-Management-Datenbank.
    1. Exportieren Sie die Benutzerdaten aus der Anwendung Quality Management mit folgendem Befehl repotools-jazz:
      repotools-jazz -migration_exportJTSData toFile=jtsData.tar 
    2. 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 
    3. 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   
  15. 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.
  16. 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.
  17. 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.
  18. Starten Sie Ihren Anwendungsserver, d. h. Jazz Team Server Version 3 oder WebSphere Application Server.
  19. 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).

  20. Rufen Sie jazz/admin auf und vergewissern Sie sich, dass keine Fehler vorliegen.
  21. 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.
  22. Öffnen Sie Ihren Browser, löschen Sie den Browsercache und stellen Sie eine neue Verbindung zu Ihrem Projekt her.
  23. 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.
  24. 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.
  25. 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.

  26. 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 finden Sie unter Migration auf Rational Reporting for Development Intelligence.
  27. 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