In diesem Artikel sind die erforderlichen Schritte für ein Upgrade von
Jazz Team Server und Change and Configuration Management Version
3.0 auf Version 3.0.1 beschrieben.
Vorbereitende Schritte
Bevor Sie ein Serverupgrade durchführen, müssen Sie sicherstellen, dass eine vollständig, aktuelle und gültige Sicherung
Ihrer Repository-Datenbank von Rational Team Concert und Jazz Team Server Version 3.0 vorhanden ist.
Stellen Sie außerdem
mit dem Network Time Protocol (NTP) sicher, dass die Systemzeit auf allen Maschinen
synchron ist. Zeit ist ein kritisches Element, mit dem ein Ereignis auf einem Netzknoten einem entsprechenden Ereignis
auf einem anderen Knoten zugeordnet werden kann. Durch eine Unternehmensimplementierung des NTP-Service können Sie Probleme durch die Systemzeit
vermeiden. Weitere Informationen zu
NTP finden Sie unter http://www.ntp.org/. Alle Server müssen außerdem
dieselbe Methode der Benutzerauthentifizierung verwenden.
Falls Sie für mehrere Produkte ein Upgrade durchführen wollen,
lesen Sie den Artikel Upgradereihenfolge. Die dort enthaltenen Informationen helfen Ihnen bei der Entscheidung,
welches Produktupgrade zuerst durchgeführt werden muss.
Wichtig: Wenn Sie das Upgrade-Script in einer verteilten Umgebung verwenden möchten,
in der Sie die Anwendung
Change and Configuration Management unabhängig vom Jazz Team Server installieren,
muss das Upgrade-Script auf das Laufwerk oder Dateisystem mit
dem installierten Jazz Team Server zugreifen
können. Unter Windows muss die Zuordnung beispielsweise das Format <Buchstabe des zugeordneten
Laufwerks>:\server\conf haben.
Ein absoluter Pfad (\\<Maschinenname>\<Installationsverzeichnis>\server\conf)
funktioniert nicht. Das angehängte Laufwerk muss mit Lese-, Schreib- und Ausführungsrechten für den Administratoraccount konfiguriert sein.
Wenn Sie die Derby-Datenbank verwenden, müssen Sie die Datenbanken von JTS und CCM
Version 3.0 in Version 3.0.1 kopieren. Weitere Informationen finden Sie im Artikel
Derby-Datenbank sichern und wiederherstellen.
Anmerkung: Falls Sie dieselbe Datenbank verwenden, ist keine Datenmigration erforderlich. Wenn Sie während des Upgrades jedoch zu einer anderen Datenbank
wechseln, müssen Sie Ihre Daten aus der vorherigen Datenbank exportieren und in die neue Datenbank
importieren.
Upgrade für Jazz Team Server (JTS) durchführen
- Informieren Sie sich bei Bedarf anhand der Artikel im Abschnitt Implementierung und Upgrade planen.
- Fahren Sie den Server mit JTS 3.0 herunter.
- Wenn Sie Jazz Team Server noch nicht im Rahmen einer
CLM-Installation installiert haben, installieren Sie Jazz Team Server jetzt an einer neuen Plattenposition. Wenn Sie Jazz Team Server schon installiert und ein Upgrade auf Version
3.0.1 durchgeführt haben und jetzt die Anwendung Change and Configuration
Management installieren und das Upgrade für diese Anwendung durchführen möchten, fahren Sie mit dem Artikel Upgrade für Change and Configuration Management (CCM) durchführen fort.
- Wählen Sie während der Installation Standardkontextstammverzeichnisse für Anwendungen von Version 3.x verwenden aus.
- Wählen Sie am Ende der Installation bei Anzeige der Frage Welches Programm möchten Sie starten? die Option Kein aus.
- Navigieren Sie zu <3.0.1-JTS-Installationsverzeichnis>/server und
führen Sie den folgenden Befehl aus:
Anmerkung: Sie können für die Script-Ausführung alle Argumente in der Befehlszeile
angeben. Wenn Sie das Script mehrere Male ausführen müssen, können Sie alternativ die Datei mit den Script-Parametern bearbeiten und
dann eine entsprechend kürzere Befehlszeile eingeben.
Anweisungen für die Parameterdatei enthält der nächste optionale Schritt.
Wichtig: Die Script-Datei befindet sich im Verzeichnis upgrade, muss jedoch im Verzeichnis server ausgeführt werden. Falls Ihr Pfad Leerzeichen enthält, müssen Sie ihn in Anführungszeichen setzen.
Windows
upgrade\jts_upgrade.bat -oldJTSHome
<3.0-JTS-Installationsverzeichnis>\server\conf
UNIX
upgrade/jts_upgrade.sh -oldJTSHome <3.0-JTS-Installationsverzeichnis>/server/conf
Weitere
Informationen zu den Befehlszeilenoptionen enthält der Artikel jts_upgrade.
Das Script führt die folgenden Schritte mit den angegebenen
Benutzerinteraktionen aus:
- Es führt den Befehl -migration_jts_updateConfigurationFiles aus und aktualisiert die Konfigurationsdateien und die
Tomcat-Dateien. Geben Sie [E] für die Ausführung des Befehls oder [S] zum Überspringen des Schritts ein oder brechen Sie die Script-Ausführung mit [Eingabetaste] ab.
- Geben Sie nach erfolgreicher Zusammenführung der Konfigurationsdateien zum Fortfahren [C] ein. Ein Editorfenster (oder auf UNIX-Systemen ein Editor vi) wird geöffnet, in dem Sie
die Datei teamserver.properties
von Jazz Team Server prüfen können. Prüfen Sie, ob das von der Eigenschaft com.ibm.team.repository.server.webapp.url angegebene Stammelement des öffentlichen URI stimmt. Prüfen Sie außerdem, ob die Datenbankeigenschaften korrekt sind. Speichern Sie ggf. vorgenommene Änderungen. Schließen Sie dann den Editor und fahren Sie mit der Script-Ausführung fort.
Wichtig: Ändern Sie
nicht die Eigenschaften für die Verbindung zur Data-Warehouse-Datenbank, auch dann nicht, wenn diese zurzeit auf Derby gesetzt sind. Modifizieren Sie diese Eigenschaften nur mit dem
Konfigurationsassistenten für den Server.
Weitere Informationen zur Überprüfung der Konfigurationsdateien enthält
der Artikel Konfigurationsdateien während des Upgrades überprüfen.
- Fahren Sie mit der Script-Ausführung fort, bis eine Nachricht erscheint, dass das Upgrade für JTS erfolgreich durchgeführt wurde.
- Optional: Alternativ zum vorherigen Schritt können Sie die Parameterdatei des Scripts öffnen, die Standardwerte
modifizieren und für die Ausführung dann eine verkürzte Befehlszeile verwenden.
Die englische Version und übersetzte Versionen der
Dateien jts_params befinden sich im Verzeichnis
<3.0.1-JTS-Installationsverzeichnis>/server/upgrade/params.
- Wenn Sie den genauen Namen der in Ihre Sprache übersetzten Parameterdatei abrufen möchten, führen Sie im Verzeichnis
<3.0.1-JTS-Installationsverzeichnis>\server\upgrade den Befehl
locale.bat -jts -showParamFileName (unter Windows)
oder locale.sh -jts -showParamFileName (auf UNIX-Systemen)
aus.
- Öffnen Sie jts_params oder eine landessprachliche Version zur Bearbeitung und geben Sie Werte für alle Parameter an. Einer der zu setzenden Parameter ist der Verzeichnispfad für
OLD_JTS_HOME.
- Falls Sie mit Apache Tomcat arbeiten, lesen Sie den Artikel Apache Tomcat konfigurieren.
- Wenn Sie mit WebSphere Application Server arbeiten, deinstallieren Sie
die bisher installierte Webanwendung und implementieren Sie die von der Installation der Version 3.0.1 bereitgestellten Anwendungen
jts.war und clmhelp.war neu. Ausführliche Informationen hierzu
enthält der Artikel WebSphere Application Server für das Upgrade auf Version 3 konfigurieren.
- Starten Sie den Server mit JTS.
- Fahren Sie mit dem Artikel Konfigurationsassistenten ausführen fort und konfigurieren Sie den
Server.
Upgrade für Change and Configuration
Management (CCM) durchführen
- Informieren Sie sich bei Bedarf anhand der Artikel im Abschnitt Implementierung und Upgrade planen.
- Fahren Sie den Server mit CCM 3.0 herunter.
- Installieren Sie die Anwendung CCM an einer neuen Plattenposition.
- Wählen Sie während der Installation Standardkontextstammverzeichnisse für Anwendungen von Version 3.x verwenden aus.
Wichtig: Falls Sie für Rational Team Concert ein Upgrade von Version 2 auf Version 3.0 durchgeführt haben, wählen Sie Kontextstammverzeichnis von Rational Team
Concert 2.x verwenden aus, um /jazz als Kontextstammverzeichnis
beizubehalten.
- Wählen Sie am Ende der Installation bei Anzeige der Frage Welches Programm möchten Sie starten? die Option Kein aus.
- Navigieren Sie zu <3.0.1-CCM-Installationsverzeichnis>/server und
führen Sie den folgenden Befehl aus:
Anmerkung: Sie können für die Script-Ausführung alle Argumente in der Befehlszeile
angeben. Wenn Sie das Script mehrere Male ausführen müssen, können Sie alternativ die Datei mit den Script-Parametern bearbeiten und
dann eine entsprechend kürzere Befehlszeile eingeben.
Anweisungen für die Parameterdatei enthält der nächste optionale Schritt.
Wichtig: Die Script-Datei befindet sich im Verzeichnis upgrade, muss jedoch im Verzeichnis server ausgeführt werden. Falls Ihr Pfad Leerzeichen enthält, müssen Sie ihn in Anführungszeichen setzen.
Außerdem müssen Sie den Parameter
applicationContextRoot angeben und auf
"ccm" setzen. Der Standardwert für
applicationContextRoot ist "jazz".
Windows
upgrade\ccm_upgrade.bat -oldApplicationHome <3.0-CCM-Installationsverzeichnis>\server\conf -applicationContextRoot ccm
UNIX
upgrade/ccm_upgrade.sh -oldApplicationHome
<3.0-CCM-Installationsverzeichnis>/server/conf -applicationContextRoot ccm
Weitere
Informationen zu den Befehlszeilenoptionen enthält der Artikel ccm_upgrade.
Das Script führt die folgenden Schritte mit den angegebenen
Benutzerinteraktionen aus:
- Es führt den Befehl -migration_ccm_updateConfigurationFiles aus und aktualisiert die Konfigurationsdateien und die
Tomcat-Dateien. Geben Sie [E] für die Ausführung des Befehls oder [S] zum Überspringen des Schritts ein oder brechen Sie die Script-Ausführung mit [Eingabetaste] ab.
- Geben Sie nach erfolgreicher Zusammenführung der Konfigurationsdateien zum Fortfahren [C] ein. Ein Editorfenster (oder auf UNIX-Systemen ein Editor vi) wird geöffnet, in dem Sie
die Datei teamserver.properties
von CCM prüfen können.
Prüfen Sie, ob das von der Eigenschaft com.ibm.team.repository.server.webapp.url angegebene Stammelement des öffentlichen URI stimmt. Prüfen Sie außerdem, ob die Datenbankeigenschaften korrekt sind. Die Datenbank muss sich an einer anderen Position als die JTS-Datenbank befinden. Speichern Sie ggf. vorgenommene Änderungen. Schließen Sie dann den Editor und fahren Sie mit der Script-Ausführung fort. Weitere Informationen zur Überprüfung der Konfigurationsdateien enthält
der Artikel Konfigurationsdateien während des Upgrades überprüfen.
- Fahren Sie mit der Script-Ausführung fort, bis eine Nachricht erscheint, dass das Upgrade für CCM erfolgreich durchgeführt wurde.
- Optional: Alternativ zum vorherigen Schritt können Sie die Parameterdatei des Scripts öffnen, die Standardwerte
modifizieren und für die Ausführung dann eine verkürzte Befehlszeile verwenden.
Die englische Version und übersetzte Versionen der
Dateien ccm_params befinden sich im Verzeichnis
<3.0.1-CCM-Installationsverzeichnis>/server/upgrade/params.
- Wenn Sie den genauen Namen der in Ihre Sprache übersetzten Parameterdatei abrufen möchten, führen Sie im Verzeichnis
<3.0.1-CCM-Installationsverzeichnis>\server\upgrade den Befehl
locale.bat -ccm -showParamFileName (unter Windows)
oder locale.sh -ccm -showParamFileName (auf UNIX-Systemen)
aus.
- Öffnen Sie die Datei ccm_params oder eine landessprachliche Version zur Bearbeitung und geben Sie Werte für alle Parameter an. Einer der zu setzenden Parameter ist der Verzeichnispfad für
OLD_AAPLICATION_HOME. Dieser Pfad darf keine Leerzeichen enthalten.
- Falls Sie mit Apache Tomcat arbeiten, lesen Sie den Artikel Apache Tomcat konfigurieren.
- Wenn Sie mit IBM WebSphere Application Server arbeiten, deinstallieren Sie
die bisher installierte Webanwendung und implementieren Sie die von der Installation der Version 3.0.1 bereitgestellte Anwendung
ccm.war neu. Ausführliche Informationen hierzu
enthält der Artikel WebSphere Application Server für das Upgrade auf Version 3 konfigurieren.
- Starten Sie den CCM-Server.
- Wenn Sie
Change and Configuration Management zu einem etablierten
Jazz Team Server hinzufügen, verwenden Sie die Webschnittstelle für Administration. Siehe Anwendungen bei Jazz Team Server registrieren.