Upgrade für Rational Engineering Lifecycle Manager bei Ausführung mit WebSphere Application Server durchführen

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

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. Konfigurieren Sie Ihren Anwendungsserver.
    1. Stellen Sie sicher, dass der alte Server ausgeführt wird.
    2. Sichern Sie das WebSphere Application Server-Profil.
      1. Öffnen Sie eine Eingabeaufforderung und wechseln Sie in das Verzeichnis bin des WebSphere Application Server-Installationsverzeichnisses.
      2. 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.
        • Linux
          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>
        • Windows
          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.
    3. Deinstallieren Sie die vorhandenen Anwendungen aus WebSphere Application Server.
      1. Starten Sie den Server.
      2. Melden Sie sich bei der Integrated Solutions Console von WebSphere Application Server unter https://Hostname:9043/ibm/console/logon.jsp an.
      3. Klicken Sie auf Anwendungen > Anwendungstypen > WebSphere-Unternehmensanwendungen.
      4. Stoppen Sie die folgenden Anwendungen und deinstallieren Sie sie: relm.war, relmhelp.war, vvc.war, lqe.war, SPARQL_Gateway.war.
      5. Speichern Sie die Änderungen an der Masterkonfiguration, wenn Sie dazu aufgefordert werden.
    4. Aktualisieren Sie die angepassten Eigenschaften JAZZ_HOME und log4j.configuration.
      1. Melden Sie sich bei der Integrated Solutions Console von WebSphere Application Server unter https://Hostname:9043/ibm/console/logon.jsp an.
      2. Klicken Sie auf Server > Servertypen > WebSphere-Anwendungsserver.
      3. Klicken Sie auf den Servernamen, um den Server zu öffnen. Der Standardservername ist server1.
      4. Klicken Sie im Abschnitt Serverinfrastruktur auf Java- und Prozessverwaltung > Prozessdefinition.
      5. Klicken Sie unter Weitere Eigenschaften auf Java Virtual Machine.
      6. Ändern Sie den Pfad für Lifecycle Query Engine und für Jazz Reporting Service. Geben Sie die neue Position an.
      7. 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

      8. Klicken Sie unter Weitere Eigenschaften auf Angepasste Eigenschaften.
      9. 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.

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

      11. Wenn Sie eine Verbindung zu einer Oracle-Datenbank herstellen, muss ORACLE_JDBC_DRIVER_FILE auf die richtige JDBC-Treiberdatei verweisen.
      12. Speichern Sie die Änderungen an der Masterkonfiguration, wenn Sie dazu aufgefordert werden.
    5. Legen Sie die gemeinsam genutzte Jazz Reporting Service-Bibliothek fest.
      1. Rufen Sie in der Administrationskonsole Umgebung > Gemeinsame Bibliotheken auf.
      2. Klicken Sie in der Liste auf Gemeinsame JRS-Bibliothek.
      3. Ä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

      4. 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.
    6. Stoppen Sie WebSphere Application Server.
      • Linux Führen Sie den Befehl stopServer.sh aus.
      • Windows Führen Sie den Befehl stopServer.bat aus.
    7. 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.

      • Linux
        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)
      • Windows
        WAS-Profilstammverzeichnis\wscache (z. B.: C:\IBM\WebSphere\AppServer\profiles\AppSrv01\wscache)
        WAS-Profilstammverzeichnis\temp (z. B.: C:\IBM\WebSphere\AppServer\profiles\AppSrv01\temp)
    8. 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:
      • Linux opt/IBM/WebSphere/AppServer/profiles/AppSrv01/logs
      • Windows C:\IBM\WebSphere\AppServer\profiles\AppSrv01\logs
    9. Starten Sie Ihren WebSphere Application Server.
      • Linux Führen Sie den Befehl startServer.sh aus.
      • Windows Führen Sie den Befehl startServer.bat aus.
  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
    • Wenn Sie das Tomcat-Upgrade überspringen möchten, müssen Sie die folgenden Parameter zum Script vvc_upgrade hinzufügen:
      -oldApplicationHome oldRELMHome/server/conf -ignoreJTSVersionCheck -updateTomcatFiles=no
    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.
  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. Implementieren Sie die Dateien relm.war, relmhelp.war, vvc.war, lqe.war und SPARQL_Gateway.war.
    1. Wählen Sie in der Administrationskonsole von WebSphere Application Server die Optionen Anwendungen > Anwendungstypen > WebSphere-Unternehmensanwendungen aus.
    2. Klicken Sie auf der Seite Unternehmensanwendungen auf Installieren.
    3. Wählen Sie unter Pfad der neuen Anwendung $newRELMHome/server/webapps/relm.war aus und klicken Sie auf Öffnen.
    4. Wählen Sie Schnell und anschließend Weiter aus.
    5. 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.
    6. In einer Nachricht wird Ihnen mitgeteilt, dass relm.war erfolgreich installiert wurde. Klicken Sie auf In Masterkonfiguration speichern.
    7. 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.
    8. 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.
    9. Richten Sie Ihren WebSphere Application Server für Lifecycle Query Engine ein und implementieren Sie die Datei lqe.war.
    10. 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.
    11. Fügen Sie die Jazz Reporting Service-Bibliotheksreferenz hinzu.
      1. Wählen Sie Anwendungen > Anwendungstypen > WebSphere-Unternehmensanwendungen aus und klicken Sie in der Liste der Anwendungen auf SPARQL_Gateway_war.
      2. Klicken Sie im Abschnitt Referenz auf Referenzen auf gemeinsam genutzte Bibliotheken.
      3. Wählen Sie das Kontrollkästchen neben SPARQL_Gateway_war aus und klicken Sie auf Gemeinsam genutzte Bibliotheken referenzieren.
      4. Wählen Sie die Gemeinsame JRS-Bibliothek aus und klicken Sie auf den Rechtspfeil.
      5. Klicken Sie auf OK. Klicken Sie anschließend noch einmal auf OK, um Ihre Einstellungen in der Masterkonfiguration zu speichern.
    12. Stellen Sie sicher, dass die Jazz Reporting Service-Reihenfolge für das Laden der Klassen ordnungsgemäß konfiguriert ist.
      1. Wählen Sie Anwendungen > Anwendungstypen > WebSphere-Unternehmensanwendungen aus und klicken Sie in der Liste der Anwendungen auf SPARQL_Gateway_war.
      2. Klicken Sie im Abschnitt Detaileigenschaften auf Laden von Klassen und Erkennung von Dateiaktualisierungen.
      3. Wählen Sie im Abschnitt Reihenfolge der Klassenladeprogramme die Option Mit dem lokalen Klassenladeprogramm geladene Klassen zuerst (übergeordneter zuletzt) aus.
      4. Klicken Sie auf OK und dann auf In Masterkonfiguration speichern.
    13. Starten Sie WebSphere Application Server erneut.
  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 Anwendungsserver erneut.
    • Linux Führen Sie die Befehle stopServer.sh und startServer.sh aus.
    • Windows Führen Sie die Befehle stopServer.bat und startServer.bat aus.
  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