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.
- Sehen Sie sich die Datei repotools-jts_importURLMappings.log an. Vergewissern Sie sich, dass der Befehl erfolgreich ausgeführt wurde.
- Stoppen Sie den Jazz Team Server.
- Führen Sie repotools-jts -exportServerRenameURLMappingHistory
toFile=history.txt aus.
In der Datei history.txt sehen Sie den Verlauf der erstellten Zuordnungsereignisse. Prüfen Sie, ob die Ergebnisse
Ihren Erwartungen entsprechen. Prüfen Sie außerdem, ob für das Zuordnungsereignis
"COMPLETED" (abgeschlossen) angezeigt wird. Wenn Alle Zuordnungsereignisse abgeschlossen sind, hat der
Jazz Team Server die Bearbeitung beendet.
Das bedeutet, es gibt keine laufende Umbenennung mehr.
Einzelheiten hierzu
enthält der Artikel Verlaufsprotokoll der Serverumbenennungen prüfen.
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
- Überprüfen Sie, ob die Anwendung aktiv ist und von
Jazz Team Server aus mit einem Ping-Signal erreichbar ist.
- 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.
- 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.
- 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.
- Überprüfen Sie die ausführlichen Fehlernachrichten in den Protokollen von Jazz Team Server und
den Anwendungen.
- 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.
- Stellen Sie anhand des Anwendungsprotokolls fest, ob aus Sicht der Anwendung die Umbenennung insgesamt abgeschlossen ist.
- Stoppen Sie die Anwendung.
- Ö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>
- 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.
- Ü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.
- Stellen Sie anhand des Protokolls von Jazz Team Server fest, welcher
Abschlussschritt fehlgeschlagen ist.
- 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.
- 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:
- Stoppen Sie die Anwendung.
- 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.
- 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.