Fehler der Benutzerschnittstelle für den Serverumbenennungsstatus

In diesem Artikel geht es um die Fehlersuche und um Wiederherstellungsprozeduren bei Fehlern, die während der Onlineumbenennung auftreten könnten.

Die Benutzerschnittstelle für den Serverumbenennungsstatus fragt bei Anwendungen den individuellen Umbenennungsstatus ab. Scheitert die Umbenennung einer Anwendung, kann die gesamte Serverumbenennung nicht abgeschlossen werden. Wenn Sie einen Fehler sehen, sollten Sie zu allererst in den Protokollen von Jazz Team Server und den Anwendungen überprüfen, was nicht ordnungsgemäß funktioniert hat. Nachfolgend sind einige allgemeine Fehler und Möglichkeiten der Fehlerbehebung aufgelistet.

Benutzerschnittstelle gibt an, dass Umbenennung nicht gestartet wurde

Nach Ausführung von importURLMappings sehen Sie einen /serverRenameStatus, der angibt, dass die Serverumbenennung nicht gestartet wurde.

Keine Umleitung zur Seite serverRenameStatus nach einer Umbenennung

Dies ist das erwartete Verhalten, wenn die Umbenennung bereits abgeschlossen ist. Prüfen Sie dies, indem Sie https://jts.example.org:9443/jts/serverRenameStatus aufrufen und sich vergewissern, dass für alle Prozesse 100 % und ein grünes Statussymbol angezeigt werden.

Umbenennung der Anwendung schlägt fehl

  1. Überprüfen Sie, ob die Anwendung aktiv ist und von Jazz Team Server aus mit einem Ping-Signal erreichbar ist.
  2. Prüfen Sie, ob Sie die rootservices jeder Anwendung im Browser erreichen können. Überprüfen Sie für CCM https://ccm.example.org:9443/ccm/rootservices. Wiederholen Sie diesen Schritt für die anderen Anwendungen.
  3. Sollte die Anwendung nicht aktiv sein, starten Sie sie. Sie müssen Jazz Team Server nicht erneut starten. Der Server fragt den Anwendungsstatus weiter ab. Wenn die Anwendung wieder online ist, wird der Status auf der Benutzerschnittstelle aktualisiert.
  4. Wenn die Anwendung aktiv ist, prüfen Sie, ob Sie Kontakt zur Anwendung herstellen können, für CCM beispielsweise unter https://ccm.example.org:9443/ccm/appServerRenameStatus. Wird ein Fehler 404 angezeigt, ist die Anwendung keine Anwendung der Version 4.0. Die Serverumbenennung wird nur von Anwendungen der Version 4.0 oder einer aktuelleren Version unterstützt. Vor der Serverumbenennung können Sie ein Upgrade durchführen. Einzelheiten hierzu enthält der Artikel roadmap_clm_upgrade.html.
  5. Überprüfen Sie die ausführlichen Fehlernachrichten in den Protokollen von Jazz Team Server und den Anwendungen.
  6. Prüfen Sie, ob im Verzeichnis server/conf/ jeder Anwendung eine Datei .mappingEvent vorhanden ist.

Benutzerschnittstelle zeigt abgeschlossene Umbenennung mit Fehlern an

Auf der Benutzerschnittstelle wird angezeigt, dass die Umbenennung abgeschlossen ist, dass aber Fehler auftreten, wenn für die Anwendung eine Aktion ausgeführt wird. Dies weist generell darauf hin, dass die Umbenennung nicht abgeschlossen ist.

  1. Stellen Sie anhand des Anwendungsprotokolls fest, ob aus Sicht der Anwendung die Umbenennung insgesamt abgeschlossen ist.
  2. Stoppen Sie die Anwendung.
  3. Öffnen Sie die WAR-Datei der Anwendung und rufen Sie WEB/web.xml auf. Suchen Sie in der XML nach folgenden Elementen:
    
    <filter>
       <filter-name>bridgefilter</filter-name>
       <filter-class>com.ibm.team.repository.server.servletbridge.BridgeFilter</filter-class>        
            </filter>
    <filter-mapping>
       <filter-name>bridgefilter</filter-name>
       <servlet-name>equinoxbridgeservlet</servlet-name>
    </filter-mapping>
  4. Wenn es diese Einträge nicht gibt, hatten die Anwendungen keine Kenntnis davon, dass die Umbenennung insgesamt abgeschlossen ist. Fügen Sie die Einträge hinzu und implementieren Sie die WAR-Datei neu. Starten Sie den Anwendungsserver neu und öffnen Sie eine Seite im Browser. Dadurch wird der Start der Anwendung ausgelöst. Öffnen Sie für die Anwendung CCM beispielsweise https://ccm.example.org:9443/ccm/admin.
  5. Überprüfen Sie, ob die WAR-Datei der anderen Anwendungen die Einträge enthält. Wenn das nicht der Fall ist, führen Sie die obigen Schritte erneut aus.

Abschluss der Serverumbenennung schlägt fehl

Nach Abschluss der Umbenennung aller Anwendungen werden für den Jazz Team Server mehrere Schritte ausgeführt.

  1. Stellen Sie anhand des Protokolls von Jazz Team Server fest, welcher Abschlussschritt fehlgeschlagen ist.
  2. Es ist möglich, dass beim Aktualisieren des Data Warehouse ein Fehler aufgetreten ist. Prüfen Sie, ob Ihre Data-Warehouse-Konfiguration in Ordnung und der Datenbankserver verfügbar ist.
  3. Gehen Sie nach Aufdeckung des Problems nach den allgemeinen Wiederherstellungsprozeduren vor. Der Abschlussschritt kann nicht erneut versucht werden.

Datei mit Zuordnungsereignissen fehlt

Bei einer dezentralen Umgebung ist es möglich, dass die Datei mit Zuordnungsereignissen nicht in das Konfigurationsverzeichnis der Anwendung kopiert wurde. Überprüfen Sie, ob das Verzeichnis server/conf/ der betreffenden Anwendung eine Datei .mappingEvent enthält. Sollte keine Datei .mappingEvent vorhanden sein, gehen Sie wie folgt vor:

  1. Stoppen Sie die Anwendung.
  2. Kopieren Sie die Datei .mappingEvent aus dem Verzeichnis server/conf/jts in das Verzeichnis server/conf der Anwendung.
    Anmerkung: Alle Dateien .mappingEvent einer gegebenen JTS-Topologie sind identisch.
  3. Starten Sie den Anwendungsserver erneut. Sie müssen Jazz Team Server nicht erneut starten. Der Server fragt den Anwendungsstatus weiter ab. Sobald die Anwendung wieder online ist, wird der Status auf der Benutzerschnittstelle aktualisiert.

Feedback