Cisco JTAPI インストレーション ガイド for Cisco CallManager 4.1(3)

Cisco JTAPI インストレーション ガイド for Cisco CallManager 4.1(3)

---

ここでは、Cisco CallManager 4.1(3) への Cisco Java Telephony API（JTAPI）クライアント ソフトウェアのインストール方法および設定方法を説明します。

目次

このマニュアルは、次のトピックで構成されています。

• 「概要」

• 「Cisco JTAPI ソフトウェアのインストレーション」

• 「インストレーションの検証」

• 「アップグレードのための自動インストール」

• 「Cisco JTAPI トレースの設定」

• 「Microsoft 以外の環境の JTAPI Preferences」

• 「JTAPI アプリケーションのユーザ情報の管理」

• 「技術情報の入手方法」

• 「テクニカル サポート」

• 「その他の資料および情報の入手方法」

概要

Cisco Java Telephony API（JTAPI）の実装では、JTAPI アプリケーションを実行するすべてのクライアント マシン上にある Java クラスを包含しています。アプリケーションを正しく機能させるには、事前に Cisco JTAPI をインストールしておく必要があります。Cisco CallManager 上であるか、あるいは別のマシン上であるかに関係なく、JTAPI アプリケーションが実行される場所に、Cisco JTAPI クラスがインストールされていることを確認してください。インストレーションには、5 MB のローカル ディスク スペースが必要です。

（注） Cisco CallManager を 4.0 にアップグレード済みである場合は、JTAPI アプリケーションがインストールされているすべてのアプリケーション サーバまたはクライアント ワークステーション上で、JTAPI クライアント ソフトウェアのアップグレードが必要です。JTAPI クライアントをアップグレードしないと、アプリケーションの初期化に失敗します。アップグレード作業をする場合は、Cisco CallManager Administration から適切なクライアントをダウンロードしてください（「Cisco JTAPI ソフトウェアのインストレーション」を参照）。

アップグレードされた JTAPI クライアント ソフトウェアは、旧リリースの Cisco CallManager 上では動作しません。

Cisco JTAPI ソフトウェアのインストレーション

Cisco JTAPI では、インストールおよび JTAPI Preferences UI で複数の言語がサポートされています。

Cisco JTAPI インストレーション ユーティリティは、ローカル ディスク ドライブに次のソフトウェアをインストールします。

• %SystemRoot%\java\lib に JTAPI java クラスをインストール。

• Program Files\JTAPITools に JTAPI Preferences をインストール。

• Program Files\JTAPITools に JTAPI サンプル アプリケーション（makecall、jtrace）をインストール。

• Program Files\JTAPITools\doc に JTAPI ドキュメントをインストール。

（注） 複数の JTAPI アプリケーションを実行するには、Java 1.1 対応環境（たとえば、Sun JDK 1.1.x、JDK 1.2、JDK 1.3、または Microsoft Virtual Machine（Internet Explorer 4.0 以上にバンドルされている））が必要です。Cisco JTAPI は、Sun JDK1.2 でも動作します。

しかし、Cisco JTAPI で JTPREFS を使用するには、JDK 1.2 以降の環境が必要です。JTPrefs については、「Cisco JTAPI トレースの設定」を参照してください。

Cisco JTAPI を Windows 2000 ワークステーションまたは Windows 2000 サーバにインストールする場合は、Microsoft Virtual Machine の互換バージョンがすでに備えられています。上記以外の
Microsoft プラットフォーム（たとえば、Windows 95、Windows 98、および Windows NT など）にインストールする場合は、コマンド「java /?」を実行し、コンソールの先頭に出力されるバージョンをチェックすることにより、Microsoft Virtual Machine の現在のバージョンを確認します。

Cisco JTAPI ソフトウェアをインストールする手順は、次のとおりです。

手順

ステップ 1 Cisco JTAPI クライアント ソフトウェアをインストールするコンピュータに、ログインします。

ステップ 2 すべての Windows プログラムを閉じます。

ステップ 3 Web ブラウザを開きます。

ステップ 4 次の Cisco CallManager Administration に移動します。

http:// Name /CCMAdmin/main.asp

ただし、

Name には、Cisco CallManager の名前または IP アドレスを指定します。

ステップ 5 Application > Install Plugins の順に選択します。

ステップ 6 Cisco JTAPI リンクを選択します。

ステップ 7 ポップアップ ウィンドウの指示に従います。

（注） インストレーション ソフトウェアが指示するデフォルト ドライブに、Cisco JTAPI ソフトウェアをインストールしてください。たとえば、Windows NT が C:\WINNT にインストールされている場合のデフォルト ディレクトリは、C:\WINNT\Java\lib です。

インストレーションの検証

JTAPI のインストレーションを検証するには、JTAPI を経由してコールを発信できる makecall アプリケーションを使用します。makecall アプリケーションを使用する手順は、次のとおりです。

手順

ステップ 1 Windows NT コマンドラインから、Cisco JTAPI Tools をインストールしたディレクトリまで移動します。デフォルトでは、このディレクトリは Program Files\JTAPITools です。

ステップ 2 次のコマンドを実行します。

java CiscoJtapiVersion

ステップ 3 次のコマンドを実行します。

java makecall < server name > < login > < password > 1000 < phone1 > < phone2 >

ただし、

server name には、Cisco CallManager のホスト名または IP アドレス（たとえば、CTISERVER）を指定します。

phone1 および phone2 は、ユーザ設定に従ってユーザによって制御される、IP Phone または仮想電話機の電話番号を示します。詳細については、『Cisco CallManager アドミニストレーション ガイド』を参照してください。

login および password には、Cisco CallManager User Configuration ウィンドウで設定したユーザ ID とパスワードを使用します。

JTAPI Preferences ユーザ インターフェイス ユーティリティのツールを使用して、インストールされている JTAPI のバージョンを確認することもできます。

［スタート］>［プログラム］>CiscoJTAPI >JTAPI Preferences の順に選択します。

アップグレードのための自動インストール

この機能を使用すると、アプリケーションは、起動時に HTTP 要求経由で Cisco CallManager Web サーバに自身を認識させ、必要な JTAPI API のバージョンを持つ応答を受信することができます。アプリケーションは、サーバから入手可能なバージョンとアプリケーション クラスパス内のローカルのバージョンとを比較し、アップグレードが必要かどうかを判断します。

アプリケーションは、アップデートされた API のインスタンスを生成する初期プロセスに変更を加え、サーバにインストールされたコンポーネントを検出し、必要に応じてコンポーネントをダウンロードします。

この機能は、Cisco CallManager と一致するようアプリケーションが jtapi.jar コンポーネントをリフレッシュできるようにするため、また、アプリケーションが jtapi.jar を一元展開し、その jtapi.jar に自動アップデートできるようにするために使用します。

この機能の実行に必要な API は、updater.jar の形式でパッケージされています。jtapi.jar および updater.jar は、バージョンの比較に使用する標準のマニフェストでパッケージされています。アプリケーションが Version クラスのインスタンスを生成する必要はありません。Version クラスのインスタンスを生成すると、API がアップグレード時に書き込み保護される可能性があるためです。

ロケーションとコンポーネントを指定してこの機能を使用すると、サーバから jtapi.jar をダウンロードし、ローカル ディレクトリに直接コピーできます。アプリケーションは、ダウンロード済みの jtapi.jar で上書きするか、または新しい jtapi.jar にアクセスするようにクラスパスを変更することができます。

（注） 自動インストールを使用しても、JTAPI Preferences、TAPITestTools、updater.jar、および
javadoc の各コンポーネントはアップグレードされません。アプリケーションにこれらのコンポーネントが必要な場合は、Cisco CallManager プラグイン ページから JTAPI をインストールします。

Cisco JTAPI トレースの設定

Cisco JTAPI tracing preferences アプリケーション（JTAPI Preferences）を使用して、トレース レベルとトレース宛先を設定します。デフォルトでは、Cisco JTAPI Preferences は、Program Files\JTAPITools ディレクトリにインストールされます。Cisco JTAPI Preferences ユーティリティを開くには、 ［スタート］>［プログラム］> Cisco JTAPI > JTAPI Preferences の順に選択してください。

この項では、Cisco JTAPI preferences アプリケーションの使用法を説明します。構成は、次のとおりです。

• 「トレース レベル」

• 「ログ先」

• 「Cisco CallManager」

• 「詳細設定」

トレース レベル

図1 では、Cisco JTAPI Preferences アプリケーションの［トレース レベル］タブを示しています。このウィンドウのタイトルには、JTAPI バージョン番号が表示されます。

図1 ［トレース レベル］タブ

 

［トレース レベル］タブでは、次の JTAPI トレース レベルを使用可能または使用不可にすることができます。

• 警告：低レベルの警告イベント

• 情報：状況イベント

• デバッグ：最高レベルのデバッグ イベント

次のリストで記述されているように、［デバッグ レベル］ウィンドウでその他のデバッグ レベルを使用可能にしたり、使用不可にしたりすることができます。

• JTAPI デバッグ：JTAPI 方式とイベントのトレース

• JTAPIIMPL デバッグ：内部 JTAPI インプリメンテーションのトレース

• CTI デバッグ：JTAPI インプリメンテーションに送信される Cisco CallManager イベントのトレース

• CTIIMPL デバッグ：内部 CTICLIENT インプリメンテーションのトレース

• PROTOCOL デバッグ：全 CTI プロトコル デコーディング

• MISC デバッグ：その他の低レベル デバッグ トレース

ログ先

図2 では、Cisco JTAPI Preferences アプリケーションの［ログ先］タブを示しています。

図2 ［ログ先］タブ

 

［ログ先］タブでは、JTAPI がトレースを作成する方法、およびトレースが保存される方法を設定できます。 表 1 では、ログ先の設定フィールドについて説明します。

 

表 1 ログ先の設定フィールド

フィールド	説明
アラームサービスの有効化	このチェックボックスがオンになっている場合、JTAPI アラームは、指定されたマシン上で実行されているアラーム サービスに送信される。このオプションを使用可能にする場合は、ホスト名とポート番号を指定する必要があります。
Java コンソールを使用	このチェックボックスがオンになっている場合、トレースは、標準出力またはコンソール（コマンド）ウィンドウに送信される。
Syslog を使用する	このチェックボックスがオンになっている場合、トレースは、［コレクタ:］フィールドと［ポート番号:］フィールドで指定された UDP ポートに送信される。Syslog collector サービスは、トレースを収集し、CiscoWorks2000 サーバにそのトレースを送信します。
回転ログファイルを使用	このオプションを使用すると、トレースを、システム内の特定のパスおよびフォルダに指定できる。2～99 個のログ ファイルを指定できます。Cisco JTAPI は、ログ ファイルを番号順に循環させ、最後のログ ファイルまで使用した後、最初のログ ファイルに戻ります。ログ ファイルのサイズは、1 メガバイトずつ増加します。
同じディレクトリを使用する	このオプションを使用すると、アプリケーションのインスタンスごとに同じフォルダ名を使用するかどうかを指定できる。 このチェックボックスがオンになっている場合、JTAPI はログ ファイルをトレースして、同じディレクトリに書き込みます。この場合、JTAPI アプリケーションの後続のインスタンスは、インデックス 01 から始まるログ ファイルを再開します。 このチェックボックスがオフになっている場合、各アプリケーション インスタンスは、連続するか、同時であるかにかかわらず、最後に書き込まれたフォルダに続く新しいフォルダに、トレース ファイルを入れます。Cisco JTAPI は、トレース パス内にある最後のフォルダを検出し、自動的に数値インデックスを増加します。
パス	このフィールドでは、トレース ファイルが書き込まれる先のパス名を指定できる。パスが指定されない場合、JTAPI は、アプリケーションのパスをデフォルトにします。使用できる文字は英語のみであり、日本語（半角カタカナ含む）は使用できません。
ディレクトリ名ベース	このフィールドでは、トレース ファイルが書き込まれるフォルダ名を指定できる。使用できる文字は英語のみであり、日本語（半角カタカナ含む）は使用できません。
ファイル名ベースおよびファイル名の拡張子	ファイルの基本名に（トレース ファイルが作成された順序を示す）数値インデックスを付けて、トレース ファイル名を作成する場合に、これらの値を使用する。 たとえば、［ファイル名ベース］フィールドに jtapiTrace と入力し、［ファイル名の拡張子］フィールドに log と入力する場合、トレース ファイルは、jtapiTrace01.log、jtapiTrace02.log ～ jtapiTrace10.log 間を循環します。［ファイル名ベース］フィールドおよび［ファイル名の拡張子］フィールドがブランクのままである場合、Cisco JTAPI は、トレース ファイル名を CiscoJtapi01.log、CiscoJtapi02.log などにします。使用できる文字は英語のみであり、日本語（半角カタカナ含む）は使用できません。

Cisco CallManager

図3 では、Cisco JTAPI Preferences アプリケーションの Cisco CallManager タブを示しています。

図3 CallManager タブ

 

このタブでは、Cisco CallManager のリストを定義しておくことが可能です。その定義により、JTAPI アプリケーションが、オプションの Cisco CallManager の接続性をユーザに提供できるようになります。

詳細設定

図4 では、Cisco JTAPI Preferences アプリケーションの［詳細設定］タブを示しています。

図4 ［詳細設定］タブ

 

Cisco JTAPI Preferences アプリケーションで［詳細設定］タブを使用して、 表 2 内のパラメータを設定できます。トラブルシューティングとデバッグのためだけに、これらの低レベルのパラメータが必要になる場合があります。

---

（注） Cisco Technical Assistance Center（TAC）からの特別な指示がある場合を除いて、表 2 のパラメータを変更しないようにお勧めします。

---

 

表 2 詳細設定の設定フィールド

フィールド	説明
定期ウェイクアップを有効にする	このオプションを使用すると、JTAPI が使用する内部メッセージ待ち行列内のハートビートを有効にする。この設定値は、［定期ウェイクアップインターバル（秒）］で指定された時間内にメッセージを受信しなかった場合に、スレッドをウェークアップさせ、イベントのログを作成します。このチェックボックスはデフォルトではオフになっています。
定期ウェイクアップインターバル（秒）	この設定値により、JTAPI 内部メッセージ スレッド内で非活動時間を指定できる。JTAPI がこの時間内にメッセージを受信しなかった場合、スレッドがウェークアップし、イベントをログに記録します。デフォルトは 50 秒です。
キューの統計を有効にする	このオプションを使用すると、指定メッセージ数ごとに、JTAPI メイン イベント スレッドに対して待ち行列に入れられる最大待ち行列項目数を、JTAPI にログ記録させる。つまり、x 個のメッセージが処理されるごとに、JTAPI は、その時間間隔で最大待ち行列項目数を報告する DEBUGGING レベル トレースをログに記録します。ここで、x は、［キューサイズしきい値］で指定されたメッセージ数です。このチェックボックスはデフォルトではオフになっています。
キューサイズしきい値	この設定値により、JTAPI が最大待ち行列項目数を報告する時間を定義する、メッセージ数を指定できる。デフォルトは 25 個のメッセージです。
CTI 要求のタイムアウト（秒）	この設定値は、JTAPI が、CTI 要求からの応答を待つ時間を秒数で指定する。デフォルトは 15 秒です。
Provider オープン要求タイムアウト（秒）	この設定値は、JTAPI が、Provider オープン要求に対する応答を待つ時間を、秒数で指定する。デフォルトは 30 秒です。
Provider 再試行インターバル（秒）	この設定値は、システムに障害が起きたときに、JTAPI が Cisco CallManager クラスタとの接続のオープンを再試行する時間を、秒数で指定する。デフォルトは 30 秒です。
サーバ ハートビート インターバル（秒）	この設定値は、JTAPI と Cisco CallManager クラスタ間の接続が作動状態であることを確認する頻度を、秒数で指定する。ハートビートを受信できない場合、JTAPI は、Provider オープン要求（秒）で指定された 2 番目の CTIManager を介して、接続を確立します。
ルート選択のタイムアウト（ミリ秒）	この設定値は、アプリケーションが Route イベントに応答するのを JTAPI が待つ時間を、ミリ秒単位で指定する。アプリケーションがこの時間内に応答しない場合、JTAPI は、そのルートを終了し、対応する RouteEnd イベントを送信します。

Microsoft 以外の環境の JTAPI Preferences

Microsoft 以外の環境では、jtapi.ini ファイルを手動で作成し、CLASSPATH に入れる必要があります。次のリストは、サンプル値と共にパラメータ名を示しています。

JTAPI アプリケーションのユーザ情報の管理

JTAPI アプリケーションでは、ユーザをディレクトリの中で管理し、1 つ以上のデバイスを制御する特権をユーザに与える必要があります。JTAPI アプリケーションを使用する前に、『Cisco CallManager アドミニストレーション ガイド』の「新規ユーザの追加」を参照して、ユーザを追加し、ユーザにデバイスを割り当てる手順を実行してください。ユーザに割り当てられるデバイスのリストは、ユーザがアプリケーションから制御する（たとえば、電話をかける、電話に応答する）必要がある電話機を表しています。

技術情報の入手方法

シスコの製品マニュアルやその他の資料は、Cisco.com でご利用いただけます。また、テクニカル サポートおよびその他のリソースを、さまざまな方法で入手することができます。ここでは、シスコ製品に関する技術情報を入手する方法について説明します。

シスコ製品のセキュリティの概要

シスコでは、オンラインの Security Vulnerability Policy ポータル（英文のみ）を無料で提供しています。URL は次のとおりです。

http://www.cisco.com/en/US/products/products_security_vulnerability_policy.html

このサイトは、次の目的に利用できます。

• シスコ製品のセキュリティ脆弱性を報告する

• シスコ製品に伴うセキュリティ事象についてサポートを受ける

• シスコからセキュリティ情報を受け取るための登録をする

シスコ製品に関するセキュリティ勧告および注意事項の最新のリストには、次の URL からアクセスできます。

http://www.cisco.com/go/psirt

勧告および注意事項がアップデートされた時点でリアルタイムに確認する場合は、次の URL から Product Security Incident Response Team Really Simple Syndication（PSIRT RSS）フィードにアクセスしてください。

http://www.cisco.com/en/US/products/products_psirt_rss_feed.html

シスコ製品のセキュリティ問題の報告

シスコでは、セキュアな製品を提供すべく全力を尽くしています。製品のリリース前には内部でテストを行い、すべての脆弱性を早急に修正するよう努力しています。万一、シスコ製品に脆弱性が見つかった場合は、PSIRT にご連絡ください。

• 緊急の場合 ： security-alert@cisco.com （英語のみ）

• 緊急でない場合 ： psirt@cisco.com （英語のみ）

---

ヒント シスコに機密情報をお送りいただく際には、PGP（Pretty Good Privacy）または互換製品を使用して、暗号化することをお勧めします。PSIRT は、PGP バージョン 2.x から 8.x と互換性のある暗号化情報に対応しています。

無効になった、または有効期限が切れた暗号キーは、絶対に使用しないでください。PSIRT に連絡する際に使用する正しい公開キーは、次の公開キー サーバのリストで作成日が最新のキーです。

http://pgp.mit.edu:11371/pks/lookup?search=psirt%40cisco.com&op=index&exact=on

---

 

緊急の場合は、電話で PSIRT に連絡することもできます。

• 1 877 228-7302（英語のみ）

• 1 408 525-6532（英語のみ）

テクニカル サポート

シスコと正式なサービス契約を交わしているすべてのお客様、パートナー、および代理店は、Cisco Technical Support で 24 時間テクニカル サポートを利用することができます。Cisco.com の Cisco Technical Support Web サイトでは、多数のサポート リソースをオンラインで提供しています。また、Cisco Technical Assistance Center（TAC）のエンジニアが電話でのサポートにも対応します。シスコと正式なサービス契約を交わしていない場合は、代理店にお問い合せください。

Cisco Technical Support Web サイト

Cisco Technical Support Web サイトでは、シスコ製品やシスコの技術に関するトラブルシューティングにお役立ていただけるように、オンラインでマニュアルやツールを提供しています。この Web サイトは、24 時間 365 日、いつでも利用可能です。URL は次のとおりです。

http://www.cisco.com/techsupport

Cisco Technical Support Web サイトのツールにアクセスするには、Cisco.com のユーザ ID とパスワードが必要です。サービス契約が有効で、ユーザ ID またはパスワードを取得していない場合は、次の URL にアクセスして登録手続きを行ってください。

http://tools.cisco.com/RPF/register/register.do

---

（注） Web または電話でサービス リクエストを発行する前に、Cisco Product Identification（CPI）ツールを使用して製品のシリアル番号を確認してください。CPI ツールには、Cisco Technical Support Web サイトから、Documentation & Tools の下の Tools & Resources リンクをクリックするとアクセスできます。アルファベット順の索引ドロップダウン リストから Cisco Product Identification Tool を選択するか、Alerts & RMAs の下の Cisco Product Identification Tool リンクをクリックします。CPI ツールには、3 つの検索オプションがあります。製品 ID またはモデル名による検索、ツリー表示による検索、show コマンド出力のコピー アンド ペーストによる特定製品の検索です。検索結果では、製品が図示され、シリアル番号ラベルの位置が強調表示されます。ご使用の製品でシリアル番号ラベルを確認し、その情報を記録してからサービス コールをかけてください。

---

その他の資料および情報の入手方法

シスコの製品、テクノロジー、およびネットワーク ソリューションに関する情報について、さまざまな資料をオンラインおよび印刷物で入手できます。

• Cisco Marketplace では、シスコの書籍やリファレンス ガイド、ロゴ製品を数多く提供しています。購入を希望される場合は、次の URL にアクセスしてください。

http://www.cisco.com/go/marketplace/

• Cisco Press では、ネットワーキング全般、トレーニング、および認定資格に関する書籍を広範囲にわたって出版しています。これらの出版物は、初級者にも上級者にも役立ちます。Cisco Press の最新の出版物やその他の情報を調べるには、次の URL から Cisco Press にアクセスしてください。

http://www.ciscopress.com

• 『 Packet 』はシスコシステムズが発行する技術者向けの雑誌で、インターネットやネットワーキングへの投資を効果的に活用するために役立ちます。本誌は季刊誌として発行され、業界の最先端トレンド、最新テクノロジー、シスコ製品やソリューション情報が記載されています。また、ネットワーク構成およびトラブルシューティングに関するヒント、コンフィギュレーション例、カスタマー ケース スタディ、認定情報とトレーニング情報、および充実したオンライン サービスへのリンクの内容が含まれます。『Packet』には、次の URL からアクセスしてください。

http://www.cisco.com/packet

日本語版『Packet』は、米国版『Packet』と日本版のオリジナル記事で構成されています。日本語版『Packet』には、次の URL からアクセスしてください。

http://www.cisco.com/japanese/warp/public/3/jp/news/packet/

• 『 iQ Magazine 』はシスコシステムズの季刊誌で、成長企業が収益を上げ、業務を効率化し、サービスを拡大するためには技術をどのように利用したらよいかを学べるように構成されています。本誌では、実例とビジネス戦略を挙げて、成長企業が直面する問題とそれを解決するための技術を紹介し、読者が技術への投資に関して適切な決定を下せるよう配慮しています。『iQ Magazine』には、次の URL からアクセスしてください。

http://www.cisco.com/go/iqmagazine

• 『 Internet Protocol Journal 』はシスコシステムズの季刊誌で、パブリック/プライベートなインターネットとイントラネットを設計、開発、および運用するエンジニアリングのプロフェッショナルを対象としています。『Internet Protocol Journal』には、次の URL からアクセスしてください。

http://www.cisco.com/ipj

• シスコは、国際的なレベルのネットワーク関連トレーニングを実施しています。トレーニングの最新情報については、次の URL からアクセスしてください。

http://www.cisco.com/en/US/learning/index.html