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 vorhandenen 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.
- Stoppen Sie Ihren alten Tomcat-Server.
- 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.
Wenn Sie Rational Engineering Lifecycle
Manager installieren,
können Sie bei Bedarf auch die Configuration Management-Anwendung installieren. Die Auswahl dieser Option
ist hilfreich,
wenn Sie die Anwendung auf einem anderen Server als Rhapsody Design Manager 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
- Starten Sie den Apache Tomcat-Server.
- 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 Tomcat-Server erneut.
- 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.