Installieren Sie für ein Upgrade von
Rational Engineering
Lifecycle Manager die neue Produktversion, aktualisieren Sie
die Konfigurationsdateien, fügen Sie Tabellen in vorhandenen Datenbankrepositorys hinzu bzw. aktualisieren
Sie die entsprechenden Tabellen und migrieren Sie Ihre Daten auf Version 5.0.1.
Vorbereitende Schritte
- Wenn Sie in Rational Engineering
Lifecycle Manager integrierte
Produkte aktualisieren, befolgen Sie
die Anweisungen im Abschnitt Upgrade für Rational Engineering Lifecycle Manager-Produktstack durchführen - Prüfliste der Reihe nach.
- Wenn Sie ein Upgrade von Version 4.x durchführen, müssen Sie neue Lizenzen
für die Anwendungen der Version 5.x anfordern.
Anwendungen der Version 5.x können nicht mit Lizenzen der Version 4.x verwendet werden.
Es ist jedoch möglich, Anwendungen der Version 4.x mit Lizenzen der Version 5.x zu verwenden.
Weitere Informationen
zu Lizenzen finden Sie im Abschnitt zum Verwalten von
Lizenzen.
- Bei einem Upgrade von Version 4.x müssen Sie die Rational Engineering
Lifecycle Manager-Datenquelle
aus Lifecycle
Query Engine entfernen.
- Öffnen Sie die Verwaltungsseite von Lifecycle
Query Engine:
https://LQE-Hostname:port/lqe/web.
- Klicken Sie auf .
Wählen Sie die
Rational Engineering
Lifecycle Manager-Datenquelle aus.
- Klicken Sie im Bereich Data Sources auf Remove und
speichern Sie die Daten.
Vorgehensweise
- Installieren Sie Rational Engineering Lifecycle
Manager.
Bei diesem Schritt wird Folgendes installiert:
- Rational Engineering
Lifecycle Manager 5.0.1
- Jazz Team Server 5.0.1
- Configuration Management-Anwendung 5.0.1
Wichtig: - Wählen Sie eine andere Paketgruppe und ein anderes Verzeichnis aus
als bei der ursprünglichen Installation.
- Wählen Sie dasselbe Kontextstammverzeichnis wie bei der vorherigen Installation aus.
Wenn Sie ein Upgrade von Rational Engineering
Lifecycle Manager
Version 5.0 oder
älteren Versionen durchführen, lautet das bestehende Kontextstammverzeichnis
für Jazz
Reporting Service oder
SPARQL Gateway SPARQL_Gateway; der Name der Anwendungsdatei
lautet SPARQL_Gateway.war.
Wählen Sie bei der Installation von Rational Engineering
Lifecycle Manager
5.0.1 die Option
für ein benutzerdefiniertes Kontextstammverzeichnis aus und geben Sie SPARQL_Gateway
im Feld Application context root values ein.
- Konfigurieren Sie Ihren Anwendungsserver.
- Stellen Sie sicher, dass der alte Server ausgeführt wird.
- Sichern Sie das WebSphere Application
Server-Profil.
- Öffnen Sie eine Eingabeaufforderung und wechseln Sie in das Verzeichnis bin
des WebSphere Application Server-Installationsverzeichnisses.
- Führen Sie diesen Befehl aus.
Wenn
die Sicherheitsfunktion für WebSphere Application Server
aktiviert ist, geben Sie den Benutzernamen und das Kennwort an.
Tipp: Der Verzeichnispfad der komprimierten Datei muss vorhanden sein,
bevor Sie den Sicherungsprozess starten.
backupConfig.sh <Pfad einer neuen komprimierten Datei zur Erstellung einer Profilsicherung> -username <Name des primären WAS-Administratorbenutzers> -password <WAS-Administratorkennwort>
Beispiel:
backupConfig.sh /root/WAS_backup/relm_50_profile.zip -username <WAS-Administrator> -password <WAS-Administratorkennwort>
backupConfig.bat <Pfad einer neuen komprimierten Datei zur Erstellung einer Profilsicherung> -username <Name des primären WAS-Administratorbenutzers> -password <WAS-Administratorkennwort>
Beispiel:
backupConfig.bat C:\WAS_backup\relm_50_profile.zip -username <WAS-Administrator> -password <WAS-Administratorkennwort>
Mit dem Befehl wird der Server beendet, bevor der Sicherungsprozess gestartet wird.
- Deinstallieren Sie die vorhandenen Anwendungen aus WebSphere Application Server.
- Starten Sie den Server.
- Melden Sie sich bei der Integrated Solutions Console von
WebSphere Application Server unter
https://Hostname:9043/ibm/console/logon.jsp an.
- Klicken Sie auf .
- Stoppen Sie die folgenden Anwendungen
und deinstallieren Sie sie: relm.war, relmhelp.war, vvc.war, lqe.war, SPARQL_Gateway.war.
- Speichern Sie die Änderungen an der Masterkonfiguration, wenn Sie dazu aufgefordert werden.
- Aktualisieren Sie die angepassten Eigenschaften JAZZ_HOME und log4j.configuration.
- Melden Sie sich bei der Integrated Solutions Console von
WebSphere Application Server unter
https://Hostname:9043/ibm/console/logon.jsp an.
- Klicken Sie auf .
- Klicken Sie auf den Servernamen, um den Server zu öffnen. Der Standardservername ist server1.
- Klicken Sie im Abschnitt Serverinfrastruktur
auf .
- Klicken Sie unter Weitere Eigenschaften auf Java Virtual Machine.
- Ändern Sie den Pfad für Lifecycle
Query Engine
und für Jazz
Reporting Service. Geben Sie die neue Position an.
- Suchen Sie das Textfeld Generische JVM-Argumente und
fügen Sie diese Umgebungsvariable zum JVM-Startprozess hinzu:
-Dlqe.config.location=file://drive:/LQE-Installationsverzeichnis/server/conf/lqe
- Klicken Sie unter Weitere Eigenschaften auf Angepasste Eigenschaften.
- Klicken Sie auf JAZZ_HOME und aktualisieren Sie den Wert wie folgt:
file:///<Installationsverzeichnis der neuen Version>/server/conf.
Beispiel: file:///C:/PROGRA~2/IBM/JazzTeamServer_5.0.1/server/conf.
- Klicken Sie auf log4j.configuration und aktualisieren Sie den Wert wie folgt:
file:///<Installationsverzeichnis der neuen Version>/server/conf/startup_log4j.properties.
Beispiel: file:///C:/PROGRA~2/IBM/JazzTeamServer_5.0.1/server/conf/startup.log4j.properties.
- Wenn Sie eine Verbindung zu einer Oracle-Datenbank herstellen, muss ORACLE_JDBC_DRIVER_FILE auf die richtige JDBC-Treiberdatei verweisen.
- Speichern Sie die Änderungen an der Masterkonfiguration, wenn Sie dazu aufgefordert werden.
- Legen Sie die gemeinsam genutzte Jazz
Reporting Service-Bibliothek fest.
- Rufen Sie in der Administrationskonsole
auf.
- Klicken Sie in der Liste auf Gemeinsame JRS-Bibliothek.
- Ändern Sie den Klassenpfad von der vorhandenen
Jazz
Reporting Service-Installationsposition in die neue Installationsposition.
Beispiel: 5.0.1-Installationsverzeichnis/server/conf/SPARQL_Gateway/SharedLibrary
- Stellen Sie unter Laden von Klassen sicher, dass die Option
zur Verwendung eines isolierten Klassenladeprogramms für die gemeinsame Bibliothek ausgewählt ist.
Klicken Sie auf Anwenden und dann auf Speichern.
- Stoppen Sie WebSphere Application Server.
Führen Sie den Befehl stopServer.sh aus.
Führen Sie den Befehl stopServer.bat aus.
- Bereinigen Sie die temporären Verzeichnisse (temp)
von WebSphere Application
Server.
Entfernen Sie Rational Engineering Lifecycle
Manager-bezogene Inhalte
aus den Verzeichnissen wscache und temp im Profil.
Abhängig von den installierten Anwendungen enthält das Profil möglicherweise die folgenden Verzeichnisse,
die entfernt werden können: relm_war, lqe_war, sparql
sowie zur Configuration Management-Anwendung gehörende Daten.

WAS-Profilstammverzeichnis/wscache (z. B.: opt/IBM/WebSphere/AppServer/profiles/AppSrv01/temp/wscache)
WAS-Profilstammverzeichnis/temp (z. B.: opt/IBM/WebSphere/AppServer/profiles/AppSrv01/temp)
WAS-Profilstammverzeichnis\wscache (z. B.: C:\IBM\WebSphere\AppServer\profiles\AppSrv01\wscache)
WAS-Profilstammverzeichnis\temp (z. B.: C:\IBM\WebSphere\AppServer\profiles\AppSrv01\temp)
- Bereinigen Sie das Verzeichnis der WebSphere Application Server-Protokolle.
Entfernen Sie auf jedem Anwendungsserver
Rational Engineering Lifecycle
Manager-bezogene Protokolldateien aus dem Verzeichnis für die Protokolldateien im Profil.
Beispiele für ein typisches Protokollverzeichnis:
opt/IBM/WebSphere/AppServer/profiles/AppSrv01/logs
C:\IBM\WebSphere\AppServer\profiles\AppSrv01\logs
- Starten Sie Ihren WebSphere Application
Server.
Führen Sie den Befehl startServer.sh aus.
Führen Sie den Befehl startServer.bat aus.
- Migrieren Sie Ihre Datenbank oder sichern Sie sie.
| Option |
Bezeichnung |
 |
Löschen Sie die Derby-Datenbanken, die mit dem Upgrade installiert wurden, und ersetzen Sie sie durch die Derby-Dateien aus der ursprünglichen Installation.rm -rf $newRELMHome/server/conf/jts/derby/repositoryDB
rm -rf $newRELMHome/server/conf/jts/indices
rm -rf $newRELMHome/server/conf/relm/derby/repositoryDB
rm -rf $newRELMHome/server/conf/vvc/derby/repositoryDB
cp -R $oldRELMHome/server/conf/jts/derby/repositoryDB $newRELMHome/server/conf/jts/derby
cp -R $oldRELMHome/server/conf/jts/indices $newRELMHome/server/conf/jts
cp -R $oldRELMHome/server/conf/relm/derby/repositoryDB $newRELMHome/server/conf/relm/derby
cp -R $oldRELMHome/server/conf/relm/indices $newRELMHome/server/conf/relm
cp -R $oldRELMHome/server/conf/vvc/derby/repositoryDB $newRELMHome/server/conf/vvc/derby
cp -R $oldRELMHome/server/conf/vvc/indices $newRELMHome/server/conf/vvc
|
oder |
Eine vollständige Anweisung hierzu finden Sie in der Dokumentation, die von Ihrem Datenbankanbieter bereitgestellt wird. Im Folgenden
sehen Sie einen Beispieldatenbanksicherungsprozess für DB2, der als Leitlinie verwendet werden kann. - Stellen Sie sicher, dass der alte
Jazz Team Server gestoppt ist.
- Suchen Sie in DB2 die Datenbanken, die von der vorherigen Installation der
Jazz Team Server-Anwendungen verwendet werden.
- Sichern Sie jede Datenbank, die von einer Jazz Team Server-Anwendung verwendet wird.
- Speichern Sie Ihre Änderungen.
Weitere Informationen zum Sichern und Wiederherstellen der Datenbank
finden Sie in der -Dokumentation zu Rational Solution for Collaborative Lifecycle Management. |
 |
Im Folgenden
sehen Sie einen Beispieldatenbanksicherungsprozess für SQL Server, der als Leitlinie verwendet werden kann.
- Stellen Sie sicher, dass Sie über den korrekten Benutzernamen und das korrekte Kennwort verfügen.
- Stellen Sie sicher, dass die Datenbank vor dem Starten des Upgradeprozesses gesichert wurde.
- Vergewissern Sie sich, dass der JDBC-Treiber (Java Database Connectivity) installiert ist
und sqljdbc4.jar verwendet wird.
In Version 5.0.1 wird die JRE-Version 5.0 nicht mehr unterstützt.
Nur die JRE-Versionen 6.0 und 7.0 werden unterstützt.
- Stellen Sie sicher, dass der SQL-Service gestartet ist.
Eine vollständige Anweisung hierzu finden Sie in der Dokumentation, die von Ihrem Datenbankanbieter bereitgestellt wird. |
Stellen Sie sicher, dass der Oracle-JDBC-Treiber
ojdbc.jar im Verzeichnis
$newRELMHome/JazzTeamServer/server/oracle verfügbar ist.
- Führen Sie ein Upgrade für die Configuration Management-Anwendung durch.
Führen Sie das Script vvc_upgrade aus, um für die Konfigurations- und
Datenbankdateien ein Upgrade durchzuführen und um die Textindizes neu zu erstellen.
Beispiel für die Parameter:
cd $newRELMHome/server/
upgrade/vvc/vvc_upgrade.sh -oldApplicationHome oldRELMHome/server/conf
Tipp: Die Configuration Management-Anwendung kann auch
mit Rhapsody Design Manager installiert werden.
Wählen Sie bei der Installation von Rational Engineering
Lifecycle Manager
die Configuration Management-Anwendung aus, wenn Sie die Komponente auf einer anderen Maschine als
das Rhapsody Design Manager-System installieren möchten.
Integrieren
Sie nur eine einzige Configuration Management-Anwendung mit Rational Engineering Lifecycle
Manager. Wenn Sie
die Komponente auf mehreren Servern installieren, müssen Sie sicherstellen, dass Sie die richtige Komponente zum Installieren und Aktualisieren auswählen.
- Führen Sie ein Upgrade für Rational Engineering Lifecycle
Manager durch.
Führen Sie den Befehl
relm_upgrade.sh aus, um für die
Konfigurations- und Datenbankdateien ein Upgrade durchzuführen und um die Textindizes neu zu erstellen.
$newRELMHome/server/upgrade/relm/relm_upgrade.sh -oldApplicationHome oldRELMHome/server/conf
- Portieren Sie Konfigurationsinformationen von
Lifecycle
Query Engine und
die vorhandenen Konfigurationsinformationen von
Jazz
Reporting Service oder
SPARQL Gateway in die neue Produktversion.
Kopieren Sie den Inhalt des Verzeichnisses
SPARQL_Gateway
der alten Installation in das neue Verzeichnis
SPARQL_Gateway.
cp -R $oldRELMHome/server/conf/SPARQL_Gateway/* $newRELMHome/server/conf/SPARQL_Gateway
Fahren Sie bei einem Upgrade von Version 5.0 auf 5.0.1 mit
Schritt 7 fort.
Verwenden Sie bei einem Upgrade von Version 4.x auf 5.0.1
einen Texteditor, um die folgenden Eigenschaften zu
$newRELMHome/server/conf/SPARQL_Gateway/SPARQL_Gateway.properties
hinzuzufügen.
- support.query.editing=false
- support.db.derby=false
- support.dwse=false
- query.results.limit=3000
- query.results.cache.timeout=300
- user.account.cache.timeout=480
Entfernen Sie
app.properties aus
SPARQL_Gateway.
rm $newRELMHome/server/conf/SPARQL_Gateway/app.properties
Benennen Sie
SPARQL_Gateway.properties in
app.properties um.
mv $newRELMHome/server/conf/SPARQL_Gateway/SPARQL_Gateway.properties $newRELMHome/server/conf/SPARQL_Gateway/app.properties
Benennen Sie
SPARQL_Gateway_runtime.properties in
app_runtime.properties um.
(Standardmäßig ist
SPARQL_Gateway_runtime.properties
nicht vorhanden; die Datei kann jedoch erstellt werden, wenn Sie die Einstellung für die
Überschreitung des Verbindungszeitlimits konfigurieren müssen.)
mv $newRELMHome/server/conf/SPARQL_Gateway/SPARQL_Gateway_runtime.properties $newRELMHome/server/conf/SPARQL_Gateway/app_runtime.properties
- Implementieren Sie die Dateien relm.war, relmhelp.war,
vvc.war, lqe.war und SPARQL_Gateway.war.
- Wählen Sie in der Administrationskonsole von WebSphere Application
Server die Optionen aus.
- Klicken Sie auf der Seite Unternehmensanwendungen auf
Installieren.
- Wählen Sie unter Pfad der neuen Anwendung
$newRELMHome/server/webapps/relm.war aus und
klicken Sie auf Öffnen.
- Wählen Sie Schnell und anschließend Weiter aus.
- Akzeptieren Sie die Standardwerte und klicken Sie im Installationsassistenten
auf Weiter. Geben Sie auf der Seite Kontextstammverzeichnisse für Webmodule zuordnen das Kontextstammverzeichnis /relm ein. Klicken Sie anschließend auf Fertigstellen.
- In einer Nachricht wird Ihnen mitgeteilt, dass relm.war erfolgreich
installiert wurde. Klicken Sie auf In Masterkonfiguration speichern.
- Installieren Sie die
Rational Engineering Lifecycle
Manager-Dokumentation relmhelp.war.
Führen Sie
die oben stehenden Schritte a - f aus. Verwenden Sie $newRELMHome/server/webapps/relmhelp.war
als Pfad und /relmhelp als Kontextstammverzeichnis.
- Installieren Sie die Configuration Management-Anwendung vvc.war. Führen Sie
die oben stehenden Schritte a - f aus. Verwenden Sie $newRELMHome/server/webapps/vvc.war als
Pfad sowie /vvc als Kontextstammverzeichnis.
- Richten Sie
Ihren WebSphere Application
Server für Lifecycle
Query Engine ein
und implementieren Sie die Datei lqe.war.
- Installieren Sie die Jazz
Reporting Service-Anwendung SPARQL_Gateway.war.
Führen Sie
die oben stehenden Schritte a - f aus. Verwenden Sie $newRELMHome/server/webapps/SPARQL_Gateway.war als Pfad.
Verwenden Sie SPARQL_Gateway als Kontextstammverzeichnis.
- Fügen Sie die Jazz
Reporting Service-Bibliotheksreferenz hinzu.
- Wählen Sie aus und klicken Sie in der Liste der Anwendungen auf SPARQL_Gateway_war.
- Klicken Sie im Abschnitt Referenz auf Referenzen auf gemeinsam genutzte Bibliotheken.
- Wählen Sie das Kontrollkästchen neben SPARQL_Gateway_war aus
und klicken Sie auf Gemeinsam genutzte Bibliotheken referenzieren.
- Wählen Sie die Gemeinsame JRS-Bibliothek aus und klicken Sie auf den Rechtspfeil.
- Klicken Sie auf OK. Klicken Sie anschließend noch einmal auf OK,
um Ihre Einstellungen in der Masterkonfiguration zu speichern.
- Stellen Sie sicher, dass die Jazz
Reporting Service-Reihenfolge für das Laden der Klassen ordnungsgemäß konfiguriert ist.
- Wählen Sie aus und klicken Sie in der Liste der Anwendungen auf SPARQL_Gateway_war.
- Klicken Sie im Abschnitt Detaileigenschaften auf
Laden von Klassen und Erkennung von Dateiaktualisierungen.
- Wählen Sie im Abschnitt Reihenfolge der Klassenladeprogramme
die Option Mit dem lokalen Klassenladeprogramm geladene Klassen zuerst (übergeordneter zuletzt) aus.
- Klicken Sie auf OK und dann auf In Masterkonfiguration speichern.
- Starten Sie WebSphere Application Server erneut.
- Bei einem Upgrade von Version 4.x müssen Sie ein Upgrade
für Lifecycle
Query Engine durchführen.
Öffnen Sie die Verwaltungsseite von Lifecycle
Query Engine:
https://RELM_Hostname:port/lqe/web/admin.
In einer Nachricht wird Ihnen mitgeteilt, dass das Lifecycle
Query Engine-Upgrade
momentan ausgeführt wird und dass die Anwendung nicht verfügbar ist. Klicken Sie auf Start Upgrade. Die Datenquellen
stehen zur Verfügung, sobald der
Upgradeprozess abgeschlossen ist.
- Führen Sie ein Upgrade für die Configuration Management-Anwendung durch.
- Stellen Sie sicher, dass die Datei credentials.txt vorhanden ist und die Angaben
adminUserId, adminPassword, repositoryURL, smartCard, certificateFile enthält.
Ist diese Datei nicht vorhanden, erstellen Sie sie.
Im Folgenden sehen Sie ein Beispiel für eine Berechtigungsnachweisdatei:
adminUserId=yourAdminUserId
adminPassword=yourAdminPassword
repositoryURL=https://yourserver.com:9443/vvc
smartCard=<none>
certificateFile=<none>
- Führen Sie den
Befehl repotools-vvc
im Verzeichnis Installationsverzeichnis der Konfigurationsanwendung/server aus.
./repotools-vvc.sh -vvc_online_migrationCommand
credentialsFile=credentials.txt fromVersion=<vorherige Version>
logPort=52000 logLevel=DEBUG
repotools-vvc.bat -vvc_online_migrationCommand
credentialsFile=credentials.txt fromVersion=<vorherige Version>
logPort=52000 logLevel=DEBUG
- Starten Sie Jazz Team Server neu.
Mit dem Befehl repotools der Configuration Management-Anwendung
wird eine Anforderung an die aktive Configuration Management-Anwendung gesendet und anschließend auf die Antwort gewartet.
Stellen Sie sicher, dass der Server aktiviert ist und dass Benutzer-ID und Kennwort in der Berechtigungsnachweisdatei
korrekt sind, falls der Befehl repotools-vvc
sofort mit einem Berechtigungsfehler beendet wird.
- Starten Sie Ihren Anwendungsserver erneut.
Führen Sie die Befehle stopServer.sh und
startServer.sh aus.
Führen Sie die Befehle stopServer.bat und
startServer.bat aus.
- Starten Sie Ihren Rational Engineering Lifecycle
Manager-Server
erneut, um für die migrierten Daten ein automatisches Upgrade in das Format durchzuführen, das für die neue
Version der Anwendung erforderlich ist. Dieser Prozess wird Online-Upgrade genannt. Melden Sie sich an, wenn Sie die Seite mit dem Upgradestatus anzeigen möchten.
Ergebnisse
Ist das Online-Upgrade erfolgreich,
wird die Anzeige des Web-Browsers aktualisiert und es wird die
Begrüßungsseite von
Rational Engineering
Lifecycle Manager geöffnet.
Überprüfen Sie die Datei
relm.log und suchen Sie nach der Fehlerursache, wenn ein Upgradeschritt
fehlschlagen sollte. Wenn in
Rational Engineering
Lifecycle Manager viele Produkte
definiert sind, beansprucht das Online-Upgrade in manchen Fällen sogar einige Stunden.