Manuelles Offlineupgrade auf Version 3.0.1

In diesem Artikel sind die manuellen Upgradeschritte für die Offlinemigration von Rational Requirements Composer Server Version 2 auf Version 3.0.1 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 diese Herausforderung meistern. 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.

Ä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 dennoch ein Leerzeichen enthält, müssen Sie ihn in Anführungszeichen setzen. Beispiel: "C:\Programme\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 Ihrer 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. Rufen Sie die folgenden Informationen aus der vorhandenen Datei teamserver.properties von Version 2 ab:
    • 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 im folgenden Beispiel 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 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 die Anwendung 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 das 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. Ö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 den folgenden Befehl aus, um die Konfigurationsdateien von Version 2 mit denen von Version 3.0.1 zusammenzuführen: repotools-jts -migration_rm_updateConfigurationFiles oldApplicationHome=RRCS-20-Installationsverzeichnis/server/conf.

    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.

    repotools-jts -migration_rm_updateConfigurationFiles 
    oldApplicationHome=RRC-2-Installationsverzeichnis/server/conf newApplicationHome=<JTS-301-Installationsverzeichnis>/server/conf -jtsURL https://<vollständig_qualifizierter_Domänenname>:<Port>/jts
    Anmerkung: 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.

    Der Befehl führt die folgenden Schritte aus:

    • Er aktualisiert die Dateien Jazz-Installationsverzeichnis/server/conf/Anwendung/teamserver.properties von Version 3 ausgehend von den Angaben in der Datei Jazz Jazz-Installationsverzeichnis/server/conf/jazz/teamserver.properties von Version 2. Sie haben die Möglichkeit, Werte zu bearbeiten, z. B. die Eigenschaften für die Position der Datenbank von Jazz Team Server. Diese Information kann das Script nicht aus Version 2 abrufen.
      Anmerkung: Falls Sie Jazz Team Server Version 3.0.1 noch nicht installiert und konfiguriert 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.
    • Er kopiert die Tomcat-Benutzerdatei (.xml-Datei) von Version 2.
    • Er 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.
    • Er mischt den Inhalt der Dateien server.xml und web.xml (LDAP-Einstellungen) mit dem der Dateien aus Version 3.0.1.

    Weitere Einzelheiten hierzu enthalten die Artikel Konfigurationsdateien zusammenführen und -migration_updateConfigurationFiles.

  14. Importieren Sie die Daten von Rational Requirements Composer aus dem exportierten Repository der Version 2 in das neue Requirements-Management-Repository der Version 3. Verwenden Sie den Befehl repotools-jts -importapplicationdata wie im folgenden Beispiel gezeigt:
    repotools-jts migration_importapplicationdata fromFile=c:\export.tar

    Die Variable fromFile gibt den Namen der TAR-Datei an, aus der das Repository importiert wird.

    Anmerkung:
    • Falls es sich hier um eine Neuinstallation von Jazz Team Server und einem der Collaborative Lifecycle Management-Produkte handelt, können Sie den Parameter createTables in den Link für den Befehl integrieren, falls Sie erstmalig Benutzerdaten in den Jazz Team Server importieren. 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.
    • Falls Sie für IBM 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 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.
  15. Prüfen Sie Ihre Repository-Daten und Konfigurationsdateien. Ausführliche Informationen hierzu enthält der Artikel Konfigurationsdateien während des Upgrades überprüfen.
  16. Erstellen Sie nach Abschluss der Offlinemigration eine Sicherung der Datenbank und Umgebung 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 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.
  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