Upgrade auf eine vollständig verteilte Unternehmenstopologie

Für Ihre Installation von Rational Team Concert können Sie ein Upgrade auf Version 3.0.1 mit neuen, jedoch verteilten Anwendungen CCM und JTS durchführen. Gehen Sie dazu wie in diesem Abschnitt beschrieben vor.

Vorbereitende Schritte

Wichtig: Stellen Sie 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. Rufen Sie für weitere Informationen zu NTP die Website http://www.ntp.org/ auf.
Anmerkung: Die vorliegenden Beispiele beziehen sich auf Jazz Team Server und Change and Configuration Management. Bei der Anwendung Quality Management können Sie genauso vorgehen.

Lesen Sie die Informationen im Thema Beispiel für die vollständig verteilte Unternehmenstopologie mit Rational Team Concert 2.0 bis 3.0.1. Dort finden Sie ein Beispiel einer komplett dezentralen Unternehmenstopologie mit Rational Team Concert 3.0.1.

Wenn Sie die Anwendung an einen separaten Server weitergeben, stellen Sie sicher, dass auf dem zweiten Server, auf dem Sie JTS implementieren, dasselbe Betriebssystem ausgeführt wird und dieselbe Anwendungsserverkonfiguration vorhanden ist. Die Dateimigration ist weniger kompliziert, wenn dasselbe Betriebssystem und derselbe Anwendungsserver verwendet werden.

Stellen Sie sicher, dass beide Server für ihre Benutzer dasselbe Authentifizierungsverfahren und denselben Benutzer-Realm verwenden.

Lesen und berücksichtigen Sie hierzu Implementierung mit Single Sign-On. Wenn Sie WebSphere verwenden, vereinfacht das die Authentifizierung in einer Umgebung mit mehreren Servern.

Wählen Sie zum Abschluss der Installationsvorgänge für Version 3.0.1 unter "Welches Programm möchten Sie starten?" Kein aus. Sie dürfen den JTS-Assistenten erst nach Abschluss der Migration aller Dateien ausführen.

Konfigurationsdateien erstellen

Vorgehensweise

  1. Installieren Sie auf Maschine A (mit dem Server von RTC 2.x, für den das Upgrade durchgeführt werden soll) Version 3.0.1 der Anwendung Change and Configuration Management ohne Jazz Team Server (JTS) und ohne die RTC-Testlizenzen.
    Anmerkung: Stellen Sie sicher, dass in der Anzeige für das Kontextstammverzeichnis Kontextstammverzeichnis von Rational Team Concert 2.x verwenden ausgewählt ist.
  2. Installieren Sie auf Maschine B Version 3.0.1 der Anwendung Jazz Team Server (JTS) und die RTC-Testlizenzen, jedoch nicht die Anwendung Change and Configuration Management. Dies ist der Server für den gemeinsam genutzten JTS.
    Anmerkung: Stellen Sie sicher, dass in der Anzeige für das Kontextstammverzeichnis Kontextstammverzeichnis von Rational Team Concert 2.x verwenden ausgewählt ist.
  3. Öffnen Sie auf Maschine A ein neues Befehlsfenster und navigieren Sie zu 3.0.1-Installationsverzeichnis/server.
  4. Führen Sie den folgenden Befehl aus, um die Konfigurationsdateien von Jazz und Tomcat zusammenzuführen:
    repotools-jazz -migration_ccm_updateConfigurationFiles oldJazzHome=2.x-Installationsverzeichnis/server/conf
    Anmerkung: Standardmäßig aktualisiert der Befehl -migration_ccm_updateConfigurationFiles die Konfigurationsdateien von Jazz und Tomcat. Falls Tomcat nicht installiert ist und Sie nur die Jazz-Konfigurationsdateien aktualisieren möchten, müssen Sie den Parameter updateType=JAZZ angeben.
    repotools-jazz -migration_ccm_updateConfigurationFiles oldJazzHome=2.x-Installationsverzeichnis/server/conf updateType=JAZZ
  5. Rufen Sie auf Maschine A das Verzeichnis 3.0.1-Installationsverzeichnis/server/conf/jazz auf und prüfen Sie den Inhalt der RTC-Datei teamserver.properties. Achten Sie besonders auf die Einträge für die Datenbankverbindung und für den öffentlichen URL. Stellen Sie sicher, dass die Einträge für den Hostnamen von Maschine A korrekt sind.
    Vorsicht:
    Es ist enorm wichtig, dass Sie sich den Inhalt der zusammengeführten Dateien ansehen, insbesondere die Einträge für die Datenbankverbindung und den öffentlichen URL in der Datei teamserver.properties unter jazz als auch der von JTS. Die Datei teamserver.properties unter jazz (RTC/CCM) befindet sich auf der Maschine A im Verzeichnis 3.0.1-Installationsverzeichnis/server/conf/jazz. Die zu Datei teamserver.properties von JTS, die bearbeitet und verschoben werden muss, befindet sich auf Maschine A im Verzeichnis 3.0.1-Installationsverzeichnis/server/jts-migration/conf/jts.

    Es ist wichtig, dass in beiden Dateien teamserver.properties der richtige Serverhostname der Maschine, auf der sie sich befinden, angegeben ist. Ggf. müssen die Dateien entsprechend bearbeitet/aktualisiert werden.

    Weitere Informationen und Beispiele für Prüfpunkte sind unter 'Konfigurationsdateien vorbereiten' im Abschnitt 'Upgrade für Rational Team Concert durchführen' in den Schritten 3-6 beschrieben.

  6. Nachdem Sie die Datei teamserver.properties von JTS auf Maschine A bearbeitet haben, kopieren Sie sie auf Maschine B in das Verzeichnis 3.0.1-Installationsverzeichnis/server/conf/jts. Sichern Sie die vorhandene Datei teamserver.properties, bevor Sie sie ersetzen.
  7. Bei einer Implementierung in Tomcat müssen Sie die Dateien 3.0.1-Installationsverzeichnis/tomcat/conf/tomcat-users.xml und 3.0.1-Installationsverzeichnis/tomcat/conf/server.xml von Maschine A in den Ordner 3.0.1-Installationsverzeichnis/tomcat/conf auf Maschine B kopieren. Erstellen Sie Sicherungskopien der vorhandenen Dateien, bevor Sie diese ersetzen.
  8. Wenn Sie die Implementierung in Tomcat durchführen und LDAP verwenden, müssen Sie die folgenden Schritte ausführen, um JTS mit der bearbeiteten Datei web.xml zu implementieren:
    1. Starten Sie JTS auf Maschine B. Führen Sie dazu server.startup aus, um die Datei JTS.war zu extrahieren.
    2. Stoppen Sie JTS auf Maschine B mit dem Befehl server.shutdown.
    3. Sichern Sie auf Maschine B die Datei 3.0.1-Installationsverzeichnis/server/tomcat/webapps/jts/WEB-INF/web.xml und ersetzen Sie sie dann durch die äquivalente Datei web.xml vom Server A.

Ergebnisse

Damit ist die Migration der Konfigurationsdateien abgeschlossen.

Repository-Datenbank migrieren

In diesem Abschnitt sind die erforderlichen Schritte für eine Migration der Repository-Datenbank einer verteilten Anwendung JTS beschrieben.

Vorbereitende Schritte

Überprüfen Sie vor der Migration der Repository-Datenbank, ob folgende Aufgaben abgeschlossen wurden:
  • Für die vorhandene Datenbank von RTC 2.x wurde eine vollständige Offlinesicherung erstellt.
  • Die Konfigurationsdateien (teamserver.properties, friendsconfig.rdf, tomcat-users.xml, server.xml, web.xml) sind migriert und befinden sich an der richtigen Position. Weitere Informationen hierzu enthält der Artikel Konfigurationsdateien vorbereiten.
  • Die JTS-Repository-Datenbank ist erstellt. Weitere Informationen hierzu finden Sie unter Konfiguration der Datenbank.
  • Der Server von Rational Team Concert Version 2.x ist heruntergefahren.
  • Falls Sie Derby für Rational Team Concert Server Version 2.x verwenden, muss die Repository-Datenbank von 2.x-Installationsverzeichnis/server/repositoryDB in das Verzeichnis 3.0.1-Installationsverzeichnis/server kopiert werden.
  • Migration von WebSphere Application Server:
    • Stellen Sie sicher, dass der Server von RTC 2.x heruntergefahren ist.
    • Stoppen Sie die Anwendung jazz.war und deinstallieren Sie sie.
    • Passen Sie die Eigenschaft JAZZ_HOME an den neuen Installationspfad (3.0.1-Installationsverzeichnis/server/conf) an.
    • Modifizieren Sie ggf. die Eigenschaft für den JDBC-Treiber von Oracle oder SQL Server. Informationen hierzu finden Sie im Abschnitt WebSphere Application Server konfigurieren.
    • Passen Sie ggf. die Speichereinstellungen an. Informationen hierzu finden Sie im Abschnitt WebSphere Application Server konfigurieren.
    • Stoppen Sie den WebSphere Application Server und starten Sie ihn erneut.

Vorgehensweise

  1. Öffnen Sie auf Maschine A ein Befehlsfenster und rufen Sie das Verzeichnis 3.0.1-Installationsverzeichnis/server auf.
  2. Führen Sie den folgenden Befehl aus, um Tabellen zur Datenbank hinzuzufügen:
    repotools-jazz -addTables
  3. Führen Sie den folgenden Befehl aus, um Benutzerdaten aus der RTC-Datenbank zu exportieren:
    repotools-jazz -migration_exportJTSData toFile=jtsData.tar
  4. Kopieren Sie die gerade erstellte Datei jtsData.jar von Maschine A auf Maschine B in das Verzeichnis 3.0.1-Installationsverzeichnis/server.
  5. Führen Sie auf Maschine B den folgenden Befehl aus, um Benutzerdaten in die JTS-Datenbank zu importieren:
    Wichtig: Falls Sie nicht die Derby-Standarddatenbank verwenden, stellen Sie sicher, dass die in conf/jts/teamserver.properties referenzierte JTS-Datenbank erstellt wurde und vorhanden ist.
    repotools-jts -migration_importJTSData fromFile=jtsData.tar createMappingFile=rtc-mapping.txt createTables
  6. Kopieren Sie die gerade erstellte Datei rtc-mapping.txt von Maschine B auf Maschine A in das Verzeichnis RTC3.0.1-Installationsverzeichnis/server.
  7. Führen Sie auf Maschine A den folgenden Befehl aus, um JTS-Benutzerdaten in die RTC-Datenbank zu importieren:
    repotools-jazz -migration_importUserMapping fromMappingFile=rtc-mapping.txt

Repository-Tools-Befehle für Migrationsabschluss

Vorgehensweise

Führen Sie auf Maschine A die folgenden Befehle aus, um die Indizes neu zu erstellen:

repotools-jazz -rebuildTextIndices

repotools-jazz -reindex

Ergebnisse

Damit ist die Migration der Repository-Datenbank abgeschlossen.

Konfigurationsschritte nach der Migration

Informationen zu diesem Vorgang

Die Schritte für den Abschluss einer RTC-Server-Migration und die Verteilung der Anwendung JTS sind dieselben wie die für die Migration in einer Einzelserverumgebung, nur dass Sie hier für den Migrationsabschluss zusätzlich folgende Schritte ausführen müssen:

Vorgehensweise

Beim Start des Konfigurationsassistenten für Jazz Team Server wird die Anwendung CCM aufgrund der verteilten Umgebung nicht automatisch erkannt, sodass keine Werte in den Feldern eingetragen werden können. Falls die Anwendung CCM während der Konfiguration von Jazz Team Server nicht automatisch erkannt wird, lesen Sie Schritt 9c im Abschnitt Konfigurationsassistenten ausführen.

Feedback