Commandes personnalisées pour les modèles de configuration des terminaux dans TMS

Introduction

Ce document décrit comment configurer des modèles de commande ou de configuration personnalisés à partir de Cisco TelePresence Management Suite (TMS).

Conditions préalables

Exigences

Cisco vous recommande de prendre connaissance des rubriques suivantes :

• Suite de gestion Cisco TelePresence
• Logiciel Cisco TelePresence TC

Vous devez disposer des accès et privilèges suivants :

• Accès Web à TMS avec des privilèges suffisants pour accéder à Systems > Configuration Templates > Configuration Templates
• Accès Web à un terminal exécutant le logiciel Cisco Telepresence TC avec des privilèges suffisants pour accéder à Configuration > API > /command.xml ou /configuration.xml
• Accès SSH (Secure Shell) ou Telnet au terminal avec des privilèges de niveau administrateur

Composants utilisés

Les informations contenues dans ce document sont basées sur les versions de matériel et de logiciel suivantes :

• Cisco TelePresence Management Suite version 14.2.2
• Codec Cisco TelePresence C40 (C40) avec logiciel Cisco TelePresence TC Version 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.

Produits connexes

Ce document peut également être utilisé avec les versions de matériel et de logiciel suivantes :

• Cisco TelePresence Management Suite versions 13.x - 14.x
• Logiciel Cisco TelePresence TC Versions TC6.0 - TC6.2.1

Configurer

Créer des chaînes de commandes simples

Mise en garde : Les modèles personnalisés envoient les API configurées dans les modèles, mais n'appliquent pas ces modifications à la configuration connue du terminal dans TMS. Alors qu'une « actualisation forcée » met à jour la plupart des paramètres, une modification de mot de passe effectuée via l'API entraîne la perte de connectivité de TMS avec le terminal jusqu'à ce que le mot de passe soit mis à jour dans les paramètres de connexion du terminal dans TMS.

Des modèles de commandes personnalisés sont couramment utilisés afin de définir des mots de passe administrateur, car il n'y a pas de modèle prédéfini dans TMS pour les terminaux qui exécutent le logiciel TC. Cet exemple utilise le fichier /command.xml.

La chaîne xCommand pour ce paramètre est :

Xcommand SystemUnit AdminPassword Set Password: NewPassword

Accédez à Configuration > API>/command.xml, et consultez le fichier /command.xml situé dans l'interface Web du point de terminaison :

Notez que le format est identique à celui de la chaîne xCommand, à l'exception des balises de fermeture nécessaires pour XML. Ceci génère la chaîne XML qui modifie le mot de passe AdminPassword :

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

NewPassword est votre mot de passe.

Créer des chaînes de commandes en plusieurs parties

Vous pouvez utiliser un modèle de commande personnalisé pour une chaîne de commande en plusieurs parties, telle que l'utilisation courante d'expressions de commentaire afin de déterminer quels événements le point d'extrémité signale au TMS.

Voici un exemple de la chaîne de commande 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

Consultez le fichier /command.xml :

Comparez la chaîne de commande au fichier /command.xml. Ceci génère la chaîne XML équivalente :

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

Créer des chaînes de commandes multitâches

Contrairement aux commandes SSH, vous pouvez utiliser des modèles de commandes personnalisés afin de créer des commandes multitâches. Cet exemple combine les deux exemples précédents et définit à la fois HttpFeedback et AdminPassword avec une seule chaîne de commande personnalisée :

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

Consultez le fichier /command.xml et voyez comment il correspond à la chaîne de commande multitâche personnalisée :

Créer des chaînes de configuration simples

Cet exemple définit le protocole DefaultCall sur H323. Il s'agit de la commande SSH/Telnet :

Xconfiguration Conference DefaultCall protocol: H323

Consultez le fichier /configuration.xml :

Comparez la chaîne de commande au fichier /command.xml. Ceci génère la chaîne XML équivalente :

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

Créer des chaînes de configuration en plusieurs parties

Contrairement aux chaînes Xcommand qui vous permettent d'exécuter une commande afin de définir plusieurs composants, les chaînes xConfiguration ne prennent en charge qu'une seule modification de configuration par chaîne. Par conséquent, cette section ne s'applique pas. 

Créer des chaînes de configuration multitâches

Comme avec les chaînes de commandes personnalisées, vous pouvez combiner plusieurs chaînes de configuration dans une seule chaîne XML de configuration personnalisée. Cet exemple utilise ces chaînes xConfiguration comme 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"

Consultez les sections suivantes du fichier /configuration.xml :

et

Comparez la chaîne de commande au fichier /command.xml. Ceci génère la chaîne XML équivalente :

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

Ajouter les chaînes XML créées au modèle personnalisé TMS

Note: Les champs de commande et de configuration personnalisés sont limités à un maximum de 1 000 caractères.

Une fois la chaîne XML identifiée, ajoutez-la à une commande personnalisée ou à un modèle de configuration. Cette procédure décrit comment :

1. Dans l'interface Web de TMS, accédez à Systems > Configuration Templates > Configuration Templates, et sélectionnez New Configuration Template :
   
   
   
   
2. Cliquez sur l'onglet Select Advanced Settings, et entrez le mot custom dans le champ de texte Filter sous Cisco TelePresence Group Systems :
   
   
   
   
3. Cochez la case en regard du paramètre approprié (Commande personnalisée et/ou Configuration personnalisée), puis cliquez sur la flèche droite (>) pour le déplacer.
   
   
4. Cliquez sur l'onglet Paramètres du modèle :
   
   
   
   
5. Entrez votre script XML dans le champ de texte Commande personnalisée et/ou Configuration personnalisée approprié.
   
   
6. Sélectionnez Enregistrer.

Vérifier

Aucune procédure de vérification n'est disponible pour cette configuration.

Dépannage

Il n'existe actuellement aucune information de dépannage spécifique pour cette configuration.