Guia de solução de problemas de catálogos telefônicos do TMS

Introdução

Este documento descreve como solucionar diferentes problemas com as agendas telefônicas do Cisco TelePresence Management Suite (TMS).

Pré-requisitos

Requisitos

A Cisco recomenda que você tenha conhecimento destes tópicos:

• Cisco TMS
• Endpoints Cisco TelePresence
• Serviços de Informações da Internet (IIS) da Microsoft

Componentes Utilizados

As informações neste documento são baseadas nestas versões de software e hardware:

• Cisco TMS versão 14.x e 15.x
• Endpoints de software TC e CE

As informações neste documento foram criadas a partir de dispositivos em um ambiente de laboratório específico. Todos os dispositivos utilizados neste documento foram iniciados com uma configuração (padrão) inicial. Se a sua rede estiver ativa, certifique-se de que entende o impacto potencial de qualquer comando.

Produtos Relacionados

Este documento também pode ser usado com as seguintes versões de hardware e software:

• Endpoints Cisco TelePresence MX-Series, C-Series, SX-Series, EX-Series, dispositivos Room Kit e MXPs
• Cisco Jabber Video for TelePresence (Movi)

Informações de Apoio

As agendas telefônicas do TMS podem ser acessadas com o uso de HTTP ou HTTPS com base no protocolo habilitado no IIS no servidor Microsoft Windows. O sistema deve ser adicionado ao TMS para obter a agenda (diretório corporativo). Para sistemas mais recentes, a pesquisa da agenda telefônica é uma comunicação em tempo real e os dados não são armazenados no sistema. O TMS deve estar ativo e aceitar conexões para que as agendas funcionem.

Diretórios de Agenda Telefônica do TMS

Diretório global

O Diretório global é um arquivo armazenado no codec onde as entradas não podem ser alteradas através do controle remoto. O arquivo é transmitido por HTTP/HTTPs para todos os endpoints que assinam uma ou mais agendas telefônicas no Cisco TMS. Várias agendas são mescladas em uma agenda. Se contiverem mais de 400 entradas, somente as primeiras 400 serão mostradas no endpoint.

O arquivo é transmitido ao endpoint nos intervalos definidos no campo Administrative Tools > Configuration > General Settings > Phone Books Update Frequency.

Isso só funciona em terminais que suportam o globdir.prm (Não suportado em terminais de software TC ou CE).

Corporate Directory

O diretório corporativo é um serviço XML no servidor Cisco TMS que permite que o endpoint recupere as agendas telefônicas diretamente do servidor toda vez que o botão de agenda telefônica no endpoint é pressionado. Ele permite uma hierarquia de agendas telefônicas e vários números de telefone em cada entrada. O diretório corporativo também pode ser pesquisado.

Tipos de agenda telefônica do sistema

Navegue até Administrative Tools > Configuration > General Settings para selecionar o tipo de agenda do sistema. Você pode:

• Usar somente agendas telefônicas TMS centralizadas (agenda telefônica corporativa)
• Usar agendas telefônicas centralizadas e baixadas (ambas)
• Usar agendas telefônicas globais baixadas somente nos sistemas (agenda telefônica global)

A Cisco recomenda que você opte pela agenda telefônica corporativa ou por ambas, pois a agenda telefônica baixada só é suportada por endpoints TANDBERG antigos.

A configuração padrão é ambos, o que torna o diretório global disponível caso a pesquisa ao vivo do diretório corporativo falhe.

Portas usadas para agendas telefônicas TMS

Os endpoints acessam o serviço TMS Phonebook com a porta 80 (HTTP) ou a porta 443 (HTTPs). Verifique se essas portas são permitidas no firewall do Microsoft Windows Server e em qualquer firewall de rede que possa estar no caminho.

Configuração do Servidor de Agenda Telefônica de Ponto de Extremidade

Depois que um sistema for adicionado ao TMS, ele deverá receber um conjunto de configurações de gerenciamento que contém o endereço de feedback, o endereço de gerenciamento externo e o endereço de agenda telefônica. O endereço no sistema pode ser verificado a partir da interface da Web do sistema, xAPI (xConfiguration //phonebook), ou a partir da interface do usuário no sistema.

O endereço enviado para o endpoint é determinado pelo que é configurado no TMS em Administrative Tools > Configuration > Network Settings em Advanced Network Settings for Systems on Internal LAN. Se o campo Endereço IPv4 do Servidor TMS estiver configurado e a Nome de host totalmente qualificado do servidor TMS estiver vazio, o Endereço IP será usado, mas se ambos os campos forem preenchidos, o Nome de domínio totalmente qualificado (FQDN) será preferido e usado.

Ao verificar o URL da agenda, é importante observar se o <TMSaddress> é um FQDN ou um endereço IP. Se for um FQDN, o ponto de extremidade também deverá ter um Servidor de Nome de Domínio (DNS) válido configurado. Se o DNS não estiver configurado no endpoint, ele não poderá resolver o FQDN para recuperar as agendas telefônicas. Consulte a seção Verificar a Configuração DNS do Ponto Final para obter as etapas para verificar o DNS.

Note: Verifique se o endereço IP está correto. Às vezes, os clientes mudaram recentemente o TMS de um servidor para outro, eles têm outro TMS de laboratório ou um TMS invasor pode existir.

Verifique o endereço com a interface da Web

Na interface da Web do endpoint, navegue para Configuration > System Configuration > Phonebook Server. Verifique se as configurações da agenda estão corretas. O mais importante é que a URL deve corresponder a este formato: http://<TMSaddress>/tms/public/external/phonebook/phonebookservice.asmx.

Verifique o endereço com Secure Shell (SSH)

Veja como você verifica o endereço com 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"

Testar solicitação de agenda telefônica do endpoint

A maneira mais rápida de determinar a conectividade é usar SSH no endpoint usando credenciais de administrador e executar o seguinte comando:

xcommand Pesquisa na Lista Telefônica Tipo de Lista Telefônica: Corporativo

Em um cenário de trabalho, isso retornará um de dois resultados, dependendo do número de agendas atribuídas ao endpoint.

Se houver um catálogo telefônico:

Se várias listas telefônicas forem aplicadas, o resultado listará as pastas de listas telefônicas:

Esse comando também identificará quaisquer problemas de conectividade. A título de exemplo:

• Se nenhum catálogo telefônico for atribuído ao endpoint no TMS:

• Se não for possível entrar em contato com o Serviço de agenda:

Se houver um problema de configuração de autenticação no IIS no servidor que hospeda o TMS:

Se estiver apontando para 'http ou https://<TMSFQDN>/tms/public/external/phonebook/phonebookservice.asmx.' ele mostrará se há um possível problema de resolução DNS:

Verificar Configuração DNS do Ponto de Extremidade

Verifique a configuração DNS com SSH

Verifique a configuração DNS com a interface da Web

Na interface da Web do endpoint, navegue para Configuration > System Configuration > Network.

Determine se o serviço de agenda está acessível

Em um PC do usuário, siga estas etapas:

1. No endpoint, navegue até Configuration > System Configuration > Phonebook Server e copie a URL da agenda telefônica do TMS configurada no endpoint.
   
   
2. Cole a URL em uma janela do navegador.
   
   

   

   
   
   Se você vir a página mostrada na imagem, isso significa que o serviço de Lista telefônica está acessível. Se você não vir esta página, verifique se o computador no qual você está testando não tem nenhuma restrição de rede para acessar o endereço.
   
   Se você vir um Não autorizado, pode haver um problema com o IIS, que será discutido mais adiante neste documento.

Na Raiz do ponto final, insira: curl http://<TMS IP Address>/tms/public/external/phonebook/phonebookservice.asmx

Catálogo telefônico do TMS e origem do catálogo telefônico

Todas as agendas do TMS são criadas a partir de fontes de agendas telefônicas.

Vá para Phone Books > Manage Phone Book Sources para gerenciar suas fontes de agenda.

Atualmente, as fontes de agenda telefônica do TMS consistem em:

• Endpoint Cisco TMS
• Lista manual
• Diretório ativo
• Diretório H.350 e Diretório de usuário H.350
• Agenda telefônica baseada em arquivo
• Gatekeeper
• Outro catálogo telefônico do TMS
• Diretório de provisionamento do Cisco TMS
• Lista telefônica local do sistema
• Cisco Unified CM gerenciado por TMS da Cisco

Depois que uma fonte de agenda telefônica tiver sido criada, conecte-a a uma agenda telefônica. A agenda telefônica à qual você conecta a origem será a agenda telefônica que você definiu nos dispositivos. Você pode conectar várias agendas telefônicas a várias origens de agendas telefônicas

Verifique se os contatos e a agenda estão definidos no sistema

Verificar contatos

Verifique a origem da agenda telefônica e verifique se os contatos e os métodos de contato existem.

Verifique se a agenda está conectada à fonte da agenda e verifique se os mesmos contatos e métodos de contato existem. A agenda telefônica à qual você conecta a origem será a agenda telefônica que você definiu nos dispositivos.

Note: Os endpoints e o Jabber Video para TelePresence (Movi) veem o que é preenchido na agenda, não a fonte da agenda. Esteja alerta para diferenças entre os dois.

Agenda definida no sistema

Verifique se as agendas foram configuradas no sistema. Vá para Phone Books > Manage Phone Books > Select the Phone Book e selecione Set on Systems.

Uma lista dos sistemas é exibida à direita em Seleted Systems.

Vídeo Jabber para TelePresence (Movi) e Phone Books

Note: O cliente deve ser autenticado para receber agendas. A zona do VCS/Expressway na qual ele se registra deve ser Verificar credenciais ou Tratar como autenticado.

Os usuários recebem a agenda telefônica através do VCS/Expressway Series e não do TMS. 

Controle de acesso

Os grupos de contas devem ter controle de acesso à agenda para serem pesquisados.

Mesmo que Nível superior esteja marcado, expanda-o e verifique se os subníveis estão marcados. Se apenas novos usuários não receberem agendas telefônicas, é possível que eles façam parte de um novo grupo que não esteja marcado na guia Controle de acesso.

Configuração de provisionamento

1. Em TMS Systems > Provisioning > Users, verifique se o Video Address Pattern está configurado.
   
   

   

   
   
   
2. Verifique o modelo de configuração atribuído ao usuário do Jabber Video for TelePresence (Movi) para a configuração da URI do servidor da agenda telefônica.
   
   

   

Entradas duplicadas

Tenha cuidado ao conectar várias agendas telefônicas a uma única agenda telefônica, pois isso pode fazer com que entradas duplicadas apareçam em endpoints ou com o cliente Jabber Video for TelePresence (Movi) se as fontes conectadas contiverem as mesmas entradas de agenda telefônica.

Roteamento da agenda telefônica

Esteja ciente dessa configuração caso alguns endpoints não obtenham algumas entradas da agenda telefônica que são vistas em outros endpoints.

Em Administrative Tools > Configuration > General Settings, há uma configuração chamada Route Phone Book Entries. Sim é a configuração padrão, o que significa que os pontos de extremidade exibem apenas os endereços que são capazes de discar. Por exemplo, em um endpoint apenas H.323, os números ISDN e os endereços SIP (Session Initiation Protocol) não são exibidos. Não significa que os endpoints exibem todos os endereços e números na agenda, independentemente de seus recursos de discagem.

401 Não Autorizado - Solução de problemas do IIS

Um dos problemas mais comuns de agenda telefônica é causado por um erro de configuração no IIS. A Autenticação Anônima deve ser habilitada para a pasta pública no IIS para que os pontos de extremidade possam recuperar agendas telefônicas. Se isso não estiver habilitado, os endpoints serão desafiados para a autenticação que não podem fornecer.

Para determinar se a autenticação do endpoint é desafiada, execute SSH no endpoint e consulte a agenda telefônica com xcommand Phonebook Search Phonebook Type: Corporativo. Se a autenticação do ponto final for solicitada, você verá '<Authentication fail>' (HTTP code=401) como visto nesta imagem.

Verificar Configurações do IIS

1. Abra uma sessão do Remote Desktop Protocol (RDP) com o servidor TMS.
   
   
2. Abra o Gerenciador do IIS .
   
   
3. Expanda Default Website.
   
   
4. Expanda TMS.
   
   
5. Selecione público.
   
   
6. Selecionar
   
   

   

   
   
   

   

   
   
   
7. Verifique se a Autenticação anônima está habilitada e habilite-a, caso ainda não esteja.

Usar uma captura de rede

Analisar dados da agenda no Wireshark

A pesquisa da agenda telefônica começa com uma solicitação de pesquisa para o serviço de agenda telefônica no TMS ao qual o TMS responde e inclui o resultado da pesquisa na resposta se tudo funcionar.

Você pode executar o rastreamento no servidor TMS ou no ponto final se o ponto final suportar tcpdump. Permita que o rastreamento seja executado e acesse o catálogo telefônico pela interface da Web ou pela interface do usuário. Você deve ver uma solicitação de pesquisa no servidor TMS.

Após esse fluxo TCP, você verá dois componentes principais do XML:

Primeiro, o endpoint identificará a si mesmo, por exemplo:

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

Em seguida, você verá os detalhes da solicitação:

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

<Observação: Os valores dos detalhes serão alterados dependendo da solicitação feita. A solicitação acima foi feita usando o comando ssh 'xcommand Phonebook Search PhonebookType: Corporativo' a partir do endpoint.>

A resposta do Servidor TMS deve ser 200 OK. Caso contrário, você poderá solucionar o problema com base nas diferentes mensagens recebidas.

A resposta 200 OK conterá as entradas relevantes das agendas telefônicas atribuídas ao endpoint no TMS. Na solicitação acima, o endpoint tinha uma única agenda telefônica atribuída no TMS, e a resposta se parece com esta:

<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 solicitação/resposta de agenda telefônica no TMS

O TMS 15.8 introduziu a capacidade de registrar todas as solicitações de agenda telefônica e suas respostas. Por padrão, esse registro está desativado, mas pode ser ativado de duas maneiras.

1. Modificando o arquivo web.config localizado, por padrão, em "C:\Program Files (x86)\TANDBERG\TMS\wwwTMS\Public\web.config" e modificando esta seção:

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

Altere o valor de nível de 'OFF' para 'DEBUG'

2. Isso também pode ser feito mais facilmente usando o TMS Log Collection Utility verificando o seguinte:

Quando uma solicitação de agenda telefônica chegar ao aplicativo TMS, o registro será gravado. O local padrão para este arquivo é "C:\Program Arquivos (x86)\TANDBERG\TMS\data\Logs\TMSDebug\log-phonebook-request-response.txt"

Um exemplo desta saída:

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>

Observe que isso é muito semelhante ao POST e 200 OK vistos em uma captura de pacote. No entanto, isso será o mesmo, seja usando HTTP ou HTTPS. Enquanto a captura será ilegível se HTTPS for usado.