TMS のエンドポイント設定テンプレートのカスタム コマンド

ダウンロード オプション

  • PDF     (665.7 KB)
    Adobe Reader を使ってさまざまなデバイスで表示
  • ePub     (1.1 MB)
    iPhone、iPad、Android、ソニーの Reader、または Windows Phone 上で、さまざまなアプリを使って表示
  • Mobi (Kindle)     (1.2 MB)
    Kindle デバイスで、または Kindle アプリを使って複数のデバイスで表示
Updated: 2014 年 2 月 19 日
Document ID:117357

偏向のない言語

この製品のドキュメントセットは、偏向のない言語を使用するように配慮されています。このドキュメントセットでの偏向のない言語とは、年齢、障害、性別、人種的アイデンティティ、民族的アイデンティティ、性的指向、社会経済的地位、およびインターセクショナリティに基づく差別を意味しない言語として定義されています。製品ソフトウェアのユーザインターフェイスにハードコードされている言語、RFP のドキュメントに基づいて使用されている言語、または参照されているサードパーティ製品で使用されている言語によりドキュメントに例外が存在する場合があります。シスコのインクルーシブ ランゲージの取り組みの詳細は、こちらをご覧ください。

翻訳について

シスコは世界中のユーザにそれぞれの言語でサポート コンテンツを提供するために、機械と人による翻訳を組み合わせて、本ドキュメントを翻訳しています。ただし、最高度の機械翻訳であっても、専門家による翻訳のような正確性は確保されません。シスコは、これら翻訳の正確性について法的責任を負いません。原典である英語版（リンクからアクセス可能）もあわせて参照することを推奨します。

概要

このドキュメントでは、Cisco TelePresence Management Suite（TMS）から、カスタム コマンド テンプレートまたはカスタム設定テンプレートを設定する方法について説明します。

前提条件

要件

次の項目に関する知識があることが推奨されます。

  • Cisco TelePresence Management Suite
  • Cisco TelePresence TC ソフトウェア

次のアクセスと権限が必要です。

  • [Systems] > [Configuration Templates] > [Configuration Templates] にアクセスするための十分な権限を持つ、TMS への Web アクセス
  • [Configuration] > [API] > [/command.xml] または [/configuration.xml] にアクセスするための十分な権限を持つ、Cisco TelePresence TC ソフトウェアを実行するエンドポイントへの Web アクセス
  • 管理者レベルの権限を持つエンドポイントへのセキュア シェル（SSH）または Telnet アクセス

使用するコンポーネント

このドキュメントの情報は、次のソフトウェアとハードウェアのバージョンに基づいています。

  • Cisco TelePresence Management Suite バージョン 14.2.2
  • Cisco TelePresence TC ソフトウェア バージョン TC6.2.1 を備えた Cisco TelePresence Codec C40（C40）

このドキュメントの情報は、特定のラボ環境にあるデバイスに基づいて作成されました。このドキュメントで使用するすべてのデバイスは、初期（デフォルト）設定の状態から起動しています。対象のネットワークが実稼働中である場合には、どのようなコマンドについても、その潜在的な影響について確実に理解しておく必要があります。

関連製品

このドキュメントは、次のバージョンのハードウェアとソフトウェアにも使用できます。

  • Cisco TelePresence Management Suite バージョン 13.x - 14.x
  • Cisco TelePresence TC ソフトウェア バージョン TC6.0 - TC6.2.1

設定

簡単なコマンド文字列の作成

注意：カスタム テンプレートはテンプレート内で設定された API を送信しますが、TMS のエンドポイントの既知の設定への変更は適用されません。「force refresh」はほとんどの設定をアップデートする一方、API を通じてパスワード変更が行われると、TMS のエンドポイントの接続設定内でパスワードが更新されるまで、TMS はエンドポイントとの接続を失います。

TMS には、TC ソフトウェアを実行するエンドポイント用に事前定義されたテンプレートがないため、管理者パスワードを設定するためにカスタム テンプレート コマンドが一般的に使用されます。この例では、/command.xml ファイルを使用しています。

この設定の xCommand 文字列は次のとおりです。

Xcommand SystemUnit AdminPassword Set Password: NewPassword

[Configuration] > [API]> [/command.xm] を選択し、エンドポイントの Web インターフェイスにある /command.xml ファイルを確認します。

117357-config-tms-01.png

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 ファイルを確認します。

117357-config-tms-02.png

コマンド文字列を /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 ファイルを確認し、カスタム マルチタスク コマンド文字列にどのようにマッピングされるかを確認します。

117357-config-tms-03.png

簡単な設定文字列の作成

次の例では、DefaultCallプロトコルをH323に設定しています。これはSSH/Telnetコマンドです。

Xconfiguration Conference DefaultCall protocol: H323

/configuration.xml ファイルを確認します。

117357-config-tms-04.png

コマンド文字列を /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 ファイルの次のセクションを確認します。

117357-config-tms-05.png

と

117357-config-tms-06.png

コマンド文字列を /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] を選択します。

    117357-config-tms-07.png

  2. [Select Advanced Settings] タブをクリックし、custom という文字を [Cisco TelePresence Group Systems] の [Filter] テキスト フィールドに入力します。

    117357-config-tms-08.png

  3. 適切な設定（[Custom Command] および（または）[Custom Configuration]）の隣のチェックボックスをオンにし、右矢印（>）をクリックして移動します。

  4. [Template Settings] タブをクリックします。

    117357-config-tms-09.png

  5. XML 文字列を、適切な [Custom Command] および（または）[Custom Configuration] テキスト フィールドに入力します。

  6. [Save] を選択します。

確認

現在、この設定に使用できる確認手順はありません。

トラブルシュート

現在、この設定に関する特定のトラブルシューティング情報はありません。

更新履歴

改定 発行日 コメント
1.0
19-Feb-2014
初版
TAC Authored

シスコ エンジニア提供

  • Jason Shupe and Adam Wamsley
    Cisco TAC Engineers.

このドキュメントは役に立ちましたか?

Feedbackフィードバック

シスコに問い合わせ

このドキュメントは次の製品に対応しています