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
- 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.
- Stoppen Sie alle Server der Version 3.0.1.x.
- 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.
- 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.
- Erstellen Sie mit dem Beispieljob BLZCREDB der Version 3.0.1.x die Tabellen in den neuen Datenbanken.
- 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.
- 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.
- Erstellen Sie für jede Datenbank separate USS-Verzeichnisse
(ussWorkDir).
- Verwenden Sie Repository-Schemapräfixe mit derselben Anzahl Zeichen.
- Vergewissern Sie sich vor dem eigentlichen Upgrade, dass die neuen Repositorys der Version 3.0.1.x erfolgreich erstellt wurden.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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:
- 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.
- 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.
- 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:
- 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.
- 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.
- 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.
- 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:
- 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.
- 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.
- 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:
- 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.
- 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.
- Kopieren Sie wie folgt die Indexdateien:
- 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.
- 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.
- 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.
- 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.
- 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
- 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.
- 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.
- Aktivieren Sie wie folgt Lizenzen:
- Melden Sie sich als Administrator bei Jazz Team Server 4.0 an.
- 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.
- Migrieren Sie Rational Requirements
Composer (RRC). Wenn Sie die Anwendung RM konfiguriert haben, müssen Sie wie folgt das
RM-Onlinemigrationsdienstprogramm ausführen:
- Ö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.
- Akzeptieren Sie für Rational Requirements Composer die Clientzugriffslizenz für Analysten.
- 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.
- 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.
- 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.