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
- Informieren Sie sich bei Bedarf anhand der Artikel im Abschnitt Implementierung und Upgrade planen.
- Fahren Sie den Server mit JTS 3.0 herunter.
- 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.
- Wählen Sie während der Installation Standardkontextstammverzeichnisse für Anwendungen von Version 3.x verwenden aus.
- Wählen Sie am Ende der Installation bei Anzeige der Frage Welches Programm möchten Sie starten? die Option Kein aus.
- 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.
- 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
- 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, 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.
- Starten Sie den Server mit JTS.
- Fahren Sie mit dem Artikel Konfigurationsassistenten ausführen fort und konfigurieren Sie den
Server.
Upgrade für Change and Configuration
Management (CCM) durchführen
- Informieren Sie sich bei Bedarf anhand der Artikel im Abschnitt Implementierung und Upgrade planen.
- Fahren Sie den Server mit CCM 3.0 herunter.
- Installieren Sie die Anwendung CCM an einer neuen Plattenposition.
- 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.
- Wählen Sie am Ende der Installation bei Anzeige der Frage Welches Programm möchten Sie starten? die Option Kein aus.
- 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.
- 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
- Falls Sie mit Apache Tomcat arbeiten, lesen Sie den Artikel Apache Tomcat konfigurieren.
- 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.
- Starten Sie den CCM-Server.
- 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.