目錄

簡介

必要條件

需求

採用元件

相關產品

設定

建立簡單命令字串

建立多部分命令字串

建立多工命令字串

建立簡單配置字串

建立多部分配置字串

建立多工配置字串

將建立的XML字串新增到TMS自定義模板

驗證

疑難排解

簡介

本檔案介紹如何從Cisco TelePresence Management Suite(TMS)中設定自訂命令範本或自訂組態範本。

必要條件

需求

思科建議您瞭解以下主題：

- Cisco TelePresence管理套件

- Cisco TelePresence TC軟體

您必須具有以下訪問和許可權：

- 具有足夠許可權的Web訪問TMS，以便訪問系統 > 配置模板 > 配置模板

- 以足夠許可權對運行Cisco Telepresence TC軟體的終端機進行Web訪問，以便訪問Configuration > API > /command.xml或/configuration.xml

- 對具有管理員級許可權的終端的安全外殼(SSH)或Telnet訪問

採用元件

本文中的資訊係根據以下軟體和硬體版本：

- Cisco TelePresence管理套件版本14.2.2

- 採用Cisco TelePresence TC軟體版本TC6.2.1的Cisco TelePresence編解碼器C40(C40)

本文中的資訊是根據特定實驗室環境內的裝置所建立。文中使用到的所有裝置皆從已清除（預設）的組態來啟動。如果您的網路正在作用，請確保您已瞭解任何指令可能造成的影響。

相關產品

本文件也適用於以下硬體和軟體版本：

- Cisco TelePresence管理套件版本13.x - 14.x

- Cisco TelePresence 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介面中，導航到Systems > Configuration Templates > Configuration Templates，然後選擇New Configuration Template:

2. 按一下Select Advanced Settings頁籤，然後在Cisco TelePresence Group Systems下的Filter文本欄位中輸入單詞custom:

3. 選中相應設定(自定義命令和/或自定義配置)旁邊的框，然後按一下右箭頭(>)將其移動。

4. 按一下Template Settings選項卡：

5. 在相應的自定義命令和/或自定義配置文本欄位中輸入XML指令碼。

6. 選擇Save。

驗證

目前沒有適用於此組態的驗證程序。

疑難排解

目前尚無適用於此組態的具體疑難排解資訊。