Manuelles Upgrade von Version 2 auf Version 3.0.1

In diesem Artikel ist das manuelle Upgrade von Rational Team Concert Version 2 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 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.

Falls Sie Derby für Rational Team Concert Server Version 2 verwenden, muss die Repository-Datenbank von RTC-2.X-Installationsverzeichnis/server/repositoryDB in das Verzeichnis 3.0.1-CCM-Installationsverzeichnis/server/conf/jazz/derby kopiert werden.

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, installieren Sie die Anwendung Change and Configuration Management.
  5. Wählen Sie während der Installation Kontextstammverzeichnis von Rational Team Concert 2.x verwenden aus, um /jazz als Kontextstammverzeichnis beizubehalten.
  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, 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.
    Wichtig: Öffnen Sie für die Ausführung der repotools-Befehle für Version 2 und Version 3 Befehlszeilenfenster. Auf diese Weise stellen Sie sicher, dass es keine Konflikte bei den von den Versionen 2 und 3 verwendeten Umgebungsvariablen gibt.
  8. Navigieren Sie zu <3.0.1-CCM-Installationsverzeichnis>/server und führen Sie den folgenden Befehl aus, um die Jazz- und Tomcat-Konfigurationsdatei (einschließlich der Freunde) zusammenzuführen.
    repotools-jazz -migration_ccm_updateConfigurationFiles oldApplicationHome=<2.x-Installationsverzeichnis>/server/conf
    Der Befehl -migration_ccm_updateConfigurationFiles aktualisiert standardmäßig Jazz- und Tomcat-Konfigurationsdateien. Falls Tomcat nicht installiert ist und Sie nur die Jazz-Konfigurationsdateien aktualisieren möchten, müssen Sie den Parameter updateTomcatFiles=false angeben.
    Der Befehl -migration_ccm_updateConfigurationFiles führt die folgenden Aufgaben aus:
    • Jazz-Konfigurationsdateien:
      • teamserver.properties (eine Datei von Rational Team Concert wird in zwei Dateien aufgenommen, in eine für den Team-Server und eine für die Anwendung)
      • friendsconfig.rdf (eine Datei von Rational Team Concert wird in eine Anwendungsdatei kopiert)
    • Tomcat-Dateien:
      • tomcat-users.xml (Kopie)
        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.
      • server.xml (Aufnahme)
      • web.xml-Dateien in Anwendungs-WAR-Dateien (eine Datei von Rational Team Concert wird in zwei Dateien aufgenommen, in eine für den Team-Server und eine für die Anwendung)
    Wichtig: Möglicherweise haben Sie in Rational Team Concert Version 2 auch andere Dateien modifiziert, z. B. log4j.properties. Solche Dateien müssen Sie manuell aufnehmen.

    Details zum repotools-Befehl enthält der Artikel -migration_ccm_updateConfigurationFiles.

    Hinweis: In den folgenden Beispielen bezieht sich die Dateiposition für die Datei teamserver.properties auf die Standardinstallation. Falls Sie die Dateianordnung in Ihrer Implementierung geändert haben, achten Sie darauf, die richtigen Positionsangaben zu verwenden. Bei den folgenden Schritten wird vorausgesetzt, dass die Implementierung auf einem Server erfolgt ist. Standardmäßig wird der Wert des Parameters newJTSHome von newApplicationHome abgeleitet. Falls Sie für CCM und Jazz Team Server gesonderte Server verwenden, müssen Sie den Parameter newJTSHome so angeben, dass er auf die Position von Jazz Team Server zeigt. So können die Eigenschaften für LDAP, E-Mail und Datenbankposition aus der Datei teamserver.properties von Rational Team Concert Version 2 aufgenommen werden. Die Tomcat-Konfigurationsdateien werden ebenfalls an die Position von Jazz Team Server kopiert.
  9. Vergewissern Sie sich, dass Ihre aktualisierten Eigenschaftendateien die folgenden Angaben enthalten:
    • Aus der Datei teamserver.properties der Version 2 kopierte Eigenschaften
    • Gültige db.vendor-Einträge für den Datenbankanbieter (Stellen Sie sicher, dass die in /conf/jts/teamserver.properties angegebene Datenbank vorhanden ist.) Weitere Informationen finden Sie im Artikel Konfigurationsdateien während des Upgrades überprüfen.
    • Prüfen Sie, ob friendsconfig.rdf von <RTC-2.X-Installationsverzeichnis>/server/conf/jazz in <3.0.1-CCM-Installationsverzeichnis>/server/conf/jazz kopiert wurde.
    • Die Datei tomcat-users.xml wurde kopiert.
    • Öffnen Sie die Datei server.xml von Version 3 und prüfen Sie, ob sie die Informationen aus Version 2 (Port-Nummern, LDAP-Einstellungen und weitere Modifikationen) enthält.
    • Öffnen Sie die Datei web.xml von Version 3 und prüfen Sie, ob sie die Informationen aus Version 2 (LDAP-Einstellungen und weitere Modifikationen) enthält.
    • Prüfen Sie, ob die Dateien teamserver.properties einen gültigen, eindeutigen, öffentlichen URL com.ibm.team.repository.server.webapp.url) enthalten. (Der URL der Anwendung CCM muss mit dem in Rational Team Concert Version 2 verwendeten übereinstimmen.)
  10. Öffnen Sie ein Befehlsfenster und rufen Sie das Verzeichnis <3.0.1-CCM-Installationsverzeichnis>/server auf.
  11. Führen Sie den folgenden Befehl aus, um Tabellen zur Datenbank hinzuzufügen:
    repotools-jazz -addTables
  12. Führen Sie den folgenden Befehl aus, um Benutzerdaten aus der Rational-Team-Concert-Datenbank zu exportieren:
    repotools-jazz -migration_exportJTSData toFile=jtsData.tar
    Anmerkung: Falls Sie diesen Prozess ein weiteres Mal durchlaufen, verwenden Sie für die zweite TAR-Datei einen anderen Dateinamen, z. B. jtsData2.tar.
  13. Führen Sie auf der Maschine, auf der Jazz Team Server installiert ist, den folgenden Befehl aus, um Benutzerdaten in die Datenbank von Jazz Team Server zu importieren:
    Anmerkung: Falls Sie nicht die Derby-Standarddatenbank verwenden, stellen Sie sicher, dass die Jazz-Team-Server-Datenbank, auf die conf/jts/teamserver.properties verweist, eine neu erstellte und vorhandene Datenbank ist.
    repotools-jts -migration_importJTSData fromFile=jtsData.tar createMappingFile=rtc-mapping.txt createTables
    Anmerkung: Falls Sie diesen Prozess ein weiteres Mal durchlaufen, verwenden Sie für die zweite TAR-Datei einen anderen Dateinamen, z. B. jtsData2.tar.
    Achtung: Beim Import von Daten des Jazz Team Server von einer zweiten Installation der CLM-Anwendung dürfen Sie den Parameter createTables nicht verwenden. Sind CLM-Anwendungen bereits auf dem Jazz Team Server installiert und der Parameter createTables wird verwendet, verlieren Sie die Benutzerdaten auf dem Server.
  14. Führen Sie den folgenden Befehl aus, um Benutzerdaten von Jazz Team Server in die Datenbank von Rational Team Concert zu importieren:
    repotools-jazz -migration_importUserMapping fromMappingFile=rtc-mapping.txt 
  15. Führen Sie den folgenden Befehl aus, um die Textindizes neu zu erstellen:
    repotools-jazz -rebuildTextIndices
  16. Führen Sie den folgenden Befehl aus, um die Lucene- und RDF-Indizes neu zu erstellen:
    repotools-jazz -reindex
  17. Falls Ihr Produkt der Version 2 nicht die Standardindexposition verwendet hat und Sie für Indizes weiterhin eine angepasste Position verwenden möchten, müssen Sie die Datei teamserver.properties von Version 3.0.1 modifizieren und die Indexposition hinzufügen.
    1. Setzen Sie den Wert von com.ibm.team.fulltext.indexLocation=conf/jts/indices/workitemindex auf den vollständigen Pfad zur Position des Volltextindex. Beispiel: com.ibm.team.fulltext.indexLocation=c:/indices/workitemindex
    2. Setzen Sie den Wert von com.ibm.team.jfs.index.root.directory=indices auf den vollständigen Pfad des JFS-Indexstammverzeichnisses. Beispiel: com.ibm.team.jfs.index.root.directory=c:/indices
  18. Überprüfen Sie, ob Folgendes zutrifft:
    • Eine andere Position für die Datenbank von Jazz Team Server als für die Anwendungsdatenbank
    • Kein gemeinsamer Index und keine anderen gemeinsamen dateibezogenen Eigenschaften für Anwendung und Jazz Team Server
    • Die Datei friendconfig.rdf muss in friendconfig.rdf.saved umbenannt werden.
  19. Falls Sie mit Apache Tomcat arbeiten, lesen Sie den Artikel Apache Tomcat konfigurieren.
  20. 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.
  21. 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 der Anwendung Change and Configuration Management oder einer anderen CLM-Anwendung durchführen (siehe Konfigurationsassistenten ausführen). Wenn Sie die Anwendung 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