Aangepaste opdrachten voor endpointconfiguratiesjablonen in TMS

Inleiding

Dit document beschrijft hoe u aangepaste opdrachtsjablonen of aangepaste configuratiesjablonen kunt configureren vanuit Cisco TelePresence Management Suite (TMS).

Voorwaarden

Vereisten

Cisco raadt kennis van de volgende onderwerpen aan:

• Cisco TelePresence Management Suite
• Cisco TelePresence TC-software

U moet over deze toegangsrechten en privileges beschikken:

• Webtoegang tot TMS met voldoende rechten om toegang te krijgen tot systemen > Configuratiescherm > Configuratiescherm
• Webtoegang tot een eindpunt waarop Cisco TelePresence TC-software wordt uitgevoerd met voldoende rechten om toegang te krijgen tot Configuration > API > /command.xml of /configuration.xml
• Beveiligde toegang via Shell (SSH) of Telnet tot het endpoint met rechten op beheerdersniveau

Gebruikte componenten

De informatie in dit document is gebaseerd op de volgende software- en hardware-versies:

• Cisco TelePresence Management Suite versie 14.2.2
• Cisco TelePresence-codec C40 (C40) met Cisco TelePresence TC-softwareversie TC6.2.1

De informatie in dit document is gebaseerd op de apparaten in een specifieke laboratoriumomgeving. Alle apparaten die in dit document worden beschreven, hadden een opgeschoonde (standaard)configuratie. Als uw netwerk live is, moet u de potentiële impact van elke opdracht begrijpen.

Verwante producten

Dit document kan ook worden gebruikt voor de volgende hardware- en softwareversies:

• Cisco TelePresence Management Suite versies 13.x - 14.x
• Cisco TelePresence TC-softwareversies TC6.0 - TC6.2.1

Configureren

Eenvoudige opdrachtreeksen maken

Voorzichtig: Aangepaste sjablonen sturen de API's die zijn geconfigureerd binnen de sjablonen, maar pas deze wijzigingen niet toe op de bekende configuratie van het eindpunt in TMS. Terwijl een 'force refresh' de meeste instellingen bijwerkt, zorgt een wachtwoordwijziging via de API ervoor dat TMS connectiviteit met het eindpunt verliest totdat het wachtwoord wordt bijgewerkt binnen de verbindingsinstellingen van het eindpunt in TMS.

Aangepaste opdrachtsjablonen worden vaak gebruikt om beheerderwachtwoorden in te stellen, omdat er geen vooraf gedefinieerde sjabloon in TMS is voor eindpunten waarop TC-software wordt uitgevoerd. In dit voorbeeld wordt het bestand /command.xml gebruikt.

De xCommand string voor deze instelling is:

Xcommand SystemUnit AdminPassword Set Password: NewPassword

Navigeer naar Configuration > API>/command.xml en bekijk het /command.xml bestand dat zich in de webinterface voor endpoints bevindt:

Merk op dat de notatie hetzelfde is als de xCommand-string met uitzondering van de afsluitende tags die nodig zijn voor XML. Dit levert de XML-string op die het AdminPassword wijzigt:

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

NieuwPassword is uw keuze van het wachtwoord.

Opdrachtstrings voor meerdere onderdelen maken

U kunt een aangepaste opdrachtsjabloon gebruiken voor een opdrachtstring die uit meerdere onderdelen bestaat, zoals het algemene gebruik van feedbackexpressies om te bepalen welke gebeurtenissen door het eindpunt aan TMS worden gerapporteerd.

Dit is een voorbeeld van de opdrachtstring 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

Bekijk het /command.xml bestand:

Vergelijk de opdrachtstring met het /command.xml bestand. Dit levert de gelijkwaardige XML-string op:

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

Opdrachtstrings voor meerdere taken maken

In tegenstelling tot SSH-opdrachten kunt u aangepaste opdrachtsjablonen gebruiken om opdrachten met meerdere taken te maken. Dit voorbeeld combineert de twee vorige voorbeelden en stelt zowel HttpFeedback als AdminPassword in met één aangepaste opdrachtstring:

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

Bekijk het /command.xml bestand en bekijk hoe het wordt toegewezen aan de aangepaste multi-task opdrachtstring:

Eenvoudige configuratiestrings maken

In dit voorbeeld wordt het DefaultCall-protocol ingesteld op H323. Dit is de opdracht SSH/Telnet:

Xconfiguration Conference DefaultCall protocol: H323

Bekijk het /configuration.xml bestand:

Vergelijk de opdrachtstring met het /command.xml bestand. Dit levert de gelijkwaardige XML-string op:

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

Configuratie-strings voor meerdere onderdelen maken

In tegenstelling tot de strings van XCommand die u een opdracht laten uitvoeren om meerdere componenten in te stellen, ondersteunen xConfiguration strings slechts één enkele configuratiewijziging per string. Daarom is dit punt niet van toepassing. 

Configuratierekeningen voor meerdere taken maken

Zoals met de koorden van het douanebevel, kunt u meerdere configuratiekoorden in één enkel koord van XML van de douaneconfiguratie combineren. In dit voorbeeld worden deze xConfiguration-strings als basis gebruikt:

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"

Bekijk deze secties van het /configuration.xml bestand:

en

Vergelijk de opdrachtstring met het /command.xml bestand. Dit levert de gelijkwaardige XML-string op:

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

Aangemaakte XML-strings toevoegen aan TMS Aangepaste sjabloon

Opmerking: Zowel de opdrachtvelden als de configuratievelden zijn beperkt tot maximaal 1000 tekens.

Zodra u de XML-string hebt geïdentificeerd, voegt u de string toe aan een aangepaste opdracht of configuratie-sjabloon. In deze procedure wordt beschreven hoe:

1. In de TMS web interface, navigeer naar systemen > Configuration Templates > Configuration Templates, en selecteer New Configuration Template:
   
   
   
   
2. Klik op het tabblad Geavanceerde instellingen selecteren en voer het aangepaste woord in het tekstveld Filter onder Cisco TelePresence Group Systems:
   
   
   
   
3. Controleer het vakje naast de juiste instelling (Aangepaste opdracht en/of Aangepaste configuratie) en klik op het pijltje rechts (>) om deze te verplaatsen.
   
   
4. Klik op het tabblad Sjablooninstellingen:
   
   
   
   
5. Voer uw XML-script in het juiste tekstveld Aangepaste Opdracht en/of Aangepaste configuratie in.
   
   
6. Selecteer Opslaan.

Verifiëren

Er is momenteel geen verificatieprocedure beschikbaar voor deze configuratie.

Problemen oplossen

Er is momenteel geen specifieke troubleshooting-informatie beschikbaar voor deze configuratie.

Revisiegeschiedenis