Guía de Troubleshooting de TMS Phone Books

Introducción

Este documento describe cómo resolver diferentes problemas con las libretas de teléfonos de Cisco TelePresence Management Suite (TMS).

Prerequisites

Requirements

Cisco recomienda que tenga conocimiento sobre estos temas:

• Cisco TMS
• Terminales de Cisco TelePresence
• Servicios de Microsoft Internet Information Server (IIS)

Componentes Utilizados

La información que contiene este documento se basa en las siguientes versiones de software y hardware.

• Cisco TMS versión 14.x y 15.x
• Terminales de software TC y 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.

Productos Relacionados

Este documento también puede utilizarse con estas versiones de software y hardware:

• Terminales Cisco TelePresence serie MX, serie C, serie SX, serie EX, dispositivos de kit de salas y MXP
• Cisco Jabber Video for TelePresence (Movi)

Antecedentes

Se puede acceder a las libretas de teléfonos TMS mediante HTTP o HTTPS en función del protocolo habilitado en IIS en el servidor de Microsoft Windows. El sistema se debe agregar en TMS para obtener la libreta de teléfonos (directorio corporativo). Para los sistemas más recientes, la búsqueda de la libreta de teléfonos es una comunicación en directo y los datos no se almacenan en el sistema. TMS debe estar activo y debe aceptar conexiones para que las libretas de teléfonos funcionen.

Directorios de la Guía TMS

Directorio global

El directorio global es un archivo almacenado en el códec en el que las entradas no se pueden cambiar a través del control remoto. El archivo es transmitido por HTTP/HTTP a todos los terminales que se suscriben a una o más libretas de teléfonos en Cisco TMS. Varias libretas de teléfonos se combinan en una sola libreta de teléfonos. Si contienen más de 400 entradas, sólo se muestran las primeras 400 en el terminal.

El archivo se transmite al terminal en los intervalos establecidos en el campo Administrative Tools > Configuration > General Settings > Phone Books Update Frequency .

Esto sólo funciona en los terminales que admiten globdir.prm (no se admite en los terminales de software TC o CE).

Corporate Directory

Corporate Directory es un servicio XML en el servidor de Cisco TMS que permite al terminal recuperar las libretas de teléfonos directamente del servidor cada vez que se pulsa el botón de libreta de teléfonos del terminal. Permite una jerarquía de libretas de teléfonos y varios números de teléfono en cada entrada. También se puede buscar en el Directorio corporativo.

Tipos de libreta de teléfonos del sistema

Navegue hasta Herramientas administrativas > Configuración > Configuración general para seleccionar el tipo de libreta de teléfonos del sistema. Puede:

• Utilizar sólo las libretas de teléfonos TMS centralizadas (libreta de teléfonos corporativa)
• Utilizar las libretas de teléfonos centralizadas y descargadas (ambas)
• Utilizar las libretas de teléfonos globales descargadas sólo en sistemas (guía global)

Cisco recomienda que opte por la agenda telefónica corporativa o por ambas, ya que los terminales TANDBERG antiguos sólo admiten la guía descargada.

La configuración predeterminada es ambas, lo que hace que el directorio global esté disponible en caso de que falle la búsqueda en vivo del directorio corporativo.

Puertos utilizados para las libretas de teléfonos TMS

Los terminales acceden al servicio TMS Phonebook con el puerto 80 (HTTP) o el puerto 443 (HTTP). Verifique que estos puertos estén permitidos en el firewall de Microsoft Windows Server y en cualquier firewall de red que pueda estar en la trayectoria.

Configuración del servidor de la libreta de teléfonos del terminal

Una vez agregado un sistema a TMS, debe recibir un conjunto de configuraciones de administración que contenga la dirección de retroalimentación, la dirección de administración externa y la dirección de la agenda telefónica. La dirección del sistema se puede comprobar desde la interfaz web del sistema, xAPI (xConfiguration //phonebook) o desde la interfaz de usuario del sistema.

La dirección enviada al terminal está determinada por lo que se configura en TMS en Administrative Tools > Configuration > Network Settings bajo Advanced Network Settings for Systems on Internal LAN. Si el campo TMS Server IPv4 Address está configurado y el campo Nombre de host completamente calificado del servidor TMS está vacío, se utiliza la dirección IP, pero si se rellenan ambos campos, se prefiere y utiliza el nombre de dominio completo (FQDN).

Cuando verifique la URL de la libreta de teléfonos, es importante observar si <TMSaddress> es un FQDN o una dirección IP. Si es un FQDN, el terminal también debe tener un servidor de nombres de dominio (DNS) válido configurado. Si DNS no está configurado en el terminal, no puede resolver el FQDN para recuperar las libretas de teléfonos. Consulte la sección Verificación de la Configuración DNS de Extremo para ver los pasos para verificar el DNS.

Nota: Asegúrese de que la dirección IP es correcta. A veces, los clientes han trasladado recientemente TMS de un servidor a otro, tienen otro TMS de laboratorio o puede que exista un TMS desconocido.

Compruebe la dirección con la interfaz web

Dentro de la interfaz web del terminal, navegue hasta Configuration > System Configuration > Phonebook Server. Compruebe que la configuración de la agenda telefónica es correcta. Lo que es más importante, la URL debe coincidir con este formato: http://<TMSaddress>/tms/public/external/phonebook/phonebookservice.asmx.

Compruebe la dirección con Secure Shell (SSH)

A continuación se muestra cómo se verifica la dirección con 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"

Prueba de la solicitud de la Guía desde el terminal

La manera más rápida de determinar la conectividad es a SSH en el terminal usando las credenciales de administrador y ejecutar el siguiente comando:

xcommand Tipo de agenda telefónica de búsqueda de agenda telefónica: Corporativo

En un escenario en funcionamiento, esto devolverá uno de dos resultados, dependiendo del número de libretas de teléfonos asignadas al terminal.

Si hay una agenda telefónica:

Si se aplican varias libretas de teléfonos, el resultado mostrará en su lugar las carpetas de la agenda telefónica:

Este comando también identificará cualquier problema de conectividad. Como ejemplos:

• Si no hay libretas de teléfonos asignadas al terminal en TMS:

• Si no puede ponerse en contacto con el servicio de la Guía:

Si hay un problema de configuración de autenticación en IIS en el servidor que aloja TMS:

Si apunta a 'http o https://<TMSFQDN>/tms/public/external/phonebook/phonebookservice.asmx'. le mostrará si hay un posible problema de resolución de DNS:

Comprobación de la configuración DNS del terminal

Verifique la configuración DNS con SSH

Verifique la configuración DNS con la interfaz Web

Dentro de la interfaz web del terminal, navegue hasta Configuración > Configuración del sistema > Red.

Determinar si el servicio de la Guía está disponible

Desde un PC de usuario, siga estos pasos:

1. Dentro del terminal, navegue hasta Configuración > Configuración del sistema > Servidor de agenda telefónica y copie la URL de la libreta de teléfonos TMS configurada en el terminal.
   
   
2. Pegue la URL en una ventana del navegador.
   
   

   

   
   
   Si ve la página mostrada en la imagen, significa que se puede acceder al servicio de la agenda telefónica. Si no ve esta página, verifique que el equipo en el que ha realizado la prueba no tenga ninguna restricción de red para acceder a la dirección.
   
   Si ve un mensaje No autorizado, podría haber un problema con IIS, que se explica más adelante en este documento.

Desde la raíz del terminal, ingrese: curl http://<TMS IP Address>/tms/public/external/phonebook/phonebookservice.asmx

Fuente de la Guía y la Guía de TMS

Todas las libretas de teléfonos de TMS se basan en fuentes de la guía.

Vaya a Libretas telefónicas > Administrar fuentes de la Guía para administrar las fuentes de su libreta de teléfonos.

Actualmente, las fuentes de la libreta de teléfonos de TMS constan de:

• Punto final de Cisco TMS
• Lista manual
• Active Directory
• Directorio H.350 y Directorio de usuarios H.350
• Libreta de teléfonos basada en archivos
• Gatekeeper
• Otra Guía TMS
• Directorio de aprovisionamiento de Cisco TMS
• Guía local del sistema
• Cisco Unified CM gestionado por TMS

Una vez creado el origen de la libreta de teléfonos, se conecta a una guía telefónica. La libreta de teléfonos a la que se conecta la fuente será la libreta de teléfonos que haya configurado en los dispositivos. Puede conectar varias libretas de teléfonos a varias fuentes de la guía

Verificar contactos y libreta de teléfonos configurados en el sistema

Verificar contactos

Verifique el origen de la libreta de teléfonos y verifique que existan contactos y métodos de contacto.

Compruebe que la agenda telefónica está conectada al origen de la guía y verifique que existan los mismos contactos y métodos de contacto. La libreta de teléfonos a la que se conecta la fuente será la libreta de teléfonos que haya configurado en los dispositivos.

Nota: Los terminales y Jabber Video para TelePresence (Movi) ven lo que se indica en la guía, no en la fuente de la guía. Esté alerta por las diferencias entre los dos.

Guía configurada en el sistema

Asegúrese de que las libretas de teléfonos se han configurado en el sistema. Vaya a Libretas de teléfonos > Gestionar libretas de teléfonos > Seleccione la Guía y seleccione Establecer en sistemas.

A la derecha aparece una lista de los sistemas en Sistemas seleccionados.

Jabber Video para TelePresence (Movi) y libretas telefónicas

Nota: El cliente debe ser autenticado para recibir las libretas de teléfonos. La zona de VCS/Expressway en la que se registra debe ser Verificar credenciales o Tratar como Autenticado.

Los usuarios reciben la libreta de teléfonos a través de la serie VCS/Expressway y no de TMS. 

Control de acceso

Los grupos de cuentas deben tener el control de acceso a la libreta de teléfonos para buscar en ella.

Incluso si el nivel superior está activado, expanda y verifique que los subniveles estén marcados. Si sólo los usuarios nuevos no reciben libretas de teléfonos, es posible que formen parte de un grupo nuevo que no esté activado en la ficha Control de acceso.

Configuración de aprovisionamiento

1. En TMS Systems > Provisioning > Users, verifique que el patrón de dirección de vídeo esté configurado.
   
   

   

   
   
   
2. Compruebe la plantilla de configuración asignada al usuario de Jabber Video para TelePresence (Movi) para la configuración de URI del servidor de la libreta de teléfonos.
   
   

   

Duplicar entradas

Tenga cuidado si conecta varias libretas de teléfonos a una sola agenda telefónica, porque esto puede hacer que aparezcan entradas duplicadas en los terminales o con el cliente Jabber Video para TelePresence (Movi) si las fuentes conectadas contienen las mismas entradas de la libreta de teléfonos.

Routing de la libreta de teléfonos

Tenga en cuenta esta configuración en caso de que algunos terminales no reciban algunas de las entradas de la agenda telefónica que se ven en otros terminales.

En Administrative Tools > Configuration > General Settings, hay una configuración llamada Route Phone Book Entries. Sí es el valor predeterminado, lo que significa que los terminales sólo muestran las direcciones que pueden marcar. Por ejemplo, en un terminal solo con H.323, no se muestran los números ISDN ni las direcciones del protocolo de inicio de sesión (SIP). No significa que los terminales muestran todas las direcciones y números de la guía, independientemente de sus capacidades de marcación.

401 No Autorizado: Solución de Problemas de IIS

Uno de los problemas más comunes de la libreta de teléfonos se debe a una configuración incorrecta en IIS. La autenticación anónima debe estar habilitada para la carpeta pública en IIS para que los terminales puedan recuperar las libretas de teléfonos. Si esto no está habilitado, los terminales se enfrentan al desafío de autenticación que no pueden proporcionar.

Para determinar si el punto final se cuestiona para la autenticación, SSH en el punto final y la consulta para la libreta de teléfonos con xcommand Phonebook Search Phonebook Type: Corporativo. Si el punto final se cuestiona para la autenticación, verá '<Authentication fail>' (código HTTP=401) como se ve en esta imagen.

Comprobar la configuración de IIS

1. Abra una sesión de protocolo de escritorio remoto (RDP) con el servidor TMS.
   
   
2. Abra el Administrador IIS .
   
   
3. Expanda Sitio Web predeterminado.
   
   
4. Expanda TMS.
   
   
5. Seleccione public.
   
   
6. Seleccionar
   
   

   

   
   
   

   

   
   
   
7. Verifique que la autenticación anónima esté habilitada y habilite si aún no lo está.

Utilizar una captura de red

Analizar los datos de la agenda telefónica en Wireshark

La búsqueda de la libreta de teléfonos comienza con una solicitud de búsqueda al servicio de libreta de teléfonos en TMS a la que TMS responde e incluye el resultado de la búsqueda en la respuesta si todo funciona.

Puede ejecutar el seguimiento en el servidor TMS o en el punto final si el punto final admite tcpdump. Deje que el seguimiento se ejecute y acceda a la agenda telefónica a través de la interfaz web o desde la interfaz de usuario. Debería ver una solicitud de búsqueda entrante en el servidor TMS.

Después de esta secuencia TCP, verá dos componentes principales del XML:

En primer lugar, el terminal se identificará a sí mismo, por ejemplo:

<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>

A continuación, verá los detalles de la solicitud:

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

<Nota: Los valores de detalle cambiarán en función de la solicitud realizada. La solicitud anterior se realizó mediante el comando ssh 'xcommand Phonebook Search PhonebookType: Corporativo" desde el terminal.>

La respuesta del servidor TMS debe ser 200 OK. De lo contrario, puede resolver problemas en función del mensaje que reciba.

La respuesta 200 OK contendrá las entradas relevantes de las libretas de teléfonos asignadas al terminal en TMS. En la solicitud anterior, el terminal tenía una sola libreta de teléfonos asignada en TMS, y la respuesta es la siguiente:

<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>

Registro de solicitud/respuesta de la Guía en TMS

TMS 15.8 introdujo la capacidad de registrar todas las solicitudes de la guía y sus respuestas. De forma predeterminada, este registro está desactivado, pero se puede habilitar de dos maneras.

1. Al modificar el archivo web.config ubicado, de forma predeterminada, en "C:\Program Files (x86)\TANDBERG\TMS\wwwTMS\Public\web.config" y modificar esta sección:

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

Cambie el valor de nivel de 'OFF' a 'DEBUG'

2. Esto también se puede hacer más fácilmente usando la utilidad de recopilación de registros de TMS al verificar lo siguiente:

Una vez que una solicitud de libreta de teléfonos llegue a la aplicación TMS, se escribirá el registro. La ubicación predeterminada para este archivo es "C:\Program Files (x86)\TANDBERG\TMS\data\Logs\TMSDebug\log-phonebook-request-response.txt"

Un ejemplo de este resultado:

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>

Tenga en cuenta que esto es muy similar al POST y 200 OK que se ven en una captura de paquetes. Sin embargo, esto será el mismo, ya sea utilizando HTTP o HTTPS. Mientras que la captura será ilegible si se utiliza HTTPS.