Zuordnungsdatei erstellen

In diesem Artikel ist die Erstellung der Zuordnungsdatei beschrieben, die Sie später bei der Umbenennung Ihrer CLM-Server verwenden werden. Sie können die Zuordnungsdatei vor der eigentlichen Umbenennung erstellen und prüfen, solange Ihre Server noch online sind.

Vorbereitende Schritte

Wichtig: Die Möglichkeit der Serverumbenennung ist ein Feature von CLM Version 4. Vor einer Serverumbenennung müssen Sie daher für Ihren Jazz Team Server und alle CLM-Anwendungen ein Upgrade auf Version 4 durchführen.

Informationen zu diesem Vorgang

Bevor Sie einen Server tatsächlich umbenennen können, sind diverse Schritte notwendig. Großen Raum nehmen dabei die Erstellung und Prüfung der Zuordnungsdatei ein, die Sie für die Umbenennung verwenden. In der Zuordnungsdatei sind die vorhandenen Quellen-URLs und die umbenannten Ziel-URLs Ihrer Implementierung aufgelistet. Dazu gehören die URLs von Jazz Team Server, der CLM-Anwendungen, der WAR-Datei für die CLM-Hilfetexte und aller anderen betroffenen Anwendungen. Beispiele für Topologiediagramme und Zuordnungsdateien finden Sie im Artikel Topologien und Zuordnungsdateien für die Einrichtung einer Bereitstellungsumgebung zu Testzwecken.

Sie können diese Schritte in einer CLM-Implementierung ausführen, bei der Jazz Team Server und die CLM-Anwendungen auf demselben Computer installiert sind, aber auch in einer verteilten Implementierung, bei der die CLM-Anwendungen auf verschiedenen Computern installiert sind. Diese vorbereitenden Schritte sind in vielen Situationen nutzbar, z. B., wenn ein Computer an einen neuen physischen Standort verlagert wird, wenn eine Test-Sandbox auf einem neuen Computer eingerichtet wird oder wenn ein Rechenzentrum konsolidiert wird, was eine umbenannte Umgebung auf neuen Computern mit sich bringt.

For z/OS operating system Anmerkung: Unter z/OS wird die Umbenennung eines Servers auch unterstützt. Hier gibt es bei der Erstellung einer Zuordnungsdatei jedoch einige Unterschiede. Ausführliche Informationen hierzu enthält der Artikel Serverumbenennung unter z/OS.

Vorgehensweise

  1. Nachdem Sie für alle an der Umbenennung beteiligten Server ein Upgrade auf Version 4 durchgeführt haben, starten Sie Jazz Team Server (JTS) und verifizieren Sie, dass die Anwendungen ordnungsgemäß beim Server registriert sind.
    1. Melden Sie sich auf der Seite Verwaltung von Jazz Team Server an. Zeigen Sie in Ihrem Webbrowser auf https://Hostname:Port/jts/admin.
    2. Klicken Sie auf das Register Server.
    3. Klicken Sie im linken Fenster im Abschnitt "Konfiguration" auf Registrierte Anwendungen.
    4. Verifizieren Sie, dass alle Ihre Anwendungen registriert sind.

    Ausführliche Informationen hierzu enthält der Artikel Anwendungen bei Jazz Team Server registrieren.

  2. Öffnen Sie auf dem Computer, auf dem Jazz Team Server installiert ist, eine Eingabeaufforderung und rufen Sie das Verzeichnis Jazz-Installationsverzeichnis\server auf.
    Anmerkung: Diesen Schritt und die folgenden Schritte müssen Sie für den ursprünglichen Jazz Team Server ausführen, auch wenn Sie auf neue Hardware umstellen.
  3. Generieren Sie wie nachfolgend gezeigt mit dem Befehl repotools-jts -generateURLMappings eine erste Zuordnungsdatei, die Sie dann als Schablone verwenden und weiter bearbeiten können. Wenn Sie den Befehl bereits ausgeführt haben oder die Datei schon vorhanden ist, fügen Sie den Parameter overwrite=true hinzu.
    Anmerkung: Alle für UNIX angegebenen Beispiele sind auch für Linux gültig.
    • For Windows operating system repotools-jts.bat -generateURLMappings toFile=mappings.txt adminUserId=<adminId> adminPassword=<adminPassword>
    • For Unix operating systems ./repotools-jts.sh -generateURLMappings toFile=mappings.txt adminUserId=<adminId> adminPassword=<adminPassword>

    Die Ausgabe dieses Befehls ist eine Zuordnungsdatei, in der der vorhandene öffentliche Quellen-URL und ein Standardziel-URL für Jazz Team Server und für jede bei Jazz Team Server registrierte CLM-Anwendung (CCM, QM und RM) aufgelistet ist. Die Datei gibt außerdem den Quellen- und Ziel-URL für die WAR-Datei mit den CLM-Hilfetexten an und für alle betroffenen Systeme, die bekannt sind.

    Vergewissern Sie sich, dass die Protokolldatei unter Jazz-Installationsverzeichnis/server/repotools-jts_generateURLMappings.log keine Fehler enthält.

  4. Prüfen Sie die generierte Zuordnungsdatei gründlich und bearbeiten Sie sie mit der gebotenen Sorgfalt. Suchen Sie nach Schreibfehlern in den Hostnamen, Ports oder Stammkontexten. Einige Schreibfehler werden von den Tools für die Serverumbenennung nicht erkannt und können so zu einem nicht funktionierenden Produkt führen.

    Lesen Sie den Artikel Zuordnungsdatei für die Serverumbenennung verstehen, um sich mit der Struktur der Zuordnungsdatei vertraut zu machen. Prüfen Sie die generierte Zuordnungsdatei gründlich und bearbeiten Sie sie mit der gebotenen Sorgfalt.

    1. Stellen Sie sicher, dass es für jede umzubenennende Anwendung und für die WAR-Datei mit den CLM-Hilfetexten ein source-target-Paar vorhanden ist.
    2. Bearbeiten Sie für die Einträge, bei denen Sie das Ziel korrigieren möchten, die Angabe target= urls.
      Anmerkung: Wenn Sie eine Port-Nummer von JTS oder einer Anwendung umbenennen, müssen Sie die Port-Angaben im Anwendungsserver nach der Umbenennung und vor dem Neustart des Servers aktualisieren. Einzelheiten hierzu enthält der Artikel Port-Nummern des Anwendungsservers ändern. Wenn Sie ein Kontextstammverzeichnis von JTS oder einer Anwendung umbenennen müssen, lesen Sie den Artikel Kontextstammverzeichnis ändern.
    3. Verwenden Sie das Zeichen '#', um source-target-Paare für URLs, die nicht umbenannt werden sollen, auf Kommentar zu setzen.
    4. Sehen Sie sich die Liste der betroffenen URLs an. Der Befehl sucht zwar nach allen bekannten URLs der Implementierung, könnte aber eventuell einige übersehen haben. Sollten Sie Unsicherheiten in Bezug auf die Umgebung haben, sprechen Sie mit einem Administrator, bevor Sie mit der Umbenennung fortfahren.
    Anmerkung: Falls bis zur eigentlichen Umbenennung noch Konfigurationsänderungen an der CLM-Implementierung vorgenommen werden, müssen Sie die Zuordnungsdatei erneut generieren.
  5. Falls in Ihrem Szenario neue Hardware hinzukommt, installieren Sie CLM Version 4 auf den neuen Computern. Führen Sie nicht den Jazz-Setup-Assistenten aus und starten Sie Jazz Team Server nicht. Informationen hierzu finden Sie im Artikel Jazz Team Server und die Anwendungen der Rational-Lösung für Collaborative Lifecycle Management installieren.

Nächste Schritte

Fahren Sie mit der Serverumbenennung fort. Einzelheiten hierzu finden Sie im Artikel Pilotimplementierung mittels Serverumbenennung in die Produktion überführen bzw. Bereitstellungsumgebung mit Produktionsdaten zu Testzwecken einrichten.

Feedback