In diesem Artikel ist das Upgrade von IBM® Rational Requirements Composer Version 2 auf Version 3.0.1 mit dem Script rm_upgrade beschrieben.
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.
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".
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.
com.ibm.team.repository.server.webapp.url=https\://hostname.example.com\:9443/jazz
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.
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.
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.
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
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
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
Das Script führt die folgenden Schritte aus:
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.