Comandos personalizados para plantillas de configuración de terminales en TMS

Introducción

Este documento describe cómo configurar plantillas de comandos o plantillas de configuración personalizadas desde Cisco TelePresence Management Suite (TMS).

Prerequisites

Requirements

Cisco recomienda que tenga conocimiento sobre estos temas:

• Cisco TelePresence Management Suite
• Software Cisco TelePresence TC

Debe tener estos accesos y privilegios:

• Acceso Web a TMS con privilegios suficientes para acceder a Systems > Configuration Templates > Configuration Templates
• Acceso web a un terminal que ejecuta el software Cisco Telepresence TC con privilegios suficientes para acceder a Configuration > API > /command.xml o /configuration.xml
• Acceso Secure Shell (SSH) o Telnet al terminal con privilegios de nivel de administrador

Componentes Utilizados

La información que contiene este documento se basa en las siguientes versiones de software y hardware.

• Cisco TelePresence Management Suite versión 14.2.2
• Cisco TelePresence Codec C40 (C40) con software Cisco TelePresence TC versión 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.

Productos Relacionados

Este documento también puede utilizarse con estas versiones de software y hardware:

• Cisco TelePresence Management Suite, versiones 13.x - 14.x
• Software Cisco TelePresence TC Versiones TC 6.0 - TC6.2.1

Configurar

Crear cadenas de comandos simples

Precaución: Las plantillas personalizadas envían las API configuradas dentro de las plantillas pero no aplican esos cambios a la configuración conocida del terminal en TMS. Mientras que una 'actualización forzada' actualiza la mayoría de las configuraciones, un cambio de contraseña realizado a través de la API hace que TMS pierda la conectividad con el punto final hasta que la contraseña se actualice dentro de las configuraciones de conexión del punto final en TMS.

Las plantillas de comandos personalizadas se utilizan comúnmente para establecer contraseñas de administrador, porque no hay una plantilla predefinida en TMS para extremos que ejecutan el software TC. Este ejemplo utiliza el archivo /command.xml.

La cadena xCommand para esta configuración es:

Xcommand SystemUnit AdminPassword Set Password: NewPassword

Vaya a Configuration > API>/command.xml, y revise el archivo /command.xml ubicado en la interfaz web del terminal:

Observe que el formato es el mismo que la cadena xCommand, con la excepción de las etiquetas de cierre necesarias para XML. Esto genera la cadena XML que cambia la contraseña de administrador:

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

NewPassword es la contraseña que ha elegido.

Crear cadenas de comandos de varias partes

Puede utilizar una plantilla de comandos personalizada para una cadena de comandos de varias partes, como el uso común de expresiones de información para determinar qué eventos notifica el terminal a TMS.

Este es un ejemplo de la cadena de comandos 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 el archivo /command.xml:

Compare la cadena de comandos con el archivo /command.xml. Esto produce la cadena 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>

Crear cadenas de comandos de varias tareas

A diferencia de los comandos SSH, puede utilizar plantillas de comandos personalizadas para crear comandos multitarea. Este ejemplo combina los dos ejemplos anteriores y establece tanto HttpFeedback como AdminPassword con una única cadena de comandos 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 el archivo /command.xml y vea cómo se asigna a la cadena de comandos multitarea personalizada:

Crear cadenas de configuración sencillas

Este ejemplo establece el protocolo DefaultCall en H323. Este es el comando SSH/Telnet:

Xconfiguration Conference DefaultCall protocol: H323

Revise el archivo /configuration.xml:

Compare la cadena de comandos con el archivo /command.xml. Esto produce la cadena XML equivalente:

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

Crear cadenas de configuración de varias partes

A diferencia de las cadenas Xcommand, que permiten ejecutar un comando para establecer varios componentes, las cadenas xConfiguration sólo admiten un único cambio de configuración por cadena. Por lo tanto, esta sección no se aplica. 

Crear cadenas de configuración de varias tareas

Al igual que con las cadenas de comandos personalizadas, puede combinar varias cadenas de configuración en una única cadena XML de configuración personalizada. Este ejemplo utiliza estas cadenas de 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 secciones del archivo /configuration.xml:

y

Compare la cadena de comandos con el archivo /command.xml. Esto produce la cadena 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>

Agregar cadenas XML creadas a la plantilla personalizada de TMS

Nota: Los campos de configuración y comando personalizado están limitados a un máximo de 1000 caracteres.

Una vez identificada la cadena XML, agregue la cadena a un comando personalizado o a una plantilla de configuración. Este procedimiento describe cómo:

1. En la interfaz web de TMS, navegue hasta Systems > Configuration Templates > Configuration Templates, y seleccione New Configuration Template:
   
   
   
   
2. Haga clic en la pestaña Select Advanced Settings y escriba la palabra custom en el campo de texto Filter en Cisco TelePresence Group Systems:
   
   
   
   
3. Active la casilla situada junto a la configuración correspondiente (Comando personalizado y/o Configuración personalizada) y haga clic en la flecha derecha (>) para moverla.
   
   
4. Haga clic en la pestaña Template Settings:
   
   
   
   
5. Ingrese su secuencia de comandos XML en el campo de texto Comando personalizado y/o Configuración personalizada correspondiente.
   
   
6. Seleccione Guardar.

Verificación

Actualmente, no hay un procedimiento de verificación disponible para esta configuración.

Troubleshoot

Actualmente, no hay información específica de troubleshooting disponible para esta configuración.