Tipps zur Fehlerbehebung bei Messaging-Engines

Dieser Artikel enthält spezifische Tipps für die Fehlerbehebung bei den Messaging-Engines in der Serviceintegration.

Die Messaging-Engine wird nicht gestartet, weil die Laufzeit noch nicht initialisiert ist

Eine Messaging-Engine wird nicht gestartet, und der folgende Fehler wird in der Administrationskonsole von WebSphere Application Server angezeigt:

Die Messaging-Engine <Name> kann nicht gestartet werden, weil
noch keine Laufzeitumgebung für sie initialisiert ist. Wiederholen Sie die Operation, sobald
die Laufzeitumgebung initialisiert ist. Wenn das dynamische Neuladen der Konfiguration für
diesen Bus aktiviert ist, müssen die Server erneut gestartet werden.

Bevor Sie versuchen, die Messaging-Engine erneut zu starten, müssen Sie sicherstellen, dass der Server erneut gestartet wurde. Damit die Laufzeitumgebung erfolgreich initialisiert werden kann, muss der Anwendungsserver gestartet werden.

Um festzustellen, ob die Initialisierung der Messaging-Engine durch ein Startproblem verursacht wird, suchen Sie in der Datei "SystemOut.log" des Host-Servers nach Fehlernachrichten.
Anmerkung: Dieser Artikel referenziert eine oder mehrere Protokolldateien des Anwendungsservers. Alternativ dazu wird empfohlen, den Server so zu konfigurieren, dass er die HPEL-Protokoll- und -Traceinfrastruktur (High Performance Extensible Logging) verwendet und nicht die Dateien SystemOut.log , SystemErr.log, trace.log und activity.log auf verteilten oder IBM® i-Systemen. Sie können HPEL auch in Verbindung mit Ihren nativen z/OS-Protokolleinrichtungen verwenden. Wenn Sie HPEL verwenden, können Sie mit dem Befehlszeilentool LogViewer im Verzeichnis "bin" des Serverprofils auf alle Ihre Protokoll- und Tracedaten zugreifen. Weitere Informationen zur Verwendung von HPEL finden Sie in der Dokumentation zum Einsatz von HPEL für die Fehlerbehebung in Anwendungen.

Die Messaging-Engine kann nicht gestartet werden, weil ein unerwarteter Fehler im Informix JDBC Driver 3.00JC1 aufgetreten ist

Wenn Sie versuchen, den Informix JDBC Driver 3.00JC1 zum Speichern der Daten zu verwenden, kann die Messaging-Engine nicht gestartet werden, und in der Datei "SystemOut.log" von WebSphere Application Server wird möglicherweise die folgende Fehlernachricht angezeigt:

00000022 SibMessage E [RetireBus:retire_web.000- RetireBus] CWSIS0002E: 
Beim Starten der Messaging-Engine ist eine Ausnahme eingetreten.
Ausnahme: com.ibm.ws.sib.msgstore.PersistenceException: CWSIS1501E:
Die Datenquelle hat eine unerwartete Ausnahme generiert: java.sql.BatchUpdateException:
Unique constraint (informix.u114_62) violated.
00000022 SibMessage E [RetireBus:retire_web.000- RetireBus] CWSID0035E:
Die Messaging-Engine retire_web.000-RetireBus kann nicht gestartet werden.
Es wurde ein Fehler in com.ibm.ws.sib.msgstore.impl.MessageStoreImpl start() festgestellt.
00000022 SibMessage E [RetireBus:retire_web.000- RetireBus] CWSID0027I:
Die Messaging-Engine retire_web.000-RetireBus kann nicht erneut gestartet
werden, weil ein schwerwiegender Fehler gemeldet wurde.]
00000022 SibMessage I [RetireBus:retire_web.000- RetireBus] CWSID0016I: 
Die Messaging-Engine retire_web.000-RetireBus hat den Status
Gestoppt. 

Der Informix JDBC Driver 3.00JC1 weist einen bekannten Mangel (PTS 172471) auf. Sie können diesen Fehler vermeiden, indem Sie für den Informix JDBC Driver ein Upgrade auf 3.00JC2 durchführen.

Fehlerbestimmung für einen Datenspeicher

Sie können einen Speicherauszug in reduzierter Form für die Daten im Datenspeicher einer Messaging-Engine erstellen. Die Ausgabe ist für das IBM Servicepersonal bestimmt. Informationen zum Ausführen des Befehls erhalten Sie von Ihrer Unterstützungsorganisation.
Sollte ein Problem mit den Daten im Datenspeicher vorliegen, ist dieses anhand der Traceausgabe nur schwer zu diagnostizieren. Sie können jedoch einen Speicherauszug (im XML-Format) der Daten im Datenspeicher erstellen. Dieser vereinfacht die Diagnose, weil er eine lesbar ist und bei Bedarf in andere Formate konvertiert werden kann. Sie können einen Speicherauszug für den Datenspeicher erstellen. Geben Sie dazu im Tool "wsadmin" den folgenden Befehl ein:
  • Mit Jython:
    AdminControl.invoke(AdminControl.queryNames("type=SIBMessagingEngine,
     name=messagingenginename,*"),
     "dump", "com.ibm.ws.sib.msgstore.*")
  • Mit Jacl:
    $AdminControl invoke [$AdminControl queryNames type=SIBMessagingEngine,
     name=messagingenginename,*] 
     dump com.ibm.ws.sib.msgstore.*

Der Speicherauszug wird als XML-Datei im Verzeichnis $WAS_HOME/logs/server1 erstellt. Der Dateiname hat das folgende Format: Name_der_Messaging-EngineUUIDZeitmarke.xml

Das Format der Datei wird im folgenden Beispiel veranschaulicht:
<MessageStore>
    <itemStreams>
        <ItemStreamLink id="0" state="Available">
            <class>com.ibm.ws.sib.msgstore.ItemStream</class>
            <priority>5</priority>
            <canExpireSilently></canExpireSilently>
            <storageStrategy>STORE_NEVER</storageStrategy>
            <expiryTime>0</expiryTime>
            <sequence>0</sequence>
            <tranID>null</tranID>
            <tickValue>0</tickValue>
            <items>
                <ItemLink id="2" state="Available" refCount="3" refCountDecreasing="false">
                    <class>com.ibm.ws.sib.msgstore.Item</class>
                    <priority>5</priority>
                    <canExpireSilently></canExpireSilently>
                    <storageStrategy>STORE_NEVER</storageStrategy>
                    <expiryTime>0</expiryTime>
                    <sequence>1</sequence>
                    <tranID>null</tranID>
                    <tickValue>0</tickValue>
                </ItemLink></items></ItemStreamLink></itemStreams></MessageStore>

Messaging-Engines lösen Nachrichten bezüglich Datenbankkonflikten aus

Wenn eine Messaging-Engine eine Datenspeicher als Nachrichtenspeicher verwendet und diese Messaging-Engine versehentlich zweimal gestartet wird, wird eine Nachricht zu einem Datenbankkonflikt angezeigt:
CWSIS1546I: The messaging engine, ME_UUID={0}, INC_UUID={1}, has lost
an existing lock or failed to gain an initial lock on the data store.
Gehen Sie wie folgt vor, um den Fehler zu beheben:
  • Suchen Sie nach Problemen mit der Datenbank, z. B. Nichtverfügbarkeit der Datenbank.
  • Suchen Sie nach Problemen mit dem Netz. Wenn das Netz beispielsweise überlastet ist, können zwei Anwendungsserver unter Umständen zwar eine Verbindung zur Datenbank herstellen, aber möglicherweise nicht untereinander, was zu Problemen bei der Ressourcenkoordination führt.

Mögliche Ursachen für die Ausnahme "XAResourceNotAvailableException" und entsprechende Maßnahmen

Wenn der Befehl deleteNode für einen Knoten verwendet wird, auf dem Messaging-Engines ausgeführt werden, werden diese Messaging-Engines gelöscht. Wenn anschließend mit dem Befehl addNode neue Messaging-Engines erstellt werden, erhalten diese andere Kennungen (IDs). Deshalb ist es während der Transaktionswiederherstellung nicht möglich, eine Verbindung zu den alten Messaging-Engines herzustellen. Es wird eine Nachricht mit der Ausnahme XAResourceNotAvailableException in der Datei SystemOut.log für jeden Server generiert, in dem eine Messaging-Engine ausgeführt wird.

Zur Behebung dieses Fehlers müssen Sie die im Artikel Unbestätigte Transaktionen auflösen beschriebene Prozedur ausführen.

Probleme beim erneuten Erstellen eines Service Integration Bus

Wenn Sie einen Service Integration Bus löschen und später einen neuen Bus mit demselben Namen erstellen, kann die Messaging-Engine nicht gestartet werden, und Nachrichten wie die folgenden werden in der Datei SystemOut.log generiert:
[8/11/04 21:55:01:439 CDT] 0000000f SibMessage    I   
[LateBus:xyzsun15.server1-LateBus] isAlive: MessagingEngine suffered common mode error. Correct error (see logs) and restart server.
[8/11/04 21:55:01:468 CDT] 0000000f SibMessage    I   
[LateBus:xyzsun15.server1-LateBus] isAlive: MessagingEngine will be stopped 
because of common mode error. 
No failover will occur.
[8/11/04 21:55:01:493 CDT] 0000000f SibMessage    I   
[LateBus:xyzsun15.server1-LateBus] Messaging Engine 
xyzsun15.server1-LateBus not in state from which stop is valid: Starting
[8/11/04 21:55:01:513 CDT] 0000000f SibMessage    I   
[LateBus:xyzsun15.server1-LateBus] isAlive: MessagingEngine stopped because 
of common mode error. Correct error (see logs) and restart server.
[8/11/04 21:57:01:431 CDT] 0000000e SibMessage    I   
[LateBus:xyzsun15.server1-LateBus] isAlive: MessagingEngine suffered 
common mode error. 
Correct error (see logs) and restart server.

Die Messaging-Engine wird nicht gestartet, weil das Datenbankverzeichnis für die Messaging-Engine auch nach dem Löschen des Busses noch vorhanden ist und manuell entfernt werden muss. Zum Löschen der Apache-Derby-Datenbank für eine nicht vorhandene Messaging-Engine müssen Sie das Datenbankverzeichnis in Profilstammverzeichnis/databases/com.ibm.ws.sib löschen, wobei Profilstammverzeichnis für das Verzeichnis steht, in dem profilspezifische Informationen gespeichert werden.

Sie müssen WebSphere Application Server stoppen, bevor Sie die Datenbankdateien löschen können.

Bei anderen Datenbanken können Sie entweder alle Zeilen aus den Datenspeichertabellen oder alle Datenspeichertabellen löschen. Diese Tabellen sind im Schema enthalten, das Sie für den Datenspeicher konfiguriert haben. Eine Liste der Tabellen finden Sie im Artikel Datenspeichertabellen.

Weitere Informationen hierzu finden Sie im Artikel Lebenszyklus eines Datenspeichers.

Probleme bei der Kommunikation mit fremden Bussen

Damit eine Kommunikation zwischen Bussen möglich ist, müssen ein fremder Bus und ein SIB-Link erstellt werden. Im ersten Bus muss der Name des fremden Busses mit dem Namen des zweiten Busses übereinstimmen, der ein fremder Bus wird, und der Name des fremden Busses für diesen zweiten Bus muss mit dem Namen des ersten Busses übereinstimmen. Der SIB-Link muss in beiden Bussen denselben Namen haben.

Es kann ein Fehler des folgenden Typs angezeigt werden, falls die Konfiguration nicht korrekt ist, z. B. weil die SIB-Links nicht übereinstimmen.

SibMessage E [TechBus:TechCluster.000-TechBus] CWSIT0057E: Die
busübergreifende Verbindung BookstoreBus ist in der fernen Messaging-Engine auf Host
aixp401.rchland.ibm.com mit dem folgenden Ursachencode fehlgeschlagen: CWSIT0067E: Die
Die busübergreifende Verbindung BookstoreBus in Bus BookstoreBus ist nicht verfügbar.

Fehler bei der Kommunikation mit einem umbenannten fremden Bus

In der Anzeige der Administrationskonsole, die für die Konfiguration der Eigenschaften eines SIB-Links verwendet wird, können Sie den Namen des fremden Busses ändern, auf den der Link zeigt. Nach der Konfiguration darf der Name des fremden Busses jedoch nicht geändert werden. Wenn Sie den Namen ändern, können alle Messaging-Engines, die bereits Statusinformationen zu diesem Link verwalten, den Link so lange nicht mehr verwenden, bis der Name des fremden Busses auf den vorherigen Wert zurückgesetzt wird.

Mögliche Ursachen einer JMSException mit einer gepackten Ausnahme SILimitExceeded

Wenn die Anzahl der Nachrichten an einem Ziel den definierten Schwellenwert erreicht, scheitert jeder Versuch, eine Nachricht an diess Ziel zu senden, mit einer JMSException mit einer gepackten Ausnahme SILimitExceeded. Das Ziel gibt diese Ausnahme so lange aus, bis die Anzahl der Nachrichten am Ziel wieder unter dem Schwellenwert liegt.

Um die genaue Anzahl der verfügbaren Nachrichten zu erhalten, können Sie die PMI-Statistik "Anzahl der verfügbaren Nachrichten" für Ziele des Typs "Warteschlange" und "Topicbereich" überwachen. Wenn sich die Anzahl verfügbarer Nachrichten erhöht, sollten Sie Maßnahmen für einen Lastausgleich einleiten. Sie können beispielsweise verhindern, dass Erzeuger neue Nachrichten senden, bis das Ziel die verfügbaren Nachrichten wieder konsumiert.

Sehen Sie sich die folgende Liste möglicher Ursachen und Lösungen für dieses Problem an:
  • Der obere Schwellenwert für das Ziel ist für die geplante Anzahl von Nachrichten zu niedrig gewählt. Das Ziel verarbeitet einige Nachrichten nicht. Der Standardwert für den oberen Schwellenwert ist 50000.
    Lösung: Erhöhen Sie den oberen Schwellenwert für das Ziel.
  • Anwendungen erzeugen mehr Nachrichten, als das Ziel verarbeiten kann.

    Im Idealfall ist das Verhältnis von erzeugten Nachrichten und konsumierten Nachrichten über einen bestimmten Zeitraum hinweg ausgeglichen. Sollte das Verhältnis unausgeglichen sein und die erzeugende Anwendung mehr Nachrichten senden, als das Ziel konsumieren kann, löst die erzeugende Anwendung nach einer gewissen Zeit eine Ausnahme des Typs "JMSException" aus.

    Lösung: Sorgen Sie dafür, dass das Verhältnis zwischen erzeugten Nachrichten und konsumierten Nachrichten ausgeglichen ist.
    Tipp: Die Standardeinstellung für den Thread-Pool des Object Request Broker (ORB) sind 100 Threads. In einigen Anwendungen kann diese Einstellung zulassen, dass 100 Anwendungen Nachrichten an dasselbe Ziel senden. Sie sollten den ORB-Thread-Pool auf einen Maximalwert von 10 Threads einstellen. Diese niedrigere Einstellung bewirkt, dass weniger Erzeuger Nachrichten senden können und sich damit der Nachrichtendurchsatz insgesamt erhöht.
  • Anwendungen verarbeiten die Nachrichten vom Ziel zu langsam.
    Lösung: Möglicherweise müssen Sie die Anzahl der von den Clientanwendungen konsumierten Nachrichten erhöhen. Ein Ziel verarbeitet mehr Nachrichten, wenn mehrere Konsumenten von diesem Ziel lesen.

    Sie könnten in einer Umgebung ohne Cluster Ihre Anwendung beispielsweise auf mehreren Servern klonen. In einer Umgebung mit Server-Clustern werden Anwendungen standardmäßig geklont. Zum Aktivieren von Subskribenten in einer Umgebung ohne Cluster setzen Sie das Flag cloned in der JNDI-Einstellung TopicConnectionFactory auf DurableSubscriptions.

    Einschränkung: Diese Lösung ist für Anwendung, die eine genaue Einhaltung der Nachrichtenreihenfolge erfordern, nicht geeignet.
  • Nachrichten haben ein Servicequalitätsattribut, das höher ist ale "Bestmöglich, nicht persistent".
    Lösung: Verwenden Sie Nachrichten mit dem Servicequalitätsattribut "Bestmöglich, nicht persistent". Wenn zu viele Nachrichten im System vorhanden sind, verwirft das Ziel Nachrichten mit dem Attribut "Bestmöglich, nicht persistent".
    Einschränkung: Diese Lösung ist für Anwendungen, die alle Nachrichten empfangen müssen, nicht geeignet.

Probleme mit Beschädigungen bei Systemneustarts

In seltenen Fällen ist es möglich, dass eine Messaging-Engine, ein Ziel oder ein Link durch den Neustart des Systems beschädigt wird. Bei einer solchen Beschädigung wird eine Nachricht angezeigt, die den Fehler beschreibt. Sollte der Fehler bei der Messaging-Engine liegen, wird die Messaging-Engine nicht gestartet. Sollte ein Ziel oder ein Link beschädigt sein, wird die zugehörige Messaging-Engine zwar gestartet, aber das Ziel bzw. der Link kann in dieser Messaging-Engine nicht verwendet werden.

Falls Sie die Ursache des Fehlers nicht kennen, sollten Sie die Situation mit einem IBM Servicemitarbeiter klären, bevor Sie versuchen, den Fehler selbst zu beheben.

Wenn Sie die Fehlerursache kennen, z. B. ein Problem mit der Datenbank, gehen Sie zur Fehlerbehebung wie folgt vor:
  1. Verwenden Sie die Administrationskonsole, um sicherzustellen, dass die Konfigurationsdateien im System synchronisiert sind. Navigieren Sie dazu zu Systemverwaltung -> Knoten, und klicken Sie anschließend auf Vollständige Neusynchronisation. Diese Operation kann mehrere Minuten dauern.
  2. Sollte der Fehler weiterhin auftreten, führen Sie eine der folgenden Tasks aus:
    • Löschen Sie das beschädigte Objekt, und erstellen Sie es erneut. Nachrichten, die vor dem Auftreten des Fehlers erzeugt oder empfangen wurden, gehen verloren.
    • Stellen Sie das System von einer Sicherung wieder her. Informationen hierzu finden Sie im Artikel Einen Datenspeicher und seine Messaging-Engine wiederherstellen. Nachrichten, die nach dem Erstellen der Sicherung erzeugt oder empfangen wurden, gehen verloren.

Status von Messaging-Engines in der Administrationskonsole abrufen

Damit Sie den Status von Messaging-Engines abrufen können, müssen Sie mindestens mit Überwachungsberechtigung an der Administrationskonsole angemeldet sein. Sollten Sie diese Berechtigung nicht haben, wird als Status für die Messaging-Engine "Nicht verfügbar" angezeigt, selbst wenn die Messaging-Engine gestartet ist.

Auch wenn Sie nicht mit der erforderlichen Berechtigung für das Abrufen des Status einer Messaging-Engine angemeldet sind, wird eine Fehlernachricht wie die folgende in der Protokolldatei systemOut des Servers aufgezeichnet:
[4/20/05 10:49:57:083 CDT] 0000004b RoleBasedAuth A   
SECJ0305I: Fehler bei der rollenbasierten Berechtigungsprüfung für
admin-authz-Operation. SIBMessagingEngine:stateExtended. Dem Benutzer UNAUTHENTICATED (eindeutige ID:
unauthenticated) wurde keine der folgenden erforderlichen Rollen erteilt:
administrator, operator, configurator, monitor.
Die in der Nachricht angegebene Benutzer-ID ist die Benutzer-ID, die Sie für die Anmeldung an der Administrationskonsole verwenden müssen.

Start einer Anwendung vor dem Start einer erforderlichen Messaging-Engine ermöglichen

Wenn eine Anwendung davon abhängig ist, dass eine Messaging-Engine verfügbar ist, muss die Messaging-Engine gestartet sein, damit die Anwendung ausgeführt werden kann. Wenn der Anwendungsserver eine Anwendung automatisch starten soll, müssen Sie Ihre Anwendungen so entwickeln, dass sie prüfen, ob die erforderliche Messaging-Engine gestartet ist, und gegebenenfalls auf die Messaging-Engine warten. Wird diese Technik in einer Startup-Bean verwendet, muss die Methode der Startup-Bean diese Arbeit (testen und warten) in einem separaten Thread unter Verwendung von WorkManager-Standardmethoden ausführen, damit der Start des Anwendungsservers nicht verzögert wird.

Ein Codebeispiel, das zeigt, wie geprüft wird, ob eine Messaging-Engine gestartet ist und wie gegebenenfalls auf die Messaging-Engine gewartet wird, finden Sie im Artikel Anwendungen mit einer Abhängigkeit von der Verfügbarkeit der Messaging-Engine.


Symbol, das den Typ des Artikels anzeigt. Referenzartikel



Symbol für Zeitmarke Letzte Aktualisierung: 25.05.2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-base-dist&topic=rjk_prob0
Dateiname:rjk_prob0.html