このドキュメントでは、Cisco TelePresence Management Suite(TMS)から、カスタム コマンド テンプレートまたはカスタム設定テンプレートを設定する方法について説明します。
次の項目に関する知識があることが推奨されます。
次のアクセスと権限が必要です。
このドキュメントの情報は、次のソフトウェアとハードウェアのバージョンに基づいています。
このドキュメントの情報は、特定のラボ環境にあるデバイスに基づいて作成されました。このドキュメントで使用するすべてのデバイスは、初期(デフォルト)設定の状態から起動しています。対象のネットワークが実稼働中である場合には、どのようなコマンドについても、その潜在的な影響について確実に理解しておく必要があります。
このドキュメントは、次のバージョンのハードウェアとソフトウェアにも使用できます。
TMS には、TC ソフトウェアを実行するエンドポイント用に事前定義されたテンプレートがないため、管理者パスワードを設定するためにカスタム テンプレート コマンドが一般的に使用されます。この例では、/command.xml ファイルを使用しています。
この設定の xCommand 文字列は次のとおりです。
Xcommand SystemUnit AdminPassword Set Password: NewPassword
[Configuration] > [API]> [/command.xm] を選択し、エンドポイントの Web インターフェイスにある /command.xml ファイルを確認します。
XML に必要な終了タグを除き、形式は xCommand 文字列と同じであることがわかります。これにより、管理者パスワードを変更する 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 コマンドとは異なり、マルチタスク コマンドを作成するためにカスタム コマンド テンプレートを使用できます。この例では、前述の 2 つの例を組み合わせて、HttpFeedback および AdminPassword の両方を 1 つのカスタム コマンド文字列で設定します。
<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 文字列は文字列ごとに 1 つの設定変更のみをサポートします。したがって、このセクションは適用されません。
カスタム コマンド文字列と同様、複数の設定文字列を 1 つのカスタム設定 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 文字列を特定したら、その文字列をカスタム コマンドまたは設定テンプレートに追加します。次の手順はその方法を示します。
現在、この設定に使用できる確認手順はありません。
現在、この設定に関する特定のトラブルシューティング情報はありません。
改定 | 発行日 | コメント |
---|---|---|
1.0 |
19-Feb-2014 |
初版 |