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

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

2015 年 11 月 26 日 - 機械翻訳について
その他のバージョン: PDFpdf | ライター翻訳版 (2003 年 3 月 27 日) | 英語版 (2015 年 8 月 22 日) | フィードバック


目次


概要

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

トラブルシューティング プロセスを開始する前に、使用するソフトウェア バージョンが互換性があることを確認して下さい。 互換性を確認するために使用する Cisco Unified CallManager のバージョンに関する Cisco CallManager リリース メモを参照して下さい。

servername が CRA が AppAdminページにログインするためにインストールされているサーバの名前である CRA のバージョンをチェックするために http:// servername を/appadmin をタイプして下さい。 メイン メニューの右下隅に、現在のバージョンが表示されます。

前提条件

要件

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

使用するコンポーネント

このドキュメントの情報は、次のソフトウェアのバージョンに基づくものです。

  • Cisco CallManager 3.1(3a)spC

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

このドキュメントの情報は、特定のラボ環境にあるデバイスに基づいて作成されたものです。 このドキュメントで使用するすべてのデバイスは、クリアな(デフォルト)設定で作業を開始しています。 ネットワークが稼働中の場合は、コマンドが及ぼす潜在的な影響を十分に理解しておく必要があります。

表記法

ドキュメント表記の詳細は、『シスコ テクニカル ティップスの表記法』を参照してください。

用語

これらの用語はこの資料の全体にわたって使用されます:

  • JTAPI user — AppAdminページの JTAPI コンフィギュレーションセクションで定義されるユーザ

  • RM user — AppAdminページのリソースマネージャ コンフィギュレーションセクションで定義されるユーザ

  • CTI ポート— Cisco Unified CallManager で作成されるデバイス。 CTI ポートは CRA プラットフォームによって呼び出しおよび演劇プロンプトを並べるために使用されます。 1 つの CTI ポートは CRA サーバに接続される各発信者のために使用されます。

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

  • Cisco Unified CallManager で作成された Cisco Unified CallManager user — A ユーザ。

  • 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』 を選択 して下さい。

    トレースファイルを表示するために、ページの左側のトレースファイル リンクを選択しましたり、そして適切なトレースファイルを選択します。

JTAPIサブシステムは out_of_service です

この問題を解決するとき、最初にトレースファイルの例外を見つける必要があります。 トレースファイルの例外を見つけるために使用できる少数の異なるキーワードがあります。 これらのキーワードのための検索。 障害が発生する最も一般的な原因が一覧表示されています。

トレースファイルの例外を見つける方法

トレースファイルの例外を見つけるためにこれらのステップを完了して下さい:

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

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

  3. トレースファイルのこれらのキーワードを捜して下さい:

MIVR-SS-TEL-4-ModuleRunTimeFailure か MIVR-GENERIC-4-EXCEPTION

トレース ファイルで、「MIVR-SS_TEL-1-ModuleRunTimeFailure」という文字列を検索します。 その行の最後に、例外が発生した理由が示されています。 これらはもっとも一般的な原因です。

プロバイダを作成することが不可能 ---- bad login or password

原因

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

解決策

ユーザ名とパスワードが正しいことを確認します。 Cisco Unified CallManager が正しく認証できることを確認するため CCMuser ページ(Cisco Unified CallManager の 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.

プロバイダを作成することが不可能 ---- 接続は拒否されました

原因

Cisco Unified CallManager への JTAPI 接続は Cisco Unified CallManager によって拒否されます。

解決策

  • JTAPI ユーザネームおよびパスワードの Cisco Unified CallManager の CCMUser にログイン正常にできることを確かめて下さい。

  • CTI マネージャ サービスが Cisco Unified CallManager コントロール センターで動作することを確認して下さい。

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

%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

プロバイダを作成することが不可能 ---- login=

原因

何も JTAPI 設定 ページで設定されません。

解決策

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=

または

MIVR-GENERIC-4-EXCEPTION:com.cisco.jtapi.PlatformExceptionImpl: 
Unable to create provider-- login=_1: login=_1

プロバイダを作成することが不可能 ---- hostname

原因

CRA エンジンは Cisco Unified 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

プロバイダを作成することが不可能 ---- Operation timed out

原因

CRA エンジンに Cisco Unified CallManager との IP接続がありません。

解決策

CRA サーバで、JTAPI プロバイダーに設定されている IP アドレスを確認します。 CRA サーバおよび Cisco Unified CallManager のデフォルトゲートウェイ設定をチェックして下さい。 IP ルーティングの問題が存在しないことを確認します。 接続をテストするために CRA サーバから Cisco Unified 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

プロバイダを作成することが不可能 ---- null

原因

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

解決策

JTAPI の設定で、ホスト名または IP アドレスが設定されていることを確認します。 JTAPIバージョンが不正確である場合、JTAPI クライアントを Cisco Unified CallManager プラグイン ページからダウンロードし、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 サーバは Cisco Unified CallManager と通信できますが JTAPI によって CTI ポートか CTI ルートポイントを初期化することができません。 CTI ポートおよび CTI ルート ポイントが、JTAPI ユーザと関連付けられていない場合に、このエラーが発生します。

解決策

Cisco Unified 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

MIVR-SS_TEL-7-UNK

原因

このエラーメッセージは壊れるコーデック インストールを示します。

解決策

  1. HKEY_LOCAL_MACHINE \ソフトウェア\シスコシステムズでレジストリを、株式会社\ CRS \ Properties \ application.MIVR.properties.com.ci sco.dialog.codec = G711ULAW64K,G711ALAW64K チェックして下さい

  2. そうでそこにない場合、コーデック G711 次を前例追加して下さい。

  3. Start > Programs > Administrative Tools からの CRS Node Manager サービスを再開して下さい。

注: これらのステップが完了した後 JTAPIサブシステムがサービスに入って来なければ、CRS はアンインストールされ、再インストールされる必要があります。

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

JTAPI-JTAPI-7-UNK:[XXX_1393]CiscoRegistrationExceptionImpl
caught: At least one media capability must be specified

JTAPIサブシステムは partial_service にあります

この問題を解決するとき、最初にトレースファイルの例外を見つける必要があります。 トレースファイルの例外を見つけるために使用できる少数の異なるキーワードがあります。 これらのキーワードのための検索。 障害が発生する最も一般的な原因が一覧表示されています。

キーワードの検索

キーワードを捜すためにこれらのステップを完了して下さい:

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

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

  3. トレースファイルにリストされているキーワードを捜して下さい:

MIVR-SS_TEL-3-UNABLE_REGISTER_CTIPORT

原因

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

解決策

トレースのエラーメッセージはどの CTI ポートかルート ポイントが初期化されることができなかったか告げます。 ことを Cisco CallManager設定で存在 するこのデバイス確認しまた Cisco Unified 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.

MIVR-SS_TEL-2-SS_PARTIAL_SERVICE

原因

この問題は CTI ポートにおいての問題があるとき発生する場合があります。

解決策

Unassociate は JTAPI ユーザからのすべてのデバイスを再び対応づけ。 それから、CRS エンジンおよび Cisco CallManager サーバを再起動して下さい。

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

%MIVR-SS_TEL-2-SS_PARTIAL_SERVICE:JTAPI subsystem in partial service: 
Failure reason=A number of route points are OOS - TR[num=8490], TR[num=8550],TR[num=8566]

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

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


関連情報


Document ID: 21972