Referenzinformationen zum Script relm_upgrade

Das Script relm_upgrade wird bei der Aktualisierung einer älteren Version von Rational Engineering Lifecycle Manager verwendet.

Zweck

Der vollständige Upgradeprozess für Rational Engineering Lifecycle Manager ist unter Upgrade für Rational Engineering Lifecycle Manager durchführen beschrieben. Die Parameter im Upgrade-Script müssen möglicherweise geändert werden, wenn Sie nicht dem Standard entsprechende Werte verwenden.

Mit dem Script relm_upgrade können Sie ein Upgrade von Rational Engineering Lifecycle Manager 1.0, 1.0.0.1, 4.0.3 oder 4.0.4 auf Version 4.0.6 durchführen. Obwohl sich die Scriptdatei im Verzeichnis upgrade/relm befindet, muss sie über das Verzeichnis RELM_4.0.6_Installationsverzeichnis/server ausgeführt werden. Falls Ihr Pfadname Leerzeichen enthält, müssen Sie ihn in Anführungszeichen setzen.

Alternativ zur Ausführung des Scripts mit all seinen Befehlszeilenargumenten können Sie die Parameterdatei des Scripts öffnen, die Standardwerte modifizieren und für die Ausführung dann eine verkürzte Befehlszeile verwenden.

Die englische und die übersetzten Versionen der Dateien für relm_params befinden sich im Verzeichnis RELM_4.0.6_Installationsverzeichnis/server/upgrade/relm/params. Öffnen Sie relm_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. Dies muss ein vorhandenes Verzeichnis sein, das auf server/conf endet.

Das Script führt die folgenden Tasks aus:
  • Es führt den Befehl -migration_relm_updateConfigurationFiles aus, der die Konfigurations- und Tomcat-Dateien (falls updateTomcatFiles nicht auf "no" gesetzt ist) aktualisiert. 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.
  • Es aktualisiert die Dateien teamserver.properties ausgehend von den Informationen der Vorversion. Geben Sie nach erfolgreicher Zusammenführung der Konfigurationsdateien zum Fortfahren [C] ein. Ein Editor wird geöffnet, in dem Sie die Datei teamserver.properties der Anwendung Change and Configuration Management 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.
  • In einer Tomcat-Umgebung führt es den Inhalt der Dateien server.xml und web.xml mit dem der neuen Version zusammen und kopiert die alte Version der Datei tomcat-users.xml.
  • Es werden Tabellen zur Repository-Datenbank von Rational Engineering Lifecycle Manager hinzugefügt.

Parameter

Attribut Beschreibung Erforderlich Standardwert
oldApplicationHome Vollständiger Pfad zum alten Rational Engineering Lifecycle Manager-Konfigurationsverzeichnis. Der Pfad darf keine Leerzeichen enthalten. Bei einer Standardinstallation lautet dieser Pfad Altes_RELM-Installationsverzeichnis/server/conf. Ja Keiner
applicationContextRoot Rational Engineering Lifecycle Manager-Kontextstammverzeichnis. Nein relm
oldApplicationVersion Die Rational Engineering Lifecycle Manager-Version, die aktualisiert wird. Nein 4.0.4
newApplicationHome Der Pfad zum Anwendungskonfigurationsverzeichnis von Rational Engineering Lifecycle Manager für die Installation der Version 4.0.6. Nein relm_4.0.6_Installationsverzeichnis/server/conf
updateTomcatFiles Angabe, ob die Tomcat-Konfigurationsdateien aktualisiert werden sollen. Setzen Sie diesen Wert auf "no", wenn Sie WebSphere Application Server verwenden. Nein yes
oldApplicationTomcatHome Vollständiger Pfad zum Tomcat-Ausgangsverzeichnis der installierten Vorversion. Standardmäßig wird der Wert des Parameters oldTomcatHome vom Wert des Parameters oldApplicationHome abgeleitet. Nein Keiner
newApplicationTomcatHome Der Pfad zum Tomcat-Ausgangsverzeichnis der Anwendung Rational Engineering Lifecycle Manager für die Installation der Version 4.0.6. Standardmäßig wird der Wert des Parameters newApplicationTomcatHome vom Wert des Parameters newApplicationHome abgeleitet. Nein Keiner
newJTSHome Der Pfad zum Jazz Team Server-Konfigurationsverzeichnis der Installation der Version 4.0.6. Standardmäßig wird der Wert des Parameters newJTSHome vom Wert des Parameters newApplicationHome abgeleitet. Nein Keiner
jtsContextRoot Das Kontextstammverzeichnis für Jazz Team Server Version 4.0.6. Nein jts
noPrompt Vor dem Erstellen oder Modifizieren der Tabellen keine Bestätigung anfordern. Nein Keiner
noVerify Keine Verifizierung der Datei teamserver.properties durchführen. Nein Keiner
overwrite Gibt an, ob eine vorhandene Datei überschrieben werden soll. Nein no
noStepPrompt Vor Ausführung eines Schritts keine Bestätigung anfordern. Nein Keiner
Windows:
cd C:\Program Files\IBM\JazzTeamServer\Server\
upgrade\relm\relm_upgrade.bat -oldApplicationHome altes_RELM-Installationsverzeichnis\server\conf
Linux:
cd opt/IBM/JazzTeamServer/Server/
./upgrade/relm/relm_upgrade.sh -oldApplicationHome altes_RELM-Installationsverzeichnis/server/conf

Feedback