Upgrade für den Version der Version 3.0.1.x mit Tomcat und DB2 für z/OS durchführen

In diesem Artikel finden Sie die erforderlichen Schritte für die Durchführung des Upgrades für den Server von Version 3.0.1.x der Rational-Lösung für Collaborative Lifecycle Management (CLM) in einem Setup mit einem Tomcat Application Server und und DB2 für z/OS auf Version 4.0.

Vorbereitende Schritte

Erstellen Sie Kopien der BLZSAMP-Member, sodass Sie sich die Originaldateien gegebenenfalls erneut ansehen können. Prüfen Sie nach Übergabe der Jobs die Jobprotokolle für die Beispiele. Der erwartete Rückkehrcode ist 0.

Informationen zu diesem Vorgang

Mit den folgenden Schritten wird die Konfiguration von Version 3.0.1.x auf eine Konfiguration der Version 4.0 umgestellt.

Vorgehensweise

  1. Führen Sie eine SMP/E-Installation des Pakets mit CLM Version 4 durch. Die Konfiguration der Version 4 muss sich an einer anderen Position als die von Version 3.0.1.x befinden. Mit der Installation des SMP/E-Pakets stehen neue Datenbanksicherungstools bereit, die für den Upgradeprozess verwendet werden. Einzelheiten hierzu enthält der Artikel Übersicht über den SMP/E-Installationsprozess.
    Anmerkung: Die FMIDs haben sich in Version 4 geändert, sodass es für das Upgrade von Version 3.0.1.x auf Version 4 keine vorläufigen Programmkorrekturen (PTFs) gibt.
  2. Stoppen Sie alle Server der Version 3.0.1.x.
  3. Sichern Sie die Repositorys von Version 3.0.1.x mit den zu DB2 für z/OS bereitgestellten Dienstprogrammen UNLOAD und LOAD. Ausführliche Informationen hierzu enthält der Artikel DB2-Entladeprozess und -Ladeprozess für Sicherungen verwenden. Zum Erstellen der Sicherungskopien können Sie auch andere Tools verwenden, solange diese getestet und als geeignet bestätigt sind.
    Wichtig: Sie müssen Sicherungskopien Ihrer Repositorys erstellen, bevor Sie das Upgrade durchführen, weil der Upgradeprozess Änderungen am Repository-Modell vornimmt, die nicht rückgängig gemacht werden können.
    1. Führen Sie die Schritte für UNLOAD und LOAD für eine neue Datenbank und ein neues Schemapräfix aus, um das Funktionieren der Sicherungs- und Wiederherstellungsprozedur zu verifizieren.
    2. Erstellen Sie mit dem Beispieljob BLZCREDB der Version 3.0.1.x die Tabellen in den neuen Datenbanken.
    3. Erstellen Sie für jedes Repository weitere Datenbanken, um die Sicherungs- und Wiederherstellungsverfahren für Datenbanken vollumfänglich zu testen. Für die neu erstellten Datenbanken müssen dieselben Berechtigungen wie für die bereits vorhandenen Datenbanken festgelegt sein.
    4. Eine Kopie eines Data Warehouse müssen Sie in einem anderen DB2-z/OS-Subsystem wiederherstellen, weil es in einem Subsystem nicht zwei Data Warehouses geben kann.
    5. Erstellen Sie für jede Datenbank separate USS-Verzeichnisse (ussWorkDir).
    6. Verwenden Sie Repository-Schemapräfixe mit derselben Anzahl Zeichen.
    7. Vergewissern Sie sich vor dem eigentlichen Upgrade, dass die neuen Repositorys der Version 3.0.1.x erfolgreich erstellt wurden.
  4. Konfigurieren Sie einen Tomcat-Server. Modifizieren Sie dazu den Member BLZPOPT des Beispiels SBLZSAMP von Version 4 und übergeben Sie den Member, um eine neue Konfigurationsstruktur und ein neues Arbeitsverzeichnis für den Tomcat-Server zu erstellen. Die Konfigurationsverzeichnisse müssen andere als in der Installation von Version 3.0.1.x sein. Befolgen Sie die Anweisungen im Beispiel-Member oder lesen Sie den Artikel Zusätzliche Verzeichnisse für Jazz Team Server und die Anwendungen der Rational-Lösung für Collaborative Lifecycle Management erstellen.
  5. Konfigurieren Sie Jazz Team Server (JTS). Modifizieren und übergeben Sie den Member BLZCPJTS des Beispiels SBLZSAMP von Version 4, um das Verzeichnis mit der Serverkonfigurationsstruktur und das Arbeitsverzeichnis sowie die Anwendung Lifecycle Project Administration einzurichten.
    Anmerkung: Das für Version 4 erstellte Konfigurationsverzeichnis (JAZZ_HOME) und Arbeitsverzeichnis müssen sich von den entsprechenden Verzeichnissen der Version 3.0.1.x unterscheiden, damit die Upgradedienstprogramme die beiden Versionen zusammenführen kann. Wenn das Konfigurationsverzeichnis für Version 3.0.1.x beispielsweise /etc/jazz ist, könnten Sie für Version 4 /etc/jazz40 verwenden. Für das Arbeitsverzeichnis könnten Sie analog /u/jazz40 verwenden.
    Befolgen Sie die Anweisungen im Beispiel-Member oder lesen Sie den Artikel Zusätzliche Verzeichnisse für Jazz Team Server und die Anwendungen der Rational-Lösung für Collaborative Lifecycle Management erstellen.
  6. Konfigurieren Sie Change and Configuration Management (CCM) Server. Modifizieren und übergeben Sie dazu den Member BLZCPCCM des Beispiels SBLZSAMP von Version 4, um die neue Serverkonfigurations- und Arbeitsverzeichnisstruktur mit CCM-Definitionen einzurichten. Befolgen Sie die Anweisungen im Beispiel-Member oder lesen Sie den Artikel Zusätzliche Verzeichnisse für Jazz Team Server und die Anwendungen der Rational-Lösung für Collaborative Lifecycle Management erstellen.
  7. Konfigurieren Sie Quality Management (QM) Server. Modifizieren und übergeben Sie dazu den Member BLZCPQM des Beispiels SBLZSAMP von Version 4, um die neue Serverkonfigurations- und Arbeitsverzeichnisstruktur mit QM-Definitionen einzurichten. Befolgen Sie die Anweisungen im Beispiel-Member.
  8. Konfigurieren Sie Requirements Management (RM) Server. Modifizieren und übergeben Sie dazu den Member BLZCPRM des Beispiels SBLZSAMP von Version 4, um die neue Serverkonfigurations- und Arbeitsverzeichnisstruktur mit RM-Definitionen einzurichten. Befolgen Sie die Anweisungen im Beispiel-Member.
  9. Implementieren Sie die Anwendungen. Starten und stoppen Sie dazu den Tomcat-Server von Version 4 (oder implementieren Sie die Dateien ccm.war und jts.war).
    Anmerkung: Falls die web.xml-Dateien der Anwendungen von Version 3.0.1.x angepasst wurden (um beispielsweise Unterstützung für eine LDAP-Registry zu bieten), werden Sie diese angepassten Dateien in den verbleibenden Schritten auf die Anwendungen von Version umstellen und die Datei web.xml in jeder einzelnen Anwendung modifizieren. Die .war-Dateien sind jedoch signiert. Modifizierungen können daher nur in der implementierten Version einer .war-Datei vorgenommen werden. Wenn die Anwendungen nach der Migration erneut implementiert werden, müssen die Dateien von Version 4 erneut manuell angepasst werden.
  10. Migrieren Sie die JTS-Konfiguration. Nehmen Sie die Einstellungen aus der Konfigurationsdatei der Version 3.0.1.x mit den Repository Tools in die JTS-Konfigurationsdateien von Version 4 auf. Modifizieren Sie dazu den Member BLZJTSU des Beispiels SBLZSAMP von Version 4. Führen Sie vor Übergabe des Jobs BLZJTSU die folgenden Schritte aus:
    1. Ersetzen Sie den Wert der Variablen @pathPrefix@. Die Variable muss auf das Pfadpräfix der Binärdateien von Version 4 zeigen.
      Anmerkung: Der von diesem Beispiel-Member verwendete Repository-Tools-Befehl migration_jts_updateConfigurationFiles ist in Version 3.0.1 neu hinzugekommen. Falls @pathPrefix@ auf frühere Versionen zeigt, verwendet der Repository-Tools-Befehl nicht den Aktualisierungsbefehl für Version 4.
    2. Befolgen Sie die Anweisungen im Beispiel-Job BLZJTSU.
    Übergeben Sie den Job BLZJTSU und prüfen Sie die Jobausgabe sowie die aktualisierte Eigenschaftendatei.
    Anmerkung: Data-Warehouse-Eigenschaften, die auf ein Derby-Data-Warehouse zeigen, bleiben bei dieser Zusammenführung erhalten und werden in einem späteren Schritt bearbeitet.
  11. Migrieren Sie die CCM-Server-Konfiguration. Nehmen Sie die Einstellungen aus der Konfigurationsdatei der Version 3.0.1.x mit den Repository Tools in die CCM-Konfigurationsdateien von Version 4 auf. Modifizieren Sie dazu den Member BLZCCMU des Beispiels SBLZSAMP von Version 4. Führen Sie vor Übergabe des Jobs BLZCCMU die folgenden Schritte aus:
    1. Ersetzen Sie die folgende Zeile: applicationContextRoot=jazz durch diese Zeile: applicationContextRoot=ccm. Sofern der Server der Version 3.0.1.x nicht ein von Version 2.x migrierter Server ist, müsste der Anwendungskontext /ccm lauten.
    2. Ersetzen Sie den Wert der Variablen @pathPrefix@. Die Variable muss auf das Pfadpräfix der Binärdateien von Version 4 zeigen.
      Anmerkung: Der von diesem Beispiel-Member verwendete Repository-Tools-Befehl migration_ccm_updateConfigurationFiles ist in Version 3.0.1.x neu hinzugekommen. Falls @pathPrefix@ auf frühere Versionen zeigt, verwendet der Repository-Tools-Befehl nicht den Aktualisierungsbefehl für Version 4.
    3. Befolgen Sie die Anweisungen im Beispiel-Job BLZCCMU.
    Übergeben Sie den Job BLZCCMU und prüfen Sie die Jobausgabe sowie die aktualisierte Eigenschaftendatei.
    Anmerkung: Data-Warehouse-Eigenschaften, die auf ein Derby-Data-Warehouse zeigen, bleiben bei dieser Zusammenführung erhalten und werden in einem späteren Schritt bearbeitet.
  12. Migrieren Sie die QM-Server-Konfiguration. Nehmen Sie die Einstellungen aus der Konfigurationsdatei der Version 3.0.1.x mit den Repository Tools in die QM-Konfigurationsdateien von Version 4 auf. Modifizieren Sie dazu den Member BLZQMU des Beispiels SBLZSAMP von Version 4. Führen Sie vor Übergabe des Jobs BLZQMU die folgenden Schritte aus:
    1. Ersetzen Sie den Wert der Variablen @pathPrefix@. Die Variable muss auf das Pfadpräfix der Binärdateien von Version 4 zeigen.
      Anmerkung: Der von diesem Beispiel-Member verwendete Repository-Tools-Befehl migration_qm_updateConfigurationFiles ist in Version 3.0.1.x neu hinzugekommen. Falls @pathPrefix@ auf frühere Versionen zeigt, verwendet der Repository-Tools-Befehl nicht den Aktualisierungsbefehl für Version 4.
    2. Befolgen Sie die Anweisungen im Beispiel-Job BLZQMU.
    Übergeben Sie den Job BLZQMU und prüfen Sie die Jobausgabe sowie die aktualisierte Eigenschaftendatei.
    Anmerkung: Data-Warehouse-Eigenschaften, die auf ein Derby-Data-Warehouse zeigen, bleiben bei dieser Zusammenführung erhalten und werden in einem späteren Schritt bearbeitet.
  13. Migrieren Sie die RM-Server-Konfiguration. Nehmen Sie die Einstellungen aus der Konfigurationsdatei der Version 3.0.1.x mit den Repository Tools in die RM-Konfigurationsdateien von Version 4 auf. Modifizieren Sie dazu den Member BLZRMU des Beispiels SBLZSAMP von Version 4. Führen Sie vor Übergabe des Jobs BLZRMU die folgenden Schritte aus:
    1. Ersetzen Sie den Wert der Variablen @pathPrefix@. Die Variable muss auf das Pfadpräfix der Binärdateien von Version 4 zeigen.
      Anmerkung: Der von diesem Beispiel-Member verwendete Repository-Tools-Befehl migration_rm_updateConfigurationFiles ist in Version 3.0.1.x neu hinzugekommen. Falls @pathPrefix@ auf frühere Versionen zeigt, verwendet der Repository-Tools-Befehl nicht den Aktualisierungsbefehl für Version 4.
    2. Befolgen Sie die Anweisungen im Beispiel-Job BLZRMU.
    Übergeben Sie den Job BLZRMU und prüfen Sie die Jobausgabe sowie die aktualisierte Eigenschaftendatei.
    Anmerkung: Data-Warehouse-Eigenschaften, die auf ein Derby-Data-Warehouse zeigen, bleiben bei dieser Zusammenführung erhalten und werden in einem späteren Schritt bearbeitet.
  14. Kopieren Sie wie folgt die Indexdateien:
    1. Kopieren Sie Ihre JFS- und Textindizes von Version 3.0.1.x in Version 4. Bei verteilten Systemen müssen Sie die Dateien vom entsprechenden Server kopieren.
      • Öffnen Sie eine Eingabeaufforderung und geben Sie den folgenden Befehl ein, um das Standardverzeichnis mit den Indizes der Version 4.0 zu bereinigen:
        rm -rf <4.0-Konfigurationsverzeichnis>/jts/indices
        rm -rf <4.0-Konfigurationsverzeichnis>/ccm/indices
        rm -rf <4.0-Konfigurationsverzeichnis>/qm/indices
      • Öffnen Sie eine Eingabeaufforderung und geben Sie den folgenden Befehl ein, um die Indizes von Version 3.0.1.x in Version 4 zu kopieren:
        cp -R <3.0.1.x-Konfigurationsverzeichnis>/jts/indices <4.0-Konfigurationsverzeichnis>/jts/indices
        cp -R <3.0.1.x-Konfigurationsverzeichnis>/ccm/indices <4.0-Konfigurationsverzeichnis>/ccm/indices
        cp -R <3.0.1.x-Konfigurationsverzeichnis>/qm/indices <4.0-Konfigurationsverzeichnis>/qm/indices
      Bearbeiten Sie die Datei teamserver.properties von JTS, von CCM und von QM. Stellen Sie sicher, dass die Eigenschaften com.ibm.team.fulltext.indexLocation und com.ibm.team.jfs.index.root.directory die richtige Position angeben.
  15. Führen Sie ein Upgrade für die JTS-Datenbank durch. Fügen Sie mit den Repository Tools Datenbanktabellen der Version 4.0 zum JTS-Repository hinzu. Modifizieren Sie dazu den Member BLZADDTB des Beispiels SBLZSAMP von Version 4 und übergeben Sie eine Kopie dieses Members. Die Anwendungsvariable @appl@ sollte auf jts gesetzt sein. Befolgen Sie die im Beispiel-Member angegebenen Anweisungen und überprüfen Sie die Jobausgabe sorgfältig.
  16. Führen Sie ein Upgrade für die CCM-Datenbank durch. Wenn Sie die Anwendung CCM konfiguriert haben, fügen Sie mit den Repository Tools Datenbanktabellen der Version 4.0 zum CCM-Repository hinzu. Modifizieren Sie dazu den Member BLZADDTB des Beispiels SBLZSAMP von Version 4 und übergeben Sie eine Kopie dieses Members. Die Anwendungsvariable @appl@ sollte auf ccm gesetzt sein. Befolgen Sie die im Beispiel-Member angegebenen Anweisungen und überprüfen Sie die Jobausgabe sorgfältig.
  17. Führen Sie ein Upgrade für die QM-Datenbank durch. Wenn Sie die Anwendung QM konfiguriert haben, fügen Sie mit den Repository Tools Datenbanktabellen der Version 4.0 zum QM-Repository hinzu. Modifizieren Sie dazu den Member BLZADDTB des Beispiels SBLZSAMP von Version 4 und übergeben Sie eine Kopie dieses Members. Die Anwendungsvariable @appl@ sollte auf qm gesetzt sein. Befolgen Sie die im Beispiel-Member angegebenen Anweisungen und überprüfen Sie die Jobausgabe sorgfältig.
  18. Konfigurieren Sie bei Bedarf das Data Warehouse. Bearbeiten Sie die Datei teamserver.properties von JTS, von CCM und von QM. Nehmen Sie in die Dateien Einstellungen für das Data-Warehouse-Repository auf. Verwenden Sie in allen drei Dateien dieselben Einstellungen.
    Wichtig: Falls Sie jetzt kein eigenständiges Data Warehouse implementieren, können Sie diesen Schritt auslassen. Sie müssen dann allerdings auch die Data-Warehouse-Konfiguration im Setup-Assistenten für Jazz Team Server übergehen.
    Wenn Sie das Data Warehouse jetzt konfigurieren, müssen Sie die Datei teamserver.properties von JTS, von CCM und von QM aktualisieren. Sie müssen in die Dateien db2z-Data-Warehouse-Parameter aufnehmen und alle vorhandenen Derby-Data-Warehouse-Eigenschaften entfernen. Setzen Sie sie wie im folgenden Beispiel mit dem Zeichen # auf Kommentar:
    #com.ibm.team.datawarehouse.db.net.port
    #com.ibm.team.datawarehouse.db.vendor=DERBY (oder derby_net)
    #com.ibm.team.datawarehouse.db.jdbc.location=/VerzeichnisUnterIhremArbeitsverzeichnis oder
    #com.ibm.team.datawarehouse.db.jdbc.location=//localhost\:1527// ...
    Fügen Sie die folgenden Informationen hinzu:
    com.ibm.team.datawarehouse.db.vendor = db2z
    com.ibm.team.datawarehouse.db.jdbc.location=//ipAddress:ipPort/location:user=jazzDBuser;password={password};
    com.ibm.team.datawarehouse.db.jdbc.password=jazzDBpswd
    # Datenbankbenutzer, dem die entsprechenden Berechtigungen eingeräumt werden.
    com.ibm.team.datawarehouse.report.user = RPTUSER
    com.ibm.team.datawarehouse.db.db2.dsn.dbname=RIDW 
  19. Führen Sie ein Upgrade für das Data Warehouse durch. Wenn Sie das Data Warehouse konfiguriert haben, führen Sie mit den Repository Tools ein Upgrade für das Data-Warehouse-Repository durch. Modifizieren Sie dazu den Member BLZDWHUP des Beispiels SBLZSAMP von Version 4 und übergeben Sie eine Kopie dieses Members. Befolgen Sie die im Beispiel-Member angegebenen Anweisungen und überprüfen Sie die Jobausgabe sorgfältig.
  20. Starten Sie die Tomcat-Server von Version 4. Modifizieren und übergeben Sie dazu den Member BLZSRVD des Beispiels SBLZSAMP von Version 4. Stellen Sie sicher, dass die Variable @confPath@ für das Konfigurationsverzeichnis und die Variable @workPath@ für das Arbeitsverzeichnis auf die neuen Verzeichnisse von Version 4 gesetzt sind.
  21. Aktivieren Sie wie folgt Lizenzen:
    1. Melden Sie sich als Administrator bei Jazz Team Server 4.0 an.
    2. Wechseln Sie zur Seite Serveradministration> Lizenzschlüsselverwaltung und aktivieren Sie Lizenzen.
      Anmerkung: Die Ausführung des Befehls setup auf dem System mit der Version 4.0 ist unnötig, denn es ist bereits alles eingerichtet.
    Lizenzhinweise:
    • Bei Meilensteinreleases müssen Sie die Lizenzen für den Vorabzugriff aktivieren, die mit dem Meilenstein zusammen ausgeliefert werden.
    • Für das endgültige Release 4.0 müssen Sie neue Lizenzen kaufen. Lizenzen für Version 4 sind mit Anwendungen der Version 3 kompatibel. Anwendungen der Version 4 können jedoch nicht mit Lizenzen für Version 3 verwendet werden. Weitere Informationen hierzu finden Sie in Lizenzen verwalten.
  22. Migrieren Sie Rational Requirements Composer (RRC). Wenn Sie die Anwendung RM konfiguriert haben, müssen Sie wie folgt das RM-Onlinemigrationsdienstprogramm ausführen:
    1. Öffnen Sie einen Browser, löschen Sie den Browsercache und navigieren Sie zum Webclient von RM. Geben Sie im folgenden URL den Namen und die Port-Nummer des Servers an: https://Servername:Port/rdm/web/projects/migration. Der Standard-Port ist 9443. Die Seite erkennt, dass gerade eine Migration durchgeführt wird, und startet den Migrationsassistenten.
    2. Akzeptieren Sie für Rational Requirements Composer die Clientzugriffslizenz für Analysten.
    3. Klicken Sie auf Anzeige 'Migrationsservice' öffnen und wählen Sie den Migrationsassistenten für die Migration von Rational Requirements Composer aus. Auf der Migrationswebseite erhält der Administrator Statusinformationen, sodass er während der Migration sehen kann, welcher Speicherbereich gerade verarbeitet wird und wann mit der Indexierung begonnen wird.
      Wichtig: Eine einmal gestartete Migration kann nicht abgebrochen werden. Sie läuft bis zum Abschluss durch.
      Nach der Migration werden die Daten von Rational Requirements Composer neu indexiert.
    4. Wenn der neue Index erstellt ist, führt die Anwendung Gültigkeits- und Konsistenzprüfungen für die migrierten Daten durch und gibt dem Administrator Rückmeldungen.
    5. Wenn eine Nachricht anzeigt, dass die Migration abgeschlossen ist, klicken Sie auf Schließen. Sie werden zur Anwendung RRC weitergeleitet.
    Weitere Details hierzu enthält der Artikel Upgradeschritte für die Onlinemigration.

Feedback