In diesem Artikel sind die Schritte beschrieben, mit denen Sie Server-URLs ändern müssen, wenn Sie eine kleine CLM-Pilotimplementierung
in die Produktion überführen.
Vorbereitende Schritte
Überprüfen Sie vor der Umbenennung, ob Ihre Umgebung die Kriterien für das Szenario 'Überführung einer Pilotimplementierung
in die Produktion' erfüllt. Weitere Details finden Sie
im Artikel Unterstützte Szenarien.
Wichtig: Für eine Serverumbenennung müssen der Jazz Team Server
und alle CLM-Anwendungen auf dem Stand von Version 4 oder einer aktuelleren Version sein.
Im folgenden Diagramm ist der allgemeine Ablauf
der Umbenennung dargestellt.

Informationen zu diesem Vorgang
Im Rahmen dieses Verfahrens werden Sie die Daten und Konfigurationsdateien von den Pilotservern auf die Produktionsserver
kopieren.
Da Sie die Datenbanken nicht kopieren, sondern verlagern, muss die Pilotumgebung für diesen Schritt durchgehend außer Betrieb sein, um den Eintrag von Daten in die
Produktionsumgebung zu vermeiden.
Das Feature für Serverumbenennung bestimmt anhand einer Zuordnungsdatei, welche
URLs umbenannt werden müssen. Es gibt einen repotools-Befehl, mit dem Sie eine erste Zuordnungsdatei
generieren können. Die Zuordnungsdatei enthält source-target-Paare für JTS und alle Anwendungen sowie
für alle weiteren, von Anwendungen beigetragenen URLs. Weitere Einzelheiten zur Zuordnungsdatei enthält der Artikel Zuordnungsdatei für die Serverumbenennung verstehen. Beispiele für Topologiediagramme und Zuordnungsdateien finden Sie im Artikel
Topologien und Zuordnungsdateien für das Szenario 'Überführung einer Pilotimplementierung in die Produktion'.
Vorgehensweise
- Erstellen und prüfen Sie die Zuordnungsdatei vor der eigentlichen Umbenennung, solange Ihre Server noch online sind.
Gehen Sie dazu wie im Artikel
Zuordnungsdatei erstellen beschrieben vor.
Falls Sie Ihre Implementierung auf einen neuen Computer verlagern, führen Sie die Installation auf dem neuen Computer
durch. Wenn Sie den URL desselben Computers ändern, wählen Sie für die Installation ein anderes Verzeichnis als für die bereits vorhandene
Installation. Sollten Sie auch das Kontextstammverzeichnis ändern, lesen Sie die Informationen im Artikel
Kontextstammverzeichnis ändern.
Das Endergebnis der Vorbereitungsphase ist eine Zuordnungsdatei, die im
Pilot-Jazz-Team-Server generiert wird.
Die Zuordnungsdatei enthält source-target-Paare für Jazz Team Server und alle Anwendungen sowie
für alle weiteren, von Anwendungen beigetragenen URLs.
- Erstellen Sie eine Sicherung der Pilotumgebung mit Version 4 und kopieren Sie Textindizes und Anwendungskonfigurationsdateien
in die neue Installation.
- Stoppen Sie Jazz Team Server und alle dezentralen CLM-Anwendungen,
die bei Jazz Team Server registriert sind.
Stoppen Sie alle anderen Anwendungsserver, die von der Serverumbenennung betroffen sind, z. B.
die Jazz-Build-Steuerkomponente,
sowie alle integrierten Produkte, die betroffen sind, wie Rational
Reporting for Development Intelligence (RRDI), Rational ClearCase
oder Rational ClearQuest.
Anmerkung: Wenn die Server inaktiv sind, können Benutzer von externen Systemen, die in die umzubenennende CLM-Implementierung integriert sind,
keine Links erstellen oder verwenden.
- Sichern Sie die Datenbanken in der CLM-4.0-Pilotumgebung, einschließlich der Datenbank für
Jazz Team Server und der Datenbanken für die Anwendungen
CCM und QM, der Data-Warehouse-Datenbank und der Content-Store-Datenbank für RRDI (sofern Sie RRDI verwenden). Falls Sie den
Datenbankserver oder -anbieter wechseln, informieren Sie sich im Artikel CLM-Datenbank verlagern über die zusätzlichen
Schritte.
- Kopieren Sie die JFS- bzw. Textindizes vom Quellenpilotserver auf den Zielproduktionsserver. (Bei verteilten Systemen müssen Sie die Dateien vom entsprechenden Server
kopieren.)
Bei den folgenden Beispielen für einen
Linux-Server wird davon ausgegangen, dass die Laufwerke der Produktionscomputer angehängte Netzlaufwerke sind.
Sollte dies in Ihrer Umgebung nicht möglich sein, nutzen Sie zum Kopieren der Dateien andere Dateiübertragungsmethoden.
cp -R Quellen-Jazz-Installationsverzeichnis/server/conf/jts/indices Ziel-Jazz-Installationsverzeichnis/server/conf/jts
cp -R Quellen-Jazz-Installationsverzeichnis/server/conf/ccm/indices Ziel-Jazz-Installationsverzeichnis/server/conf/ccm
cp -R Quellen-Jazz-Installationsverzeichnis/server/conf/qm/indices Ziel-Jazz-Installationsverzeichnis/server/conf/qm
- Kopieren Sie die Anwendungskonfigurationsdateien vom Quellenpilotserver auf den Zielproduktionsserver. (Bei verteilten Systemen müssen Sie die Dateien vom entsprechenden Server
kopieren.) Wie im vorherigen Schritt beziehen sich die folgenden Beispiele auf einen
Linux-Server und es wird davon ausgegangen, dass die Laufwerke der Produktionscomputer angehängte Netzlaufwerke sind.
cp Quellen-Jazz-Installationsverzeichnis/server/conf/jts/teamserver*.properties Ziel-Jazz-Installationsverzeichnis/server/conf/jts
cp Quellen-Jazz-Installationsverzeichnis/server/conf/ccm/teamserver*.properties Ziel-Jazz-Installationsverzeichnis/server/conf/ccm
cp Quellen-Jazz-Installationsverzeichnis/server/conf/qm/teamserver*.properties Ziel-Jazz-Installationsverzeichnis/server/conf/qm
cp Quellen-Jazz-Installationsverzeichnis/server/conf/admin/admin.properties* Ziel-Jazz-Installationsverzeichnis/server/conf/admin
cp Quellen-Jazz-Installationsverzeichnis/server/conf/admin/friends.rdf* Ziel-Jazz-Installationsverzeichnis/server/conf/admin
cp Quellen-Jazz-Installationsverzeichnis/server/conf/rm/fronting.properties Ziel-Jazz-Installationsverzeichnis/server/conf/rm
cp Quellen-Jazz-Installationsverzeichnis/server/conf/rm/friendsconfig.rdf Ziel-Jazz-Installationsverzeichnis/server/conf/rm
- Kopieren Sie die Zuordnungsdatei in das Verzeichnis Ziel-Jazz-Installationsverzeichnis\server auf dem
Produktionsserver. Einzelheiten zur Zuordnungsdatei enthält der Artikel Zuordnungsdatei erstellen.
- Führen Sie den Offlineabschnitt der Serverumbenennung aus.
Importieren Sie dazu mit dem Befehl repotools-jts -importURLMappings die Zuordnungsdatei in den Ziel-Jazz-Team-Server in der Produktionsumgebung.
- Wenn Sie eine zentrale Implementierung mit nur einem Server haben, können Sie die Zuordnungsdatei wie folgt mit dem Befehl
repotools-jts.bat -importURLMappings importieren:
repotools-jts.bat -importURLMappings
fromFile=".\mappings.txt"
./repotools-jts.sh -importURLMappings
fromFile="./mappings.txt"
Die Umbenennung beginnt offline im Jazz Team Server,
bevor der Server erneut gestartet wird.
- Wenn Sie in einer verteilten Implementierung arbeiten und die Möglichkeit haben, Netzlaufwerke zuzuordnen, ordnen Sie jedem der Anwendungshosts ein Netzlaufwerk
vom Jazz-Team-Server-Host zu. Erstellen Sie dann eine Datei (z. B. serverConfFile.txt)
mit einer Liste aller fernen server/conf-Verzeichnisse Ihrer Umgebung im folgenden Format:
# Ferner CCM Server
x:/JazzTeamServer/server/conf
# Ferner QM Server
y:/JazzTeamServer/server/conf
# Ferner RM Server
z:/JazzTeamServer/server/conf
Führen Sie abschließend den Befehl
repotools-jts -importURLMappings wie folgt aus und fügen Sie den Parameter
serverConfFile= hinzu.
repotools-jts.bat -importURLMappings
fromFile=".\mappings.txt" serverConfFile=".\serverConf.txt"
./repotools-jts.sh -importURLMappings
fromFile="./mappings.txt" serverConfFile="./serverConf.txt"
- Sollten Sie in einer verteilten CLM-Implementierung arbeiten und nicht die Möglichkeit haben, Netzlaufwerke neu zuzuordnen,
führen Sie den Befehl
repotools-jts -importURLMappings (ohne den Parameter serverConfFile=) aus. Kopieren Sie dann die Datei server/conf/jts/.mappingEvent in die Konfigurationsverzeichnisse der fernen Anwendungen
(server/conf/Anwendungsname, wobei /Anwendungsname für
ccm, qm oder rm steht).
Die Ereignisdatei wird generiert, wenn Sie die Zuordnungen importieren. Die Datei .mappingEvent müssen Sie nach dem Import der Zuordnungsdatei und vor dem Start des Servers
kopieren.
Die Datei .mappingEvent enthält Informationen, die die Anwendungen für den Kontakt zum
Jazz Team Server an seiner neuen Position
benötigen. Ein
Jazz Team Server und die bei diesem registrierten Anwendungen verwenden eine Datei .mappingEvent mit identischem Inhalt.
Anmerkung: Unter z/OS ausgeführte Server sollten mit dem Beispiel-JCL-Member
HLQ.SBLZSAMP(BLZRENAM) umbenannt werden. Ausführliche Anpassungsanweisungen finden Sie in den Kopfdaten von BLZRENAM in den Kommentaren.
Überprüfen Sie die Konsolausgabe und die Datei
Jazz-Installationsverzeichnis/server/repotools-jts_importURLMappings.log, um sich zu vergewissern, dass die Umbenennung erfolgreich war.
Falls Fehler angezeigt werden oder Sie meinen, dass Ihnen in der Zuordnungsdatei ein Fehler unterlaufen ist,
bestimmen Sie präzise, um welchen Fehler es sich handelt, und korrigieren Sie ihn. Informationen dazu finden Sie im Artikel Fehler bei der Serverumbenennung beheben.
- Starten Sie Jazz Team Server und alle installierten dezentralen CLM-Anwendungen.
Jetzt werden die CLM-Anwendungen mit
Jazz Team Server synchronisiert, um die URL-Zuordnungen anzuwenden und ihre
Data-Warehouse-Daten zu aktualisieren. Dieser Prozess dauert für eine kleine Dateigruppe etwa fünf Minuten und für eine sehr große Dateigruppe bis zu 30 Minuten oder noch länger.
- Melden Sie sich bei Jazz Team Server
an (https://Hostname:Port/jts/serverRenameStatus), um den Fortschritt der Umbenennung zu überwachen.
(Verwenden Sie beispielsweise den URL https://clmhost.production.example.org:9443/jts/serverRenameStatus.) Die Seitenanzeige wird automatisch aktualisiert, bis die Umbenennung
abgeschlossen ist.
Falls Fehler angezeigt werden,
bestimmen Sie präzise, um welche Fehler es sich handelt, und korrigieren Sie sie. Informationen dazu finden Sie im Artikel Fehler bei der Serverumbenennung beheben.
Anmerkung: Bei jedem Versuch, sich vor Abschluss der Umbenennung bei der Webbenutzerschnittstelle einer CLM-Anwendung anzumelden, werden Sie
zu dieser Statusseite umgeleitet.
- Führen Sie die im Artikel
Serverumbenennung überprüfen beschriebenen Schritte aus, um die Serverumbenennung zu überprüfen.
- Führen Sie bei Bedarf die folgenden Schritte aus, um
Rational Reporting for Development Intelligence (RRDI) in der Produktionsumgebung zu konfigurieren.
- Sichern Sie die folgenden Datenbanken aus der Pilotumgebung und speichern Sie sie auf einem neuen Datenbankserver
für die Neuinstallation von
RRDI in der Produktionsumgebung zurück:
- Content-Store-Datenbank (z. B RICM, sofern noch nicht gesichert und wiederhergestellt)
- Data Warehouse (z. B. RIDW, sofern noch nicht gesichert und wiederhergestellt)
- Installieren Sie Rational Reporting for Development Intelligence
Version 2.0 in der Produktionsumgebung. Einzelheiten hierzu enthält der Artikel Rational Reporting for Development Intelligence mit Installation Manager installieren.
- Konfigurieren Sie den Berichtsserver. Führen Sie dazu die RRDI-Setup-Anwendung aus. Einzelheiten hierzu
enthält der Artikel Aufgaben nach der Installation. Vergessen Sie nicht,
die folgenden Aktionen auszuführen:
- Geben Sie auf der Seite Configure Content Store Database die Verbindungseigenschaften für die
Content-Store-Datenbank (z. B.
RICM) ein, die Sie in Schritt 7.a wiederhergestellt haben.
- Geben Sie auf der Seite Configure Data Warehouse die Verbindungseigenschaften für die
Data-Warehouse-Datenbank (z. B.
RIDW) ein, die Sie in Schritt 7.a wiederhergestellt haben.
- Melden Sie sich bei Jazz Team Server an und prüfen Sie die
auf der Verwaltungsseite von
Jazz Team Server und den Anwendungen
CCM und QM die unter Erweiterte Eigenschaften gespeicherten Berichtsserver-URLs. Die neuen URLs müssen auf den RRDI-Berichtsserver in der Produktionsumgebung
zeigen. Ist das nicht der Fall, müssen Sie sie entsprechend aktualisieren.
Anmerkung: Enthielt Ihre Zuordnungsdatei Zuordnungen für den Berichtsserver-URL, müssten diese automatisch aktualisiert
worden sein.
- Verifizieren Sie, dass alle bisher importierten Berichte vom RRDI-Berichtsserver aus der Pilotimplementierung
weiter funktionieren.
- Alle Cognos-Berichte oder -Berichtsansichten mit gesetzter Aktion View
most recent report müssen nach einer CLM-Serverumbenennung neu erstellt werden, damit der zwischengespeicherte
HTML-Bericht aktualisiert wird.
- Melden Sie sich beim RRDI-Berichtsserver an.
- Suchen Sie nach Berichten oder Berichtsansichten mit zwischengespeicherten Ausgabeversionen.
Anmerkung: Wenn Sie eine
zwischengespeicherte Ausgabeversion für einen Bericht oder eine Berichtsansicht finden, können Sie auf
View the output versions klicken, um die zwischengespeicherten Berichte anzuzeigen. Falls die Berichte oder Berichtsansichten vor der
CLM-Serverumbenennung generiert wurden, müssen Sie diese erneut erstellen, um sie zu aktualisieren. Andernfalls sehen Benutzer, die die Berichte oder Berichtsansichten verwenden, ungültige Links, die auf den alten
CLM-Server zeigen.
- Klicken Sie auf Run with Options, um die Berichte oder Berichtsansichten neu zu erstellen.
- Klicken Sie in der Berichtsanzeige auf , um die zwischengespeicherten Ausgabeversionen der Berichte oder Berichtsansichten
zu aktualisieren.
- Importieren Sie einen neuen Bericht vom RRDI-Berichtsserver in der Produktionsumgebung.
Verifizieren Sie, dass der Bericht importiert wurde und ohne Probleme ausgeführt werden kann.
- Falls Sie in RRDI Liveberichte für Rational Quality Manager konfiguriert haben, generieren Sie die
xdc-Datei für den neuen Server und konfigurieren Sie sie im 32-Bit-ODBC-Manager. Einzelheiten hierzu enthält der Artikel
Erstellung von Liveberichten einrichten.
- Führen Sie alle weiteren Schritte aus, die für die Integration anderer Komponenten und Produkte
wie die
Jazz-Build-Steuerkomponenten, Rational Reporting, die Clients von Rational Team Concert,
Rational ClearQuest oder Rational ClearCase erforderlich sind, um die Serverbenennung abzuschließen. Einzelheiten hierzu
enthält der Artikel Einschränkungen und zusätzliche Informationen.