Manuelles Upgrade von Version 3.0 auf Version 3.0.1

In diesem Artikel ist das manuelle Upgrade von Rational Team Concert Version 3.0 auf Version 3.0.1 mit den Repository Tools 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.

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:

    Wenn Sie mit WebSphere Application Server arbeiten, geben Sie den Befehl mit dem Parameter updateTomcatFiles=no an. Informationen zu den möglichen Parameter für diesen Befehl finden Sie im Artikel -migration_jts_updateConfigurationFiles.

    repotools-jts -migration_jts_updateConfigurationFiles oldJTSHome=<3.0-JTS-Installationsverzeichnis>/server/conf 

    Der Befehl führt die folgenden Schritte aus:

    • Er aktualisiert die Datei teamserver.properties von Version 3.0.1 ausgehend von den Informationen in der Datei von Version 3.0.
    • Er kopiert den Inhalt der Tomcat-Benutzerdatei (XML-Datei).
      Hinweis: Nur für die Tomcat-Benutzerdatenbank: Die Datei tomcat-users.xml wird kopiert (und nicht mit der vorhandenen Datei zusammengeführt). Wenn Sie ein Upgrade für mehrere CLM-Anwendungen mit einem gemeinsamen JTS durchführen, müssen Sie die Benutzer- und Gruppeninformationen in der Datei tomcat-users.xml manuell zusammenführen. Wenn die Benutzer in verschiedenen Anwendungen zu unterschiedlichen Gruppen gehören, unterscheiden sich die Benutzer- und Gruppeninformationen. Benutzer A können in CCM beispielsweise die Rolle JazzAdmins und in QM die Rolle JazzUsers haben. Es kann auch sein, dass Benutzer in der einen Anwendung vorhanden sind, jedoch nicht in der anderen. Diese müssen dann manuell zur Datei tomcat-users.xml hinzugefügt werden.
    • Er nimmt den Inhalt der Dateien server.xml und web.xml von Version 3.0 in die entsprechenden Dateien von Version 3.0.1 auf.
  7. Navigieren Sie zu <3.0.1-JTS-Installationsverzeichnis>/server und führen Sie den folgenden Befehl aus, um JTS-Datenbanktabellen zu erstellen:
    repotools-jts -addTables
  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 installierten Webanwendungen und implementieren Sie die von der Installation der Version 3.0.1 bereitgestellten Anwendungen jts.war, admin.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:

    Wenn Sie mit WebSphere Application Server arbeiten, geben Sie den Befehl mit dem Parameter updateTomcatFiles=no an. Informationen zu den möglichen Parameter für diesen Befehl finden Sie im Artikel -migration_ccm_updateConfigurationFiles.

    Anmerkung: Der Standardwert für applicationContextRoot ist "jazz". Falls Sie ein Upgrade für Version 3 durchführen, müssen Sie sicherstellen, dass für den Parameter applicationContextRoot der Wert "ccm" angegeben ist.
    repotools-ccm
    -migration_ccm_updateConfigurationFiles oldApplicationHome=<3.0-CCM-Installationsverzeichnis>/server/conf applicationContextRoot=ccm

    Der Befehl führt die folgenden Schritte aus:

    • Er aktualisiert die Datei teamserver.properties der Anwendung der Version 3.0.1 ausgehend von den Informationen in der Datei von Version 3.0.
    • Er kopiert den Inhalt der Datei tomcat-users.xml.
      Hinweis: Nur für die Tomcat-Benutzerdatenbank: Die Datei tomcat-users.xml wird kopiert (und nicht mit der vorhandenen Datei zusammengeführt). Wenn Sie ein Upgrade für mehrere CLM-Anwendungen mit einem gemeinsamen JTS durchführen, müssen Sie die Benutzer- und Gruppeninformationen in der Datei tomcat-users.xml manuell zusammenführen. Wenn die Benutzer in verschiedenen Anwendungen zu unterschiedlichen Gruppen gehören, unterscheiden sich die Benutzer- und Gruppeninformationen. Benutzer A können in CCM beispielsweise die Rolle JazzAdmins und in QM die Rolle JazzUsers haben. Es kann auch sein, dass Benutzer in der einen Anwendung vorhanden sind, jedoch nicht in der anderen. Diese müssen dann manuell zur Datei tomcat-users.xml hinzugefügt werden.
    • Er nimmt den Inhalt der Dateien server.xml und web.xml von Version 3 in die entsprechenden Dateien von Version 3.0.1 auf.
  7. Navigieren Sie zu <3.0.1-CCM-Installationsverzeichnis>/server und führen Sie den folgenden Befehl aus, um CCM-Datenbanktabellen zu erstellen:
    repotools-ccm -addTables 
  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