UMS ExtraLogging
Version |
R21sp1 Patch-ID |
API-Attribute: |
Channel |
So beheben Sie Probleme: |
V1 |
AP375053 |
isBindResourceExtraLoggingActive
isJabberIqAuthExtraLoggingAktiv
|
bindRessourceExtraLoggingAktiv JabberIqAuthExtraProtokollierungAktiv |
XMPP-Bind-Problem |
V2 |
AP374519 |
isJabberIqRosterExtraLoggingAktiv
isRosterFlatExtraProtokollierungAktiv
|
JabberIqRosterExtraProtokollierungAktiv ListeFlachExtraProtokollierungAktiv |
Listenausgabe |
V3 |
AP377180 |
isNachrichtExtraLoggingAktiv
isMessageHistoryExtraLoggingActive
|
NachrichtExtraLoggingActive NachrichtVerlaufExtraLoggingAktiv |
Message-to-Message-Problem (Benutzer A auf N1 und Benutzer B auf N2 chatten) |
V4 |
AP377373 |
isEmpfängerBareJidLBExtraProtokollierungAktiv
isComponentProtocolExtraLoggingActive
|
EmpfängerBareJidLBExtraLoggingAktiv KomponenteProtokollExtraLoggingAktiv |
node-disconnect, MUC* & XMPP_Bind Probleme |
* Nur für Systeme mit als externe Komponente konfiguriertem MUC unter:
UMS_CLI/System/ProfileTuning/GeneralSettings> g
profileTuningName = mucExternal
Gemäß dem vom TAC angeforderten Test müssen Sie einen oder mehrere der Kanäle zur Fehlerbehebung mithilfe der zugehörigen API-Attribute aktivieren/deaktivieren.
Beachten Sie, dass die Kunden diese ExtaLogging-IMPLog-Kanäle nicht mit den ursprünglichen Testanweisungen aus diesen Patches aktivieren können.
Die ursprünglichen Patches Release Notes "Testanweisungen" enthalten ungeeignete Informationen, plus die API haben sich im Laufe der Zeit geändert, um einen Neustart des UMS-Servers zu überleben
Hier sind die richtigen Anweisungen zur Verwendung von API/gateway/implog
1. Um die zusätzliche IMP-Protokollierung zu aktivieren, müssen Sie einen POST-HTTP-Befehl mit dem Namen der API-Attribute senden, die mit dem gewünschten Kanal übereinstimmen. Hier ist ein Beispiel für die Channel-KomponenteProtocolExtraLoggingActive:
POST http://xx.xxx.xxx.xxx/gateway/implog/isComponentProtocolExtraLoggingActive
2. Um zu überprüfen, wie die Channels konfiguriert sind, müssen Sie den folgenden API-Befehl senden:
GET http://xx.xxx.xxx.xxx/gateway/implog
Als Antwort vom Server werden die Kanäle aufgelistet, die eine individuelle Konfiguration aufweisen:
Response:
{
"status":{
"code":"0300001",
"type":"success",
"message":"LogState Get Successfully!"
},
"impLogState":{
"bindResourceExtraLoggingActive":false,
"jabberIqAuthExtraLoggingActive":false,
"jabberIqRosterExtraLoggingActive":false,
"rosterFlatExtraLoggingActive":false,
"messageExtraLoggingActive":false,
"messageHistoryExtraLoggingActive":false,
"receiverBareJidLBExtraLoggingActive":false,
"componentProtocolExtraLoggingActive":true
}
}
5. Um einen zusätzlichen IMP-Protokollierungskanal zu deaktivieren, müssen Sie einen DELETE HTTP-Befehl mit dem Namen der API-Attribute senden, die mit dem gewünschten Kanal übereinstimmen:
DELETE http://xx.xxx.xxx.xxx/gateway/implog/isComponentProtocolExtraLoggingActive
Hier einige Beispiele für die Verwendung von CURL-Befehlen zur Verwendung der ExtraLogging IMPLog-API:
1) Status bestätigen:
curl -X GET -u '' http://localhost/gateway/implog/
2) Aktivieren Sie einen Kanal:
curl -X POST -H "Content-Type: application/json" -u '' http://localhost/gateway/implog/isMessageExtraLoggingActive
3) Deaktivieren Sie einen Kanal:
curl -X DELETE -H "Content-Type: application/json" -u '' http://localhost/gateway/implog/isMessageExtraLoggingActive
USERID:
Für alle HTTP-Anfragen ist ein autorisierter Benutzer erforderlich. Ihr UMS-System verfügt bereits über ein Skript, mit dem Sie Berechtigungen festlegen können.
Weitere Informationen finden Sie in dieser Datei, die auf dem UMS-Server zur Verfügung steht:
/usr/local/broadworks/UMS_Rel_21.sp1_1.551/sbin/authorization/README-authorization.txt
WICHTIG:
Sie müssen jeden UMS-Server einzeln konfigurieren, damit die Kanäle auf beiden Servern verfügbar sind, da die Konfiguration der API-Attribute nicht zwischen ihnen synchronisiert wird.
Hinweis: Nach einem Neustart des Servers bleiben die API-Attributstatus wie zuvor festgelegt erhalten.