Offlineupgrade auf Version 3.0.1 mit dem Upgrade-Script

In diesem Artikel ist das Upgrade von IBM® Rational Requirements Composer Version 2 auf Version 3.0.1 mit dem Script rm_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 die Anwendung Requirements Management (RM) unabhängig vom Jazz Team Server installieren, muss das Upgrade-Script auf das Laufwerk oder Dateisystem mit der installierten Anwendung RM zugreifen können. Unter Windows muss die Angabe eines angehängten Laufwerks mit Verzeichnissen beispielsweise das Format Buchstabe des angehängten Laufwerks:\server\conf haben. Ein absoluter Pfad wie \\<Maschinenname>\JTS-301-Installationsverzeichnis\server\conf funktioniert nicht. Das angehängte Laufwerk muss mit Lese-, Schreib- und Ausführungsrechten für den Administratoraccount konfiguriert sein.

Befolgen Sie diese Anweisungen für die Verwendung des Upgrade-Scripts, wenn Sie mit einer Einzelserverimplementierung arbeiten oder eine dezentrale Implementierung nutzen und ein Laufwerk mit Requirements Management (RM) und Jazz Team Server zuordnen anhängen können.

Befolgen Sie die Anweisungen im Artikel Manuelles Offlineupgrade auf Version 3.0.1, wenn Sie eine verteilte Netzimplementierung durchführen und das Laufwerk nicht anhängen dürfen oder wenn Sie ein erfahrener Administrator sind und diese Schritte lieber manuell ausführen möchten. In den Anweisungen für die manuellen Schritte sind die Aktionen der Scripts ausführlich beschrieben.

Ändern Sie in einer Umgebung mit IBM WebSphere Application Server die Installationspfade so, dass sie keine Leerzeichen enthalten (z. B. in C:\IBM\JazzTeamServer). Wenn ein Parameter für einen Dateinamen oder einen Dateipfad ein Leerzeichen enthält, müssen Sie diesen in Anführungszeichen setzen, wie z. B. "C:\Program Files\IBM".

Vorgehensweise

  1. Lesen Sie den Artikel Basisinformationen zum Implementierungs- und Upgradeprozess. Informieren Sie sich bei Bedarf anhand der Artikel im Abschnitt Implementierung und Upgrade planen.
    Wichtig:
    • Das ursprüngliche Kontextstammverzeichnis von RM Version 2 (/rdm) und die URIs für alle RM-Artefakte bleiben erhalten. Das Kontextstammverzeichnis von Jazz Team Server ändert sich von /jazz in /jts.
    • Falls in der installierten Version 2.0 ein öffentlicher URI festgelegt wurde, müssen Sie in Version 3.0.1 denselben öffentlichen URI verwenden.
  2. Prüfen Sie anhand der Informationen im Artikel System Requirements, ob Ihre Hardware und Software die erforderlichen Mindestanforderungen erfüllt. Überprüfen Sie in Ihrer aktuellen Datei teamserver.properties von Version 2 die folgenden Angaben:
    • Eigenschaft für den öffentlichen URI: com.ibm.team.repository.server.webapp.url
    • Informationen für die Verbindung zu Ihrem Datenbankserver, in der Regel 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 URI verwenden. Wenn kein öffentlicher URI definiert wurde, rufen Sie die Webschnittstelle für Administration von Version 2 auf und legen Sie (unter Erweiterte Eigenschaften) den URI mit qualifiziertem Hostnamen (https://hostname.example.com:port) fest, bevor Sie das Upgrade durchführen.

    Die Zeile mit dem öffentlichen URI in der Datei teamserver.properties sieht etwa wie folgt aus:
    com.ibm.team.repository.server.webapp.url=https\://hostname.example.com\:9443/jazz
  3. Laden Sie die Software IBM Rational Requirements Composer und alle anderen zu installierenden Anwendungen der Rational-Lösung für Collaborative Lifecycle Management (CLM) von der entsprechenden Projektseite auf jazz.net herunter. Anweisungen finden Sie im Abschnitt Produktinstallationsmedien herunterladen.
  4. Stoppen Sie IBM Rational Requirements Composer Server Version 2.
  5. Sichern Sie Ihre Datenbank und die Datei teamserver.properties von IBM Rational Requirements Composer Version 2 an einer temporären Position (tmp). Die Datei teamserver.properties enthält die Position der Datenbank, zu der jede Anwendung eine Verbindung herstellen muss. In Version 2 befindet sich die Datei standardmäßig an der Position Installationsverzeichnis\server\conf\jazz\teamserver.properties. Sicherungsanweisungen finden Sie in den folgenden Artikeln:
  6. Exportieren Sie die Daten aus Ihrer Datenbank von IBM Rational Requirements Composer Version 2:
    1. Rufen Sie das Verzeichnis RRC-2-Installationsverzeichnis\server von IBM Rational Requirements Composer Version 2 auf.
    2. Führen Sie den Windows-Befehl repotools -export oder auf AIX- bzw. Linux-Systemen den Befehl ./repotools.sh - export aus und speichern Sie die Datei außerhalb der Verzeichnisstruktur von IBM Rational Requirements Composer. Sehen Sie sich dazu das folgende Beispiel für Version 2.0.1 an:

    Windows: repotools -export toFile=c:\tmp\rrcdata.tar

    AIX oder Linux: repotools -export toFile=/tmp/rrcdata.tar

    Die Variable toFile gibt den Namen der TAR-Datei, in die die Datenbank exportiert wird.

    Anmerkung:
  7. Falls Sie Jazz Team Server Version 3.0.1 bereits installiert haben, stoppen Sie alle Server der Version 3.0.1, einschließlich Jazz Team Server und der Server der anderen CLM-Anwendungen, und sichern Sie Ihre Datenbank und Umgebung von Jazz Team Server Version 3.0.1. Fahren Sie mit Schritt 10 fort.
  8. Falls Sie Jazz Team Server Version 3.0.1 noch nicht installiert haben, installieren Sie Jazz Team Server. Führen Sie nicht den Konfigurationsassistenten aus.
  9. Wenn Sie Jazz Team Server Version 3.0.1 noch nicht installiert haben und nicht die Derby-Standarddatenbank verwenden, müssen Sie die Datenbanken für Jazz Team Server erstellen.

    Datenbanken werden für Jazz Team Server 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. Installieren Sie die Anwendung Requirements Management auf einer anderen Maschine. Anweisungen finden Sie im Abschnitt Installation mit IBM Installation Manager.

    Wählen Sie während der Installation Kontextstammverzeichnis von Rational Requirements Composer 2.x verwenden aus. Bei Auswahl dieser Option wird die Anwendung RM so installiert, dass das Kontextstammverzeichnis von Version 2 (/rdm) erhalten bleibt und Links zu RM-Artefakten weiter funktionieren. Wählen Sie diese Option nicht aus, schlägt Ihr Upgrade fehl. Einzelheiten finden Sie im Artikel Basisinformationen zum Implementierungs- und Upgradeprozess.

  11. Wählen Sie am Ende der Installation bei Anzeige der Frage Welches Programm möchten Sie starten? die Option Kein aus. Klicken Sie dann auf Fertigstellen und Installation Manager beenden.
  12. Wenn Sie die Implementierung in WebSphere Application Server durchführen, stoppen Sie die Anwendungen converter.war, jazz.war, rrc-help.war und rdm.war von Version 2 und deinstallieren Sie sie. Weitere Informationen hierzu finden Sie unter WebSphere Application Server für das Upgrade auf Version 3 konfigurieren.
  13. Führen Sie das Offlineupgrade-Script aus. Öffnen Sie an der Position, an der Sie Jazz Team Server Version 3.0.1 installiert haben, ein neues Befehlsfenster und navigieren Sie zum Verzeichnis JTS-301-Installationsverzeichnis\server. Führen Sie unter Windows das Upgrade-Script upgrade\rm_upgrade.bat oder auf AIX- bzw. Linux-Systemen das Upgrade-Script upgrade/rm_upgrade.sh aus. Das Script verwendet während seiner Ausführung die der Spracheinstellung des Computers entsprechende Sprache.
    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 zur Parameterdatei enthält Schritt 14.
    Wichtig:
    • Die Script-Datei befindet sich im Verzeichnis upgrade, muss jedoch im Verzeichnis server ausgeführt werden. Falls Ihr Pfadname Leerzeichen enthält, müssen Sie ihn in Anführungszeichen setzen.
    • Falls Sie für Rational Requirements Composer Version 2 Floating-Lizenzen verwendet haben, gibt es ein bekanntes Problem. Möglicherweise müssen Sie das Upgrade-Script stoppen, die Anwendung Jazz Team Server starten und die Floating-Lizenzen für Version 3.0.1 installieren, bevor Sie Ihre Daten aus der Datenbank von IBM Rational Requirements Composer Version 2 importieren. Weitere Informationen hierzu enthält der Artikel https://jazz.net/library/article/659.

    Wenn Sie Jazz Team Server Version 3.0.1 zusammen mit der Anwendung RM 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\rm_upgrade.bat -oldApplicationHome RRC-2-Installationsverzeichnis\server\conf -importFromFile c:\tmp\export.tar -createJTSTables 

    AIX oder Linux:

    ./upgrade/rm_upgrade.sh -oldApplicationHome RRC-2-Installationsverzeichnis/server/conf -importFromFile /tmp/export.tar -createJTSTables 
    Anmerkung: Der Parameter -createJTSTables ist nur anwendbar, wenn Sie Jazz Team Server 3.0.1 und bielebige produkte von Collaborative Lifecycle Management zum ersten Mal installieren. Wenn Sie RM als eigenständige Anwendung installieren, müssen Sie diesen Parameter nicht in die Befehlszeile aufnehmen, weil sich Jazz Team Server Version 3.0.1 an einer anderen Position befindet. Der Parameter createTables bewirkt die Erstellung einer Datenbank für Jazz Team Server und den Import des Inhalts der TAR-Datei. Ist bereits eine Jazz Team Server-Datenbank vorhanden, dann dürfen Sie den Parameter createTables in der Befehlszeile nicht verwenden, denn damit würde die vorhandene Datenbank überschrieben werden.

    Wenn Sie Jazz Team Server Version 3.0.1 unabhängig von der Anwendung RM installiert haben, wie es bei einer dezentralen Implementierung der Fall sein kann, müssen Sie die Position von RM angeben und das Script im Installationsverzeichnis von Jazz Team Server 3.0.1 ausführen. Nehmen Sie in dem Fall das Argument -newApplicationHome auf.

    Windows:

    JTS-301-Installationsverzeichnis\server upgrade\rm_upgrade.bat -oldApplicationHome RRCS-2-Installationsverzeichnis\server\conf -importFromFile c:\tmp\export.tar -newApplicationHome RRC-301-Installationsverzeichnis\server\conf -jtsURL https://vollständig_qualifizierter_Domänenname:Port/jts

    AIX oder Linux:

    JTS-301-Installationsverzeichnis/server ./upgrade/rm_upgrade.sh -oldApplicationHome RRCS-2-Installationsverzeichnis/server/conf -importFromFile /tmp/export.tar -newApplicationHome RRC-301-Installationsverzeichnis/server/conf -jtsURL https://vollständig_qualifizierter_Domänenname:Port/jts
    Anmerkung:
    • Wenn Sie eine verteilte Implementierung durchführen und Jazz Team Server Version 3.0.1 noch nicht konfiguriert haben, können Sie zur obigen Beispielbefehlszeile den Parameter -createJTSTables 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 RM ausgeführt wird, muss dieser Parameter angegeben sein.

    Geben Sie einen der folgenden Befehle ein, um weitere Details zu Befehlszeilenoptionen aufzurufen:

    Windows: upgrade\rm_upgrade.bat -help

    AIX oder Linux: ./upgrade/rm_upgrade.sh -help

    Die Offlinemigration kann benötigt aufgrund der Fülle der zu migrierenden Daten viel Zeit benötigen.
    Achtung: Während der Offlinemigration müssen Sie sich die Bedienerführung ansehen, die den Inhalt der zusammengeführten Dateien anzeigt, insbesondere die Angaben für die Datenbankverbindung in der Datei teamserver.properties. Bearbeiten Sie die zusammengeführten Dateien, sofern nötig.

    Das Script führt die folgenden Schritte aus:

    1. Es aktualisiert wie folgt die Konfigurationsdateien von Version 3.0.1:
      • Es führt den Befehl -migration_rm_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.
        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.
        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 9 erstellt haben.
      • 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-Datei users.xml.
      • 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.0.1 zusammen.
      • Es mischt den Inhalt der Dateien server.xml und web.xml (LDAP-Einstellungen) mit dem der Dateien aus Version 3.0.1.
    2. Importieren Sie die exportierten Daten von RM Version 2 aus der TAR-Datei mit dem Befehl repotools-jts -import (unter Windows) oder ./repotools-jts.sh -import (auf AIX- bzw. Linux-Systemen in die Datenbank von Jazz Team Server Version 3.0.1.
      Anmerkung:
      • Wenn Sie umfangreiche Repositorys für Requirements Management 3.0.1 importieren, können Fehler des Typs OutOfMemoryException auftreten. Sollten Sie eine große Anzahl von Projekten und Artefakten haben, setzen Sie im Script repotools-jazz.bat oder repotools-jazz.sh den Wert des Parameters -Xmx auf einen höheren Wert als den Standardwert (1500M). Beste Resultate erzielen Sie mit 4096M, sofern Ihre Maschine über ausreichend Hauptspeicher verfügt.
      • Eine ausführliche Liste der Änderungen, die an den Konfigurationsdateien von Rational Requirements Composer vorgenommen werden, enthält der Artikel Änderungen in Rational Requirements Composer.
  14. 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. Detailinformationen zu diesen Werten finden Sie im Artikel rm_upgrade.

    Die englische Version und übersetzte Versionen der Parameterdatei sind im Verzeichnis Jazz-Installationsverzeichnis\server\upgrade\params\rm_params.bat (unter Windows) oder ./params/rm_params.sh (auf AIX- bzw. Linux-Systemen) 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 -rm -showParamFileName (unter Windows) oder ./locale.sh -rm -showParamFileName (auf AIX- bzw. UNIX-Systemen) aus.
    2. Öffnen Sie die Datei rm_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. Dieser Pfad darf keine Leerzeichen enthalten. Wenn ein Parameter für einen Dateinamen oder einen Dateipfad dennoch ein Leerzeichen enthält, müssen Sie ihn in Anführungszeichen setzen. Legen Sie beispielsweise OLD_APPLICATION_HOME="C:\Program Files\IBM\RRCS2002\server\conf" fest. Informationen zu den einzelnen Parametern finden Sie in der Datei Jazz-Installationsverzeichnis\server\upgrade\doc\rm_help.txt.
  15. Prüfen Sie, ob Ihre Repository-Daten und Konfigurationsdateien aktualisiert wurden. Ausführliche Informationen hierzu enthalten die Artikel Konfigurationsdateien während des Upgrades überprüfen und -migration_rm_updateConfigurationFiles.
  16. Erstellen Sie nach Abschluss der Offlinemigration eine Sicherung der Datenbank und des gesamten Serververzeichnisses von Jazz Team Server Version 3.0.1. Diese Sicherung muss an einer anderen Position als die für die Datenbank von Version 2 erstellt werden. Erstellen Sie die Sicherung, bevor Sie mit der Onlinemigration fortfahren. Überschreiben Sie nicht Ihre Datenbanksicherung von Version 2.
  17. Falls Sie für das vorherige Release ein Sicherheitszertifikat erstellt haben, kopieren Sie das Zertifikat oder erstellen Sie ein neues. Weitere Details finden Sie im Artikel Sicherheitszertifikate konfigurieren.
  18. 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.
  19. Wenn Sie die Implementierung in IBM WebSphere Application Server durchführen, müssen Sie die WAR-Dateien von Version 3.0 implementieren und einem Benutzer oder einer Gruppe Sicherheitsrollen zuweisen. Einzelheiten finden Sie im Artikel WebSphere Application Server für das Upgrade auf Version 3 konfigurieren.
  20. Fahren Sie nach der Sicherung mit den Schritten für die Onlinemigration fort. Informationen hierzu finden Sie im Abschnitt Upgradeschritte für die Onlinemigration.

Feedback