Configuration et dépannage de la fédération XMPP sur Expressway

Options de téléchargement

PDF (660.3 KB)
Consulter à l'aide d'Adobe Reader sur un grand nombre d'appareils
ePub (555.9 KB)
Consulter à l’aide de différentes applications sur iPhone, iPad, Android ou Windows Phone
Mobi (Kindle) (650.5 KB)
Consulter sur un appareil Kindle ou à l’aide d’une application Kindle sur plusieurs appareils

Mis à jour:1 novembre 2018

ID du document:213865

Langage exempt de préjugés

Dans le cadre de la documentation associée à ce produit, nous nous efforçons d’utiliser un langage exempt de préjugés. Dans cet ensemble de documents, le langage exempt de discrimination renvoie à une langue qui exclut la discrimination en fonction de l’âge, des handicaps, du genre, de l’appartenance raciale de l’identité ethnique, de l’orientation sexuelle, de la situation socio-économique et de l’intersectionnalité. Des exceptions peuvent s’appliquer dans les documents si le langage est codé en dur dans les interfaces utilisateurs du produit logiciel, si le langage utilisé est basé sur la documentation RFP ou si le langage utilisé provient d’un produit tiers référencé. Découvrez comment Cisco utilise le langage inclusif.

À propos de cette traduction

Cisco a traduit ce document en traduction automatisée vérifiée par une personne dans le cadre d’un service mondial permettant à nos utilisateurs d’obtenir le contenu d’assistance dans leur propre langue. Il convient cependant de noter que même la meilleure traduction automatisée ne sera pas aussi précise que celle fournie par un traducteur professionnel.

Contenu

Introduction

Conditions préalables

Conditions requises

Components Used

Informations générales

Configuration

Étape 1. Activer la fédération XMPP sur Expressway E

Vérification de la configuration XMPP sur Expressway

Dépannage de la fédération XMPP sur Expressway C et Expressway E

Étape 2. Configurer le secret de numérotation

Vérifier le secret de numérotation

Étape 3. Configurer le mode Sécurité

Dépannage du mode de sécurité

Problèmes courants:

Symptôme 1 : Messagerie unidirectionnelle. Internet vers l'extérieur ne fonctionne pas. L'état IM&P est actif

Symptôme 2 : Échec de la fédération, le routeur XCP sur CUP rebondit les paquets

Vérification

Dépannage

Informations connexes

Introduction

Ce document décrit les étapes de configuration de la fédération XMPP (Extensible Messaging and Presence Protocol) sur Expressway.

Conditions préalables

Conditions requises

Aucune spécification déterminée n'est requise pour ce document.

Components Used

Les informations contenues dans ce document sont basées sur les versions de matériel et de logiciel suivantes :

Cisco Expressway X8.2 ou version ultérieure
Unified Call Manager(CM) Instant Messanger (IM) and Presence Service 9.1.1 ou version ultérieure

The information in this document was created from the devices in a specific lab environment. All of the devices used in this document started with a cleared (default) configuration. Si votre réseau est en ligne, assurez-vous de bien comprendre l’incidence possible des commandes.

Informations générales

Ce diagramme illustre la communication de haut niveau :

Si vous activez XMPP Federation sur Expressway, le serveur actif vers Server(S2S) passe de Cisco Unified Presence (CUP) à Expressway Edge (Expressway E). Ce composant gère toutes les communications XMPP entre les domaines fédérés.

S2S utilise le port 5269 pour communiquer avec les domaines fédérés
Le trafic XMPP interne entre les routeurs XCP sur ExpresswayE, C et CUP s’exécute sur le port 7400
Les informations d’approvisionnement XMPP d’Expressway E sont envoyées à Expressway C via le tunnel SSH sur le port 2222
Expressway C met à jour CUP avec les informations de routage nécessaires via le port AXL 8443

Configuration

Étape 1. Activer la fédération XMPP sur Expressway E

Configuration > Unified Communication > Prise en charge de la fédération XMPP > Activé

Après avoir activé la fédération XMPP, ceci sera observé :

1. Expressway-E met à jour sa configuration locale et duplique ce paramètre avec Expressway Core (Expressway C).

Les journaux de l’Expressway E affichent : « Detail=« xconfiguration xcpConfiguration is_Federation_enabled - changé de : 0 à : 1"

2. Expressway-C met à jour la table « xmpps2snode » de la base de données CUP avec les royaumes du composant S2S d’Expressway E.

Les journaux d’Expressway C indiquent : « Module=« network.axl » Level=« INFO » Action=« Send » URL="https://cups.ciscotac.net:8443/axl/" Function=« executeSQLQuery »

3. Assurez-vous que le DNS public est mis à jour avec les enregistrements SRV du serveur XMPP pour tous les domaines avec lesquels la fédération est nécessaire.

_xmpp-server._tcp.domain.com sur le port 5269

Vérification de la configuration XMPP sur Expressway

Étape 1. Vérifiez si les modifications apportées à la base de données ont été acceptées par le serveur IM&P en exécutant cette requête à partir de l'interface de ligne de commande (CLI) CUP :

admin : exécutez sql select * à partir de xmpps2snoeuds
pkid cp_id
==========================================================================================================================================================================================================================================================
055c13d9-943d-459d-a3c6-af1d1176936d cm-2_s2scp-1.eft-xwye-a-coluc-com
admin:

Étape 2. Vérifiez que la fédération XMPP est désactivée sur le serveur IM&P :

Présence > Fédération interdomaine > Fédération XMPP > Paramètres > État du noeud de fédération XMPP > Désactivé

Dépannage de la fédération XMPP sur Expressway C et Expressway E

Étape 1. .Activez le journal de niveau DEBUG :

Sur Expressway-E :

Maintenance > Diagnostics > Advanced > Support Log configuration > developer.clusterdb.restapi

Sur Expressway-C :

Maintenance > Diagnostics > Advanced > Support Log configuration > developer.clusterdb.restapi

Maintenance > Diagnostics > Advanced > Network Log configuration > network.axl

Étape 2. Démarrez le journal de diagnostic et les vidages TCP sur Expressway-C et Expressway-E :

Si un problème réseau est suspecté, effectuez la capture de paquets côté IM&P à partir de l'interface de ligne de commande :

« utils network capture eth0 file axl_inject.pcap count 1000000 size all »

Étape 3. Activer la fédération XMPP sur Expressway-E

Attendez 30 secondes et passez ensuite aux étapes décrites sous « Vérifier la configuration XMPP sur Expressway »

Étape 2. Configurer le secret de numérotation

Configuration > Unified Communication > Dialback Secret

Comment fonctionne la commutation ?

Étape 1. Le serveur initiateur calcule en fonction du secret configuré pour son résultat de numérotation et envoie au serveur récepteur.

Étape 2. Le serveur récepteur valide ces résultats avec le serveur faisant autorité à partir du domaine initiateur.

Étape 3. Comme le serveur faisant autorité partage le même secret de numérotation, il pourra valider le résultat.

Étape 4. Une fois validé, le serveur récepteur accepte XMPP du serveur initiateur.

Étape 5. Le serveur initiateur effectue une recherche sur _xmpp-server._tcp.<domaine cible> pour trouver le serveur récepteur

Étape 6. Le serveur récepteur effectue une recherche sur _xmpp-server._tcp.<domaine d'origine> pour trouver le serveur faisant autorité

Étape 7. Le serveur faisant autorité peut être identique au serveur initiateur

Vérifier le secret de numérotation

Expressway affiche ce débogage lorsqu’il s’agit du serveur initiateur :

XCP_CM2[12122] : ... Level=« INFO » CodeLocation=« stanza.component.out » Detail=« xcoder=34A9B60C8 envoi : <db : result from='coluc.com' to='vngtp.lab'>d780f198ac34a6dbd795fcdaf8762eaf52ea9b03</db : result>"

XCP_CM2[12122] : ... Level=« DEBUG » CodeLocation=« stream.out » Detail="(00000000-0000-0000-0000-000000000000, coluc.com:vngtp.lab, T) xcoder=34A9B60C8 Délai d'expiration de la numérotation dans 30 secondes. »

XCP_CM2[12122] : ... Level=« INFO " CodeLocation=« ConnInfoHistory » Detail=« Modification de l'état de la connexion : EN ATTENTE->CONNECTÉ : ...

Expressway affiche ce débogage lorsqu’il s’agit du serveur récepteur :

XCP_CM2[22992] : ... Level=« VBOSE » CodeLocation=« stanza.component.in » Detail=« xcoder=05E295A2B reçu :
<db : result from='coluc.com' to='vngtp.lab'>d780f198ac34a6dbd795fcdaf8762eaf52ea9b03</db : result> ”

XCP_CM2[22992] : ... Level=« INFO " CodeLocation=« Resolver.cpp:128 » Detail=
« Démarrage de la recherche de résolveur pour 'coluc.com : puny=coluc.com : service=_xmpp-server._tcp : defport=0' ”

XCP_CM2[22992] : ... Level=« INFO » CodeLocation=« debug » Detail="(e5b18d01-fe24-4290-bba1-a57788a76468, vngtp.lab:coluc.com, IN)
adresse de rappel résolue pour host=coluc.com method=SRV dns-timings=(TOTAL:0.003157 SRV:0.002885) ”

XCP_CM2[22992] : ... Level=« INFO » CodeLocation=« DBVerify.cpp:270 » Detail="(e5b18d01-fe24-4290-bba1-a57788a76468, vngtp.lab:coluc.com, IN)
Le flux DBVerify est ouvert. Envoi de db:verify packet : <db : verify from='vngtp.lab' id='05E295A2B' to='coluc.com'>d780f198ac34a6dbd795fcdaf8762eaf52ea9b03< : db vérifier> ”

XCP_CM2[22992] : ... Level=« INFO » CodeLocation=« DBVerify.cpp:282 » Detail="(e5b18d01-fe24-4290-bba1-a57788a76468, vngtp.lab:coluc.com, IN)
Paquet DBVerify reçu <db : verify from='coluc.com' id='05E295A2B' to='vngtp.lab' type='valide'>d780f198ac34a6dbd795fcdaf8762eaf 52ea9b03</db : verify>

Expressway affiche ce débogage lorsqu’il s’agit du serveur faisant autorité

XCP_CM2[5164]:..Level=« INFO " CodeLocation=« debug » Detail=« xcoder=94A9B60C8 onStreamOpen :
<stream : stream from='vngtp.lab' id='1327B794B' to='coluc.com' version='1.0' xml : lang='en-US.UTF-8' xmlns='jabber:server' xmlns:db='jabber:server:dialback' xmlns : stream='http://etherx.jabber.org/streams'/> ”

XCP_CM2[5164]:..Level=« VBOSE » CodeLocation=« stanza.component.in » Detail=« xcoder=94A9B60C8 reçu :
<db : verify from='vngtp.lab' id='05E295A2B' to='coluc.com'>d780f198ac34a6dbd795fcdaf8762eaf52ea9b03< : db vérifier> ”

XCP_CM2[5164]:..Level=« INFO " CodeLocation=« stream.in » Detail=« xcoder=94A9B60C8 flux de fermeture utilisé uniquement pour la commutation »

Étape 3. Configurer le mode Sécurité

Dépannage du mode de sécurité

Wireshark peut être utilisé pour le dépannage
Les fonctionnalités indiquent si TLS (Transport Layer Security) est requis, FACULTATIF ou Pas de TLS

Cet extrait de capture de paquets montre un exemple de la date à laquelle TLS est requis :

Lorsque vous déboguez en tant que SSL, vous voyez la connexion TLS

Problèmes courants:

Symptôme 1 : Messagerie unidirectionnelle. Internet vers l'extérieur ne fonctionne pas. L'état IM&P est actif

Sur les journaux Expressway-C :

« Function=« executeSQLQuery » Status=« 401 » Reason=« None »

Cause 1 : Informations d’identification erronées pour l’utilisateur IM&P côté Expressway-C.

Vous pouvez également vérifier cela en exécutant cette URL et en vous connectant avec les informations d’identification configurées sur Expressway C

Configuration > Unified Communications > IM and Presence Servers

https://cups_address.domain.com:8443/axl

Solution 1 : Mettre à jour le mot de passe, actualiser la détection du serveur CUP

Symptôme 2 : Échec de la fédération, le routeur XCP sur CUP rebondit les paquets

Cause 2 : Le routeur XCP sur CUP n'a pas été redémarré

Ceci peut être vérifié sur CUP Administration sous la page Notifications.

Solution 2 : Redémarrer le routeur XCP sur CUP

Parfois, il n'y aura aucune notification, mais la connexion du routeur XCP sur CUP est toujours en train de rebondir les paquets. Si le redémarrage du service du routeur XCP ne résout pas ce problème, le redémarrage du cluster IM&P le fait.