Zuordnungsdatei für die Serverumbenennung verstehen

In diesem Artikel ist die Struktur der Zuordnungsdatei beschrieben, die mit dem Befehl generateURLMappings generiert wird. Hier finden Sie auch Anweisungen für die Bearbeitung der Zuordnungsdatei entsprechend Ihrer Implementierung.

Wenn Sie bereit sind, eine Zuordnungsdatei zu generieren, befolgen Sie die Anweisungen im Artikel Zuordnungsdatei erstellen. Zusätzliche Beispiele finden Sie in den Artikeln Topologien und Zuordnungsdateien für die Einrichtung einer Bereitstellungsumgebung zu Testzwecken und Topologien und Zuordnungsdateien für das Szenario 'Überführung einer Pilotimplementierung in die Produktion'.

Die Zuordnungsdatei enthält URL-Paare (source-target) für Jazz Team Server, die bei diesem registrierten Anwendungen und für weitere, von Anwendungen beigetragene URLs. Die URLs sind zwei Typen zugeordnet:

Die URL-Paare, die in die Umbenennung einbezogen werden, umfassen alle URLs in der Domäne von Jazz Team Server. Dazu gehören der öffentliche URL von Jazz Team Server, die öffentlichen URLs der Anwendungen und weitere, von Anwendungen beigetragene URLs.

Zu den betroffenen URLs gehören alle anderen Systeme, die mit dieser Topologie interagieren, jedoch nicht zur Domäne dieses Jazz Team Server gehören. Der URL einer Anwendung, die bei einem anderen, befreundeten Jazz Team Server registriert ist, ist ein betroffener URL. URLs externer Produkte, die eingebunden sind, sind ebenfalls betroffene URLs.

Beschreibung einer Beispielzuordnungsdatei

# JTS
source=https://clmhost.example.org:9443/jts
target=https://clmhost2.example.org:9443/jts
# von clmhost.example.org:9443/jts zusätzlich in die Umbenennung einbezogene URLs
# ADMIN
source=https://clmhost.example.org:9443/admin
target=https://clmhost2.example.org:9443/admin
# (URL der CLM-Hilfe)
source=https://clmhost.example.org:9443/clmhelp
target=https://clmhost2.example.org:9443/clmhelp
# CCM
source=https://clmhost.example.org:9443/ccm
target=https://clmhost2.example.org:9443/ccm
# RM
source=https://clmhost.example.org:9443/rm
target=https://clmhost2.example.org:9443/rm
# Von RM ZUSÄTZLICH in die Umbenennung einbezogene URLs
source=https://clmhost.example.org:9443/converter/htmlgen
target=https://clmhost2.example.org:9443/converter/htmlgen
# QM
source=https://clmhost.example.org:9443/qm
target=https://clmhost2.example.org:9443/qm

# Die nachfolgend aufgelisteten URLs repräsentieren externe Server, die in Kombination mit diesem Jazz Team Server oder mit bei diesem Jazz Team Server registrierten Anwendungen verwendet werden.
# https://friend1.example.org:9443/jts/rootservices (Freundeseintrag)
# https://cqconnector.example.org:9084/cqconnector/gateway

Die generierte Zuordnungsdatei ist eine Schablone, die vor Ausführung von importURLMappings bearbeitet werden muss. Es ist wichtig, das Sie alle Einträge in der Zuordnungsdatei verstehen, damit alle Systeme in Ihrer Topologie ordnungsgemäß umbenannt werden. Der obere Abschnitt der Datei enthält die URL-Paare, die in die Umbenennung einbezogen werden. In diesem Beispiel sehen Sie URL-Paare für den öffentlichen URL von Jazz Team Server und alle Anwendungen, die bei diesem Jazz Team Server registriert sind. Außerdem sehen Sie URL-Paare, die von Anwendungen beigesteuert werden, z. B. das von Jazz Team Server beigetragene URL-Paar für die CLM-Hilfe und das von der Anwendung RM beigetragene URL-Paar für den Converter.

Sehen Sie sich jeden dieser URLs an und stellen Sie fest, welche sich ändern. Aktualisieren Sie den target-Eintrag für jeden URL, der umbenannt wird, mit dem entsprechenden neuen Wert. Falls ein angegebener Quellen-URL (source) nicht umbenannt wird, setzen Sie das Paar mit dem Zeichen ' #' auf Kommentar.

# JTS
#source=https://clmhost.example.org:9443/jts
#target=https://clmhost2.example.org:9443/jts

Der untere Abschnitt der Zuordnungsdatei enthält eine Liste der betroffenen URLs, die auf Kommentar gesetzt sind. Diese URLs werden nicht in die Umbenennung einbezogen, sind aber von den URL-Änderungen betroffen. Sie sollten diese URLs auf Kommentar gesetzt lassen, da sie hier nur als Referenz angegeben sind. Sie müssen überprüfen, ob diese URLs Teil eines unterstützten Szenarios sind. Ziehen Sie für diese Überprüfung die für Ihre Topologie zutreffende Dokumentation zur Umbenennung heran.

In einer Bereitstellungsumgebung sollten Sie betroffene URLs immer maskieren, um sicherzustellen, dass es keine Querverbindungen zwischen Bereitstellungsservern und Produktionsservern gibt. Einzelheiten dazu finden Sie weiter unten.

Pseudozuordnungen für Bereitstellungsumgebungen

Wenn Sie eine Bereitstellungsumgebung einrichten, müssen Sie für alle betroffenen URLs in der Zuordnungsdatei Pseudozuordnungen erstellen. Zu den betroffenen URLs können die URLs anderer CLM-Anwendungen gehören, die Freunde dieser Implementierung sind, oder die URLs externer Server. Erstellen Sie für Freundeseinträge eine Pseudozuordnung für den öffentlichen URL des Freundes.

Angenommen, der URL im Freundeseintrag lautet https://friendhost.example.org:9443/jts/rootservices. Der öffentliche URL wäre dann normalerweise https://friendhost.example.org:9443/jts. Fügen Sie am Ende Ihrer Zuordnungsdatei ein URL-Paar hinzu, bei dem der Ziel-URL (target) auf einen falschen Hostnamen gesetzt ist, um diesen URL zu maskieren. Verifizieren Sie die Nichterreichbarkeit des Pseudozielhosts, bevor Sie den Hostnamen auswählen.

# Freund
source=https://friendhost.example.org:9443/jts
target=https://dummyfriendhost.example.org:9443/jts

Jeder Zieleintrag (target) darf nur einmal verwendet werden. Wenn Sie mehrere Freundeseinträge haben, verwenden Sie dummyhost2, dummyhost3 usw. Für eine Einzelserverimplementierung, bei der sich Jazz Team Server und alle Anwendungen auf demselben Host befinden und denselben Port verwenden, können Sie wie unten beschrieben eine vereinfachte Zuordnung nutzen.

Fügen Sie für alle betroffenen URLs, die keine Freundeseinträge sind, am Ende Ihrer Zuordnungsdatei das folgende URL-Paar hinzu:

source=https://externalserver.example.org:9555/
target=https://dummyhost.example.org:9555/

Vereinfachte Zuordnungsdatei verwenden

Wenn Ihre Topologie einfach ist und das Protokoll, der Host, die Domäne und der Port bei allen URLs übereinstimmen, kann die Zuordnungsdatei auf einen source-target-Eintrag reduziert werden. Angenommen, Sie habe alle Anwendungen auf clmhost.example.org implementiert und möchten diese so umbenennen, dass sie newhost.example.org verwenden. In dem Fall könnten Sie die generierte Zuordnungsdatei so bearbeiten, dass sie nur die folgenden URLs enthält:

Anmerkung: Mit der vereinfachten Zuordnung von clmhost.example.org zu newhost.example.org werden nur der Jazz Team Server und die CLM-Anwendungen umbenannt. Integrierte Rational-Produkte oder integrierte Produkte anderer Anbieter werden nicht umbenannt. Führen Sie stets generateURLMappings aus, um festzustellen, ob Ihr Szenario unterstützt wird, und um sicherzustellen, dass die Umbenennung in Ihrer Topologie ordnungsgemäß durchgeführt wird.
source=https://clmhost.example.org:9443
target=https://newhost.example.org:9443

URLs mit Standard-Ports

Falls einer der Quellen-URLs (source) den Standard-Port verwendet und die Standard-Port-Nummer nicht explizit angegeben ist, werden zwei Gruppen von Zuordnungen benötigt, eine mit dem Standard-Port und eine ohne den Standard-Port. Der Befehl generateURLMappings generiert die zusätzlichen Zuordnungen automatisch für Sie. Die Standard-Ports sind 443 für HTTPS und 80 für HTTP.

Nehmen wir beispielsweise an, Sie würden eine vorhandene Anwendung CCM auf https://clmhost.example.org/ccm ausführen. In diesem Fall wurde CCM auf einem Server implementiert, der den Standard-Port verwendet (weil der Port für den Anwendungsserver konfiguriert wurde oder weil ein Reverse-Proxy-HTTP-Server am Standard-Port verwendet wird). In CLM können für URLs auch Links zu Ressourcen gespeichert sein, bei denen der Port explizit im URL angegeben ist. Beispiel:

https://clmhost.example.org:443/resource/...

Da die Möglichkeit besteht, URLs auf beide Formen zu speichern, muss für jede Form eine Zuordnung erstellt werden. Nehmen wir an, clmhost.example.org soll in newhost.example.org umbenannt werden. Für diese Umbenennung währen die folgenden Zuordnungen erforderlich. Die Paare werden von generateURLMappings automatisch generiert.

source=https://clmhost.example.org/ccm
target=https://newhost.example.org/ccm

source=https://clmhost.example.org:443/ccm
target=https://newhost.example.org:443/ccm

Beachtung der Groß-/Kleinschreibung

Die CLM-Anwendungen unterscheiden bei URLs die Groß-/Kleinschreibung. Der URL https://clmhost:443/jts wird also von https://CLMHOST:443/jts unterschieden. Sie müssen die Groß-/Kleinschreibung Ihrer Quellen-URLs beibehalten, da sie sonst nicht zugeordnet werden.

In den Ziel-URLs können Sie die Groß-/Kleinschreibung ändern, wenn Sie möchten. Folgende Zuordnung wäre beispielsweise zulässig:

source=https://CLMHOST:443/jts
target=https://clmhost:443/jts

Wenn Sie eine vereinfachte Zuordnungsdatei verwenden, müssen alle URLs (Quelle und Ziel) dieselbe Schreibweise haben. Angenommen, es gibt die folgenden URLs:

https://clmhost:443/jts
https://CLMHOST:443/ccm

Sie verwenden nun die folgende vereinfachte Zuordnung:

source=https://clmhost:443
target=https://clmhost:9443

In diesem Fall wird nur der erste URL zugeordnet, der zweite jedoch nicht. Um dies zu korrigieren, müssten Sie folgende weitere Zuordnung hinzufügen:

source=https://CLMHOST:443
target=https://CLMHOST:9443

Fehler bei der Generierung der Zuordnungsdatei

Aufgrund der großen zu verarbeitenden Datenmenge können Fehler auftreten. Einige Fehler liegen auf der Hand, z. B. der Versuch, die Zuordnungsdatei vor dem Start des Servers zu generieren oder die Verwendung falscher Berechtigungsnachweise für die Anmeldung. Andere Fehler sind weniger offensichtlich. Details zu Fehlern bei der Serverumbenennung enthält der Artikel Fehler bei der Serverumbenennung beheben.

Serverumbenennung unter z/OS

Die Umbenennung Ihres Servers wird unter z/OS unterstützt und ist mit dem Prozess unter anderen Betriebssystemen identisch, nur dass unter z/OS der Repository-Tools-Befehl -generateURLMappings nicht verwendet wird. Passen Sie stattdessen den Beispiel-JCL-Member BLZGENMP in HLQ.SBLZSAMP an. Hier steht HLQ für den High Level Qualifier, den Sie während der SMP/E-Installation angegeben haben. Ausführliche Anpassungsanweisungen finden Sie in den Kopfdaten von BLZGENMP in den Kommentaren.

Die Erstellung der Zuordnungsdatei für z/OS unterscheidet sich nicht von der Erstellung unter anderen Betriebssystemen, nur dass die Zuordnungsdatei in UTF-8 codiert ist. Verwenden Sie eines der folgenden Verfahren, um die UTF-8-Dateien unter z/OS UNIX zu bearbeiten:
  • Bei Verwendung von z/OS ab Version 1.10 oder z/OS 1.9 mit dem PTF für APAR OA22250 verwenden Sie ISPF Option 3.17, um die UTF-8-Dateien unter den z/OS UNIX System Services zu bearbeiten.
  • Bei Verwendung von Rational Developer für System z verwenden Sie Remote System Explorer zur Verbindungsherstellung und Änderung der Dateien.
  • Laden Sie die Dateien auf einen Windows-PC herunter oder übertragen Sie sie mit FTP, ändern Sie sie, und übertragen Sie sie zurück zum z/OS-System.
  • Wenn Sie über andere Tools für die Bearbeitung der UTF-8-Dateien unter den z/OS UNIX System Services verfügen, setzen Sie diese Tools ein.

Feedback