この製品のドキュメントセットは、偏向のない言語を使用するように配慮されています。このドキュメントセットでの偏向のない言語とは、年齢、障害、性別、人種的アイデンティティ、民族的アイデンティティ、性的指向、社会経済的地位、およびインターセクショナリティに基づく差別を意味しない言語として定義されています。製品ソフトウェアのユーザインターフェイスにハードコードされている言語、RFP のドキュメントに基づいて使用されている言語、または参照されているサードパーティ製品で使用されている言語によりドキュメントに例外が存在する場合があります。シスコのインクルーシブ ランゲージの取り組みの詳細は、こちらをご覧ください。
シスコは世界中のユーザにそれぞれの言語でサポート コンテンツを提供するために、機械と人による翻訳を組み合わせて、本ドキュメントを翻訳しています。ただし、最高度の機械翻訳であっても、専門家による翻訳のような正確性は確保されません。シスコは、これら翻訳の正確性について法的責任を負いません。原典である英語版(リンクからアクセス可能)もあわせて参照することを推奨します。
Cisco Computer Telephony Integration(CTI)環境では、Cisco Interactive Call Distribution(ICD)のエージェントが Cisco Agent Desktop にログインしようとすると、ログインに失敗し、エラー メッセージが表示されます。このドキュメントでは、さまざまなエラー メッセージ、考えられる原因、および推奨処置について説明します。
このドキュメントを読む前に、次の点を確認してください。
エージェントのユーザ ID とパスワードでは大文字/小文字が区別されるため、これらの項目が正しく入力されていることを確認します。
[User Information] ページ([User] > [Global Directory])で [Enable CTI Application Use] チェックボックスがオンになっていることを確認します。
CTI サーバで CTI Manager サービスが稼働していることを確認します。
CRS エンジンが Serviceability Utility で有効にされていることを確認します。
Cisco Customer Response Solution(CRS)サーバがインストールされ、ICD と Cisco CallManager 用に設定されている必要があります。
このドキュメントの情報は、CRS バージョン 3.0.2 および Cisco Unified Contact Center Express 7.x/8.x に基づいています。
このドキュメントの情報は、特定のラボ環境にあるデバイスに基づいて作成されました。このドキュメントで使用するすべてのデバイスは、初期(デフォルト)設定の状態から起動しています。対象のネットワークが実稼働中である場合には、どのようなコマンドについても、その潜在的な影響について確実に理解しておく必要があります。
ドキュメント表記の詳細については、『シスコ テクニカル ティップスの表記法』を参照してください。
Cisco Agent Desktop へのログインに失敗したエージェントが、このエラー メッセージを受信する。
Failed to login into CTI Manager Server! Please talk to your administrator.
影響を受けているのが全ユーザであるのか、1 人のユーザであるのかを確認します。全ユーザが影響を受けている場合は、「DSBrowser.exe の編集」の項に進んでください。
この問題が 1 人のユーザに影響を与えている場合は、そのユーザから CTI Manager サーバに対してホスト名で ping できるかどうかを確認します。できない場合は、この問題の原因として DNS エラーが考えられます。Hosts ファイルを編集して、CTI Manager のホスト名と IP アドレスを追加すると、この問題は解決します。
ここでは、この問題に対する解決策について詳しく説明します。
以下の手順に従って、デバッグ トレースを有効にします。
c:\Program Files\Cisco\Desktop\config\fastcalllocal.ini ファイルで、トレース レベルを 204 に設定します。
トレース サイズを 30000000 にします(デフォルトは 300000)。
[Program Log] Path=..\log\agent.log Size=300000 [Debug Log] Path=..\log\agent.dbg Size=300000000 Level=204
この変更は、Agent Desktop のログを再有効化すると適用されます。
トレース ファイルは c:\Program Files\Cisco\Desktop\log フォルダにあります。最大ファイル サイズを超えた場合は、古いログ ファイルが c:\Program Files\Cisco\Desktop\log\old\ フォルダにコピーされます。
エージェントのログ ファイルを開き、ページの一番下までスクロールします。
CTI Manager のホスト名ではなく、IP アドレスが記録されています。CTI Manager のホスト名が記録されている場合には、次の手順を実行して、これを IP アドレスに変更してください。以下に、ログ ファイルの例を示します。
074906 02/24/2003 MAJOR FCCTI_1000 splkJtapiServerstartServerSession jtapi provider login return false 074906 02/24/2003 MAJOR FCCTI_1000 Error Return (21error in invoking Java Method) startServerSession 074906 02/24/2003 MAJOR PhoneDev PD2377 CTIServerLogin Failed to establish connection to CTI Manager Host A (CS-PUB) 074906 02/24/2003 MAJOR FCCTI_1000 splkJtapiServerstartServerSession jtapi provider login return false 074906 02/24/2003 MAJOR FCCTI_1000 Error Return (21error in invoking Java Method) startServerSession 074906 02/24/2003 MAJOR PhoneDev PD2384 CTIServerLogin Failed to establish connection to CTI Manager Host B (CS-SUB) 074906 02/24/2003 INFO PhoneDev PD1787 PhoneDevShutDown CTI Shutdown 075206 02/24/2003 INFO FastCall FC0376 Releasing license... 075206 02/24/2003 INFO FastCall FC0405 FastCall Shutting Down 075206 02/24/2003 INFO PhoneDev PD1787 PhoneDevShutDown CTI Shutdown
以下の手順に従って、CTI Manager サーバ上の DSBrowser.exe を編集します。
[Start] > [Run] > [cmd] の順に選択します。
コマンド c:\program files\cisco\desktop_config\util\dsbrowser /editable を入力します。
ディレクトリ サーバのパスワードを入力し、[OK] をクリックします。
[Server Data] > [(サーバ名)-LCC] > [App Data] > [CTI Manager List] の順に選択します。
CTI Manager が複数ある場合は、上記のステップをすべての CTI Manager に対して行います。画面の右側で、各 CTI Manager をダブルクリックし、ホスト名が設定されている場合は IP アドレスを設定して OK をクリックします。
この変更を行った後も、同じエラーが発生する場合は、エージェントのデバッグ ログを取得して、シスコ テクニカル サポートに提出してください。
エージェントが Cisco Agent Desktop へのログインに失敗し、以下のエラー メッセージを受信する。
Login attempt failed due to Peripheral Offline
RM JTAPI ユーザの無効なログイン/パスワードが原因で Resource Manager-Contact Manager(RMCM)サブシステムが起動しないと、このエラーが発生します。つまり、この問題の原因は、RM JTAPI ユーザと JTAPI ユーザのパスワードの不一致です。
この問題を解決するには、JTAPI ユーザと RM JTAPI ユーザのパスワードを同期してから、CTI Manager サービスを再起動します。
注:RM JTAPIユーザーのパスワードが無期限に設定されていることを確認してください。パスワードが期限切れになると、パスワードが一致しない結果となり、このエラーが発生します。
エージェントが Cisco Agent Desktop にログインするときに、「Error Reading File\\server\DESKTOP_CFG\config\ag_default\DataFields.ini」エラー メッセージを受信する。
以下の原因が考えられます。
Cisco Agent Desktop(CAD)ユーザに、DESKTOP_CFG 設定ファイルに対する読み取り/書き込みアクセス権が割り当てられていない。
Cisco Customer Response Applications(CRA)サーバとの IP 接続が失われている。
この問題を解決するには、次の手順を実行します。
共有ロケーションとファイルの読み取り/書き込みアクセス権が適切に DESKTOP_CFG 設定ファイルに設定されていることを確認します。共有ロケーションが正常に開く場合は、クライアント PC で、Customer Response Solutions(CRS)サーバ上の Desktop_cfg\Desktop\License フォルダ内に(読み取り/書き込みアクセス権を設定した)ファイルを作成できることを確認します。
詳細については、『Cisco Agent Desktop for IPCC Express で DESKTOP_CFG の共有ドライブ マッピングを自動化できない』を参照してください。
CRA サーバとの IP 接続が確立されていることを確認します。
エージェントが Cisco Agent Desktop にログインしようとするとこのエラーが表示され、RMCM サブシステムが初期化中の状態のままになる。
The ID you entered was not found
または
Specified ID is invalid
この問題は、Cisco Bug ID CSCsv98008にも記載されています。
この問題を解決するには、次の手順を実行します。
ユーザ ID が正しく入力されていることを確認します。ユーザ ID では大文字小文字が区別されます。
正しい Cisco CallManager パスワードを使用していることを確認します。
RM JTAPI ユーザ ID が [Standard CTI Enabled] ユーザ グループのメンバーとして設定されていることを確認します。
それでも問題が解決しない場合は、Cisco Desktop Sync Server サービスを停止してから再起動してみます。
注:エージェントに「電話がサービス停止の間は、You cannot change to Ready state while the phone is out of service」というエラーメッセージが表示された場合。Other agent states are available」エラー メッセージが表示されるときには、問題を解決するために CTI マネージャ サービスを再起動してください。
注:エージェントがログインできず、MIVRログがdb_craを疑わしいとマークする場合、問題はデータベースの破損によるものです。この場合、破損して起動しないデータベースを交換するために、CRS を再インストールする必要があります。
Cisco Agent Desktop ログインは成功して作動可能の状態になるが、「Resources off the agent ext is out of service」エラー メッセージが表示される。[OK] をクリックすると、作動不可の状態に変わり、それから電話の呼び出し音が鳴る。ダイヤル トーンを聞いて通話を終了すると、Cisco Agent Desktop が機能するようになる。
この問題は、IPCC Express を Cisco CallManager Express にリンクさせようとすると発生します。
この問題の原因は、デフォルトではブロックされる着信プレゼンス要求にあります。
この問題を解決するには、Cisco CallManager Express で以下のコマンドを入力します。
これらのコマンドにより、ルータは内部ウォッチャと SIP トランクからの着信プレゼンス要求(SUBSCRIBE メッセージ)を受け入れられるようになります。発信プレゼンス要求には影響しません。
Router(config)# sip-ua
Router(config-sip-ua)# presence enable
電話からエージェントにログインしようとすると、以下のエラー メッセージが表示される。
Agent has no workgroup specified.
この問題を解決するには、CRS ノード マネージャを再起動します。
Cisco Unified Communications Manager を 6.x から 7.x にアップグレードした後、Cisco Agent Desktop にログインできなくなる。次のエラー メッセージが表示されます。
You cannot login because the phone is JAL-enabled. JAL-enabled phones are not compatible with CAD.
CCX 7.0 SR4 リリース ノートでは、この問題を、2 つの条件下において想定される CUCM 7.1.3 の動作として説明しています。
「Unified CCM 7.1(3) では、エージェント電話で JAL または DTAL が有効にされているとエージェントがログインできなくなります。Unified CM 7.1(3) 以降では、エージェント電話で JAL(直接複数ライン同時通話機能)または DTAL(Direct Transfer Across Line)が有効にされていると、エージェントが CAD/CAD-BE/IPPA サービスにログインできません。」
根本原因は、UCCX 7 では現在 JAL 電話をサポートしいてないことにあります。エージェントを再び機能させるには、Cisco Unified Comunication Manager で JAL パラメータを無効にする必要があります。次のステップを実行します。
Cisco Unified Communications Manager の [Administration] ページで [Device] > [Phone] の順に選択して [Phone Configuration] ウィンドウに移動します。
[Join Across Lines] オプション(同じウィンドウの [Device Information] セクションにもあります)に対して [Off] を選択します。。
Cisco Agent Desktop にログインしようとすると、以下のエラー メッセージが表示される。
Invalid Password
このエラーの原因として、SQL エージェント サービスがダウンしていることが考えられます。このサービスを再起動するには、以下の手順を実行します。
[Start] > [Run] に移動し、Services.msc と入力します。
[OK] をクリックします。
[Services] ウィンドウで、[SQL Server Agent service] を見つけます。
[SQL Server Agent service] の [Status] 列の値が [Running] になっていることを確認します。実行されていない場合は再起動します。
Cisco Agent Desktop へのログインが失敗し、「You cannot log in because your phone is ipv6 enabled」または「Unsupported IP Addressing Mode」エラー メッセージが表示される。
Cisco Unified Communications Manager の [Administration] ページで、[Device] > [Device Settings] > [Common Device Config] に移動し、[Find] をクリックして、該当する電話機が含まれるプロファイルをクリックします。次に、[IP Addressing Mode] を [IPv4 & IPv6] から [IPv4 only] に変更します。
詳細はCSCtz07348を参照してください。
エージェントが CAD にログインしようとすると、「CAD cannot login user due that IPV6 is not supported on Cisco Agent Desktop」エラー メッセージが表示される。
注:これは、新規インストールまたはW1アップグレード後にCADがログインした場合に発生します。
この問題の回避策は、UCCX エンジンを再起動することです。この問題は、Cisco Bug ID CSCtk00173に記載されています。
この回避策は、電話機を RmCm ユーザに再び関連付けることに相当します。そのため、以下の点を確認する必要があります。
CUCM エンド ユーザ設定ページにアクセスします。
制御対象のデバイスで、IP Phone の MAC アドレスがエンド ユーザに関連付けられていることを確認します。
エンド ユーザが [Standard CTI enabled] ユーザ グループに追加されていて、電話機が [rmcm] ユーザに属していることを確認します。
この問題を解決するには、次の手順を実行します。
[CUCM Administration] > [Device] > [Phone] の順に選択し、問題が発生している IP Phone をクリックします。
[Device] > [Device Settings] > [Common Device Configuration] の順に選択します。
[Common Device Configuration] で、[IP Addressing Mode] を [IPv4 only] に変更します。.
CUCM の電話機設定ページで、[Reset the IP phone] を選択します。
[TFTP] および [CTIManager] サービスをリセットします。
CUCM 8.6 および UCCX 8.5 で、エージェントが Extension Mobility からログオフし、後で再びログインした場合、エージェントが Cisco Agent Desktop にログインしようとすると、以下のメッセージでログインが失敗する。
An extension on the agent phone is shared with one or more other devices. This configuration is not supported.
または
Login failed due to a configuration error with your phone and JTAPI or Unified CM. Contact your administrator.
この問題は、ユーザ デバイス プロファイルに自動コール録音オプションが有効にされている電話番号が含まれる Extension Mobility を使用する CAD エージェントで発生します。
回避策として、Extension Mobility にログインした後に電話機をリセットします。考えられる解決方法については、Cisco Bug ID CSCty63105を参照してください。