Benutzerdefinierte Befehle für Endpunktkonfigurationsvorlagen in TMS

Einleitung

In diesem Dokument wird beschrieben, wie Sie benutzerdefinierte Befehlsvorlagen oder Konfigurationsvorlagen aus der Cisco TelePresence Management Suite (TMS) konfigurieren.

Voraussetzungen

Anforderungen

Cisco empfiehlt, dass Sie über Kenntnisse in folgenden Bereichen verfügen:

• Cisco TelePresence Management Suite
• Cisco TelePresence TC Software

Sie müssen über folgende Zugriffsrechte verfügen:

• Webzugriff auf TMS mit ausreichenden Berechtigungen für den Zugriff auf Systeme > Konfigurationsvorlagen > Konfigurationsvorlagen
• Webzugriff auf einen Endpunkt, auf dem Cisco TelePresence TC Software mit ausreichenden Berechtigungen ausgeführt wird, um auf Configuration > API > /command.xml oder /configuration.xml zuzugreifen
• Secure Shell (SSH)- oder Telnet-Zugriff auf den Endpunkt mit Administratorberechtigungen

Verwendete Komponenten

Die Informationen in diesem Dokument basierend auf folgenden Software- und Hardware-Versionen:

• Cisco TelePresence Management Suite 14.2.2
• Cisco TelePresence Codec C40 (C40) mit Cisco TelePresence TC Softwareversion TC6.2.1

Die Informationen in diesem Dokument beziehen sich auf Geräte in einer speziell eingerichteten Testumgebung. Alle Geräte, die in diesem Dokument benutzt wurden, begannen mit einer gelöschten (Nichterfüllungs) Konfiguration. Wenn Ihr Netz Live ist, überprüfen Sie, ob Sie die mögliche Auswirkung jedes möglichen Befehls verstehen.

Verwandte Produkte

Dieses Dokument kann auch mit folgenden Hardware- und Softwareversionen verwendet werden:

• Cisco TelePresence Management Suite-Versionen 13.x - 14.x
• Cisco TelePresence TC Softwareversionen TC6.0 - TC6.2.1

Konfigurieren

Erstellen einfacher Befehlszeichenfolgen

Vorsicht: Benutzerdefinierte Vorlagen senden die in den Vorlagen konfigurierten APIs, wenden diese Änderungen jedoch nicht auf die bekannte Endpunktkonfiguration in TMS an. Während die meisten Einstellungen durch eine Aktualisierung erzwungen werden, führt eine über die API vorgenommene Kennwortänderung dazu, dass TMS die Verbindung zum Endpunkt verliert, bis das Kennwort in den Verbindungseinstellungen des Endpunkts in TMS aktualisiert wird.

Benutzerdefinierte Befehlsvorlagen werden häufig verwendet, um Administratorkennwörter festzulegen, da es in TMS keine vordefinierte Vorlage für Endpunkte gibt, auf denen TC-Software ausgeführt wird. In diesem Beispiel wird die Datei /command.xml verwendet.

Die xCommand-Zeichenfolge für diese Einstellung lautet:

Xcommand SystemUnit AdminPassword Set Password: NewPassword

Navigieren Sie zu Configuration > API>/command.xml, und überprüfen Sie die Datei /command.xml, die sich in der Webschnittstelle des Endgeräts befindet:

Beachten Sie, dass das Format mit Ausnahme der für XML erforderlichen schließenden Tags mit der xCommand-Zeichenfolge übereinstimmt. Daraus ergibt sich die XML-Zeichenfolge, die das AdminPassword:

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

NewPassword ist das von Ihnen ausgewählte Kennwort.

Erstellen von mehrteiligen Befehlszeichenfolgen

Sie können eine benutzerdefinierte Befehlsvorlage für eine mehrteilige Befehlszeichenfolge verwenden, z. B. die häufige Verwendung von Feedbackausdrücken, um zu bestimmen, welche Ereignisse der Endpunkt an TMS meldet.

Dies ist ein Beispiel für die Telnet/SSH-Befehlszeichenfolge:

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

Überprüfen Sie die Datei /command.xml:

Vergleichen Sie die Befehlszeichenfolge mit der Datei /command.xml. Dies ergibt die entsprechende XML-Zeichenfolge:

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

Erstellen von Multi-Task-Befehlszeichenfolgen

Im Gegensatz zu SSH-Befehlen können Sie benutzerdefinierte Befehlsvorlagen verwenden, um Multitasking-Befehle zu erstellen. In diesem Beispiel werden die beiden vorherigen Beispiele kombiniert und sowohl HttpFeedback als auch AdminPassword mit einer einzigen benutzerdefinierten Befehlszeichenfolge festgelegt:

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

Überprüfen Sie die Datei /command.xml, und sehen Sie, wie sie der benutzerdefinierten Multitasking-Befehlszeichenfolge zugeordnet ist:

Erstellen einfacher Konfigurationszeichenfolgen

In diesem Beispiel wird das DefaultCall-Protokoll auf H323 festgelegt. Dies ist der SSH/Telnet-Befehl:

Xconfiguration Conference DefaultCall protocol: H323

Überprüfen Sie die Datei /configuration.xml:

Vergleichen Sie die Befehlszeichenfolge mit der Datei /command.xml. Dies ergibt die entsprechende XML-Zeichenfolge:

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

Erstellen von mehrteiligen Konfigurationszeichenfolgen

Im Gegensatz zu Xcommand-Zeichenfolgen, mit denen Sie einen Befehl ausführen können, um mehrere Komponenten festzulegen, unterstützen xConfiguration-Zeichenfolgen nur eine einzelne Konfigurationsänderung pro Zeichenfolge. Dieser Abschnitt gilt daher nicht. 

Erstellen von Konfigurationszeichenfolgen für mehrere Aufgaben

Wie bei benutzerdefinierten Befehlszeichenfolgen können Sie mehrere Konfigurationszeichenfolgen in einer einzelnen benutzerdefinierten Konfigurations-XML-Zeichenfolge kombinieren. In diesem Beispiel werden die folgenden xConfiguration-Zeichenfolgen als Basis verwendet:

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"

Lesen Sie die folgenden Abschnitte der Datei /configuration.xml:

und

Vergleichen Sie die Befehlszeichenfolge mit der Datei /command.xml. Dies ergibt die entsprechende XML-Zeichenfolge:

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

Erstellte XML-Zeichenfolgen zu benutzerdefinierter TMS-Vorlage hinzufügen

Anmerkung: Sowohl benutzerdefinierte Befehls- als auch Konfigurationsfelder sind auf maximal 1000 Zeichen beschränkt.

Nachdem Sie die XML-Zeichenfolge identifiziert haben, fügen Sie die Zeichenfolge zu einem benutzerdefinierten Befehl oder einer benutzerdefinierten Konfigurationsvorlage hinzu. Dieses Verfahren beschreibt, wie:

1. Navigieren Sie in der TMS-Webschnittstelle zu Systems > Configuration Templates > Configuration Templates, und wählen Sie New Configuration Template (Neue Konfigurationsvorlage):
   
   
   
   
2. Klicken Sie auf die Registerkarte Erweiterte Einstellungen auswählen, und geben Sie das Wort custom in das Textfeld Filter unter Cisco TelePresence Group Systems ein:
   
   
   
   
3. Aktivieren Sie das Kontrollkästchen neben der entsprechenden Einstellung (Custom Command und/oder Custom Configuration), und klicken Sie auf den Pfeil nach rechts (>), um die Einstellung zu verschieben.
   
   
4. Klicken Sie auf die Registerkarte Vorlageneinstellungen:
   
   
   
   
5. Geben Sie Ihr XML-Skript in das entsprechende Textfeld für benutzerdefinierte Befehle und/oder benutzerdefinierte Konfigurationen ein.
   
   
6. Wählen Sie Speichern.

Überprüfung

Für diese Konfiguration ist derzeit kein Überprüfungsverfahren verfügbar.

Fehlerbehebung

Für diese Konfiguration sind derzeit keine spezifischen Informationen zur Fehlerbehebung verfügbar.