In diesem Artikel finden Sie die erforderlichen Schritte für die Durchführung des Upgrades von Rational Team Concert (RTC)
Version 3.0 auf die Anwendungen der
Rational-Lösung für
Collaborative Lifecycle Management (CLM) Version 4.0 in einem Setup mit einem Tomcat Application Server
und
und DB2 für z/OS.
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 RTC Version
3.0 auf eine Konfiguration der CLM-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
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 auf Version 4 keine vorläufigen Programmkorrekturen (PTFs) gibt.
- Sichern Sie die Repositorys von Version
3.0 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 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.
- 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 erfolgreich erstellt wurden.
- 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 unterscheiden, damit die Upgradedienstprogramme
die beiden Versionen zusammenführen kann. Wenn das Konfigurationsverzeichnis für
Version 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.
- Erstellen Sie in
DB2 für z/OS eine neue Datenbank mit der Bezeichnung RIDW, die als Data Warehouse
verwendet werden soll, und gewähren Sie Zugriffsrechte für die Datenbank. Einzelheiten hierzu
enthält der Artikel DB2 für z/OS für die Verwendung mit Jazz Team Server konfigurieren.
- 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 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 3.0 erneut manuell angepasst werden.
- Migrieren Sie die
JTS-Konfiguration. Nehmen Sie die Einstellungen aus der Konfigurationsdatei der Version 3.0 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 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 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.
- Stoppen Sie den Tomcat-Server von RTC Version 3.
- Kopieren Sie wie folgt die Indexdateien:
- Kopieren Sie Ihre JFS- und Textindizes von Version 3 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
Öffnen Sie eine Eingabeaufforderung und geben Sie den folgenden Befehl ein, um die Indizes von Version 3 in Version 4 zu kopieren: cp -R <3.0-Konfigurationsverzeichnis>/jts/indices <4.0-Konfigurationsverzeichnis>/jts/indices
cp -R <3.0-Konfigurationsverzeichnis>/ccm/indices <4.0-Konfigurationsverzeichnis>/ccm/indices
Bearbeiten Sie die Datei teamserver.properties von JTS und von CCM. 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.
- Konfigurieren Sie bei Bedarf
das Data Warehouse. Bearbeiten Sie die Datei teamserver.properties von JTS und CCM. 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 und von CCM 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
- Falls Sie die Datei teamserver.properties für das Data Warehouse aktualisiert haben, erstellen Sie ein Data-Warehouse-Repository.
Modifizieren Sie dazu den Member
BLZCREDB des Beispiels SBLZSAMP von Version 4 und übergeben Sie ihn, um die Data-Warehouse-Tabellen zu
erstellen. Setzen Sie die Anwendungsvariable @appl@
auf jts. Der Repository-Tools-Befehl (@repotoolsCommand@) ist -createWarehouse.
- 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.
- Falls Sie die Anwendung Quality Management (QM) oder Requirements
Management (RM) hinzufügen möchten, befolgen Sie die Anweisungen für eine Neuinstallation.
Einzelheiten hierzu enthält der Artikel Jazz Team Server und die Anwendungen der Rational-Lösung für Collaborative Lifecycle Management unter z/OS installieren und konfigurieren.