Comandos Personalizados para Modelos de Configuração de Ponto de Extremidade no TMS

Introduction

Este documento descreve como configurar modelos de comando personalizados ou modelos de configuração personalizados a partir do Cisco TelePresence Management Suite (TMS).

Prerequisites

Requirements

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

• Cisco TelePresence Management Suite
• Software Cisco TelePresence TC

Você deve ter estes acessos e privilégios:

• Acesso via Web ao TMS com privilégios suficientes para acessar Systems > Configuration Templates > Configuration Templates
• Acesso via Web a um endpoint que esteja executando o software Cisco Telepresence TC com privilégios suficientes para acessar Configuration > API > /command.xml ou /configuration.xml
• Shell Seguro (SSH) ou acesso Telnet ao ponto final com privilégios de nível de administrador

Componentes Utilizados

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

• Cisco TelePresence Management Suite versão 14.2.2
• Cisco TelePresence Codec C40 (C40) com software Cisco TelePresence TC versão TC6.2.1

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:

• Cisco TelePresence Management Suite versões 13.x - 14.x
• Software Cisco TelePresence TC versões TC6.0 - TC6.2.1

Configurar

Criar Strings de Comando Simples

Caution: Os modelos personalizados enviam as APIs configuradas nos modelos, mas não aplicam essas alterações à configuração conhecida do ponto final no TMS. Enquanto uma "atualização forçada" atualiza a maioria das configurações, uma alteração de senha feita através da API faz com que o TMS perca a conectividade com o ponto de extremidade até que a senha seja atualizada nas configurações de conexão do ponto de extremidade no TMS.

Modelos de comando personalizados são comumente usados para definir senhas de administrador, porque não há nenhum modelo predefinido no TMS para endpoints que executam o software TC. Este exemplo usa o arquivo /command.xml.

A string xCommand para essa configuração é:

Xcommand SystemUnit AdminPassword Set Password: NewPassword

Navegue até Configuration > API>/command.xml e revise o arquivo /command.xml localizado na interface da Web do endpoint:

Observe que o formato é o mesmo que a string xCommand, com exceção das tags de fechamento necessárias para XML. Isso resulta na sequência de caracteres XML que altera a SenhaAdmin:

<Command>
 <SystemUnit>
  <AdminPassword>
   <Set>
    <Password>NewPassword</Password>
   </Set>
  </AdminPassword>
 </SystemUnit>
</Command>

NewPassword é a sua escolha de senha.

Criar Cadeias de Comando de Várias Partes

Você pode usar um modelo de comando personalizado para uma cadeia de caracteres de comando de várias partes, como o uso comum de expressões de feedback, a fim de determinar quais eventos o ponto final relata ao TMS.

Este é um exemplo da sequência de comando 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

Revise o arquivo /command.xml:

Compare o comando com o arquivo /command.xml. Isso resulta na string XML equivalente:

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

Criar Cadeias de Comando Multitarefa

Ao contrário dos comandos SSH, você pode usar modelos de comando personalizados para criar comandos multitarefa. Este exemplo combina os dois exemplos anteriores e define HttpFeedback e AdminPassword com uma única sequência de comando personalizada:

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

Revise o arquivo /command.xml e veja como ele é mapeado para a sequência de comando multitarefa personalizada:

Criar Cadeias de Configuração Simples

Este exemplo define o protocolo DefaultCall como H323. Este é o comando SSH/Telnet:

Xconfiguration Conference DefaultCall protocol: H323

Revise o arquivo /configuration.xml:

Compare o comando com o arquivo /command.xml. Isso resulta na string XML equivalente:

<Configuration>
 <Conference>
  <DefaultCall>
   <Protocol>H323</Protocol>
  </DefaultCall>
 </Conference>
</Configuration>

Criar Cadeias de Configuração de Várias Partes

Diferentemente das strings de comando Xque permitem executar um comando para definir vários componentes, as strings de xConfiguration suportam apenas uma única alteração de configuração por string. Por conseguinte, esta seção não se aplica. 

Criar Cadeias de Configuração Multitarefa

Assim como com as strings de comando personalizadas, você pode combinar várias strings de configuração em uma única string XML de configuração personalizada. Este exemplo usa estas strings xConfiguration como base:

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"

Revise estas seções do arquivo /configuration.xml:

e

Compare o comando com o arquivo /command.xml. Isso resulta na string XML equivalente:

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

Adicionar strings XML criadas ao modelo personalizado do TMS

Note: Os campos de comando e configuração personalizados estão limitados a um máximo de 1000 caracteres.

Depois de identificar a sequência de caracteres XML, adicione-a a um comando personalizado ou modelo de configuração. Este procedimento descreve como:

1. Na interface da Web do TMS, navegue para Systems > Configuration Templates > Configuration Templates e selecione New Configuration Template:
   
   
   
   
2. Clique na guia Select Advanced Settings e insira a palavra custom no campo de texto Filter em Cisco TelePresence Group Systems:
   
   
   
   
3. Marque a caixa ao lado da configuração apropriada (Custom Command e/ou Custom Configuration) e clique na seta para a direita (>) para movê-la.
   
   
4. Clique na guia Configurações de modelo:
   
   
   
   
5. Insira seu script XML no campo de texto Custom Command e/ou Custom Configuration apropriado.
   
   
6. Selecione Save.

Verificar

No momento, não há procedimento de verificação disponível para esta configuração.

Troubleshoot

Atualmente, não existem informações disponíveis específicas sobre Troubleshooting para esta configuração.

Histórico de revisões