Upgrade für Rational Engineering Lifecycle Manager durchführen, der mit Apache Tomcat ausgeführt wird

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

Vorgehensweise

  1. 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.

  2. Stoppen Sie Ihren alten Tomcat-Server.
  3. Migrieren Sie Ihre Datenbank oder sichern Sie sie.
    Option Bezeichnung
    Derby 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
    DB2 oder Oracle 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.
    1. Stellen Sie sicher, dass der alte Jazz Team Server gestoppt ist.
    2. Suchen Sie in DB2 die Datenbanken, die von der vorherigen Installation der Jazz Team Server-Anwendungen verwendet werden.
    3. Sichern Sie jede Datenbank, die von einer Jazz Team Server-Anwendung verwendet wird.
    4. Speichern Sie Ihre Änderungen.
    Weitere Informationen zum Sichern und Wiederherstellen der Datenbank finden Sie in der -Dokumentation zu Rational Solution for Collaborative Lifecycle Management.
    SQL Server

    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.
    Oracle Stellen Sie sicher, dass der Oracle-JDBC-Treiber ojdbc.jar im Verzeichnis $newRELMHome/JazzTeamServer/server/oracle verfügbar ist.
  4. 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
    • Falls Sie ein Upgrade für eine verteilte Installationstopologie, d. h. eine Installationstopologie mit mehreren Servern, durchführen, verwenden Sie den folgenden Parameter mit dem Script vvc_upgrade:
      -oldApplicationHome oldRELMHome/server/conf -ignoreJTSVersionCheck
    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.
  5. 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
  6. 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
  7. Starten Sie den Apache Tomcat-Server.
  8. 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.

  9. Führen Sie ein Upgrade für die Configuration Management-Anwendung durch.
    1. 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>
    2. Führen Sie den Befehl repotools-vvc im Verzeichnis Installationsverzeichnis der Konfigurationsanwendung/server aus.
      • Linux./repotools-vvc.sh -vvc_online_migrationCommand credentialsFile=credentials.txt fromVersion=<vorherige Version> logPort=52000 logLevel=DEBUG
      • Windowsrepotools-vvc.bat -vvc_online_migrationCommand credentialsFile=credentials.txt fromVersion=<vorherige Version> logPort=52000 logLevel=DEBUG
    3. 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.
  10. Starten Sie Ihren Tomcat-Server erneut.
  11. 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.

Nächste Schritte


Feedback