音声とユニファイド コミュニケーション : Cisco Unified Communications Manager(CallManager)

JTAPI サブシステムの起動に関する問題のトラブルシューティング

2003 年 3 月 27 日 - ライター翻訳版
その他のバージョン: PDFpdf | 機械翻訳版 (2013 年 8 月 21 日) | 英語版 (2007 年 5 月 15 日) | フィードバック

目次

概要
はじめに
     表記法
     前提条件
     使用するコンポーネント
     用語
スタートアップ ガイド
     トレースの有効化
JTAPI サブシステムが OUT OF SERVICE である場合
     トレース ファイルでの例外の検索
     MIVR-SS-TEL-4-ModuleRunTimeFailure
     MIVR-SS_TEL-1-ModuleRunTimeFailure
JTAPI サブシステムが PARTIAL_SERVICE 状態である場合
     キーワードの検索
     MIVR-SS_TEL-3-UNABLE_REGISTER_CTIPORT
関連するシスコ サポート コミュニティ ディスカッション
関連情報

概要

JTAPI(Java Telephony API)サブシステムは、Cisco Customer Response Application(CRA)プラットフォームの非常に重要なコンポーネントです。JTAPI は、CallManager との通信を行うコンポーネントで、テレフォニー コール制御を担当します。CRA プラットフォームは、Cisco AutoAttendant、Cisco IP ICD、Cisco IP-IVR などのテレフォニー アプリケーションをホストします。この文書は、これらのうち特定のアプリケーションが対象ではありません。JTAPI サブシステムは、これらすべてのアプリケーションにより使用されるベース コンポーネントです。

トラブルシューティング プロセスを開始する前に、使用中のソフトウェアのバージョンの互換性を確認してください。互換性を確認するには、使用中の CallManager のバージョンの Cisco CallManager リリース ノートを参照してください。

CRA のバージョンを確認するには、「http://servername/appadmin」(servername は CRA がインストールされているサーバの名前)と入力して、AppAdmin ページにログインします。メイン メニューの右下隅に、現在のバージョンが表示されます。

はじめに

表記法

文書の表記法の詳細は、「シスコ テクニカル ティップの表記法」を参照してください。

前提条件

この文書では、ユーザがすでに CRA サーバの設定を試みたことがあると仮定しています。設定情報を使用せずに CRA を新規インストールすると、すべてのサブシステムは OUT_OF_SERVICE 状態になります。この文書では、CRA プラットフォームのコンポーネントのインストールと設定は説明しません。

使用するコンポーネント

この文書の情報は、次のソフトウェアのバージョンに基づいています。

  • Cisco CallManager 3.1(3a)spC

  • Customer Response Application バージョン 2.2(3a)

この文書の情報は、特定のラボ環境にあるデバイスに基づいて作成されています。また、この文書で使用するデバイスは、すべて初期(デフォルト)の設定で起動しています。実稼動中のネットワークで作業をしている場合、実際にコマンドを使用する前に、その潜在的な影響について理解しておく必要があります。

用語

この文書全体を通じて、次の用語を使用します。

  • JTAPI ユーザ:AppAdmin ページの JTAPI configuration セクションで定義されているユーザ。

  • RM ユーザ:AppAdmin ページの Resource Manager configuration セクションで定義されているユーザ。

  • CTI ポート:CallManager で作成されるデバイス。CRA プラットフォームでは、CTI ポートを使用してコールをキューイングし、プロンプトを再生します。CRA サーバに接続している 1 人の発信者につき、1 つの CTI ポートを使用します。

  • CTI ルート ポイント:CallManager で作成されるデバイス。CRA サーバにより使用される 1 つのテレフォニー アプリケーションにつき、1 つの CTI ルート ポイントが作成されます。

  • CallManager ユーザ:CallManager で作成されたユーザ。

  • AppAdmin ページ:CRA サーバの設定に使用される Web ページ(http://servername/appadmin)。

  • CRA サーバ:CRA アプリケーションをホストするサーバ。CRA は、Apps、eServices、Workflow Engine とも呼ばれます。

スタートアップ ガイド

この問題のトラブルシューティングを行うには、まず CRA サーバで一部のトレースを有効にする必要があります。

トレースの有効化

トレースを有効にするには、次の手順を実行します。

  1. AppAdmin ページから Engine > Trace Configuration を選択します。

  2. Debugging 列と Alarm 列で SS_TEL チェックボックスをチェックします。

  3. Update をクリックします。

    トレース ファイルを表示するには、ページの左側にある Trace Files リンクをクリックしてから、適切なトレース ファイルを選択します。

JTAPI サブシステムが OUT_OF_SERVICE である場合

この問題のトラブルシューティングを行う際には、まずトレース ファイルで例外を見つける必要があります。トレース ファイルで例外を見つけるには、数種類のキーワードを使用できます。次に示すキーワードを検索します。障害が発生する最も一般的な原因が一覧表示されています。

トレース ファイルでの例外の検索

トレース ファイルで例外を検索するには、次の手順を実行します。

  1. Engine ページから、Application Engine を停止して、起動します。

  2. 最新のトレース ファイルを開きます。

  3. トレース ファイルで、次のキーワードを検索します。

MIVR-SS-TEL-4-ModuleRunTimeFailure

トレース ファイルで、「MIVR-SS_TEL-1-ModuleRunTimeFailure」という文字列を検索します。その行の最後に、例外が発生した理由が示されています。最も可能性の高い原因を、次に示します。

Unable to create provider -- bad login or password

原因

JTAPI の設定に入力されているユーザ名またはパスワードが正しくありません。

解決策

ユーザ名とパスワードが正しいことを確認します。CallManager が正しく認証できることを確かめるために、CallManager で CCMuser ページ(http://servername/ccmuser)にログインしてみてください。

エラー メッセージの全テキスト

%MIVR-SS_TEL-4-ModuleRunTimeFailure:Real-time
 failure in JTAPI subsystem: Module=JTAPI
 Subsystem,Failure Cause=7,Failure
 Module=JTAPI_PROVIDER_INIT,
 Exception=com.cisco.jtapi.PlatformExceptionImpl:
 Unable to create provider -- bad login or password.
 %MIVR-SS_TEL-7-
 EXCEPTION:com.cisco.jtapi.PlatformExceptionImpl:
 Unable to create provider -- bad login or password.

Unable to create provider -- Connection refused

原因

CallManager への JTAPI 接続が、CallManager により拒否されました。

解決策

CallManager Control Center で、CTI Manager サービスが実行中であることを確認します。

エラー メッセージの全テキスト

%MIVR-SS_TEL-4-ModuleRunTimeFailure:Real-time
 failure in JTAPI subsystem: Module=JTAPI Subsystem,
 Failure Cause=7,Failure Module=JTAPI_PROVIDER_INIT,
 Exception=com.cisco.jtapi.PlatformExceptionImpl: Unable
 to create provider -- Connection refused
 %MIVR-SS_TEL-7-EXCEPTION:com.cisco.jtapi.PlatformExceptionImpl:
 Unable to create provider -- Connection refused

Unable to create provider -- login=

原因

JTAPI configuration ページで、設定が行われていません。

解決策

CRA サーバの JTAPI configuration ページで、JTAPI プロバイダーを設定します。

エラー メッセージの全テキスト

%MIVR-SS_TEL-4-ModuleRunTimeFailure:Real-time
 failure in JTAPI subsystem: Module=JTAPI Subsystem,
 Failure Cause=7,Failure Module=JTAPI_PROVIDER_INIT,
 Exception=com.cisco.jtapi.PlatformExceptionImpl:
 Unable to create provider -- login=
 %MIVR-SS_TEL-7-EXCEPTION:com.cisco.jtapi.PlatformExceptionImpl:
 Unable to create provider -- login=

Unable to create provider -- hostname

原因

CRA エンジンが、CallManager のホスト名を解決できません。

解決策

CRA エンジンから、DNS 解決が正しく機能していることを確認します。DNS 名の代わりに、IP アドレスを使用してみてください。

エラー メッセージの全テキスト

%M%MIVR-SS_TEL-4-ModuleRunTimeFailure:Real-time
 failure in JTAPI subsystem: Module=JTAPI Subsystem,
 Failure Cause=7,Failure Module=JTAPI_PROVIDER_INIT,
 Exception=com.cisco.jtapi.PlatformExceptionImpl:
 Unable to create provider -- dgrant-mcs7835.cisco.com
 %MIVR-SS_TEL-7-EXCEPTION:com.cisco.jtapi.PlatformExceptionImpl:
 Unable to create provider -- dgrant-mcs7835.cisco.com

Unable to create provider -- Operation timed out

原因

CRA エンジンと CallManager との IP 接続が存在しません。

解決策

CRA サーバで、JTAPI プロバイダーに設定されている IP アドレスを確認します。CRA サーバおよび CallManager でのデフォルト ゲートウェイの設定を確認します。IP ルーティングの問題が存在しないことを確認します。CRA サーバから CallManager に ping を発行して、接続をテストします。

エラー メッセージの全テキスト

101: Mar 24 11:37:42.153 PST
 %MIVR-SS_TEL-4-ModuleRunTimeFailure:Real-time
 failure in JTAPI subsystem: Module=JTAPI Subsystem,
 Failure Cause=7,Failure Module=JTAPI_PROVIDER_INIT,
 Exception=com.cisco.jtapi.PlatformExceptionImpl:
 Unable to create provider -- Operation timed out
 102: Mar 24 11:37:42.168 PST %MIVR-SS_TEL-7-EXCEPTION:
 com.cisco.jtapi.PlatformExceptionImpl:
 Unable to create provider -- Operation timed out

Unable to create provider -- null

原因

JTAPI プロバイダーの IP アドレスまたはホスト名が設定されていないか、JTAPI クライアントが正しいバージョンを使用していません。

解決策

JTAPI の設定で、ホスト名または IP アドレスが設定されていることを確認します。JTAPI のバージョンが正しくない場合は、CallManager Plugins ページから JTAPI クライアントをダウンロードし、CRA サーバにインストールします。

エラー メッセージの全テキスト

%MIVR-SS_TEL-4-ModuleRunTimeFailure:Real-time
 failure in JTAPI subsystem: Module=JTAPI Subsystem,
 Failure Cause=7,Failure Module=JTAPI_PROVIDER_INIT,
 Exception=com.cisco.jtapi.PlatformExceptionImpl:
 Unable to create provider -- null

MIVR-SS_TEL-1-ModuleRunTimeFailure

トレース ファイルで、「MIVR-SS_TEL-1-ModuleRunTimeFailure」という文字列を検索します。通常、この例外が発生するのは、JTAPI サブシステムがポートを初期化できない場合です。

原因

CRA サーバは CallManager と通信できますが、JTAPI を介して CTI ポートまたは CTI ルート ポイントを初期化することはできません。CTI ポートおよび CTI ルート ポイントが、JTAPI ユーザと関連付けられていない場合に、このエラーが発生します。

解決策

CallManager で JTAPI ユーザをチェックし、CRA サーバで設定されている CTI ポートおよび CTI ルート ポイントがユーザと関連付けられていることを確認します。

エラー メッセージの全テキスト

255: Mar 23 10:05:35.271 PST %MIVR-SS_TEL-1-ModuleRunTimeFailure:
 Real-time failure in JTAPI subsystem: Module=JTAPI Subsystem,
 Failure Cause=7,Failure Module=JTAPI_SS,Exception=null

JTAPI サブシステムが PARTIAL_SERVICE 状態である場合

この問題のトラブルシューティングを行う際には、まずトレース ファイルで例外を見つける必要があります。トレース ファイルで例外を見つけるには、数種類のキーワードを使用できます。次に示すキーワードを検索します。障害が発生する最も一般的な原因が一覧表示されています。

キーワードの検索

キーワードを検索するには、次の手順を実行します。

  1. Engine ページから、Application Engine を停止して、起動します。

  2. 最新のトレース ファイルを開きます。

  3. トレース ファイルで、次のキーワードを検索します。

MIVR-SS_TEL-3-UNABLE_REGISTER_CTIPORT

原因

JTAPI サブシステムが、1 つまたは複数の CTI ポートまたはルート ポイントを初期化できません。

解決策

トレース内のエラー メッセージには、どの CTI ポートまたはルート ポイントが初期化できなかったかが記載されています。このデバイスが CallManager の設定に存在することだけでなく、CallManager で JTAPI ユーザに関連付けられていることも確認します。

エラー メッセージの全テキスト

1683: Mar 24 11:27:51.716 PST
 %MIVR-SS_TEL-3-UNABLE_REGISTER_CTIPORT:
 Unable to register CTI Port: CTI Port=4503,
 Exception=com.cisco.jtapi.InvalidArgumentExceptionImpl:
 Address 4503 is not in provider's domain.
 1684: Mar 24 11:27:51.716 PST %MIVR-SS_TEL-7-EXCEPTION:
 com.cisco.jtapi.InvalidArgumentExceptionImpl:
 Address 4503 is not in provider's domain.
 

関連するシスコ サポート コミュニティ ディスカッション

シスコ サポート コミュニティは、どなたでも投稿や回答ができる情報交換スペースです。


関連情報


Document ID: 21972