TMS Telefoonboeken Problemen oplossen

Inleiding

In dit document wordt beschreven hoe u problemen met Cisco TelePresence Management Suite (TMS)-telefoonboeken kunt oplossen.

Voorwaarden

Vereisten

Cisco raadt kennis van de volgende onderwerpen aan:

• Cisco TMS
• Cisco TelePresence-eindpunten
• Microsoft Internet Information Services (IIS)

Gebruikte componenten

De informatie in dit document is gebaseerd op de volgende software- en hardware-versies:

• Cisco TMS versie 14.x en 15.x
• Eindpunten voor TC- en CE-software

De informatie in dit document is gebaseerd op de apparaten in een specifieke laboratoriumomgeving. Alle apparaten die in dit document worden beschreven, hadden een opgeschoonde (standaard)configuratie. Als uw netwerk live is, moet u de potentiële impact van elke opdracht begrijpen.

Verwante producten

Dit document kan ook worden gebruikt voor de volgende hardware- en softwareversies:

• Cisco TelePresence-eindpunten MX-reeks, C-reeks, SX-reeks, EX-reeks, Room Kit-apparaten en MXP's
• Cisco Jabber Video voor TelePresence (Movi)

Achtergrondinformatie

De TMS-telefoonboeken zijn toegankelijk met het gebruik van HTTP of HTTPS op basis van welk protocol is ingeschakeld in IIS op de Microsoft Windows-server. Het systeem moet worden toegevoegd in TMS om het telefoonboek (bedrijfsgids) te krijgen. Voor nieuwere systemen is het zoeken naar telefoonboeken een live communicatie en worden de gegevens niet op het systeem opgeslagen. TMS moet zijn ingeschakeld en moet verbindingen accepteren om telefoonboeken te laten werken.

Telefoonboekdirectory's TMS

Globale directory

De Global Directory is een bestand dat is opgeslagen op de codec waar de items niet kunnen worden gewijzigd via de afstandsbediening. Het bestand wordt door HTTP/HTTP's verzonden naar alle eindpunten die zich abonneren op een of meer telefoonboeken in Cisco TMS. Meerdere telefoonboeken worden samengevoegd tot één telefoonboek. Als ze meer dan 400 vermeldingen bevatten, worden alleen de eerste 400 weergegeven op het eindpunt.

Het bestand wordt naar het eindpunt verzonden met de intervallen die zijn ingesteld in het veld Systeembeheer > Configuratie > Algemene instellingen > Frequentie bijwerken telefoonboeken.

Dit werkt alleen op eindpunten die globdir.prm ondersteunen (niet ondersteund op eindpunten van TC- of CE-software).

bedrijvengids

De Corporate Directory is een XML-service op de Cisco TMS-server waarmee het eindpunt de telefoonboeken rechtstreeks van de server kan ophalen telkens wanneer de telefoonboekknop op het eindpunt wordt ingedrukt. Het zorgt voor een hiërarchie van telefoonboeken en meerdere telefoonnummers bij elk item. De Corporate Directory is ook doorzoekbaar.

Systeem Telefoonboek Typen

Navigeer naar Systeembeheer > Configuratie > Algemene instellingen om het type telefoonboek van uw systeem te selecteren. U kunt:

• Gebruik alleen gecentraliseerde TMS-telefoonboeken (zakelijk telefoonboek)
• Gebruik zowel gecentraliseerde als gedownloade telefoonboeken (beide)
• Gebruik globale telefoonboeken die alleen naar systemen zijn gedownload (wereldwijd telefoonboek)

Cisco raadt u aan te kiezen voor het zakelijke telefoonboek of beide, omdat het gedownloade telefoonboek alleen wordt ondersteund door bestaande TANDBERG-eindpunten.

De standaardinstelling is beide, waardoor de globale directory beschikbaar is als de bedrijfsdirectory live zoeken mislukt.

Poorten gebruikt voor TMS-telefoonboeken

De eindpunten hebben toegang tot de telefoonboekservice van TMS met poort 80 (HTTP) of poort 443 (HTTP). Controleer of deze poorten zijn toegestaan in de Microsoft Windows Server-firewall en eventuele netwerkfirewall die zich op het pad bevindt.

Configuratie van eindpunttelefoonboekserver

Zodra een systeem is toegevoegd aan TMS, moet het een set beheerinstellingen ontvangen die het feedbackadres, het externe beheeradres en het telefoonboekadres bevat. Het adres op het systeem kan worden gecontroleerd via de webinterface van het systeem, xAPI (xConfiguration //phonebook), of via de gebruikersinterface op het systeem.

Het adres dat naar het eindpunt wordt doorgestuurd, wordt bepaald door wat wordt geconfigureerd in TMS bij Systeembeheer > Configuratie > Netwerkinstellingen onder Geavanceerde netwerkinstellingen voor systemen op een intern LAN. Als het veld IPv4-adres TMS Server is geconfigureerd en de TMS Server Fully Qualified Hostname Als het veld leeg is, wordt het IP-adres gebruikt, maar als beide velden zijn ingevuld, heeft de volledig gekwalificeerde domeinnaam (FQDN) de voorkeur en wordt deze gebruikt.

Wanneer u de URL van het telefoonboek controleert, is het belangrijk om op te merken of het <TMS-adres> een FQDN of een IP-adres is. Als het een FQDN is, moet op het eindpunt ook een geldige Domain Name Server (DNS) zijn geconfigureerd. Als DNS niet is geconfigureerd op het eindpunt, kan de FQDN niet worden opgelost om telefoonboeken op te halen. Raadpleeg het gedeelte Eindpunt DNS-configuratie controleren voor stappen om de DNS te verifiëren.

Opmerking: Controleer of het IP-adres juist is. Soms hebben klanten onlangs TMS van de ene server naar de andere verplaatst, hebben ze een ander lab-TMS of bestaat er mogelijk een malafide TMS.

Controleer het adres met de webinterface

Navigeer binnen de webinterface van het eindpunt naar Configuratie > Systeemconfiguratie > Telefoonboekserver. Controleer of de instellingen van het telefoonboek correct zijn. Het belangrijkste is dat de URL overeenkomt met dit formaat: http://<TMSaddress>/tms/public/external/phonebook/phonebookservice.asmx.

Controleer het adres met Secure Shell (SSH)

Hier is hoe u het adres met SSH controleert:

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"

Telefoonboek aanvragen testen vanaf het eindpunt

De snelste manier om connectiviteit te bepalen is om SSH in het eindpunt te plaatsen met behulp van beheerdersreferenties en de volgende opdracht uit te voeren:

xcommand Telefoonboek Zoeken Telefoonboek Type: Zakelijk

In een werkscenario zal dit een van de twee resultaten opleveren, afhankelijk van het aantal telefoonboeken dat aan het eindpunt is toegewezen.

Als één telefoonboek:

Als meerdere telefoonboeken worden toegepast, worden in het resultaat in plaats daarvan de telefoonboekmappen vermeld:

Met deze opdracht worden ook eventuele connectiviteitsproblemen geïdentificeerd. Als voorbeelden:

• Als er geen telefoonboeken zijn toegewezen aan het eindpunt in TMS:

• Als u geen contact kunt opnemen met de telefoonboekservice:

Als er een probleem is met de verificatieconfiguratie in IIS op de server waarop TMS wordt gehost:

Als u naar 'http of https://<TMSFQDN>/tms/public/external/phonebook/phonebookservice.asmx.' verwijst, wordt aangegeven of er een mogelijk probleem met de DNS-oplossing is:

Controleer de DNS-configuratie van het eindpunt

Controleer de DNS-configuratie met SSH

Controleer de DNS-configuratie met de webinterface

Navigeer binnen de webinterface van het eindpunt naar Configuratie > Systeemconfiguratie > Netwerk.

Bepaal of de telefoonboekservice bereikbaar is

Voer vanaf een gebruikers-pc de volgende stappen uit:

1. Navigeer binnen het eindpunt naar Configuratie > Systeemconfiguratie > Telefoonboekserver en kopieer de URL van het TMS-telefoonboek die op het eindpunt is geconfigureerd.
   
   
2. Plak de URL in een browservenster.
   
   

   

   
   
   Als u de pagina in de afbeelding ziet, betekent dit dat de telefoonboekservice bereikbaar is. Als u deze pagina niet ziet, controleert u of de computer waarop u test geen netwerkbeperkingen heeft om toegang te krijgen tot het adres.
   
   Als u een ongeautoriseerde, dan kan er een probleem met IIS, die verder wordt besproken in dit document.

Voer in de hoofdmap van het eindpunt het volgende in: curl http://<TMS IP Address>/tms/public/external/phonebook/phonebookservice.asmx

TMS Telefoonboek en Telefoonboek Bron

Alle TMS-telefoonboeken zijn opgebouwd uit telefoonboekbronnen.

Ga naar Telefoonboeken > Bronnen van telefoonboeken beheren om de bronnen van uw telefoonboek te beheren.

Momenteel TMS telefoonboek bronnen bestaan uit:

• Cisco TMS Endpoint
• handmatige lijst
• Active Directory
• H.350 Directory en H.350 User Directory
• Bestandsgebaseerd telefoonboek
• poortwachter
• Ander TMS-telefoonboek
• Cisco TMS Provisioning Directory
• Lokaal telefoonboek van systeem
• Cisco TMS-Managed Cisco Unified CM

Zodra een telefoonboek bron is gemaakt, verbindt u het met een telefoonboek. Het telefoonboek waarmee u de bron verbindt, is het telefoonboek dat u op apparaten hebt ingesteld. U kunt meerdere telefoonboeken verbinden met meerdere telefoonboekbronnen

Contactpersonen controleren en telefoonboek is ingesteld op Systeem

Contactpersonen verifiëren

Controleer de bron van het telefoonboek en controleer of er contactpersonen en contactmethoden bestaan.

Controleer of het telefoonboek is aangesloten op de telefoonboekbron en controleer of dezelfde contactpersonen en contactmethoden bestaan. Het telefoonboek waarmee u de bron verbindt, is het telefoonboek dat u op apparaten hebt ingesteld.

Opmerking: Eindpunten en Jabber Video voor TelePresence (Movi) zien wat er in het telefoonboek wordt ingevuld, niet de bron van het telefoonboek. Wees alert op verschillen tussen de twee.

Telefoonboek ingesteld op systeem

Zorg ervoor dat de telefoonboeken op het systeem zijn ingesteld. Ga naar Telefoonboeken > Telefoonboeken beheren > Selecteer het telefoonboek en selecteer Instellen op systemen.

Rechts onder Geselecteerde systemen wordt een lijst van de systemen weergegeven.

Jabber Video voor TelePresence (Movi) en Telefoonboeken

Opmerking: de client moet zijn geverifieerd om telefoonboeken te ontvangen. De VCS/Expressway-zone waarin deze zich registreert, moet Inloggegevens controleren of als geverifieerd behandelen.

De gebruikers ontvangen het telefoonboek via de VCS / Expressway-serie en niet van TMS. 

toegangscontrole

De accountgroepen moeten toegangscontrole krijgen om het telefoonboek te kunnen doorzoeken.

Zelfs als het bovenste niveau is ingeschakeld, vouwt u het uit en controleert u of de subniveaus zijn gecontroleerd. Als alleen nieuwe gebruikers geen telefoonboeken ontvangen, is het mogelijk dat ze deel uitmaken van een nieuwe groep die niet is ingeschakeld op het tabblad Toegangscontrole.

Provisioning-configuratie

1. Controleer in TMS Systems > Provisioning > Users of het Video Address Pattern is geconfigureerd.
   
   

   

   
   
   
2. Controleer de configuratiesjabloon die is toegewezen aan de gebruiker Jabber Video for TelePresence (Movi) voor de URI-configuratie van de telefoonboekserver.
   
   

   

Items dupliceren

Wees voorzichtig als u meerdere telefoonboeken verbindt met één telefoonboek, omdat dit kan leiden tot dubbele vermeldingen op eindpunten of met de Jabber Video for TelePresence (Movi) -client als de aangesloten bronnen dezelfde telefoonboekvermeldingen bevatten.

Routering van telefoonboeken

Wees u bewust van deze instelling voor het geval dat sommige eindpunten niet een aantal van de telefoonboek vermeldingen die worden gezien in andere eindpunten te krijgen.

In Systeembeheer > Configuratie > Algemene instellingen is er een instelling met de naam Route Telefoonboekvermeldingen. Ja is de standaardinstelling, wat betekent dat eindpunten alleen adressen weergeven die ze kunnen kiezen. Op een H.323-eindpunt worden bijvoorbeeld geen ISDN-nummers en SIP-adressen weergegeven. Dit betekent niet dat de eindpunten alle adressen en nummers in het telefoonboek weergeven, ongeacht hun kiesmogelijkheden.

401 Niet geautoriseerd - Problemen met IIS oplossen

Een van de meest voorkomende problemen met telefoonboeken wordt veroorzaakt door een verkeerde configuratie in IIS. Anonieme verificatie moet zijn ingeschakeld voor de openbare map in IIS, zodat de eindpunten telefoonboeken kunnen ophalen. Als dit niet is ingeschakeld, worden de eindpunten uitgedaagd voor verificatie die ze niet kunnen bieden.

Om te bepalen of het eindpunt wordt uitgedaagd voor authenticatie, SSH in het eindpunt en query voor het telefoonboek met xcommand Telefoonboek Zoeken Type: Corporate. Als het eindpunt wordt uitgedaagd voor verificatie, ziet u '<Authentication fail>' (HTTP-code=401) zoals te zien is in deze afbeelding.

IIS-instellingen controleren

1. Open een RDP-sessie (Remote Desktop Protocol) met de TMS-server.
   
   
2. Open de IIS Manager.
   
   
3. Standaardwebsite uitbreiden.
   
   
4. TMS uitbreiden.
   
   
5. Selecteer openbaar.
   
   
6. selecteren
   
   

   

   
   
   

   

   
   
   
7. Controleer of Anonieme verificatie is ingeschakeld en schakel deze optie in als deze nog niet is ingeschakeld.

Een netwerkopname gebruiken

Telefoonboekgegevens analyseren in Wireshark

Het zoeken naar telefoonboeken begint met een zoekverzoek aan de telefoonboekservice op TMS waarop TMS reageert en neemt het zoekresultaat op in het antwoord als alles werkt.

U kunt de trace uitvoeren op de TMS-server of op het eindpunt als het eindpunt tcpdump ondersteunt. Laat de trace uitvoeren en toegang tot het telefoonboek via de webinterface of vanuit de gebruikersinterface. U ziet een zoekverzoek binnenkomen op de TMS-server.

Na deze TCP-stream ziet u twee primaire componenten van de XML:

Ten eerste zal het eindpunt zichzelf identificeren, bijvoorbeeld:

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

Vervolgens ziet u de details van het verzoek:

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

<Opmerking: de detailwaarden veranderen afhankelijk van het verzoek. Het bovenstaande verzoek werd gedaan met behulp van de ssh opdracht 'xcommand Phonebook Search PhonebookType: Corporate' van het eindpunt.>

Het antwoord van de TMS-server moet 200 OK zijn. Anders kunt u problemen oplossen op basis van de verschillende berichten die u ontvangt.

De 200 OK-respons bevat de relevante items uit de telefoonboeken die zijn toegewezen aan het eindpunt in TMS. In het bovenstaande verzoek had het eindpunt een enkel telefoonboek toegewezen in TMS en het antwoord ziet er als volgt uit:

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

Telefoonboek aanvragen/beantwoorden Inloggen in TMS

TMS 15.8 introduceerde de mogelijkheid om alle telefoonboekverzoeken en hun antwoorden te registreren. Standaard is deze logboekregistratie uitgeschakeld, maar kan deze op twee manieren worden ingeschakeld.

1. Door het bestand web.config te wijzigen, dat zich standaard op "C:\Program Files (x86)\TANDBERG\TMS\wwwTMS\Public\web.config" bevindt, en door dit gedeelte te wijzigen:

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

Wijzig de niveauwaarde van 'OFF' in 'DEBUG'

2. Dit kan ook gemakkelijker worden gedaan met behulp van het TMS Log Collection Utility door het volgende te controleren:

Zodra een telefoonboekverzoek de TMS-toepassing raakt, wordt het logboek geschreven. De standaardlocatie voor dit bestand is C:\Program Files (x86)\TANDBERG\TMS\data\Logs\TMSDebug\log-phonebook-request-response.txt

Een voorbeeld van deze output:

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>

Merk op dat dit erg lijkt op de POST en 200 OK gezien in een pakketopname. Dit zal echter hetzelfde zijn, of het nu gaat om HTTP of HTTPS. Terwijl de opname onleesbaar zal zijn als HTTPS wordt gebruikt.