Cisco JTAPI インストレーション ガイド for Cisco CallManager 3.3
目次
Microsoft 以外の環境の JTAPI Preferences
TAC（Technical Assistance Center）
Cisco JTAPI インストレーション ガイド
for Cisco CallManager 3.3
このマニュアルでは、Cisco CallManager 3.3 へのCisco Java Telephony API（JTAPI）クライアント ソフトウェアのインストールおよび設定方法を説明します。
概要
Cisco Java Telephony API（JTAPI）の実装では、JTAPI アプリケーションを実行するすべてのクライアント マシン上にある Java クラスを包含しています。アプリケーションを正しく機能させるには、事前に Cisco JTAPI をインストールしておく必要があります。Cisco CallManager 上であるか、あるいは別のマシン上であるかに関係なく、JTAPI アプリケーションが実行される場所に、Cisco JTAPI クラスがインストールされていることを確認してください。インストレーションには、5 MB のローカル ディスク スペースが必要です。
（注） Cisco CallManager を 3.3 にアップグレード済みである場合は、JTAPI アプリケーションがインストールされているすべてのアプリケーション サーバまたはクライアント ワークステーション上で、JTAPI クライアント ソフトウェアのアップグレードが必要です。JTAPI クライアントをアップグレードしないと、アプリケーションの初期化に失敗します。アップグレード作業をする場合は、Cisco CallManager Administration から適切なクライアントをダウンロードしてください（「Cisco JTAPI ソフトウェアのインストレーション」を参照）。
アップグレードされた JTAPI クライアント ソフトウェアは、旧リリースの Cisco CallManager 上では動作しません。
Cisco JTAPI ソフトウェアのインストレーション
Cisco JTAPI インストレーション ユーティリティは、ローカル ディスク ドライブに次のソフトウェアをインストールします。
•
%SystemRoot%\java\lib に JTAPI java jar ファイルをインストール。
• Program Files\JTAPITools に JTAPI Preferences (jtprefs.exe) をインストール。
• Program Files\JTAPITools に JTAPI サンプル アプリケーション (makecall, jtrace) をインストール。
• Program Files\JTAPITools\doc に JTAPI ドキュメントをインストール。
• Program Files\JTAPITools\Locale_files、\Program File\JTAPITools\LanguageName.properties に JTAPI 言語関連ファイルをインストール。
• %SystemRoot%\java\lib に JTAPILocaleProperties.ini をインストール。
（注） 複数の JTAPI アプリケーションを実行するには、Java 1.1 対応環境（たとえば、Sun JDK 1.1.x、JDK 1.2、 または Microsoft Virtual Machine（Internet Explorer 4.0 以上にバンドルされている）が必要です。Cisco JTAPI は、Sun JDK1.2 および Sun JDK 1.3 でも動作します。
しかし、Cisco JTAPI で JTPREFS を使用するには、Microsoft Java Virtual Machine 5.00.3190 以降が必要です。JTPrefs については、「Cisco JTAPI トレースの設定」を参照してください。
Cisco JTAPI のインストールは、Windows 2000 プラットフォームおよび Windows NT プラットフォームでサポートされています。
Cisco JTAPI ソフトウェアをインストールする手順は、次のとおりです。
ステップ 1 Cisco JTAPI クライアント ソフトウェアをインストールするコンピュータに、ログインします。
ステップ 2 すべての Windows プログラムを閉じます。
ステップ 4 次の Cisco CallManager administration ウィンドウに進みます。
http:// Name /CCMAdmin/main.asp
Name には、Cisco CallManager の名前または IP アドレスを指定します。
ステップ 5 Application > Install Plugins の順に選択します。
JTAPI インストール プログラムが起動したら、インストール言語を選択するように求められます。インストールは、選択した言語で続行します。
（注） インストレーション ソフトウェアが指示するデフォルト ドライブに、Cisco JTAPI ソフトウェアをインストールしてください。たとえば、Windows NT が C:\WINNT にインストールされている場合のデフォルト ディレクトリは、C:\WINNT\Java\lib です。
インストレーションの検証
JTAPI のインストレーションを検証するには、JTAPI を経由してコールを発信できる makecall アプリケーションを使用します。makecall アプリケーションを使用する手順は、次のとおりです。
ステップ 1 Windows NT コマンド行から、Cisco JTAPI Tools をインストールしたディレクトリまで移動します。デフォルトでは、このディレクトリは Program Files\JTAPITools です。
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 とパスワードを使用します。
Cisco JTAPI トレースの設定
Cisco JTAPI tracing preferences アプリケーション（JTPREFS.EXE）を使用して、トレース レベルとトレース宛先を設定します。デフォルトでは、Cisco JTAPI Preferences は、Program Files\JTAPITools ディレクトリ ユーティリティにインストールされます。Cisco JTAPI Preferences ユーティリティを開くには、 ［スタート］ >［プログラム］ > Cisco JTAPI > JTAPI Preferences の順に選択してください。
この項では、Cisco JTAPI preferences アプリケーションの使用法を説明します。構成は、次のとおりです。
• 「ログ先」
• 「詳細設定」
• 「言語」
トレース レベル
図1 では、Cisco JTAPI Preferences アプリケーションの［トレース レベル］ タブを示しています。このウィンドウのタイトルには、JTAPI バージョン番号が表示されます。
［トレース レベル］ タブでは、次の JTAPI トレース レベルを使用可能または使用不可にすることができます。
次のリストで記述されているように、デバッグ レベル ウィンドウでその他のデバッグ レベルを使用可能にしたり、使用不可にしたりすることができます。
• JTAPI デバッグ：JTAPI 方式とイベントのトレース
• JTAPIIMPL デバッグ：内部 JTAPI インプリメンテーションのトレース
• CTI デバッグ：JTAPI インプリメンテーションに送信される Cisco CallManager イベントのトレース
• CTIIMPL デバッグ：内部 CTICLIENT インプリメンテーションのトレース
ログ先
図2 では、Cisco JTAPI Preferences アプリケーションの［ログ先］ タブを示しています。
［ログ先］ タブでは、JTAPI がトレースを作成する方法、およびトレースが保存される方法を設定できます。 表 1 では、ログ先フィールドの説明をします。
Cisco CallManager
図3 では、Cisco JTAPI Preferences アプリケーションの Cisco CallManager タブを示しています。
このタブでは、Cisco CallManager のリストを定義しておくことが可能です。その定義により、JTAPI アプリケーションが、オプションの Cisco CallManager の接続性をユーザに提供できるようになります。
詳細設定
図4 では、Cisco JTAPI Preferences アプリケーションの［詳細設定］ タブを示しています。
Cisco JTAPI Preferences アプリケーションで［詳細設定］ タブを使用して、 表 2 内のパラメータを設定できます。トラブルシューティングとデバッグのためだけに、これらの低レベルのパラメータが必要になる場合があります。
（注） シスコ代理店からの特別な指示がある場合を除いて、表 2 のパラメータを変更しないようにお勧めします。
言語
図5 では、Cisco JTAPI Preferences アプリケーションの 言語 タブを示しています。［言語］ タブで、サポートされる言語の中からプルダウン メニューで言語を選択します。現在は、英語、フランス語、ドイツ語および日本語など、14 ヶ国語がサポートされています。
Microsoft 以外の環境の JTAPI Preferences
Microsoft 以外の環境では、jtapi.ini ファイルを手作業で作成し、CLASSPATH に入れる必要があります。次のリストは、サンプル値と共にパラメータ名を示しています。
（注） 注意：jtapi.ini ファイルは、jview CiscoJtapiVersion -parms または java CiscoJtapiVersion-parms と入力することで生成されます。この操作によって、現在の CiscoJTAPI バージョンの .ini パラメータを表示し、jtapi.ini ファイルへコピーできます。（ファイルは、複数の jtapi.ini ファイルが生成されてしまい通常のアプリケーションの起動に影響を与えることを避けるため、自動的には生成されません。
JTAPI アプリケーションのユーザ情報の管理
JTAPI アプリケーションでは、ユーザをディレクトリの中で管理し、1 つ以上のデバイスを制御する特権をユーザに与える必要があります。JTAPI アプリケーションを使用する前に、「新しいユーザの追加」の項を参照して、ユーザを追加し、ユーザにデバイスを割り当てる手順を実行してください。ユーザに割り当てられるデバイスのリストは、ユーザがアプリケーションから制御する（たとえば、電話をかける、電話に応答する）必要がある電話機を表しています。
マニュアルの入手
Documentation CD-ROM
シスコのマニュアルおよびその他の資料は、製品に付属している Cisco Documentation CD-ROM パッケージでご利用いただけます。Documentation CD-ROM は毎月更新されるので、印刷資料よりも新しい情報が得られます。この CD-ROM パッケージは、1 つのパッケージごとでも、年間契約という形でもご利用いただけます。
マニュアルの発注方法
• Cisco.com 登録ユーザ（シスコの直接顧客）は、Networking Products MarketPlace からシスコ製品のマニュアルを発注できます。
http://www.cisco.com/en/US/partner/ordering/index.shtml
• Cisco.com 登録ユーザの場合、Subscription Store からオンラインで Documentation CD-ROM を発注できます。
テクニカル サポート
シスコでは、技術上のあらゆる問題の最初の窓口として Cisco.com を運営しています。お客様およびパートナーはオンライン ツールからマニュアル、トラブルシューティングに関するヒント、およびコンフィギュレーション例を入手できます。Cisco.com にご登録済みのお客様は、TAC の Web サイトにあるテクニカル サポートにアクセスできます。
Cisco.com
Cisco.com は、いつでもどこからでも、シスコの情報やリソースにアクセスできる対話形式のネットワーク サービスです。
優れた、使いやすい統合インターネット アプリケーションにより、シスコ製品を次のような形でより一層有効にご活用いただけます。
• オンライン テクニカル サポートによる技術上の問題の解決
• オンラインでの技術査定、トレーニング、認定プログラムへの登録
Cisco.com に登録されると、各ユーザに合った情報やサービスをご利用いただくことができます。Cisco.com には、次の URL からアクセスしてください。
TAC（Technical Assistance Center）
Cisco TAC では、すべてのお客様が、シスコ製品または技術についてのテクニカル サポートを受けることができます。Cisco TAC Web サイトと Cisco TAC Escalation センターの 2 タイプのサポートが提供されます。
Cisco TAC inquires は、問題の緊急性の度合いによって分類されます。
• 優先レベル 4（P4）：シスコ製品の機能、インストレーション、基本的なコンフィギュレーションについて、情報または支援が必要である。
• 優先レベル 3（P3）：ネットワークのパフォーマンスが低下した。ネットワークは十分に機能していないが、ほとんどの業務運用を継続できる。
• 優先レベル 2（P2）：ネットワークのパフォーマンスが著しく低下したため、業務に大きな影響がある。対応策が見つからない。
• 優先レベル 1（P1）：ネットワークがダウンし、すぐにサービスを回復しなければ業務に致命的な損害が発生する。対応策が見つからない。
不具合の優先レベルとお客様が加入されたサービス契約の条件に基づいて、シスコ製品または技術についてのテクニカル サポートを受けることができます。
Cisco TAC Web サイト
Cisco TAC の Web サイトでは、ユーザは P3 および P4 レベルの問題をユーザ自身で解決でき、費用と時間を節約することができます。このサイトでは、オンライン ツール、知識ベース、ソフトウェアに 24 時間アクセスできます。Cisco TAC Web サイトには、次の URL からアクセスしてください。
シスコと正式なサービス契約を交わしているすべてのお客様、パートナー、および代理店は、Cisco TAC Web サイトのテクニカル サポートをご利用いただけます。Cisco TAC Web サイトへのアクセスには、Cisco.com のログイン ID とパスワードが必要です。ログイン ID とパスワードを取得されていない場合は、次の URL にアクセスして登録手続きを行ってください。
http://www.cisco.com/register/
Cisco.com 登録ユーザは、TAC Web サイトで技術上の問題を解決できなかった場合、TAC Case Open ツールのオンライン サービスをご利用いただけます。TAC Case Open ツールの URL は次の通りです。
http://www.cisco.com/tac/caseopen
インターネットからのアクセスの場合は、Cisco TAC Web サイトから、P3 および P4 に対応したサイトの利用をお勧めします。
Japan TAC Web サイト
Japan TAC Web サイトでは、利用頻度の高い TAC Web サイト（http://www.cisco.com/tac）のドキュメントを日本語で提供し ています。Japan TAC Web サイトには、次の URL からアクセスし てください。
http://www.cisco.com/jp/go/tac
サポート契約を結んでいない方は、「ゲスト」としてご登録いただくだけで、Japan TAC Web サイトのドキュメントにアクセスできます。Japan TAC Web サイトにアクセスするには、Cisco.com のログイン ID とパスワードが必要です。ログイン ID とパスワードを取得してい ない場合は、次の URL にアクセスして登録手続きを行ってください。
Cisco TAC Escalation センター
Cisco TAC Escalation Center では、P1 から P2 に該当する問題を取り扱います。P 1 と P2 は、重大なネットワークの性能低下がビジネスの遂行に著しく影響する場合に割り当てられます。TAC Escalation センターに P1 または P2 レベルのご相談をした場合、Cisco TAC の担当者は、すぐに関連する Web サイトを開きます。
TAC フリーダイヤルの国別番号へは、次の URL からアクセスしてください。
http://www.cisco.com/warp/public/687/Directory/DirTAC.shtml
電話で問い合せる前に、お客様のネットワーク管理センターへ連絡して、シスコが御社へ提供できるサービスのレベル（SMARTnet、SMARTnet Onsite、Network Supported Accounts など）を確定してください。お電話の場合は、有効なサービス契約番号と製品のシリアル番号をお手元にご用意ください。
フィードバック