Fehlerbehebung beim Sitzungsrepository des SIP-Containers
Für die Fehlerbehebung beim Sitzungsrepository des SIP-Containers kann es erforderlich sein, die SIP-Sitzungsdetails in eine angegebene Tracedatei auszugeben.
Informationen zu diesem Vorgang
Sie können das Dienstprogramm für SIP-Sitzungsspeicherauszug verwenden, um Probleme im Zusammenhang mit SIP-Containersitzungen zu beheben. Der SIP-Container verwendet die Methode SipContainerMBean, um mehrere Operationen bezüglich der Funktionsfähigkeit des SIP-Containers durchzuführen, einschließlich der Einleitung eines Server-Quiesce (Stilllegung) über wsadmin (Befehlszeilenschnittstelle). Diese Task beschreibt, wie Sie mit der Methode SipContainerMBean einen Speicherauszug der SIP-Anwendungssitzungs- und SIP-Sitzungsinformationen erstellen, die im speicherinternen Sitzungsrepository für SIP-Container enthalten sind. Indem Sie die Methode SIPContainerMBean für die Verwendung verschiedener Tracemethoden konfigurieren, können Sie die SIP-Sitzungsdetails angeben, deren Speicherauszug in der angegebenen Tracedatei erstellt werden soll.
Wenn die Methoden für den Sitzungsspeicherauszug über wsadmin-Scripting gestartet werden, werden die angeforderten Informationen zu den Sitzungen standardmäßig in "SystemOut.log" ausgegeben oder an eine vordefinierte Quelle gesendet, falls diese mit der Methode "setDumpMethod" festgelegt wurde.
Wenn Sie die komprimierten Methoden für den Sitzungsspeicherauszug verwenden, werden für jede Ausführung der Speicherauszugsmethode nur die Sitzungs-IDs ausgegeben.
- Für jede Ausführung der Speicherauszugsmethode werden die Details des Transaktionsbenutzers zusammen mit den Details der SIP-Sitzung, falls vorhanden, ausgegeben.
- In den Tracedateien werden nur der Speicherauszug der Attribute ausgegeben, die gemäß der Spezifikation JSR 289 angezeigt werden dürfen.
- Die ausführlichen Methoden geben die folgenden Informationen in der Tracedatei aus: Anwendungsname (appName), Anruf-ID (callID), Dialogstatus, Erstellungszeit und Attributnamen.
Die Traceausgabe erfolgt nach SIP-Anwendung. Daher werden alle SIP-Sitzungsdatenstrukturen sortiert, bevor die Daten ausgegeben werden. Sie können die Speicherauszugsfunktion SIPContainerMBean für einen Produktionsserver verwenden, indem Sie die Ausführung einem Thread mit niedriger Priorität zuteilen, so dass sich alle Speicherauszüge in einem separaten Thread befinden und sich das Tracing nicht auf die Latenzzeit bei der Anrufverarbeitung im Gesamtsystem auswirkt.
Im Speicherauszug wird unterschieden zwischen einem Transaktionsbenutzer, der eine SIP-Sitzung erstellt hat, und einem Transaktionsbenutzer, der kein SipSession-Objekt hat. Außerdem enthält der Speicherauszug skizzenartige Darstellungen von SIP-Sitzungen, die nicht mehr existieren oder nicht mehr gültig sind bzw. SIP-Sitzungen, die zum Zeitpunkt des Trace-Snapshot existieren.
Methode | Bescheibung |
---|---|
dumpAllSASIds() | Gibt die Anzahl aller SIP-Anwendungssitzungen und die SIP-Anwendungssitzungs-IDs aus. |
dumpAllTUSipSessionIds() | Gibt die Anzahl der Transaktionsbenutzer aus und die SIP-Sitzungs-IDs im Transaktionsbenutzer, falls vorhanden. |
Methode | Bescheibung |
---|---|
dumpAllSASDetails() | Gibt die Anzahl der SIP-Anwendungssitzungen und die Details der SIP-Anwendungssitzungs-ID aus. |
dumpAllTUSipSessionDetails() | Gibt die Anzahl der Transaktionsbenutzer aus und die Details der SIP-Sitzungs-IDs im Transaktionsbenutzer, falls vorhanden. |
dumpSASDetails(String sasId) | Gibt die Details der mit dem Parameter sasId angegebenen SIP-Anwendungssitzung aus. |
dumpSipSessionDetails(String sessionId) | Gibt die Details der mit dem Parameter sessionId angegebenen SIP-Sitzung aus. |
- In jeglicher Druckausgabe enthält die erste Zeile einen Anwendungsnamen und eine Anzahl Datensätze.
- Das Begrenzungszeichen zwischen den Abschnitten der Ausgabe ist eine Registerkarte.
- Das Begrenzungszeichen zwischen Sitzungsattributen ist ein ; (Semikolon).
Vorgehensweise
Ergebnisse
Sie haben das Dienstprogramm für SIP-Sitzungsspeicherauszug so konfiguriert, dass die für die SIP-Anwendungssitzung und SIP-Sitzung gewünschte Traceinformationstufe ausgegeben wird, um Sie bei der Behebung von Fehlern im Zusammenhang mit dem SIP-Container zu unterstützen.
Beispiel
- Komprinierte Methode
dumpAllSASIds:
- Mit Jacl:
$AdminControl invoke $apps dumpAllSASIds
- Mit Jython:
AdminControl.invoke (apps, "dumpAllSASIds")
Diese Informationen werden im folgenden Format bereitgestellt:dump.ids.test.app1 2 local.1347524282775_8 local.1347524282775_7
[SAS_ID]
- Mit Jacl:
- Ausführliche Methode
"dumpAllSASDetails" und Ausgabe der Speicherauszugsinformationen in die Datei "/opt/IBM/output.log":
- Mit Jacl:
$AdminControl invoke $apps setDumpMethod {{FILE} {/opt/IBM/output.log}} $AdminControl invoke $apps dumpAllSASDetails
- Mit Jython:
AdminControl.invoke (apps, "setDumpMethod", ["FILE", "/opt/IBM/output.log"]) AdminControl.invoke (apps, "dumpAllSASDetails")
Diese Informationen werden im folgenden Format bereitgestellt:dump.ids.test.app1 1 local.1348147884986_2 Sep 20,2012 16:31 DumpSasDetailsAttr;
[SAS_ID] [CreationTime] [Attribute]
- Mit Jacl:
- Komprimierte Methode
dumpAllTUSipSessionIds zur Ausgabe der Anzahl der Transaktionsbenutzer und der SIP-Sitzungs-IDs im Transaktionsbenutzer:
- Mit Jacl:
$AdminControl invoke $apps dumpAllTUSipSessionIds
- Mit Jython:
AdminControl.invoke (apps, "dumpAllTUSipSessionIds")
Diese Informationen werden im folgenden Format bereitgestellt:DumpSessionsTest 1 local.1349965420866_1_0 true local.1349965420866_1_0_1
[TU_ID] [hasSIPSession] [SipSessionId]
- Mit Jacl:
- Ausführliche Methode
dumpAllTUSipSessionDetails zur Ausgabe der Transaktionsbenutzer und der Details
der SIP-Sitzungs-IDs im Transaktionsbenutzer:
- Mit Jacl:
$AdminControl invoke $apps dumpAllTUSipSessionDetails
- Mit Jython:
AdminControl.invoke (apps, "dumpAllTUSipSessionDetails")
Diese Informationen werden im folgenden Format bereitgestellt:DumpSessionsTest 1 local.1349965420866_1_0 true local.1349965420866_1_0_1 8-8548@9.148.57.128 2 false INVITE local.1349965420866_1 Jan 24,2013 14:41 TestSSAttr1; TestSSAttr2;
[TU_ID] [hasSIPSession] [SipSessionId] [Call-Id] [DialogState] [hasOutgoingTransaction] [initialMethod] [SAS_ID] [CreationTime] [Attribute]
- Mit Jacl:
- Verwendung der ausführlichen Methode "dumpSASDetails" zur Ausgabe der Einzeldaten der vom Parameter "sasID" angegebenen SIP-Anwendungssitzung:
- Mit Jacl:
$AdminControl invoke $apps dumpSASDetails $sasId
- Mit Jython:
AdminControl.invoke (apps, "dumpSASDetails ", "sasId")
Wenn die angeforderte Sitzung nicht vorhanden ist, wird eine Fehlernachricht angezeigt. Beispiel:local.1358950127352_20 Jan 23,2013 16:19 TestSASAttr1; TestSASAttr2;
ERROR: Requested session <local.1358950127352_20> does not exist.
- Mit Jacl:
- Verwendung der ausführlichen Methode "dumpSipSessionDetails" zur Ausgabe der Einzeldaten der vom Parameter "sessionId" angegebenen SIP-Sitzung:
- Mit Jacl:
$AdminControl invoke $apps dumpSipSessionDetails $sessionId
- Mit Jython:
AdminControl.invoke (apps, "dumpSipSessionDetails", "sessionId")
Wenn die angeforderte Sitzung nicht vorhanden ist, wird eine Fehlernachricht angezeigt. Beispiel:local.1358950127352_21_20_1 local.1358950127352_21 Jan 23,2013 16:22 TestSSAttr1; TestSSAttr2;
ERROR: Requested session <local.1358950127352_21_20_1> does not exist.
- Mit Jacl: