목차

소개

사전 요구 사항

요구 사항

사용되는 구성 요소

관련 제품

구성

간단한 명령 문자열 만들기

여러 부분으로 구성된 명령 문자열 만들기

다중 작업 명령 문자열 만들기

간단한 구성 문자열 만들기

여러 부분으로 구성된 구성 문자열 만들기

다중 작업 구성 문자열 만들기

생성된 XML 문자열을 TMS 사용자 지정 템플릿에 추가

다음을 확인합니다.

문제 해결

소개

이 문서에서는 Cisco TMS(TelePresence Management Suite)에서 사용자 지정 명령 템플릿 또는 사용자 지정 구성 템플릿을 구성하는 방법에 대해 설명합니다.

사전 요구 사항

요구 사항

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

- Cisco TelePresence Management Suite

- Cisco TelePresence TC 소프트웨어

다음 액세스 및 권한이 있어야 합니다.

- Systems(시스템) > Configuration Templates(컨피그레이션 템플릿) > Configuration Templates(컨피그레이션 템플릿)에 액세스할 수 있는 충분한 권한을 가진 TMS에 대한 웹 액세스

- Configuration(컨피그레이션) > API(API) > /command.xml 또는 /configuration.xml에 액세스하기 위해 충분한 권한을 가지고 Cisco Telepresence TC 소프트웨어를 실행 중인 엔드포인트에 대한 웹 액세스 기능

- 관리자 레벨 권한으로 엔드포인트에 대한 SSH(Secure Shell) 또는 텔넷 액세스

사용되는 구성 요소

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

- Cisco TelePresence Management Suite 버전 14.2.2

- Cisco TelePresence Codec C40(C40) with Cisco TelePresence TC Software Version TC6.2.1

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

관련 제품

이 문서는 다음 하드웨어 및 소프트웨어 버전에서도 사용할 수 있습니다.

- Cisco TelePresence Management Suite 버전 13.x - 14.x

- Cisco TelePresence TC Software 버전 TC6.0 - TC6.2.1

구성

간단한 명령 문자열 만들기

주의: 사용자 지정 템플릿은 템플릿 내에 구성된 API를 전송하지만 TMS의 엔드포인트의 알려진 컨피그레이션에는 이러한 변경 사항을 적용하지 않습니다. '강제 새로 고침'이 대부분의 설정을 업데이트하는 동안 API를 통해 비밀번호를 변경하면 TMS의 엔드포인트 연결 설정 내에서 비밀번호가 업데이트될 때까지 TMS가 엔드포인트와의 연결을 잃게 됩니다.

사용자 지정 명령 템플릿은 일반적으로 관리자 비밀번호를 설정하기 위해 사용됩니다. TC 소프트웨어를 실행하는 엔드포인트용 TMS에는 사전 정의된 템플릿이 없기 때문입니다. 이 예에서는 /command.xml 파일을 사용합니다.

이 설정의 xCommand 문자열은 다음과 같습니다.

Xcommand SystemUnit AdminPassword Set Password: NewPassword

Configuration(컨피그레이션) > API>/command.xml으로 이동하여 엔드포인트 웹 인터페이스에 있는 /command.xml 파일을 검토합니다.

형식은 XML에 필요한 닫는 태그를 제외하고 xCommand 문자열과 동일합니다. 이렇게 하면 AdminPassword를 변경하는 XML 문자열이 생성됩니다.

<Command>

<SystemUnit>

<AdminPassword>

<Set>

<Password>NewPassword</Password>

</Set>

</AdminPassword>

</SystemUnit>

</Command>

NewPassword는 사용자가 선택한 비밀번호입니다.

여러 부분으로 구성된 명령 문자열 만들기

엔드포인트가 TMS에 보고하는 이벤트를 확인하기 위해 피드백 표현식의 일반적인 사용과 같이 다중 부분 명령 문자열에 대해 사용자 지정 명령 템플릿을 사용할 수 있습니다.

다음은 Telnet/SSH 명령 문자열의 예입니다.

xcommand HttpFeedback Register FeedbackSlot: 1 ServerUrl:

http://172.30.10.7/tms/public/feedback/code.aspx

Expression: /History/CallLogs/Call Expression: /Status/Call[Status='Connected']

Expression: /Status/H323/Gatekeeper Expression: /Status/SIP/Registration

Expression: /Status/Network/Ethernet/Speed Expression: /Event/CallSuccessful

Expression: /Event/Message/Prompt/Response Expression: /Configuration

Expression: /Event/CallDisconnect Expression: /Status/Call

/command.xml 파일을 검토합니다.

명령 문자열을 /command.xml 파일과 비교합니다. 그러면 다음과 같은 XML 문자열이 생성됩니다.

<Command>

<HttpFeedback>

<Register>

<FeedbackSlot>1</FeedbackSlot>

<ServerUrl>http://172.30.10.7/tms/public/feedback/code.aspx</ServerUrl>

<Expression item="1">/History/CallLogs/Call</Expression>

<Expression item="2">/Status/Call[Status='Connected']</Expression>

<Expression item="3">/Status/H323/Gatekeeper</Expression>

<Expression item="4">/Status/SIP/Registration</Expression>

<Expression item="5">/Status/Network/Ethernet/Speed</Expression>

<Expression item="6">/Event/CallSuccessful</Expression>

<Expression item="7">/Event/Message/Prompt/Response</Expression>

<Expression item="8">/Configuration</Expression>

<Expression item="9">/Event/CallDisconnect</Expression>

<Expression item="10">/Status/Call</Expression>

</Register>

</HttpFeedback>

</Command>

다중 작업 명령 문자열 만들기

SSH 명령과 달리 사용자 지정 명령 템플릿을 사용하여 다중 작업 명령을 생성할 수 있습니다. 이 예에서는 앞의 두 예를 결합하고 HttpFeedback 및 AdminPassword를 단일 사용자 지정 명령 문자열로 설정합니다.

<Command>

<HttpFeedback>

<Register>

<FeedbackSlot>1</FeedbackSlot>

<ServerUrl>http://172.30.10.7/tms/public/feedback/code.aspx</ServerUrl>

<Expression item="1">/History/CallLogs/Call</Expression>

<Expression item="2">/Status/Call[Status='Connected']</Expression>

<Expression item="3">/Status/H323/Gatekeeper</Expression>

<Expression item="4">/Status/SIP/Registration</Expression>

<Expression item="5">/Status/Network/Ethernet/Speed</Expression>

<Expression item="6">/Event/CallSuccessful</Expression>

<Expression item="7">/Event/Message/Prompt/Response</Expression>

<Expression item="8">/Configuration</Expression>

<Expression item="9">/Event/CallDisconnect</Expression>

<Expression item="10">/Status/Call</Expression>

</Register>

</HttpFeedback>

<SystemUnit>

<AdminPassword>

<Set>

<Password>NewPassword</Password>

</Set>

</AdminPassword>

</SystemUnit>

</Command>

/command.xml 파일을 검토하여 사용자 지정 다중 작업 명령 문자열에 매핑되는 방법을 확인합니다.

간단한 구성 문자열 만들기

다음 예에서는 DefaultCall 프로토콜을 H323으로 설정합니다. 이는 SSH/Telnet 명령입니다.

Xconfiguration Conference DefaultCall protocol: H323

/configuration.xml 파일을 검토합니다.

명령 문자열을 /command.xml 파일과 비교합니다. 그러면 다음과 같은 XML 문자열이 생성됩니다.

<Configuration>

<Conference>

<DefaultCall>

<Protocol>H323</Protocol>

</DefaultCall>

</Conference>

</Configuration>

여러 부분으로 구성된 구성 문자열 만들기

여러 구성 요소를 설정하기 위해 명령을 실행할 수 있는 Xcommand 문자열과 달리 xConfiguration 문자열은 문자열당 단일 구성 변경만 지원합니다. 따라서 이 절은 적용되지 않습니다.

다중 작업 구성 문자열 만들기

사용자 지정 명령 문자열과 마찬가지로 단일 사용자 지정 구성 XML 문자열에서 여러 구성 문자열을 결합할 수 있습니다. 다음 예에서는 이러한 xConfiguration 문자열을 기반으로 사용합니다.

xConfiguration H323 Profile 1 H323Alias ID: c40-1.lab.h323@tac.lab

xConfiguration H323 Profile 1 H323Alias E164: 180004

xConfiguration H323 Profile 1 CallSetup Mode: Gatekeeper

xConfiguration H323 Profile 1 Gatekeeper Address: taccluster.tac.lab

xConfiguration H323 Profile 1 Gatekeeper Discovery: Manual

xConfiguration SIP Profile 1 URI: c40-1.lab.sip@tac.lab

xConfiguration SIP Profile 1 DefaultTransport: Auto

xConfiguration SIP Profile 1 Proxy 1 Discovery: Manual

xConfiguration SIP Profile 1 Proxy 1 Address: "taccluster.tac.lab"

/configuration.xml 파일의 다음 섹션을 검토합니다.

및

명령 문자열을 /command.xml 파일과 비교합니다. 그러면 다음과 같은 XML 문자열이 생성됩니다.

<Configuration>

<H323>

<Profile>

<H323Alias>

<ID>c40-1.lab.h323@tac.lab</ID>

<E164>180004</E164>

</H323Alias>

<CallSetup>

<Mode>Gatekeeper</Mode>

</CallSetup>

<Gatekeeper>

<Address>taccluster.tac.lab</Address>

<Discovery>Manual</Discovery>

</Gatekeeper>

</Profile>

</H323>

<Sip>

<Profile>

<URI>c40-1.lab.sip@tac.lab</URI>

<DefaultTransport>Auto</DefaultTransport>

<Proxy item="1">

<Discovery>Manual</Discovery>

<Address>taccluster.tac.lab</Address>

</Proxy>

</Profile>

</Sip>

</Configuration>

생성된 XML 문자열을 TMS 사용자 지정 템플릿에 추가

참고: 맞춤형 명령 및 컨피그레이션 필드 모두 최대 1000자로 제한됩니다.

XML 문자열이 식별되면 해당 문자열을 사용자 지정 명령 또는 컨피그레이션 템플릿에 추가합니다. 이 절차에서는 다음 방법을 설명합니다.

1. TMS 웹 인터페이스에서 Systems > Configuration Templates > Configuration Templates로 이동하고 New Configuration Template을 선택합니다.

2. Select Advanced Settings(고급 설정 선택) 탭을 클릭하고 Cisco TelePresence Group Systems(Cisco TelePresence 그룹 시스템) 아래의 Filter(필터) 텍스트 필드에 맞춤이라는 단어를 입력합니다.

3. 적절한 설정(Custom Command 및/또는 Custom Configuration) 옆의 상자를 선택하고 오른쪽 화살표(>)를 클릭하여 이동합니다.

4. Template Settings(템플릿 설정) 탭을 클릭합니다.

5. 적절한 Custom Command 및/또는 Custom Configuration 텍스트 필드에 XML 스크립트를 입력합니다.

6. 저장을 선택합니다.

다음을 확인합니다.

현재 이 설정에 사용 가능한 확인 절차는 없습니다.

문제 해결

현재 이 설정에 사용할 수 있는 특정 문제 해결 정보가 없습니다.