Mit dem Upgrade-Script können Sie die Anzahl der manuell auszuführenden Befehle für das Upgrade Ihrer
Anwendungsdaten auf ein Minimum beschränken.
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 Version 2 vorhanden ist.
Stellen Sie mit dem Network Time Protocol (NTP) sicher, dass die Systemzeit auf allen Servern
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.
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, kopieren Sie die Datenbank von
Rational Team Concert Version 2 (<RTC-2-Installationsverzeichnis>\server\repositoryDB)
in Version 3.0.1. Weitere Informationen finden Sie im Artikel
Derby-Datenbank sichern und wiederherstellen.
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.
Vorgehensweise
- Informieren Sie sich bei Bedarf anhand der Artikel im Abschnitt Implementierung und Upgrade planen.
- Überprüfen Sie in der Datei teamserver.properties Ihrer vorhandenen Version 2 die Eigenschaft für den öffentlichen URL
(com.ibm.team.repository.server.webapp.url).
In Version 3.0.1 müssen Sie denselben öffentlichen URL verwenden. Wenn kein öffentlicher URL definiert ist, rufen Sie die Webschnittstelle für Administration von Version 2
auf und legen Sie (unter Erweiterte Eigenschaften)
den URL mit qualifiziertem Hostnamen (https://hostname.example.com:port) fest, bevor Sie das Upgrade durchführen.
Die Zeile mit dem öffentlichen URL in der Datei teamserver.properties
müsste etwa wie folgt aussehen:
com.ibm.team.repository.server.webapp.url=https\://<hostname.example.com>\:9443/jazz
- Fahren Sie den Server der Version 2 herunter.
- Installieren Sie Jazz Team Server (sofern dies noch nicht geschehen ist) und die Anwendung Change and Configuration
Management (CCM) an einer neuen Position. Wenn
Jazz Team Server bereits installiert ist und Sie ein Upgrade auf Version 3.0.1 durchführen, müssen Sie nur die Anwendung Change
and Configuration Management installieren.
- Wählen Sie während der Installation Kontextstammverzeichnis von Rational Team Concert 2.x verwenden aus.
- Wählen Sie am Ende der Installation bei Anzeige der Frage Welches Programm möchten Sie starten? die Option Kein aus.
- Erstellen Sie für Jazz Team Server eine gesonderte Datenbank mit einem anderen Namen als Ihre Datenbank von Version 2.x, jedoch mit dieselben
Parametern.
Weitere Informationen zur Erstellung von Datenbanken finden Sie im Artikel
Konfiguration der Datenbank.
Anmerkung: Jazz Team Server
muss eine andere Datenbank als CCM verwenden.
Erstellen Sie eine neue Jazz-Team-Server-Datenbank, sofern dies noch nicht geschehen ist.
- 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.
Weitere
Informationen zu den Befehlszeilenoptionen enthält der Artikel ccm_upgrade.
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.
Wenn Sie
Jazz Team Server Version 3.0.1 zusammen mit der Anwendung CCM
installiert haben und dies die erste oder einzige Anwendung ist, für die Sie ein Upgrade durchführen möchten,
gilt die folgende Befehlssyntax:
Windows
upgrade\ccm_upgrade.bat -oldApplicationHome <RTC2.x-Installationsverzeichnis>\server\conf -createJTSTables
UNIX
upgrade/ccm_upgrade.sh -oldApplicationHome <RTC2.x-Installationsverzeichnis>/server/conf -createJTSTables
Anmerkung: Der Parameter -createJTSTables ist nur anwendbar, wenn Sie
Jazz Team Server 3.0.1
zum ersten Mal installieren.
Wenn Sie
Jazz Team Server Version 3.0.1 unabhängig von der Anwendung
CCM installiert haben (wie es bei einer dezentralen Implementierung der Fall sein kann), müssen Sie die Position von Jazz Team Server
3.0.1
angeben und das Script im Installationsverzeichnis von
CCM 3.0.1 ausführen. Nehmen Sie in dem Fall das Argument
-newJTSHome auf.
Windows
upgrade\ccm_upgrade.bat -oldApplicationHome <RTC2.x-Installationsverzeichnis>\server\conf -newJTSHome <JTS-3.0.1-Installationsverzeichnis>\server\conf
UNIX
upgrade/ccm_upgrade.sh -oldApplicationHome <RTC2.x-Installationsverzeichnis>/server/conf -newJTSHome <JTS-3.0.1-Installationsverzeichnis>/server/conf
Anmerkung: Wenn Sie eine verteilte Implementierung durchführen und den Jazz dTeam Server
noch nicht konfiguriert haben, können Sie im obigen Beispiel den Parameter -createJTSTables zur Befehlszeile
hinzufügen.
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.
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 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 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 WebSphere Application Server arbeiten, deinstallieren Sie
die bisher installierten Webanwendungen und implementieren Sie die von der Installation der Version 3.0.1 bereitgestellten Anwendungen
jts.war, ccm.war und clmhelp.war neu.
Ausführliche Informationen hierzu
enthält der Artikel WebSphere Application Server für das Upgrade auf Version 3 konfigurieren.
- Konfigurieren Sie den Server und alle installierten CLM-Anwendungen.
Führen Sie den Konfigurationsassistenten für den Server aus, wenn Sie das Upgrade für Jazz Team Server zusammen mit
Change and Configuration Management
oder anderen CLM-Anwendungen durchführen (siehe Konfigurationsassistenten ausführen). 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).