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
- 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.
- 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
- 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.
- Stoppen Sie IBM Rational Requirements Composer Server Version
2.
- 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:
- Exportieren Sie die Daten aus Ihrer Datenbank von IBM Rational Requirements Composer Version 2.
- Rufen Sie das Verzeichnis RRC-2-Installationsverzeichnis\server von IBM Rational Requirements Composer Version 2 auf.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- Ö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.
- 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.
- Prüfen Sie Ihre Repository-Daten und Konfigurationsdateien. Ausführliche Informationen hierzu enthält der Artikel
Konfigurationsdateien während des Upgrades
überprüfen.
- 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.
- 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.
- 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.
- 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.
- Fahren Sie nach der Sicherung mit den Schritten für die Onlinemigration fort. Informationen hierzu finden Sie im Abschnitt Upgradeschritte für die Onlinemigration.