目录

简介

先决条件

要求

使用的组件

相关产品

配置

创建简单命令字符串

创建多部分命令字符串

创建多任务命令字符串

创建简单配置字符串

创建多部分配置字符串

创建多任务配置字符串

将创建的XML字符串添加到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。

验证

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

故障排除

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