Upgrade von Version 2 auf Version 3.0.1 mit dem Upgrade-Script

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

  1. Informieren Sie sich bei Bedarf anhand der Artikel im Abschnitt Implementierung und Upgrade planen.
  2. Ü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
  3. Fahren Sie den Server der Version 2 herunter.
  4. 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.
  5. Wählen Sie während der Installation Kontextstammverzeichnis von Rational Team Concert 2.x verwenden aus.
  6. Wählen Sie am Ende der Installation bei Anzeige der Frage Welches Programm möchten Sie starten? die Option Kein aus.
  7. 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.
  8. 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.
  9. 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.

    1. 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.
    2. Ö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.
  10. Falls Sie mit Apache Tomcat arbeiten, lesen Sie den Artikel Apache Tomcat konfigurieren.
  11. 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.
  12. 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).


Feedback