Cisco JTAPI インストレーション ガイド for Cisco CallManager 4.0

Cisco JTAPI インストレーション ガイド for Cisco CallManager 4.0

---

ここでは、Cisco CallManager 4.0 への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（jtprefs.exe）をインストール。

• 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 を使用するには、Microsoft Java Virtual Machine 5.00.3190 以降が必要です。JTPrefs については、「Cisco JTAPI トレースの設定」を参照してください。

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

Jview CiscoJtapiVersion

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

Jview 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 のバージョンを持つ応答を受信することができます。アプリケーションは、サーバから入手可能なバージョンとアプリケーション クラスパス内のローカルのバージョンとを比較し、アップグレードが必要かどうかを判断します。

アプリケーションは、updater 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 アプリケーション（JTPREFS.EXE）を使用して、トレース レベルとトレース宛先を設定します。デフォルトでは、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 アプリケーションの［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 Technical Assistance Center（TAC）の 24 時間テクニカル サポートを、オンラインと電話でご利用いただけます。Cisco.com は、オンラインのテクニカル サポートの最初の窓口として、Cisco TAC Web サイトを運営しています。シスコと正式なサービス契約を交わしていない場合は、リセラーにお問い合せください。

Developer Support

Developer Support Program は、シスコシステムズのインターフェイスを使用したサポート（正式に承認済み）を提供しています。このサポートによって、開発者、カスタマー、パートナーは、Cisco Service Provider ソリューション エコシステムおよび Cisco AVVID Partner プログラムを使用して、業務に対応したソリューションをいち早く決定することができます。

製品技術に関する専門用語を調査する手段として、Developer Support のエンジニアに尋ねる方法があります。Developer Support のエンジニアは、必要なリソースに直接アクセスして、専門的なサポートをタイムリーに提供します。

このプログラムの詳細については、次のURL にあるDeveloper Support ProgramのWeb サイトを参照してください。
www.cisco.com/go/developersupport/（英語）

www.cisco.com/jp/go/dsp/（日本語）

Cisco JTAPI Development を使用している開発者には、Cisco Developer Support Program への加入を推奨しています。この新しいプログラムは、シスコ インターフェイスをプロジェクト推進に活用できる一方で、常に一定レベルのサポートを提供します。

---

（注） Cisco Technical Assistance Center（TAC）は、Cisco JTAPI Development をサポートしていません。サポート対象は、Cisco AVVID installation/configuration および Cisco-developed application です。Developer Support Program に関する詳細は、developer-support@cisco.com 宛てにシスコまでご連絡ください（英語）。

---

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

シスコの製品、技術、およびネットワーク ソリューションに関する情報は、各種オンラインで、また、出版物として入手できます。

• Cisco Product Catalog は、シスコシステムズが提供するネットワーク製品とその発注方法、およびカスタマー サポート サービスについて説明しています。Cisco Product Catalog には、次の URL からアクセスしてください。

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

• Cisco Press は、ネットワーク、トレーニングおよび認定資格に関する書籍を広範囲にわたって出版しています。初心者のユーザおよび熟練したユーザに、次の書籍をお勧めします。現行の Cisco Press の発行書籍とその他の情報は、次の URL で Cisco Press online から参照できます。

http://www.ciscopress.com

• 『Packet』は、シスコが 3 ヶ月に 1 回発行している出版物です。ネットワーク分野の最新動向、技術的な進展、シスコ製品、およびソリューションを提供することで、業界のプロフェッショナルがネットワーク事業への投資を最大限に活かすための情報を記載しています。これには、ネットワークの配置、トラブルシューティングのヒント、コンフィギュレーション例、お客様のケース スタディ、チュートリアルとトレーニング、認定資格情報、および詳細なオンライン リソースへの数多くのリンクが含まれています。『Packet』は、次の URL で参照いただけます。

http://www.cisco.com/packet

• 『iQ Magazine』は、シスコが 2 ヶ月に 1 回発行している出版物で、インターネット ビジネス戦略に関する最新情報を企業の経営者に提供しています。『iQ Magazine』には、次の URL からアクセスできます。

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

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

http://www.cisco.com/en/US/about/ac123/ac147/about_cisco_the_internet_protocol_journal.html

• トレーニング：ネットワーキングの高水準なトレーニングを提供しています。ネットワーク トレーニングの最新内容は、次の URL で参照できます。

http://www.cisco.com/en/US/learning/le31/learning_learning_resources_home.html