In diesem Artikel ist beschrieben, wie Sie mit dem Feature für Serverumbenennung eine Bereitstellungsumgebung mit tatsächlichen Produktionsdaten
einrichten können.
Eine Bereitstellungsumgebung ist eine Test-Sandbox, die von der Produktionsumgebung isoliert ist. In dieser Sandbox können Sie neue Features oder Funktionen an realen Daten ausprobieren, ohne dass sich
Auswirkungen auf die Produktionsdatenbank ergeben.
Informationen zu diesem Vorgang
Wichtig: Dieses
Verfahren ist nicht geeignet, um für Ihre Umgebung ein Upgrade für ein früheres Release durchzuführen. Die Serverumbenennung wird erst ab Version 4 unterstützt. Ein Upgrade auf Version 4 ist daher die Vorbedingung
für das Einrichten einer Bereitstellungsumgebung mittels Serverumbenennung.
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 Jazz Team Server 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 die Einrichtung einer Bereitstellungsumgebung zu Testzwecken.
Wenn Sie eine Bereitstellungsumgebung planen, müssen Sie besonders darauf achten, dass
keine Wechselwirkung mit den Produktionsdaten möglich ist. Dies können Sie auf zwei Wegen sicherstellen. Zum Einen können Sie Einträge zur Datei
hosts hinzufügen, wenn das in Ihrer Umgebung erlaubt ist.
Zum Anderen können Sie Zuordnungen erstellen, die die nicht in der Bereitstellungsumgebung vorhandenen Server maskieren. In die Zuordnung müssen Sie alle weiteren
CLM-Server und Nicht-CLM-Produkte aufnehmen, die eine Verbindung zum Produktionsserver herstellen können. Einzelheiten hierzu
finden Sie in Schritt 3.c und im Artikel Pseudozuordnungen
für Bereitstellungsumgebungen.
Angenommen, es gibt auf einem Produktionsserver eine Anwendung
Change and Configuration Management (CCM) mit Links zur Anwendung CCM auf einem anderen Produktionsserver sowie
Links zu
Quality Management (QM) auf einem wieder anderen Produktionsserver.
Darüber hinaus könnten Nicht-CLM-Produkte wie
Rational ClearQuest eingebunden sein. In einem solchen Fall sollten Sie zuerst
den URL des zusätzlichen CCM-Servers und QM-Servers maskieren und sicherstellen, dass der URL
für Rational ClearQuest ebenfalls maskiert ist oder auf andere Weise einem
Rational-ClearQuest-Gateway-Server in der Bereitstellungsumgebung zugeordnet ist.
Wichtig: Ein Rational Team Concert Client
darf keine Verbindung zu den Produktions-Repositorys herstellen können, wenn er mit den Bereitstellungs-Repositorys verbunden werden kann, und umgekehrt. Nutzen Sie für die Verbindung zum Bereitstellungsserver
stets einen Bereitstellungsarbeitsbereich.
Im folgenden Diagramm sind die wichtigsten Schritte für das Einrichten einer Bereitstellungsumgebung
mithilfe einer Serverumbenennung dargestellt. Hier ist vorausgesetzt, dass die jeweils aktuellste Version
von CLM (Version 4) und RRDI (Version 2) bereits installiert ist.
- Bereiten Sie die Umbenennung vor, indem Sie die Schritte im Artikel
Zuordnungsdatei erstellen ausführen.
Sie müssen für alle betroffenen URLs in der Zuordnungsdatei Pseudozuordnungen erstellen. Damit vermeiden Sie Querverbindungen zwischen der Bereitstellungs- und der Produktionsumgebung. Einzelheiten hierzu
finden Sie im Artikel Pseudozuordnungen
für Bereitstellungsumgebungen.
Das Endergebnis der Vorbereitungsphase ist eine Zuordnungsdatei, die im ursprünglichen
Quellen-Jazz-Team-Server generiert wird.
Nachdem Sie die Zuordnungsdatei sorgfältig bearbeitet und überprüft haben, können Sie sie
in das Verzeichnis Jazz-Installationsverzeichnis\server des Ziel-Jazz-Team-Servers in der
Bereitstellungsumgebung kopieren.
- Erstellen Sie eine Sicherung der Produktionsumgebung mit Version 4 und kopieren Sie Textindizes und Anwendungskonfigurationsdateien
auf den Zielbereitstellungsserver.
Da die Produktionsserver während dieser Schritte gestoppt sein müssen, wählen Sie für die Sicherung eine günstige Zeit aus.
Am besten ist es, wenn Sie die Sicherung unmittelbar vor dem Einrichten der Bereitstellungsumgebung
erstellen. Falls bis zur eigentlichen Umbenennung noch Änderungen an der Produktionsumgebung vorgenommen werden, müssen Sie
die Zuordnungsdatei erneut generieren, bevor Sie sie auf den Bereitstellungsserver importieren. Wenn die Server inaktiv sind, können Benutzer von externen Systemen, die in die umzubenennende CLM-Implementierung integriert sind,
keine Links erstellen oder verwenden.
- Stoppen Sie Jazz Team Server und alle dezentralen CLM-Anwendungen,
die bei Jazz Team Server in der Produktionsumgebung registriert sind.
- Sichern Sie alle Datenbanken in der CLM-4.0-Produktionsumgebung, 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. Führen Sie beim Kopieren der Datenbanken von der Produktions- in die Bereitstellungsumgebung
die im Artikel
CLM-Datenbank verlagern beschriebenen Schritte aus.
- Kopieren Sie die JFS- bzw. Textindizes vom Quellenproduktionsserver auf den Zielbereitstellungsserver. (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 Bereitstellungscomputer 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 Quellenproduktionsserver auf den Zielbereitstellungsserver. (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 Bereitstellungscomputer 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.
Anmerkung: Falls bis zum folgenden Schritt noch Konfigurationsänderungen an der CLM-Implementierung vorgenommen werden, müssen Sie
die Zuordnungsdatei erneut generieren.
- Starten Sie alle CLM-Server neu. Die Benutzer können jetzt ihre Arbeit in der Produktionsumgebung
fortsetzen. Alle übrigen Schritte gelten für die Bereitstellungstestumgebung.
- Führen Sie in der Bereitstellungstestumgebung die folgenden Schritte aus.
- Speichern Sie die gesicherten Datenbanken aus der Produktionsumgebung in der
Bereitstellungsumgebung zurück. Sie sollten in der Bereitstellungsumgebung einen gesonderten Datenbankserver verwenden, um eine Überlastung des Produktionsdatenbankservers
zu vermeiden.
- Setzen Sie die Datenbankverbindungsparameter in den Dateien
Jazz-Installationsverzeichnis/server/conf/Anwendungsname/teamserver.properties
auf die Werte der Verbindungsparameter der Bereitstellungskopie der Datenbank in der Testumgebung. Dazu gehören die Einträge für die
Datenbank von jts, die Datenbanken der Anwendungen ccm und qm, die
Data-Warehouse-Datenbank und für aktualisierte Kennwörter.
- Als zusätzliche Vorsichtsmaßnahme zu den Pseudozuordnungen in der Zuordnungsdatei sollten Sie Ihre Datei 'hosts' aktualisieren (sofern dies in Ihrer Umgebung erlaubt ist),
um den Zugriff auf die URLs des Produktionssystems und
eine versehentliche Bearbeitung von Artefakten auf dem Produktionsserver zu verhindern.
Ziel ist es, die Hostnamen in eine falsche IP-Adresse aufzulösen, die von keinem der CLM-Server in der Produktionsumgebung
verwendet wird. Wenn also ein Server in der Bereitstellungsumgebung versucht, eine Verbindung zu einem Produktionsserver herzustellen, schlägt
dieser Versuch fehl.
Erstellen Sie eine Liste aller Hostnamen, die in Ihrer Zuordnungsdatei erscheinen. Dabei kann es sich um Quellen-URLs oder betroffene
URLs handeln. Erstellen Sie in der Datei 'hosts' für jeden einzelnen Namen einen Eintrag, der den Hostnamen einer falschen IP-Adresse zuordnet. Sie müssen die Datei 'hosts' für alle Server in Ihrer
Bereitstellungsumgebung bearbeiten, also auch die Datei 'hosts' für Server anderer Anbieter und für Clientworkstatations. In der folgenden Datei 'hosts' sehen Sie Beispieleinträge für
einen Bereitstellungsserver:
# 10.10.10.10 bezieht sich auf eine IP-Adresse, unter der keine CLM-Anwendung bereitgestellt wird.
10.10.10.10 ProduktionsserverP1
10.10.10.10 ProduktionsserverP2
10.10.10.10 ProduktionsserverP3
- Öffnen Sie im Verzeichnis Jazz-Installationsverzeichnis\server eine Eingabeaufforderung und importieren Sie die Zuordnungsdatei mit
dem
Befehl repotools-jts -importURLMappings in den Ziel-Jazz-Team-Server.
- 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="C:\mappings.txt"
./repotools-jts.sh -importURLMappings
fromFile="opt/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="C:\mappings.txt" serverConfFile="C:\serverConf.txt"
./repotools-jts.sh -importURLMappings
fromFile="/opt/mappings.txt" serverConfFile="/opt/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 wie folgt aus:
repotools-jts.bat -importURLMappings
fromFile="C:\mappings.txt"
./repotools-jts.sh -importURLMappings
fromFile="opt/mappings.txt"
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 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.
Überprüfen Sie die Konsolausgabe und die Datei
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.
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.
- Starten Sie Jazz Team Server und alle dezentralen CLM-Anwendungen,
die bei Jazz Team Server registriert sind.
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 (unter https://neuer
Host:Port/jts/serverRenameStatus), um den Status der Umbenennung zu
überprüfen.
Warten Sie, bis alle Anwendungen umbenannt sind und der Schritt 'Serverumbenennung abschließen' vollständig ausgeführt ist. Verifizieren Sie, dass die folgende
Nachricht erscheint: Die Serverumbenennung wurde erfolgreich abgeschlossen. Jazz Team Server und die Anwendungen sind voll funktionsfähig.
Sie können sofort mit der Servernutzung beginnen. Ein Neustart ist nicht erforderlich.
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.
Anmerkung: Wenn Sie Pseudozuordnungen zum Schutz der Produktionsumgebung eingeführt haben,
werden auf dem bereitgestellten Server auf der Diagnoseseite im Abschnitt
Anwendungen und Freunde Fehler zu diesen URLs angezeigt.
- Führen Sie bei Bedarf die folgenden Schritte aus, um
Rational Reporting for Development Intelligence (RRDI) in der Bereitstellungsumgebung zu konfigurieren.
- Sichern Sie die folgenden Datenbanken aus der Produktionsumgebung und speichern Sie sie auf einem neuen Datenbankserver
für die Neuinstallation von
RRDI in der Bereitstellungsumgebung zurück:
- Content-Store-Datenbank (z. B RICM)
- Data Warehouse (z. B. RIDW, sofern noch nicht gesichert und wiederhergestellt)
- Installieren Sie Rational Reporting for Development Intelligence
Version 2.0 in der Bereitstellungsumgebung. 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 aktualisieren 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 Bereitstellungsumgebung
zeigen.
Anmerkung: Dieser Schritt ist nur erforderlich, wenn Ihre Zuordnungsdatei keine
URLs für RRDI enthält.
- Verifizieren Sie, dass alle bisher importierten Berichte vom RRDI-Berichtsserver aus der Produktion
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 Bereitstellungsumgebung.
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.
- Falls Sie andere Komponenten wie die Jazz-Build-Steuerkomponenten, Clients von
Rational Team Concert,
Rational ClearQuest oder Rational ClearCase in Ihre Bereitstellungsumgebung aufnehmen, führen Sie alle dafür zusätzlich erforderlichen
Schritte aus. Einzelheiten finden Sie im Artikel Einschränkungen und zusätzliche Informationen.