TMS中终端配置模板的自定义命令

简介

本文档介绍如何从思科网真管理套件(TMS)配置自定义命令模板或自定义配置模板。

先决条件

要求

Cisco 建议您了解以下主题：

• 思科网真管理套件
• 思科网真TC软件

您必须具有下列访问和权限：

• 具有足够权限的Web访问TMS以访问系统 > 配置模板 > 配置模板
• 对运行Cisco Telepresence TC软件的终端的Web访问，具有足够的权限，以便访问Configuration > API > /command.xml或/configuration.xml
• 使用管理员级别的权限对终端进行安全外壳(SSH)或Telnet访问

使用的组件

本文档中的信息基于以下软件和硬件版本：

• 思科网真管理套件版本14.2.2
• 采用思科网真TC软件版本TC6.2.1的思科网真Codec C40(C40)

本文档中的信息都是基于特定实验室环境中的设备编写的。本文档中使用的所有设备最初均采用原始（默认）配置。如果您使用的是真实网络，请确保您已经了解所有命令的潜在影响。

相关产品

本文档也可用于以下硬件和软件版本：

• 思科网真管理套件版本13.x - 14.x
• 思科网真TC软件版本TC6.0 - TC6.2.1

配置

创建简单命令字符串

警告：自定义模板发送在模板中配置的API，但不会将这些更改应用于TMS中终端的已知配置。当“强制刷新”更新大多数设置时，通过API进行的密码更改会导致TMS失去与终端的连接，直到在TMS中终端的连接设置内更新密码。

自定义命令模板通常用于设置管理员密码，因为TMS中没有用于运行TC软件的终端的预定义模板。本示例使用/command.xml文件。

此设置的xCommand字符串为：

Xcommand SystemUnit AdminPassword Set Password: NewPassword

导航到Configuration > API>/command.xml，然后查看位于终端Web界面中的/command.xml文件：

请注意，格式与xCommand字符串相同，但XML所需的结束标记除外。这会生成更改AdminPassword的XML字符串：

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

NewPassword是您选择的密码。

创建多部分命令字符串

您可以将自定义命令模板用于多部分命令字符串，例如常用反馈表达式来确定终端向TMS报告哪些事件。

以下是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

查看/command.xml文件：

比较命令字符串与/command.xml文件。这会产生等效的XML字符串：

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

创建多任务命令字符串

与SSH命令不同，您可以使用自定义命令模板来创建多任务命令。此示例将前面两个示例结合使用，并将HttpFeedback和AdminPassword都设置为一个自定义命令字符串：

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

查看/command.xml文件并查看它如何映射到自定义多任务命令字符串：

创建简单配置字符串

此示例将DefaultCall协议设置为H323。这是SSH/Telnet命令：

Xconfiguration Conference DefaultCall protocol: H323

查看/configuration.xml文件：

比较命令字符串与/command.xml文件。这会产生等效的XML字符串：

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

创建多部分配置字符串

与允许您运行命令以设置多个组件的Xcommand字符串不同，xConfiguration字符串仅支持每个字符串进行一次配置更改。因此，此部分不适用。 

创建多任务配置字符串

与自定义命令字符串一样，您可以在单个自定义配置XML字符串中组合多个配置字符串。此示例使用以下xConfiguration字符串作为基数：

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"

查看/configuration.xml文件的以下部分：

和

比较命令字符串与/command.xml文件。这会产生等效的XML字符串：

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

将创建的XML字符串添加到TMS自定义模板

注意：自定义命令和配置字段限制为最多1000个字符。

确定XML字符串后，将该字符串添加到自定义命令或配置模板。此过程描述以下方式：

1. 在TMS Web界面中，导航到系统 > 配置模板 > 配置模板，然后选择新建配置模板:
   
   
   
   
2. 单击Select Advanced Settings选项卡，然后在Cisco TelePresence Group Systems下的Filter文本字段中输入单词custom:
   
   
   
   
3. 选中相应设置(Custom Command和/或Custom Configuration)旁边的框，然后单击右箭头(>)将其移动。
   
   
4. 单击Template Settings选项卡：
   
   
   
   
5. 在相应的自定义命令和/或自定义配置文本字段中输入您的XML脚本。
   
   
6. 选择Save。

验证

当前没有可用于此配置的验证过程。

故障排除

目前没有针对此配置的故障排除信息。

修订历史记录