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

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

  1. Informieren Sie sich bei Bedarf anhand der Artikel im Abschnitt Implementierung und Upgrade planen.
  2. Fahren Sie den Server mit JTS 3.0 herunter.
  3. 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.
  4. Wählen Sie während der Installation Standardkontextstammverzeichnisse für Anwendungen von Version 3.x verwenden aus.
  5. Wählen Sie am Ende der Installation bei Anzeige der Frage Welches Programm möchten Sie starten? die Option Kein aus.
  6. 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.
  7. 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.

    1. 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.
    2. Ö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.
  8. Falls Sie mit Apache Tomcat arbeiten, lesen Sie den Artikel Apache Tomcat konfigurieren.
  9. 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.
  10. Starten Sie den Server mit JTS.
  11. Fahren Sie mit dem Artikel Konfigurationsassistenten ausführen fort und konfigurieren Sie den Server.

Upgrade für Change and Configuration Management (CCM) durchführen

  1. Informieren Sie sich bei Bedarf anhand der Artikel im Abschnitt Implementierung und Upgrade planen.
  2. Fahren Sie den Server mit CCM 3.0 herunter.
  3. Installieren Sie die Anwendung CCM an einer neuen Plattenposition.
  4. 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.
  5. Wählen Sie am Ende der Installation bei Anzeige der Frage Welches Programm möchten Sie starten? die Option Kein aus.
  6. 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.
  7. 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 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.
  8. Falls Sie mit Apache Tomcat arbeiten, lesen Sie den Artikel Apache Tomcat konfigurieren.
  9. 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.
  10. Starten Sie den CCM-Server.
  11. 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