TMS 전화 번호부 트러블슈팅 가이드

다운로드 옵션

PDF (1.0 MB)
다양한 디바이스에서 Adobe Reader로 보기
ePub (849.5 KB)
iPhone, iPad, Android, Sony Reader 또는 Windows Phone의 다양한 앱에서 보기
Mobi (Kindle) (727.7 KB)
Kindle 디바이스에서 보기 또는 다양한 디바이스의 Kindle 앱에서 보기

업데이트:2021년 5월 18일

문서 ID:215223

편견 없는 언어

본 제품에 대한 문서 세트는 편견 없는 언어를 사용하기 위해 노력합니다. 본 설명서 세트의 목적상, 편견 없는 언어는 나이, 장애, 성별, 인종 정체성, 민족 정체성, 성적 지향성, 사회 경제적 지위 및 교차성에 기초한 차별을 의미하지 않는 언어로 정의됩니다. 제품 소프트웨어의 사용자 인터페이스에서 하드코딩된 언어, RFP 설명서에 기초한 언어 또는 참조된 서드파티 제품에서 사용하는 언어로 인해 설명서에 예외가 있을 수 있습니다. 시스코에서 어떤 방식으로 포용적인 언어를 사용하고 있는지 자세히 알아보세요.

이 번역에 관하여

Cisco는 전 세계 사용자에게 다양한 언어로 지원 콘텐츠를 제공하기 위해 기계 번역 기술과 수작업 번역을 병행하여 이 문서를 번역했습니다. 아무리 품질이 높은 기계 번역이라도 전문 번역가의 번역 결과물만큼 정확하지는 않습니다. Cisco Systems, Inc.는 이 같은 번역에 대해 어떠한 책임도 지지 않으며 항상 원본 영문 문서(링크 제공됨)를 참조할 것을 권장합니다.

소개

이 문서에서는 Cisco TMS(TelePresence Management Suite) 전화번호부에서 다양한 문제를 해결하는 방법에 대해 설명합니다.

사전 요구 사항

요구 사항

다음 주제에 대한 지식을 보유하고 있으면 유용합니다.

Cisco TMS
Cisco TelePresence 엔드포인트
Microsoft IIS(인터넷 정보 서비스)

사용되는 구성 요소

이 문서의 정보는 다음 소프트웨어 및 하드웨어 버전을 기반으로 합니다.

Cisco TMS 버전 14.x 및 15.x
TC 및 CE 소프트웨어 엔드포인트

이 문서의 정보는 특정 랩 환경의 디바이스를 토대로 작성되었습니다. 이 문서에 사용된 모든 디바이스는 초기화된(기본) 컨피그레이션으로 시작되었습니다. 현재 네트워크가 작동 중인 경우, 모든 명령어의 잠재적인 영향을 미리 숙지하시기 바랍니다.

배경 정보

TMS 전화 번호부는 Microsoft Windows 서버의 IIS에서 활성화된 프로토콜을 기반으로 HTTP 또는 HTTPS를 사용하여 액세스할 수 있습니다. 전화번호부(회사 디렉터리)를 가져오려면 시스템을 TMS에 추가해야 합니다. 최신 시스템의 경우 전화 번호부 검색은 라이브 통신이며 데이터가 시스템에 저장되지 않습니다. 전화 번호부가 작동하려면 TMS가 작동해야 하며 연결을 수락해야 합니다.

TMS 전화 번호부 디렉터리

글로벌 디렉토리

전역 디렉터리는 코덱에 저장된 파일이며, 여기서 항목은 리모콘을 통해 변경할 수 없습니다. 이 파일은 HTTP/HTTP를 통해 Cisco TMS에 있는 하나 이상의 전화 번호부를 구독하는 모든 엔드포인트로 전송됩니다. 여러 개의 전화번호부가 하나의 전화번호부에 합쳐진다. 400개가 넘는 항목이 포함된 경우 엔드포인트에는 처음 400개만 표시됩니다.

파일은 관리 도구 > 구성 > 일반 설정 > 전화 번호부 업데이트 빈도 필드에 설정된 간격으로 엔드포인트로 전송됩니다.

이는 globdir.prm을 지원하는 엔드포인트에서만 작동합니다(TC 또는 CE 소프트웨어 엔드포인트에서는 지원되지 않음).

회사 디렉터리

회사 디렉터리는 Cisco TMS 서버의 XML 서비스로서 엔드포인트에서 전화 번호부 단추를 누를 때마다 엔드포인트가 서버에서 직접 전화 번호부를 검색할 수 있도록 합니다. 모든 항목에서 전화 번호부와 여러 전화 번호의 계층 구조를 허용합니다. 기업 디렉토리도 검색할 수 있습니다.

시스템 전화 번호부 유형

시스템 전화번호부 유형을 선택하려면 Administrative Tools(관리 툴) > Configuration(컨피그레이션) > General Settings(일반 설정)로 이동합니다. 다음과 같은 작업을 수행할 수 있습니다.

중앙 집중식 TMS 전화 번호부만 사용(회사 전화 번호부)
중앙 집중식 전화기와 다운로드한 전화기를 모두 사용(둘 다)
시스템에 다운로드한 글로벌 전화 번호부 사용(글로벌 전화 번호부)

다운로드한 전화번호부는 레거시 TANDBERG 엔드포인트에서만 지원하므로 회사 전화번호부 또는 둘 다를 선택하는 것이 좋습니다.

기본 설정은 both입니다. 그러면 회사 디렉터리 라이브 검색에 실패할 경우 전역 디렉터리를 사용할 수 있습니다.

TMS 전화번호부에 사용되는 포트

엔드포인트는 포트 80(HTTP) 또는 포트 443(HTTP)으로 TMS 전화번호부 서비스에 액세스합니다. 이러한 포트가 Microsoft Windows Server 방화벽과 경로에 있을 수 있는 네트워크 방화벽에서 허용되는지 확인합니다.

엔드포인트 Phone Book Server 컨피그레이션

TMS에 추가한 시스템은 피드백 주소, 외부 관리 주소, 전화번호부 주소를 포함하는 관리 설정 집합을 받아야 합니다. 시스템의 주소는 시스템의 웹 인터페이스, xAPI(xConfiguration //phonebook) 또는 시스템의 사용자 인터페이스에서 확인할 수 있습니다.

엔드포인트로 푸시되는 주소는 내부 LAN의 시스템에 대한 고급 네트워크 설정 아래에서 TMS의 관리 도구 > 구성 > 네트워크 설정에 구성된 내용에 따라 결정됩니다. TMS Server IPv4 Address 필드가 구성된 경우 TMS 서버 정규화된 호스트 이름 필드가 비어 있으면 IP 주소가 사용되지만, 두 필드가 모두 채워지면 FQDN(Fully Qualified Domain Name)이 선호되어 사용됩니다.

전화번호부 URL을 확인할 때 <TMSaddress>가 FQDN인지 IP 주소인지 확인하는 것이 중요합니다. FQDN인 경우 엔드포인트에 유효한 DNS(Domain Name Server)도 구성되어 있어야 합니다. DNS가 엔드포인트에 구성되어 있지 않으면 전화 번호부를 검색하기 위해 FQDN을 확인할 수 없습니다. DNS 확인 단계는 Check Endpoint DNS Configuration(엔드포인트 DNS 컨피그레이션 확인) 섹션을 참조하십시오.

참고: IP 주소가 정확한지 확인합니다. 고객이 최근에 한 서버에서 다른 서버로 TMS를 이동했거나, 다른 랩 TMS를 보유하고 있거나, 비인가 TMS가 있을 수 있습니다.

웹 인터페이스로 주소 확인

엔드포인트의 웹 인터페이스에서 Configuration(컨피그레이션) > System Configuration(시스템 컨피그레이션) > Phonebook Server(전화번호부 서버)로 이동합니다. 전화 번호부 설정이 올바른지 확인합니다. 가장 중요한 것은 URL이 다음 형식과 일치해야 한다는 것입니다. http://<TMSaddress>/tms/public/external/phonebook/phonebookservice.asmx.

SSH(Secure Shell)로 주소 확인

다음은 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"

엔드포인트에서 전화 번호부 요청 테스트

연결을 확인하는 가장 빠른 방법은 관리자 자격 증명을 사용하여 엔드포인트로 SSH를 연결하고 다음 명령을 실행하는 것입니다.

xcommand 전화번호부 검색 전화번호부 유형: 기업

작업 시나리오에서는 엔드포인트에 할당된 전화번호부의 수에 따라 두 개의 결과 중 하나를 반환합니다.

전화번호부가 하나인 경우:

여러 전화번호부가 적용된 경우 전화번호부 폴더 목록이 표시됩니다.

또한 이 명령은 모든 연결 문제를 식별합니다. 예를 들면 다음과 같습니다.

전화번호부가 TMS의 엔드포인트에 할당되지 않은 경우:

전화 번호부 서비스에 연결할 수 없는 경우:

TMS를 호스팅하는 서버의 IIS에 인증 구성 문제가 있는 경우:

'http 또는 https://<TMSFQDN>/tms/public/external/phonebook/phonebookservice.asmx'를 가리키는 경우 가능한 DNS 확인 문제가 있는 경우 표시됩니다.

엔드포인트 DNS 컨피그레이션 확인

SSH로 DNS 컨피그레이션 확인

웹 인터페이스로 DNS 컨피그레이션 확인

엔드포인트의 웹 인터페이스에서 Configuration(컨피그레이션) > System Configuration(시스템 컨피그레이션) > Network(네트워크)로 이동합니다.

전화 번호부 서비스에 연결할 수 있는지 확인

사용자 PC에서 다음 단계를 완료합니다.

엔드포인트 내에서 Configuration(컨피그레이션) > System Configuration(시스템 컨피그레이션) > Phonebook Server(전화번호부 서버)로 이동하고 엔드포인트에 구성된 TMS 전화번호부 URL을 복사합니다.
브라우저 창에 URL을 붙여넣습니다.

그림에 나와 있는 페이지가 보이면 전화번호부 서비스에 연결할 수 있음을 의미합니다. 이 페이지가 표시되지 않으면 테스트하는 컴퓨터에 주소에 액세스할 수 있는 네트워크 제한이 없는지 확인합니다.

Unauthorized가 표시되면 IIS에 문제가 있는 것입니다. 이 문서에서 자세히 설명합니다.

엔드포인트의 루트에서 다음을 입력합니다. curl http://<TMS IP Address>/tms/public/external/phonebook/phonebookservice.asmx

TMS 전화 번호부 및 전화 번호부 소스

모든 TMS 전화번호부는 전화번호부 소스로 제작되었습니다.

전화번호부 > 전화번호부 소스 관리로 이동하여 전화번호부 소스를 관리합니다.

현재 TMS 전화번호부 소스는 다음과 같이 구성됩니다.

Cisco TMS 엔드포인트
수동 목록
액티브 디렉토리
H.350 디렉토리 및 H.350 사용자 디렉토리
파일 기반 전화 번호부
게이트키퍼
기타 TMS 전화 번호부
Cisco TMS 프로비저닝 디렉토리
시스템 로컬 전화 번호부
Cisco TMS 관리 Cisco Unified CM

전화번호부 소스가 만들어지면 전화번호부에 연결합니다. 소스에 연결한 전화 번호부가 장치에 설정한 전화 번호부가 됩니다. 여러 전화 번호부를 여러 전화 번호부 소스에 연결할 수 있습니다

시스템에 연락처 및 전화 번호부가 설정되어 있는지 확인

연락처 확인

전화 번호부 소스를 확인하고 연락처 및 연락처 방법이 있는지 확인합니다.

전화번호부가 전화번호부 소스에 연결되었는지 확인하고 동일한 연락처 및 연락 방법이 있는지 확인합니다. 소스에 연결한 전화 번호부가 장치에 설정한 전화 번호부가 됩니다.

참고: 엔드포인트 및 Jabber Video for TelePresence(Movi)는 전화번호부 소스가 아니라 전화번호부에 무엇이 입력되었는지 확인합니다. 둘 사이의 차이점에 유의하십시오.

시스템에 전화 번호부 설정

전화 번호부가 시스템에 설치되어 있는지 확인합니다. Phone Books(전화 번호부) > Manage Phone Books(전화 번호부 관리) > Phone Book(전화 번호부)을 선택하고 Set on Systems(시스템에 설정)를 선택합니다.

시스템 목록이 Selected Systems(선택한 시스템) 아래 오른쪽에 나타납니다.

TelePresence(Movi) 및 전화 번호부를 위한 Jabber 비디오

참고: 전화 번호부를 받으려면 클라이언트가 인증되어야 합니다. VCS/Expressway 영역이 등록되는 VCS/Expressway 영역은 Check Credentials(자격 증명 확인) 또는 Treat as Authenticated(인증된 것으로 처리)여야 합니다.

사용자는 TMS가 아닌 VCS/Expressway 시리즈를 통해 전화번호부를 수신합니다.

액세스 제어

계정 그룹에 전화번호부를 검색하려면 해당 전화번호부에 대한 액세스 권한이 부여되어야 합니다.

Top-Level(최상위)을 선택해도 이를 확장하고 하위 레벨이 선택되었는지 확인합니다. 새 사용자만 전화번호부를 받지 않는 경우 해당 사용자는 액세스 제어 탭에서 확인하지 않는 새 그룹에 속할 수 있습니다.

프로비저닝 컨피그레이션

TMS Systems > Provisioning > Users에서 Video Address Pattern이 구성되었는지 확인합니다.
전화번호부 서버 URI 컨피그레이션의 Jabber Video for TelePresence(Movi) 사용자에게 할당된 컨피그레이션 템플릿을 확인합니다.

중복 항목

여러 전화 번호부를 단일 전화 번호부에 연결하는 경우, 연결된 소스에 동일한 전화 번호부 항목이 포함되어 있으면 엔드포인트에 또는 Jabber Video for TelePresence(Movi) 클라이언트에 중복 항목이 표시될 수 있으므로 주의해야 합니다.

전화 번호부 라우팅

일부 엔드포인트에서 다른 엔드포인트에 표시되는 일부 전화 번호부 항목을 가져오지 못하는 경우 이 설정에 유의하십시오.

Administrative Tools > Configuration > General Settings에 Route Phone Book Entries라는 설정이 있습니다. 예는 기본 설정이며, 이는 엔드포인트가 다이얼할 수 있는 주소만 표시함을 의미합니다. 예를 들어 H.323 전용 엔드포인트에서는 ISDN 번호 및 SIP(Session Initiation Protocol) 주소가 표시되지 않습니다. 아니요는 엔드포인트가 다이얼링 기능과 상관없이 전화번호부에 모든 주소와 번호를 표시함을 의미합니다.

401 무단 - IIS 문제 해결

가장 일반적인 전화 번호부 문제 중 하나는 IIS의 잘못된 구성으로 인해 발생합니다. 엔드포인트가 전화 번호부를 검색할 수 있으려면 IIS의 공용 폴더에 대해 익명 인증을 사용하도록 설정해야 합니다. 이 기능을 활성화하지 않으면 엔드포인트에서 제공할 수 없는 인증에 대한 문제가 발생합니다.

엔드포인트에서 인증 문제가 있는지 확인하려면 엔드포인트로 SSH를 연결하고 xcommand 전화번호부 검색 전화번호부 유형으로 전화번호부를 쿼리합니다. 기업. 엔드포인트에서 인증이 시도되면 이 이미지에 표시된 것처럼 '<Authentication fail>'(HTTP 코드=401)이 표시됩니다.

IIS 설정 확인

TMS 서버에서 RDP(Remote Desktop Protocol) 세션을 엽니다.
IIS 관리자를 엽니다.
Default Website(기본 웹 사이트)를 확장합니다.
TMS를 펼칩니다.
Public을 선택합니다.
선택
익명 인증이 활성화되었는지 확인하고 활성화되지 않은 경우 활성화합니다.

네트워크 캡처 사용

Wireshark에서 전화번호부 데이터 분석

전화번호부 검색은 TMS가 응답한 TMS의 전화번호부 서비스에 대한 검색 요청으로 시작해 모든 것이 작동하면 그 응답에 검색 결과를 포함시킨다.

엔드포인트가 tcpdump를 지원하는 경우 TMS 서버 또는 엔드포인트에서 추적을 실행할 수 있습니다. 추적이 실행되어 웹 인터페이스 또는 사용자 인터페이스를 통해 전화번호부에 액세스하도록 허용합니다. TMS 서버에 검색 요청이 들어오는 것을 볼 수 있습니다.

이 TCP 스트림 다음에는 XML의 두 가지 기본 구성 요소가 표시됩니다.

먼저 엔드포인트는 다음과 같이 스스로를 식별합니다.

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

다음은 요청의 세부 정보입니다.

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

<참고: 세부 정보 값은 요청에 따라 변경됩니다. 위의 요청은 ssh 명령 'xcommand Phonebook Search PhonebookType: 엔드포인트의 '회사'입니다.>

TMS 서버의 응답은 200 OK여야 합니다. 그렇지 않으면 수신한 다른 메시지를 기반으로 문제를 해결할 수 있습니다.

200 OK 응답에는 TMS의 엔드포인트에 할당된 전화 번호부의 관련 항목이 포함됩니다. 위 요청에서 엔드포인트에 TMS에 할당된 단일 전화번호부가 있으며 응답은 다음과 같습니다.

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

TMS에서 전화 번호부 요청/응답 로깅

TMS 15.8은 모든 전화 번호부 요청과 응답을 기록하는 기능을 도입했습니다. 기본적으로 이 로깅은 비활성화되어 있지만 두 가지 방법으로 활성화할 수 있습니다.

1. 기본적으로 "C:\Program Files (x86)\TANDBERG\TMS\wwwTMS\Public\web.config"에 있는 web.config 파일을 수정하고 이 섹션을 수정합니다.

수준 값을 'OFF'에서 'DEBUG'로 변경합니다.

2. 다음 사항을 확인하여 TMS 로그 수집 유틸리티를 사용하여 더 쉽게 수행할 수 있습니다.

전화번호부 요청이 TMS 애플리케이션에 도달하면 로그가 작성됩니다. 이 파일의 기본 위치는 "C:\Program Files (x86)\TANDBERG\TMS\data\Logs\TMSDebug\log-phonebook-request-response.txt"입니다.

이 출력의 예:

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>

이는 패킷 캡처에서 볼 수 있는 POST 및 200 OK와 매우 유사합니다. 그러나 HTTP를 사용하든 HTTPS를 사용하든 이는 동일합니다. 반면 HTTPS를 사용하는 경우 캡처를 읽을 수 없습니다.

개정 이력

개정	게시 날짜	의견
1.0	06-Jan-2015	최초 릴리스

Cisco 엔지니어가 작성

애덤 왐슬리
Cisco TAC 엔지니어
마그누스 옴
Cisco TAC 엔지니어
제이슨 수페
Cisco TAC 엔지니어