Fehler bei Ausführung des Befehls importURLMappings

In diesem Artikel sind Wiederherstellungsprozeduren für Fehler bei Ausführung des Befehls importURLMappings beschrieben.

Sollten während der Ausführung von importURLMappings ein Fehler auftreten, können Sie die Datei Jazz-Installationsverzeichnis/server/repotools-jts_importURLMappings.log prüfen.

Fehlender Eintrag in der Zuordnungsdatei

Wenn Sie feststellen, dass in Ihrer ursprünglichen Zuordnungsdatei ein Eintrag fehlte,, z. B. ein source-target-Paar für eine der CLM-Anwendungen, gehen Sie wie folgt vor:

  1. Fahren Sie Ihren Server herunter.
  2. Erstellen Sie eine neue Zuordnungsdatei, die nur den fehlenden Eintrag enthält.
  3. Wenden Sie die neue Zuordnungsdatei an. Führen Sie dazu erneut den Befehl repotools-jts -importUrlMappings aus.

Fehler im Ziel-URL einer Zuordnung

Wenn Ihnen im Ziel-URL ein Fehler unterlaufen ist, ergreifen Sie die folgenden Korrekturmaßnahmen. Da Korrekturen kumulativ sind, können Sie jederzeit durchgeführt werden, solange der Server abgeschaltet ist. Sie können diese Korrekturen auch für mehrere Einträge vornehmen, sollten jedoch nur Einträge für Fehler hinzufügen. URLs, die Sie für ordnungsgemäß zugeordnet halten, sollten nicht aufgenommen werden. Angenommen, Ihre ursprüngliche Zuordnungsdatei enthält den folgenden Eintrag:
...
source=https://meinOriginal-URL
target=https://meinZiel-URLmitTippfehler
...
  1. Fahren Sie den Server herunter.
  2. Erstellen Sie eine neue Zuordnungsdatei mit der korrigierten Zuordnung. Fügen Sie diesen Eintrag nicht zur ursprünglichen Zuordnungsdatei hinzu. Der Eintrag könnte folgendermaßen aussehen:
    source=https://meinZiel-URLmitTippfehler
    target=https://meinKorrigierterZiel-URL
  3. Wenden Sie die neue Zuordnungsdatei an. Führen Sie dazu erneut den Befehl repotools-jts -importUrlMappings aus.

Fehler im Quellen-URL einer Zuordnung

Der Prozess ist ähnlich dem im vorherigen Abschnitt, aber ein bisschen komplizierter, weil Sie zwei separate Korrekturmaßnahmen durchführen müssen. Angenommen, Ihre ursprüngliche Zuordnungsdatei enthält den folgenden Eintrag:

...
source=https://meinOriginal-URLmitTippfehler
target=https://meinZiel-URL
...
  1. Erstellen Sie eine neue Zuordnungsdatei mit der folgenden korrigierten Zuordnung. Diese Zuordnungsdatei soll den Ziel-URL (meinZiel-URL) ausräumen.
    source=https://meinZiel-URL
    target=dummy://einTest-URL
  2. Wenden Sie die neue Zuordnungsdatei an. Führen Sie dazu erneut den Befehl repotools-jts -importUrlMappings aus. Wenden Sie die richtige Zuordnung wie folgt an:
    source=https://meinOriginal-URL
    target=https://meinZiel-URL

Versuchen Sie nicht, diese Zuordnungen in einer Datei zu kombinieren. Die oben dargestellten Korrekturzuordnungen müssen unabhängig voneinander angewendet werden, damit sich das System ohne Mehrdeutigkeiten selbst korrigieren kann.

Versehentliche Verwechselung von source und target in der Zuordnungsdatei

Ihre Ausgangssituation könnte wie folgt aussehen:

...
source=https://meinZiel-URL
target=https://meinQuellen-URL
...
Wichtig: Für dieses Szenario gibt es nur die allgemeinen Wiederherstellungsprozeduren.

Als Abhilfe müssen Sie die allgemeinen Wiederherstellungsregeln befolgen. Das Problem besteht darin, dass eine solche Zuordnung ausdrückt, dass es die Anwendung unter https://meinZiel-URL auch unter https://meinQuellen-URL gibt. Da dies die Position ist, an der sich Ihre Anwendung bereits befindet, entsteht eine Mehrdeutigkeit, die nicht aufgehoben werden kann.

Syntaxfehler in der Zuordnung

Korrigieren Sie den Fehler und führen Sie importURLMappings erneut aus.

Befehlsausführung schlägt mit Nachricht CRJAZ2436E fehl

In einem Cluster wird die Serverumbenennung nicht unterstützt. Während der Offline- und Onlinephase der Umbenennung dürfen Jazz Team Server und die CLM-Anwendungsserver nicht im Clustermodus arbeiten.

Befehlsausführung schlägt mit Nachricht CRJAZ2449E fehl

Das Upgrade wurde gestartet, konnte aber nicht abgeschlossen werden. Dieser Fehler tritt in der Regel auf, wenn vor Abschluss eines Onlineupgrades eine Umbenennung versucht wird. Für RM muss nach dem Offlineupgrade eine Onlinemigration durchgeführt werden. Schließen Sie das Onlineupgrade ab. Einzelheiten hierzu enthält der Artikel roadmap_clm_upgrade.html. Fahren Sie den Server herunter und versuchen Sie erneut, importURLMappings auszuführen.

Befehl meldet die Warnung CRJAZ2425W

Diese Warnung zeigt an, dass die Datei mit Zuordnungsereignissen keine neuen Zuordnungen enthält. Dies kann geschehen, wenn eine Zuordnungsereignisdatei zweimal importiert wird oder wenn die ursprünglich generierte Datei mit Zuordnungsereignissen nicht aktualisiert wurde und daher nicht die Ziel-URLs enthält. Verifizieren Sie, dass das Argument für die Datei mit Zuordnungsereignissen auf die richtige Datei zeigt, und überprüfen Sie den Inhalt der Datei.

Befehl zeigt Nachricht CRJAZ2197E an

Das Protokoll von importURLMappings enthält Fehler mit der Kennung CRJAZ2197E, oder die Nachricht CRJAZ2197E erscheint, wenn Sie nach der Ausführung von importURLMappings den Server starten.

Die Nachricht lautet: Der öffentliche URI für diesen Server ist schon auf https://jts.source.example.org:9443/jts gesetzt. Nachdem der Server konfiguriert wurde, kann er nicht mehr in https://jts.target.example.org:9443/jts geändert werden. Wenn der Server an eine neue Position unter https://jts.target.example.org:9443/jts verlagert wurde, befolgen Sie die Anweisungen für die Serverumbenennung.

Wenn die Ausführung von importURLMappings fehlschlägt, sollten die URLs in der Datei teamserver.properties von JTS auf ihre ursprünglichen Werte zurückgesetzt werden. Ist das nicht der Fall, können Sie die Datei teamserver.properties manuell mit dem ursprünglichen URL aktualisieren. Führen Sie dann importURLMappings erneut aus oder starten Sie den Server neu.


Feedback