Guide de dépannage des annuaires téléphoniques TMS

Introduction

Ce document décrit comment résoudre différents problèmes avec les annuaires téléphoniques Cisco TelePresence Management Suite (TMS).

Conditions préalables

Exigences

Cisco vous recommande de prendre connaissance des rubriques suivantes :

• Cisco TMS
• Terminaux Cisco TelePresence
• Microsoft Internet Information Services (IIS)

Composants utilisés

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

• Cisco TMS versions 14.x et 15.x
• Terminaux logiciels TC et CE

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. If your network is live, make sure that you understand the potential impact of any command.

Produits associés

Ce document peut également être utilisé avec les versions matérielles et logicielles suivantes :

• Terminaux Cisco TelePresence série MX, série C, série SX, série EX, périphériques de kit de salle et MXP
• Cisco Jabber Video pour TelePresence (Movi)

Informations générales

Les annuaires téléphoniques TMS sont accessibles à l'aide de HTTP ou HTTPS en fonction du protocole activé dans IIS sur le serveur Microsoft Windows. Le système doit être ajouté dans TMS pour obtenir l'annuaire téléphonique (répertoire d'entreprise). Pour les systèmes plus récents, la recherche dans l'annuaire téléphonique est une communication en direct et les données ne sont pas stockées sur le système. TMS doit être activé et accepter les connexions pour que les annuaires téléphoniques fonctionnent.

Répertoires du répertoire téléphonique TMS

Répertoire global

Le répertoire global est un fichier stocké sur le codec où les entrées ne peuvent pas être modifiées via la télécommande. Le fichier est transmis par HTTP/HTTP à tous les terminaux qui s'abonnent à un ou plusieurs annuaires téléphoniques dans Cisco TMS. Plusieurs annuaires téléphoniques sont fusionnés en un seul. S'ils contiennent plus de 400 entrées, seules les 400 premières sont affichées sur le terminal.

Le fichier est transmis au point d'extrémité sur les intervalles définis dans le champ Outils d'administration > Configuration > Paramètres généraux > Fréquence de mise à jour des annuaires téléphoniques.

Cela fonctionne uniquement sur les terminaux qui prennent en charge le globdir.prm (Non pris en charge sur les terminaux logiciels TC ou CE).

Répertoire d'entreprise

Le répertoire d'entreprise est un service XML sur le serveur Cisco TMS qui permet au point d'extrémité de récupérer les annuaires téléphoniques directement à partir du serveur chaque fois que vous appuyez sur le bouton d'annuaire téléphonique du point d'extrémité. Il permet une hiérarchie des annuaires téléphoniques et plusieurs numéros de téléphone sur chaque entrée. Le répertoire d'entreprise est également consultable.

Types de répertoire téléphonique du système

Accédez à Outils d'administration > Configuration > General Settings afin de sélectionner votre type d'annuaire téléphonique système. Vous pouvez :

• Utiliser uniquement les annuaires téléphoniques TMS centralisés (annuaire téléphonique d'entreprise)
• Utiliser des annuaires téléphoniques centralisés et téléchargés (les deux)
• Utiliser les annuaires téléphoniques globaux téléchargés sur les systèmes uniquement (annuaire téléphonique global)

Cisco vous recommande d'opter pour l'annuaire téléphonique de l'entreprise ou les deux, car l'annuaire téléchargé est uniquement pris en charge par les terminaux TANDBERG hérités.

Le paramètre par défaut est both, ce qui rend le répertoire global disponible en cas d'échec de la recherche en direct dans le répertoire d'entreprise.

Ports utilisés pour les annuaires téléphoniques TMS

Les terminaux accèdent au service de répertoire TMS par le port 80 (HTTP) ou le port 443 (HTTP). Vérifiez que ces ports sont autorisés sur le pare-feu Microsoft Windows Server et sur tout pare-feu réseau éventuellement présent sur le chemin.

Configuration du serveur Endpoint Phone Book

Une fois qu'un système est ajouté à TMS, il doit recevoir un ensemble de paramètres de gestion qui contient l'adresse de rétroaction, l'adresse de gestion externe, et l'adresse du répertoire. L'adresse sur le système peut être vérifiée à partir de l'interface Web du système, xAPI (xConfiguration //phonebook), ou de l'interface utilisateur sur le système.

L'adresse diffusée au point d'extrémité est déterminée par ce qui est configuré dans TMS dans Outils d'administration > Configuration > Paramètres réseau sous Paramètres réseau avancés pour les systèmes sur le réseau local interne. Si le champ Adresse IPv4 du serveur TMS est configuré et que Nom d'hôte complet du serveur TMS est vide, l'adresse IP est utilisée, mais si les deux champs sont remplis, le nom de domaine complet (FQDN) est préféré et utilisé.

Lorsque vous vérifiez l'URL de l'annuaire téléphonique, il est important de savoir si <TMSaddress> est un nom de domaine complet ou une adresse IP. S'il s'agit d'un nom de domaine complet, un serveur de noms de domaine (DNS) valide doit également être configuré sur le point de terminaison. Si DNS n'est pas configuré sur le point d'extrémité, il ne peut pas résoudre le nom de domaine complet afin de récupérer les annuaires téléphoniques. Reportez-vous à la section Vérifier la configuration DNS du point de terminaison pour connaître les étapes de vérification du DNS.

Remarque : Assurez-vous que l'adresse IP est correcte. Parfois, les clients ont récemment déplacé TMS d'un serveur à un autre, ils ont un autre TMS de laboratoire, ou un TMS non autorisé peut exister.

Vérification de l'adresse avec l'interface Web

Dans l'interface Web du terminal, accédez à Configuration > System Configuration > Phonebook Server. Vérifiez que les paramètres de l'annuaire téléphonique sont corrects. Plus important encore, l'URL doit correspondre à ce format : http://<TMSaddress>/tms/public/external/phonebook/phonebookservice.asmx.

Vérification de l'adresse avec Secure Shell (SSH)

Voici comment vous vérifiez l'adresse avec SSH :

xConfiguration //phonebook
*c xConfiguration Phonebook Server 1 ID: "default"
*c xConfiguration Phonebook Server 1 Type: TMS
*c xConfiguration Phonebook Server 1 URL: "http://<TMSaddress>/tms/public/external/
phonebook/phonebookservice.asmx"

Tester la demande d'annuaire téléphonique depuis le terminal

Le moyen le plus rapide de déterminer la connectivité est d’établir une connexion SSH au point d’extrémité à l’aide des informations d’identification admin et d’exécuter la commande suivante :

xcommand Recherche dans le répertoire téléphonique Type de répertoire : Entreprise

Dans un scénario de travail, deux résultats sont renvoyés, selon le nombre d'annuaires attribués au point d'extrémité.

Si un répertoire :

Si plusieurs annuaires sont appliqués, le résultat affiche les dossiers d'annuaires :

Cette commande identifie également les problèmes de connectivité. Par exemple :

• Si aucun répertoire n'est attribué au point d'extrémité dans TMS :

• Si vous ne parvenez pas à contacter le service d'annuaire téléphonique :

En cas de problème de configuration de l'authentification dans IIS sur le serveur hébergeant TMS :

Si vous pointez vers 'http ou https://<TMSFQDN>/tms/public/external/phonebook/phonebookservice.asmx.' il vous indique s'il existe un problème de résolution DNS possible :

Vérifier la configuration DNS du terminal

Vérification de la configuration DNS avec SSH

Vérification de la configuration DNS avec l'interface Web

Dans l'interface Web du terminal, accédez à Configuration > System Configuration > Network.

Déterminez si le service d'annuaire téléphonique est accessible

À partir d'un PC utilisateur, procédez comme suit :

1. Dans le terminal, naviguez vers Configuration > System Configuration > Phonebook Server, et copiez l'URL du répertoire téléphonique TMS configurée sur le terminal.
   
   
2. Collez l'URL dans une fenêtre de navigateur.
   
   

   

   
   
   Si vous voyez la page affichée dans l'image, cela signifie que le service d'annuaire est accessible. Si vous ne voyez pas cette page, vérifiez que l'ordinateur sur lequel vous effectuez le test ne comporte aucune restriction réseau pour accéder à l'adresse.
   
   Si vous voyez un message Non autorisé, alors il peut y avoir un problème avec IIS, qui est discuté plus loin dans ce document.

À partir de la racine du point d'extrémité, saisissez : curl http://<Adresse IP TMS>/tms/public/external/phonebook/phonebookservice.asmx

Répertoire téléphonique TMS et source du répertoire téléphonique

Tous les annuaires téléphoniques TMS sont construits à partir de sources d'annuaire téléphonique.

Accédez à Annuaires téléphoniques > Gérer les sources d'annuaire téléphonique afin de gérer vos sources d'annuaire téléphonique.

Actuellement, les sources d'annuaire téléphonique TMS sont les suivantes :

• Terminal Cisco TMS
• Liste manuelle
• Active Directory
• Répertoire H.350 et répertoire utilisateur H.350
• Annuaire téléphonique basé sur des fichiers
• Gardien
• Autre répertoire téléphonique TMS
• Répertoire de provisionnement Cisco TMS
• Annuaire téléphonique local du système
• Cisco Unified CM géré par Cisco TMS

Une fois qu'une source d'annuaire téléphonique a été créée, vous la connectez à un annuaire téléphonique. L'annuaire téléphonique auquel vous connectez la source sera celui que vous avez défini sur les périphériques. Vous pouvez connecter plusieurs annuaires téléphoniques à plusieurs sources d'annuaire téléphonique

Vérifier que les contacts et le répertoire téléphonique sont définis sur le système

Vérifier les contacts

Vérifiez la source de l'annuaire téléphonique et assurez-vous que les contacts et les méthodes de contact existent.

Vérifiez que l'annuaire est connecté à la source de l'annuaire téléphonique et que les mêmes contacts et méthodes de contact existent. L'annuaire téléphonique auquel vous connectez la source sera celui que vous avez défini sur les périphériques.

Remarque : Les terminaux et la vidéo Jabber pour TelePresence (Movi) voient ce qui est renseigné dans l'annuaire téléphonique, et non la source de l'annuaire téléphonique. Soyez attentif aux différences entre les deux.

Annuaire téléphonique défini sur le système

Assurez-vous que les annuaires téléphoniques ont été configurés sur le système. Accédez à Annuaires téléphoniques > Gérer les annuaires téléphoniques > Sélectionnez l'annuaire téléphonique et sélectionnez Définir sur les systèmes.

Une liste des systèmes s'affiche à droite sous Systèmes sélectionnés.

Vidéo Jabber pour la téléprésence (Movi) et annuaires téléphoniques

Remarque : Le client doit être authentifié pour pouvoir recevoir les annuaires téléphoniques. La zone VCS/Expressway dans laquelle il s’inscrit doit être Check Credentials ou Treat as Authenticated.

Les utilisateurs reçoivent l’annuaire téléphonique par l’intermédiaire de la gamme VCS/Expressway et non de TMS. 

Contrôle d'accès

Les groupes de comptes doivent disposer d'un contrôle d'accès à l'annuaire téléphonique pour pouvoir effectuer des recherches.

Même si le niveau supérieur est coché, développez-le et vérifiez que les sous-niveaux sont cochés. Si seuls les nouveaux utilisateurs ne reçoivent pas les annuaires téléphoniques, il est possible qu'ils fassent partie d'un nouveau groupe qui n'est pas coché dans l'onglet Contrôle d'accès.

Configuration du provisionnement

1. Dans TMS Systems > Provisioning > Users, vérifiez que le modèle d'adresse vidéo est configuré.
   
   

   

   
   
   
2. Vérifiez le modèle de configuration attribué à l'utilisateur Jabber Video for TelePresence (Movi) pour la configuration URI du serveur de l'annuaire téléphonique.
   
   

   

Entrées en double

Soyez prudent si vous connectez plusieurs annuaires téléphoniques à un seul, car cela peut entraîner l'affichage d'entrées en double sur les terminaux ou avec le client Jabber Video for TelePresence (Movi) si les sources connectées contiennent les mêmes entrées d'annuaire téléphonique.

Routage du répertoire téléphonique

Tenez compte de ce paramètre au cas où certains terminaux n'obtiendraient pas certaines entrées de l'annuaire téléphonique visibles sur d'autres terminaux.

Dans Outils d'administration > Configuration > Paramètres généraux, il existe un paramètre appelé Router Phone Book Entries. Oui est le paramètre par défaut, ce qui signifie que les points d'extrémité affichent uniquement les adresses qu'ils sont capables de composer. Par exemple, sur un terminal H.323 uniquement, les numéros RNIS et les adresses SIP (Session Initiation Protocol) ne sont pas affichés. Non signifie que les terminaux affichent toutes les adresses et tous les numéros dans l'annuaire téléphonique, quelles que soient leurs capacités de numérotation.

401 Non autorisé - Dépannage d'IIS

L'un des problèmes les plus courants dans l'annuaire téléphonique est dû à une mauvaise configuration dans IIS. L'authentification anonyme doit être activée pour le dossier public dans IIS pour que les points de terminaison puissent récupérer les annuaires téléphoniques. Si cette option n'est pas activée, les terminaux sont interrogés pour l'authentification qu'ils ne peuvent pas fournir.

Afin de déterminer si le point d'extrémité est mis à l'épreuve pour l'authentification, envoyez une requête SSH au point d'extrémité et recherchez l'annuaire téléphonique avec la commande xcommand Phonebook Search Phonebook Type : Entreprise. Si l'authentification du point de terminaison est demandée, vous verrez '<Authentication fail>' (code HTTP=401) comme indiqué dans cette image.

Vérifier les paramètres IIS

1. Ouvrez une session RDP (Remote Desktop Protocol) avec le serveur TMS.
   
   
2. Ouvrez le Gestionnaire IIS .
   
   
3. Développez Site Web par défaut.
   
   
4. Développez TMS.
   
   
5. Sélectionnez public.
   
   
6. Sélectionner
   
   

   

   
   
   

   

   
   
   
7. Vérifiez que l'authentification anonyme est activée et activez-la si ce n'est pas déjà fait.

Utiliser une capture réseau

Analyser les données du répertoire téléphonique dans Wireshark

La recherche dans l'annuaire téléphonique commence par une demande de recherche au service d'annuaire téléphonique sur TMS, à laquelle TMS répond et inclut le résultat de la recherche dans la réponse si tout fonctionne.

Vous pouvez exécuter le suivi sur le serveur TMS ou sur le point d'extrémité si le point d'extrémité prend en charge tcpdump. Laissez le suivi s'exécuter et accédez au répertoire via l'interface Web ou depuis l'interface utilisateur. Vous devriez voir une demande de recherche arriver sur le serveur TMS.

À la suite de ce flux TCP, vous verrez deux composants principaux du XML :

Tout d'abord, le terminal s'identifie lui-même, par exemple :

<Search>
<Identification>
  <SystemName>RoomKit</SystemName>
  <MACAddress>08:96:ad:5a:f4:f4</MACAddress>
  <IPAddress>14.49.31.33</IPAddress>
  <IPAddressV6 type="Local">fe80::a96:adff:fe5a:f4f4</IPAddressV6>
  <ProductType>Cisco Codec</ProductType>
  <ProductID>Cisco Webex Room Kit</ProductID>
  <SWVersion>ce9.9.0.3a4afe323b0</SWVersion>
  <SerialNumber>FOC2108NFRA</SerialNumber>
</Identification>

Ensuite, vous verrez les détails de la demande :

<CaseSensitiveSearch>false</CaseSensitiveSearch>
      <SearchPath/>
      <SearchString/>
      <SearchType>Free</SearchType>
      <Scope>SubTree</Scope>
      <MaxResult>50</MaxResult>
      <RangeInclusive>false</RangeInclusive>
    </Search>

<Remarque : Les valeurs détaillées varient selon la demande effectuée. La demande ci-dessus a été effectuée à l'aide de la commande ssh 'xcommand Phonebook Search PhonebookType: Entreprise' à partir du terminal.>

La réponse du serveur TMS doit être 200 OK. Sinon, vous pouvez effectuer un dépannage en fonction des différents messages que vous recevez.

La réponse 200 OK contiendra les entrées pertinentes des annuaires téléphoniques attribués au point d'extrémité dans TMS. Dans la demande ci-dessus, un seul annuaire téléphonique a été attribué au terminal dans TMS et la réponse est la suivante :

<SearchResponse xmlns="http://www.tandberg.net/2004/06/PhoneBookSearch/">
    <SearchResult>
        <Name />
        <Id />
        <Entry>
            <Name>HDX8000</Name>
            <Id>e_92750</Id>
            <Route>
                <CallType>384</CallType>
                <Protocol>H323</Protocol>
                <Restrict>Norestrict</Restrict>
                <DialString>hdx8000</DialString>
                <Description>hdx8000 (H.323)</Description>
                <SystemType>Polycom HDX 8000 HD</SystemType>
            </Route>
            <IsLast>false</IsLast>
            <IsFirst>true</IsFirst>
            <BaseDN />
            <SystemType>Polycom HDX 8000 HD</SystemType>
        </Entry>
        <Entry>
            <Name>SX10</Name>
            <Id>e_92749</Id>
            <Route>
                <CallType>384</CallType>
                <Protocol>SIP</Protocol>
                <Restrict>Norestrict</Restrict>
                <DialString>sx10@example.com</DialString>
                <Description>sx10@example.com (SIP)</Description>
                <SystemType>Cisco TelePresence SX10</SystemType>
            </Route>
            <IsLast>false</IsLast>
            <IsFirst>false</IsFirst>
            <BaseDN />
            <SystemType>Cisco TelePresence SX10</SystemType>
        </Entry>
        <NoOfEntries>7</NoOfEntries>
        <FolderExists>true</FolderExists>
    </SearchResult>
</SearchResponse>

Journalisation des demandes/réponses du répertoire téléphonique dans TMS

TMS 15.8 a introduit la fonctionnalité de journalisation de toutes les demandes d’annuaire téléphonique et de leurs réponses. Par défaut, cette journalisation est désactivée, mais elle peut être activée de deux façons.

1. En modifiant le fichier web.config situé, par défaut à "C:\Program Files (x86)\TANDBERG\TMS\wwwTMS\Public\web.config" et en modifiant cette section :

<logger name="Tandberg.TMS.Phonebook.PhonebookRequestResponse" additivity="false">
<level value="OFF" />

Remplacez la valeur de niveau 'OFF' par 'DEBUG'

2. Cela peut également être fait plus facilement à l'aide de l'utilitaire de collecte de journaux TMS en vérifiant les éléments suivants :

Une fois qu'une demande d'annuaire téléphonique a atteint l'application TMS, le journal est écrit. L'emplacement par défaut de ce fichier est "C:\Program Fichiers (x86)\TANDBERG\TMS\data\Logs\TMSDebug\log-phonebook-request-response.txt"

Un exemple de cette sortie :

Incoming Request
2020-01-08 09:30:54,856|PhoneBookService [ec3eaf80-f519-4573-9e68-3d98ab494d0b] REQUEST : Identification = 14.49.31.33,Scope = SubTree,Start Time = 1/8/2020 9:30:54 AM,Start From Id = "",End At Id = "",Max Result = 50,Search String = "",Search Path = "",Range Inclusive = False,Case Sensitive Search = False,Search Type = Free,Starts With = "",

Outgoing Response
2020-01-08 09:30:55,121|PhoneBookService [ec3eaf80-f519-4573-9e68-3d98ab494d0b] RESPONSE : 14.49.31.33 <?xml version="1.0" encoding="utf-16"?><Catalog xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"><Name /><Id /><Entry><Name>HDX8000</Name><Id>e_92750</Id><Route><CallType>384</CallType><Protocol>H323</Protocol><Restrict>Norestrict</Restrict><DialString>hdx8000</DialString><Description>hdx8000 (H.323)</Description><SystemType>Polycom HDX 8000 HD</SystemType></Route><Route><CallType>384</CallType><Protocol>H323</Protocol><Restrict>Norestrict</Restrict><DialString>1001</DialString><Description>1001 (H.323)</Description><SystemType>Polycom HDX 8000 HD</SystemType></Route><Route><CallType>384</CallType><Protocol>H323</Protocol><Restrict>Norestrict</Restrict><DialString>14.49.31.35</DialString><Description>14.49.31.35 (H.323)</Description><SystemType>Polycom HDX 8000 HD</SystemType></Route><IsLast>false</IsLast><IsFirst>true</IsFirst><BaseDN /><SystemType>Polycom HDX 8000 HD</SystemType></Entry><Entry><Name>SX10</Name><Id>e_92749</Id><Route><CallType>384</CallType><Protocol>SIP</Protocol><Restrict>Norestrict</Restrict><DialString>sx10@example.com</DialString><Description>sx10@example.com (SIP)</Description><SystemType>Cisco TelePresence SX10</SystemType></Route><IsLast>false</IsLast><IsFirst>false</IsFirst><BaseDN /><SystemType>Cisco TelePresence SX10</SystemType></Entry><IsLast>false</IsLast><IsFirst>false</IsFirst><NoOfEntries>7</NoOfEntries><FolderExists>true</FolderExists></Catalog>

Notez que cela est très similaire au POST et à 200 OK observés dans une capture de paquets. Cependant, cela sera le même, que vous utilisiez HTTP ou HTTPS. Alors que la capture sera illisible si HTTPS est utilisé.