Guia de solução de problemas de listas telefônicas do TMS

Introduction

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

Prerequisites

Requirements

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

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

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

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.

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 de kit de salas 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 telefônica (diretório corporativo). Para sistemas mais novos, a pesquisa na agenda telefônica é uma comunicação ao vivo e os dados não são armazenados no sistema. O TMS deve estar ativo e deve aceitar conexões para que as agendas telefônicas funcionem.

Diretórios da agenda telefônica do TMS

Diretório global

O diretório global é um arquivo armazenado no codec no qual as entradas não podem ser alteradas pelo controle remoto. O arquivo é transmitido por HTTP/HTTPs para todos os endpoints que se inscrevem em uma ou mais listas telefônicas no Cisco TMS. Várias agendas telefônicas 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 Ferramentas Administrativas > Configuração > Configurações Gerais > Frequência de Atualização de Livros Telefônicos.

Isso só funciona em endpoints que suportam o globdir.prm (sem suporte em endpoints 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 sempre que o botão da agenda telefônica no endpoint for pressionado. Ele permite uma hierarquia de agendas e vários números de telefone em cada entrada. O diretório corporativo também pode ser pesquisado.

Tipos de Lista Telefônica do Sistema

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

• Usar somente agendas telefônicas TMS centralizadas (agenda telefônica corporativa)
• Usar listas telefônicas centralizadas e baixadas (ambas)
• Utilizar listas telefônicas globais transferidas apenas para sistemas (lista telefônica global)

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

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

Portas usadas para livros telefônicos do TMS

Os endpoints acessam o serviço Lista telefônica do TMS 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 da agenda telefônica do endpoint

Quando um sistema é adicionado ao TMS, ele deve 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 da lista telefônica. O endereço no sistema pode ser verificado na Interface Web do sistema, xAPI (xConfiguration //phonebook) ou na Interface do usuário do 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 o comando Nome de host totalmente qualificado do servidor TMS está vazio, então o endereço IP é usado, mas se ambos os campos forem preenchidos, o FQDN (Fully Qualified Domain Name, nome de domínio totalmente qualificado) será o preferido e usado.

Quando você verifica o URL da agenda telefônica, é importante observar se <TMSaddress> é um FQDN ou um endereço IP. Se for um FQDN, o endpoint também deve ter um Domain Name Server (DNS) válido configurado. Se o DNS não estiver configurado no endpoint, ele não poderá resolver o FQDN para recuperar agendas telefônicas. Consulte a seção Verificar a configuração de DNS do endpoint para obter 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, 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 (Configuração > Configuração do sistema > Servidor do catálogo telefônico). Verifique se as configurações da agenda telefônica estão corretas. O mais importante é que o 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 da agenda telefônica do endpoint

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

Tipo de Lista Telefônica de Pesquisa da Lista Telefônica do xcommand: Corporativo

Em um cenário funcional, isso retornará um de dois resultados, dependendo do número de listas telefônicas atribuídas ao ponto final.

Se uma lista telefônica:

Se houver várias listas telefônicas aplicadas, o resultado listará as pastas da lista telefônica:

Esse comando também identificará quaisquer problemas de conectividade. Como exemplos:

• Se nenhuma lista telefônica for atribuída ao ponto final no TMS:

• Se não conseguir entrar em contato com o Phone Book Service:

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 de DNS:

Verificar a configuração de DNS do endpoint

Verifique a configuração de 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 (Configuração > Configuração do sistema > Rede).

Determine se o serviço da agenda telefônica está acessível

Em um PC de usuário, faça o seguinte:

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

   

   
   
   Se você vir a página mostrada na imagem, significa que o serviço da 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, poderá 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

Lista telefônica e fonte da agenda do TMS

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

Vá para Phone Books > Manage Phone Book Sources (Agendas telefônicas > Gerenciar fontes da agenda telefônica) para gerenciar as fontes da sua agenda telefônica.

As fontes atuais da agenda telefônica do TMS consistem em:

• Endpoint Cisco TMS
• Lista manual
• Ative Diretory
• Diretório H.350 e diretório de usuário H.350
• Lista telefônica baseada em arquivos
• Gatekeeper
• Outras listas telefônicas do TMS
• Diretório de provisionamento do Cisco TMS
• Catálogo telefônico local do sistema
• Cisco TMS gerenciado Cisco Unified CM

Depois de criar uma fonte de agenda, conecte-a a uma agenda telefônica. A agenda telefônica à qual você conecta a origem será a agenda telefônica definida nos dispositivos. Você pode conectar várias agendas telefônicas a várias fontes de agendas telefônicas

Verifique se Contatos e Lista telefônica estão definidos no sistema

Verificar contatos

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

Verifique se a agenda telefônica está conectada à fonte da agenda telefônica 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 definida nos dispositivos.

Note: Endpoints e Jabber Video for TelePresence (Movi) veem o que é preenchido na agenda telefônica, não na fonte da agenda telefônica. Esteja alerta para diferenças entre os dois.

Lista telefônica configurada no sistema

Verifique se as agendas telefônicas foram definidas no sistema. Vá para Phone Books > Manage Phone Books > Select the Phone Book (Agendas telefônicas > Gerenciar agendas telefônicas > Selecionar a agenda telefônica e selecione Set on Systems (Definir nos sistemas).

Uma lista dos sistemas é exibida à direita em Seleted Systems (Sistemas selecionados).

Vídeo Jabber para TelePresence (Movi) e livros telefônicos

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

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

Controle de acesso

Para pesquisá-la, os grupos de contas devem ter controle de acesso à agenda telefônica.

Mesmo que a opção Nível superior esteja marcada, expanda-a 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 padrão do endereço de vídeo 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 apareçam entradas duplicadas em endpoints ou com o cliente Jabber Video for TelePresence (Movi) se as fontes conectadas contiverem as mesmas entradas da agenda telefônica.

Roteamento de agenda telefônica

Esteja ciente dessa configuração caso alguns endpoints não obtenham algumas das 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 endpoints exibem apenas endereços que eles são capazes de discar. Por exemplo, em um endpoint H.323 apenas, 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 telefônica, independentemente de seus recursos de discagem.

401 Não Autorizado - Solucionar Problemas do IIS

Um dos problemas mais comuns da agenda telefônica é causado por uma configuração incorreta no IIS. A autenticação anônima deve ser habilitada para a pasta pública no IIS para que os endpoints possam recuperar agendas telefônicas. Se isso não estiver habilitado, os endpoints são desafiados pela autenticação que não podem fornecer.

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

Verificar configurações do IIS

1. Abra uma sessão do Protocolo de Área de Trabalho Remota (RDP - Remote Desktop Protocol) com o servidor TMS.
   
   
2. Abra o Gerenciador do IIS .
   
   
3. Expanda o site padrão.
   
   
4. Expanda o TMS.
   
   
5. Selecione público.
   
   
6. Selecionar
   
   

   

   
   
   

   

   
   
   
7. Verifique se a autenticação anônima está ativada e ative-a se ainda não estiver.

Usar uma captura de rede

Analisar dados de agenda no Wireshark

A pesquisa da agenda telefônica começa com uma solicitação de pesquisa para o serviço da 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 endpoint se o endpoint suportar tcpdump. Permitir que o rastreamento execute e acesse a lista telefônica por meio da interface da Web ou da interface do usuário. Você deve ver uma solicitação de pesquisa entrar no servidor TMS.

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

Primeiro, o endpoint se identificará, 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 detalhados serão alterados dependendo da solicitação feita. A solicitação acima foi feita usando o comando ssh 'xcommand Phonebook Search PhonebookType: Corporativo' do endpoint.>

A resposta do Servidor TMS deve ser um 200 OK. Caso contrário, você pode solucionar o problema com base na mensagem diferente que recebe.

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 é assim:

<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 da agenda telefônica no TMS

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

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

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

Altere o valor do nível de 'DESLIGADO' 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 atingir o aplicativo TMS, o registro será gravado. O local padrão para este arquivo é "C:\Program Files (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 ficará ilegível se o HTTPS for usado.