Journalisation supplémentaire UMS
Version |
ID de patch R21sp1 |
Attributs API : |
Canal |
Pour dépanner : |
v1 |
ap375053 |
isBindResourceExtraLoggingActive
isJabberIqAuthExtraLoggingActive
|
bindResourceExtraLoggingActive jabberIqAuthExtraLoggingActive |
Problème XMPP-Bind |
v2 |
ap374519 |
isJabberIqRosterExtraLoggingActive
isRosterFlatExtraLoggingActive
|
jabberIqRosterExtraLoggingActive ListePlatJournalisationSupplémentaireActive |
Émission de liste |
v3 |
ap377180 |
isMessageExtraLoggingActive
isMessageHistoryExtraLoggingActive
|
messageExtraLoggingActive HistoriqueMessageExtraJournalisationActive |
problème de message à message (l'utilisateur A sur N1 et l'utilisateur B sur N2 sont en conversation) |
v4 |
ap377373 |
isReceiverBareJidLBExtraLoggingActive
isComponentProtocolExtraLoggingActive
|
RécepteurJidLBExtraLoggingActive componentProtocolExtraLoggingActive |
Problèmes de déconnexion de noeud, MUC* et XMPP_Bind |
* Uniquement pour les systèmes dont la fonction MUC est configurée en tant que composant externe sous :
UMS_CLI/System/ProfileTuning/GeneralSettings> g
profileTuningName = mucExternal
Selon le test demandé par le TAC, vous devrez activer/désactiver un ou plusieurs des canaux de dépannage à l'aide des attributs API associés.
Notez que les clients ne pourront pas activer ces canaux ExtaLogging IMPLog avec les instructions de test d'origine de ces correctifs.
Les notes de version des correctifs d'origine contiennent des informations incorrectes, ainsi que les API ont changé au fil du temps pour pouvoir survivre au redémarrage du serveur UMS
Voici les instructions correctes sur l'utilisation de l'interface API /gateway/implog
1. Pour activer la journalisation IMP supplémentaire, vous devez envoyer une commande HTTP POST avec le nom des attributs API correspondant au canal dont vous avez besoin. Voici un exemple pour le composant de canal ProtocolExtraLoggingActive :
POST http://xx.xxx.xxx.xxx/gateway/implog/isComponentProtocolExtraLoggingActive
2. Pour vérifier la configuration des canaux, vous devez envoyer la commande API suivante :
GET http://xx.xxx.xxx.xxx/gateway/implog
Les canaux répertoriés dans la réponse du serveur indiquent la configuration individuelle :
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. Pour désactiver un canal de journalisation IMP supplémentaire, vous devez envoyer une commande DELETE HTTP avec le nom des attributs d'API correspondant au canal dont vous avez besoin :
DELETE http://xx.xxx.xxx.xxx/gateway/implog/isComponentProtocolExtraLoggingActive
Voici des exemples d'utilisation des commandes CURL pour utiliser l'API IMPLog ExtraLogging :
1) confirmer l'état :
curl -X GET -u '' http://localhost/gateway/implog/
2) activer un canal :
curl -X POST -H "Content-Type: application/json" -u '' http://localhost/gateway/implog/isMessageExtraLoggingActive
3) désactiver un canal :
curl -X DELETE -H "Content-Type: application/json" -u '' http://localhost/gateway/implog/isMessageExtraLoggingActive
ID UTILISATEUR :
Un utilisateur autorisé est requis pour toutes les requêtes HTTP. Votre système UMS dispose déjà d'un script qui vous permet de définir des autorisations.
Pour plus de détails, consultez ce fichier disponible sur le serveur UMS :
/usr/local/broadworks/UMS_Rel_21.sp1_1.551/sbin/authorization/README-authorization.txt
IMPORTANT :
Vous devez configurer chaque serveur UMS individuellement pour avoir les canaux sur les deux serveurs, puisque la configuration des attributs API n'est pas synchronisée entre eux.
Remarque : après le redémarrage d'un serveur, les états API Attributes restent tels qu'ils ont été définis précédemment.