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
- Informieren Sie sich bei Bedarf anhand der Artikel im Abschnitt Implementierung und Upgrade planen.
- Ü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
- Fahren Sie den Server der Version 2 herunter.
- 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.
- Wählen Sie während der Installation Kontextstammverzeichnis von Rational Team
Concert 2.x verwenden aus, um /jazz als Kontextstammverzeichnis
beizubehalten.
- Wählen Sie am Ende der Installation bei Anzeige der Frage Welches Programm möchten Sie starten? die Option Kein aus.
- 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.
- 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.
- 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.)
- Öffnen Sie ein Befehlsfenster und rufen Sie das Verzeichnis <3.0.1-CCM-Installationsverzeichnis>/server auf.
- Führen Sie den folgenden Befehl aus, um Tabellen zur Datenbank hinzuzufügen:
repotools-jazz -addTables
- 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.
- 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.
- 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
- Führen Sie den folgenden Befehl aus, um die Textindizes neu zu erstellen:
repotools-jazz -rebuildTextIndices
- Führen Sie den folgenden Befehl aus, um die Lucene- und RDF-Indizes neu zu erstellen:
repotools-jazz -reindex
- 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.
- 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
- 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
- Ü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.
- Falls Sie mit Apache Tomcat arbeiten, lesen Sie den Artikel Apache Tomcat konfigurieren.
- 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.
- 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).