内容

概要

CUICデータソースの概要

CUIC UCCXデータソースの設定

CUICデータソース

UCCXデータソース

ライブデータストリーミングデータソース

パスワード管理インタラクション

以前のリリースからの変更

履歴レポートユーザ(uccxhruser)

HAでのUCCXデータソースホストのリダイレクト

以前のUCCXバージョン10.5(1)および10.6(1)

シナリオ1:N1はプライマリで、データソースは両方のノードのN2を指しています。

シナリオ 2：N1はプライマリであり、データソースは両方のノードのN2を指しています。N2でエンジンとデータベースがシャットダウンします。

バージョン11.0(1)および11.5(1)

シナリオ 1：N1はプライマリであり、データソースは両方のノードのN2を指しています。

シナリオ 2：N1はプライマリであり、データソースは両方のノードのN2を指しています。N2でエンジンとデータベースがシャットダウンします。

ライブデータストリーミングデータソース

一般的な問題のトラブルシューティング

LDストリーミングデータソースのトラブルシューティング

オフラインを示すUCCXデータソース：

CCX用CUICスタンドアロン

スタンドアロンCUICとUCCXの設定

スタンドアロンCUICの統合に関する一般的なトラブルシューティング

概要

このドキュメントでは、Unified Contact Center Express(UCCX)ソリューションの[Cisco Unified Intelligence Center(CUIC)Administration]ページのさまざまなデータソース、その機能、設定、およびトラブルシューティングの技術について説明します。

CUICデータソースの動作はリリースによって変更されています。この記事では、UCCX 11.5(1)リリース以降の動作について説明します。

CUICデータソースの概要

Datasourceは、サーバーとデータベース間の接続に与えられる名前で、サーバーがデータベース上でSQLクエリーを実行できるようにします。

ここで行う接続はJDBC接続です。

CUIC UCCXデータソースの設定

図に示すように、CCX用の共存CUICアプリケーションには3種類の組み込みデータソースがすでに設定済みです。

CUICデータソース

これはクエリベースのデータソースで、TCPポート1500経由のCUICデータベース(cuic_data)へのデータベース接続であり、cuic_reportユーザを使用してCUICデータベース上でクエリを実行します。

UCCXデータソース

これはクエリベースのデータソースで、TCPポート1504を介したCCXデータベース(db_cra)へのデータベース接続で、UCCX履歴レポートユーザ(uccxhruser)を使用してレポートを取得します。CUICとUCCXはは両方のInformixデータソースで編集可能です。

ライブデータストリーミングデータソース

これはライブデータに使用されるクエリに基づかないwebsocket接続であり、編集できません。つまり、パラメータを手動で変更することはできません。

このデータソースは、UCCXエンジンのSocketIOサービスを継続的にポーリングして、UCCXエンジンのReal-Time Data Manager(RTDM)からライブデータの結果を取得します。 これは常にローカルノードを指します。これは、プライマリエンジンサービスから結果を取得するためです。

パスワード管理インタラクション

以前のリリースからの変更

UCCX 11.0までは、UCCXデータソースはuccxhrcユーザをデフォルトのデータベースユーザとして使用し、図に示すように履歴データを取得してCUICに表示します。

図に示すように、UCCX 11.5が起動すると、データソースはUCCXのデフォルトデータベースユーザとしてuccxhruserを使用します。

また、uccxhruserを使用して外部データベースユーザをUCCXに接続し、履歴データを取得することもできます(例：サードパーティのレポーティングサーバ、またはCisco WorkForce Optimization(WFO)。

履歴レポートユーザ(uccxhruser)

このユーザは、構成、履歴、およびリポジトリのデータストア（CDS、HDS、およびRDS）に接続でき、次の権限を持ちます。

- 履歴、構成、リポジトリの各テーブルへの読み取り専用アクセス。

- ストアドプロシージャを実行します。

- 新しいストアドプロシージャを作成します。

バージョン11.5ではUCCXデータソースにこのユーザを使用するため、パスワードを更新するには、

[Unified CCX Administration]メニューバー> [Tools] > [Password Management] > [Historical Reporting User]

CUICでの履歴レポート用にUCCXデータソースのパスワードを自動的に変更します。

HAセットアップでは、この変更は他のノードに伝搬されないため、両方のノードでこの変更を更新する必要があります。

また、HAセットアップでは、[Password Management]ページのアイコンをクリックして、[Check Consistency]を選択して、両方のノードでパスワードが一致し、クラスタ間で一貫性があることを確認できます。

パスワードの不一致により、リダイレクト後にデータソースがオフラインになる可能性があります(例：フェールオーバー後)。

HAでのUCCXデータソースホストのリダイレクト

シスコでは、プライマリエンジンサービスの余分な負荷を防ぐために、レポートをプルするためにUCCXデータソースを現在のセカンダリノードにポイントすることを推奨しています。

履歴レポートを実行すると、uccxoninitプロセスでCPU使用率がピークに達する場合があり、これによりCPUが過剰に消費され、サーバのパフォーマンスの問題が発生します。したがって、履歴データストアをセカンダリノードにポイントするようにこの推奨事項が適用されます。

ここでは、N1をUCCXパブリッシャノード（ノード1）とし、N2をサブスクライバノード（ノード2）とします。

通常のシナリオでは、両方のノードのUCCXデータソースが同じノードを指しています。

例：

N1データソースがN1を指している場合、N2データソースもN1を指しています。

データソースのリダイレクション動作は、バージョンによって異なります。次に、バージョン固有のシナリオをいくつか示します。

以前のUCCXバージョン10.5(1)および10.6(1)

CUICに初めてログインするときは、インストールされているバージョンに応じて、履歴データストアを手動でセカンダリノードにポイントする必要があります。

ステップ1:CUICにログインします。

ステップ2：データソースをクリックします。

ステップ3:UCCXデータソースを選択します。

ステップ4:[Edit]をクリックします。

ステップ5：データソースホストをセカンダリノードのホストに変更します（つまり、インスタンス名をセカンダリノードのホストに変更します）。

ステップ6:[Test connection]をクリックします。

ステップ 7：[Save] をクリックします。

シナリオ1:N1はプライマリで、データソースは両方のノードのN2を指しています。

ノードのプライマリ所有権の変更時には、CCXデータソースリダイレクションは発生せず、プライマリ所有権の変更前にポイントしていた同じノードをポイントし続けます。

したがって、N1およびN2データソースは、フェールオーバー後にプライマリノードになったN2を指し続けます。

フェールオーバーの前後で、図に示すように、同じノードN2をポイントします。

シナリオ 2：N1はプライマリであり、データソースは両方のノードのN2を指しています。N2でエンジンとデータベースがシャットダウンします。

N2上のCCXエンジンがデータソースに変更を加えずに、N2上でデータベースがシャットダウンした瞬間に停止した場合、CCXデータソースは自動的にN1にリダイレクトされず、赤いXマークでダウンします。レポートをプルするには、サブノードデータベースをバックアップするか、データソースをN1ノードデータベースに手動でポイントする必要があります。

フェールオーバーの前後で、図に示すように、同じノードN2をポイントします。

バージョン11.0(1)および11.5(1)

HAのノード2のインストールが完了すると、CCXデータソースは自動的にセカンダリノードを指します。データソースを手動でセカンダリノードにポイントする必要はありません。

シナリオ 1：N1はプライマリであり、データソースは両方のノードのN2を指しています。

ノードのプライマリ所有権が変更されると、CCXデータソースのリダイレクションが行われ、フェールオーバーデータソースの後、両方のノードのN1（現在はセカンダリ）をポイントします。

フェールオーバーがN2をポイントする前。

フェールオーバー後にN1をポイント

シナリオ 2：N1はプライマリであり、データソースは両方のノードのN2を指しています。N2でエンジンとデータベースがシャットダウンします。

これで、N2上のエンジンがデータソースに変更を加えずに、N2上でデータベースがシャットダウンした瞬間に停止すると、CCXデータソースは自動的にN1にリダイレクトされます。

N2のデータベースを停止する前に

N2のデータベース停止後

したがって、データソース全体は常にセカンダリデータベースを指します。

ライブデータストリーミングデータソース

ライブデータレポートは、このストリーミングデータソースを使用します。これは、Unified Intelligence Centerで事前設定されたストックデータソースであり、フィールドは編集できません。ライブデータレポートでは、エージェントとスーパーバイザのリアルタイム統計が提供されます。エージェントおよびスーパーバイザのライブデータ（リアルタイム）レポートはCUICで実行でき、ガジェットとしてfinesseデスクトップでも使用できます。ライブデータはIntelligence Center Reportingサービスによって消費されます。

データソース一覧ページに、プライマリホスト名またはIPアドレスが表示されます。このデータソースは、ポート12015からソケットIOサービスへのwebsocket接続を行います。これはライブデータフィードを担当するため、継続的なストリーム接続であり、常に現在のノードを指します。つまり、N1はN1のIP/ホスト名をを指します。

Live Data Webサービスは、基本的に通話の発信に使用されます。基本的に3つの残りのコールをサポートします。

- 認証トークン：接続するにはトークンが必要です。Socket IOサービスに新しく接続します。

クライアントは、ソケットIOサービスによって検証されるすべての接続要求に対してトークンを送信します。これは、Live Data Webサービスに対してrestコールを発信することによって検証されます。

- スナップショット要求：スナップショット要求は、ソケットIOサービスに対して完全なスナップショットデータを送信するように要求することです。

- 認証URL:このrest APIは、このエージェントに関する情報を提供します。この情報は、LDガジェットレポートでデータを表示できる有効な値です。

最初にCUICにログインする際には、このデータソースはポート12015で受け入れられる必要があります。受け入れられた後に、CCXエンジンからポート9443でトークンをフェッチし、トークンの認証後にオンラインになります。

このデータソースが何らかの理由でオフラインになると、すべてのLDレポートが失敗します。

一般的な問題のトラブルシューティング

CUICデータベースから、cuicdatasourceテーブルを使用してデータソースにクエリーを実行できます。

各データソースは一意のIDを持ち、すべてのバージョンで同じです。これは、BOLDSの重要な情報を持つ11.0システムからのCLI出力です

run sql select * from cuic_data:cuicdatasource

id cccccccc00000000AAAAAAA00000001

名前CUIC

説明ローカルCUICデータベースのデータソース

Informixタイプ

dbhost ${HOSTNAME}

dbport 1500

dbuser cuic_reportuser

dbpassword {CUIC_DB_PASSWORD}

dbinstance ${INFORMIXSERVER}

dbname ${CUIC_DB_NAME}

dbencoding UTF-8

jdbcdriverclass com.informix.jdbc.IfxDriver

timezoneid

createdtime 2010-01-27 14:48:14.368

最終更新日：2015-10-14 18:35:15.615

version 1

パーティションデフォルト

共有の許可3

minpoolsize 5

maxpoolsize 100

owner 1111111111111111111111111111AAAA

id D7D7E1A610000132363635BD3F57F543

名前UCCX

説明

Informixタイプ

dbhost 10.78.93.233

dbport 1504

dbuser uccxhruser

dbpassword cuicenc:85b5vBq+dMxeD1ZnIWIn9A==

dbinstance uccx_106_233_n2_uccx

dbname db_cra

dbencoding UTF-8

jdbcdriverclass com.informix.jdbc.IfxDriver

timezoneid GMT

createdtime 2017-05-18 18:03:52.000

最終更新日：2017-05-28 02:18:43.770

owner 1111111111111111111111111111AAAA

id E1350DCC1000013F000001CB0A4E5B4B

name Live Data Streaming Data Source

説明UCCXライブデータストリーミングデータソース

type streaming

dbhost localhost

dbport 9443

ダブザー

timezoneid UTC

createdtime 2017-04-05 12:11:00.000

最終更新日：2017-04-05 12:11:00.000

minpoolsize 5

maxpoolsize 100

owner 1111111111111111111111111111AAAA

Brocurl

topicschemaurl realtime/schema

restuser LiveDataAdmin

restpassword ～12Live_Data!12

tokenurl livedata/token/new

websocketport 12015

3行を取得しました。

LDストリーミングデータソースのトラブルシューティング

LDデータソースがオンラインになるには、最初にCUIC—>datasourceページへの最初のログイン時にポート12015で提供される証明書を受け入れる必要があります。

証明書を受け入れると、さらにエンジンでトークンを検証します。LDデータソースがまだオフラインと表示されている場合は、次のチェックを実行します。

- utils ntp statusを使用してNTPを確認します。ライブデータは、発生しているライブイベントを同期する必要があるため、NTPに依存しています。必ずNTPストラタム5を確認してください。

- utils diagnose testはネットワークを正しく検証する必要があります。

- ovaの展開中に使用された不適切なネットワークアダプタは、ライブデータの断続的な切断を引き起こす可能性があります。

上記のチェックに問題がなければ、データソースがトークン要求を認証したかどうかを検証できます。ブラウザで次のURLを実行して、同じことを確認します。

https://FQDN-OF-SERVER.com:9443/livedata/token/new

ユーザ名：LiveDataAdmin

パスワード：～12Live_Data!12

上記のurlをブラウザで直接実行すると、このエラーが表示される場合は、CCXが認証トークンを提供していないことを確認します。

Firefoxはuccx.mapfregenelsigorta.com:9443でサーバへの接続を確立できません。

そのため、CSCvb75279の不具合があります 回避策については、TACに問い合わせる必要があります。

UCCX 11.6以降のバージョンでは、このURLにuccxhruserユーザ名とパスワードを指定して使用し、データソースがトークン要求を認証したかどうかを確認します。

https://FQDN-OF-SERVER.com:9443/livedata/token/new

ユーザ名：uccxhruser

password：必要なパスワードを入力します

認証に成功すると、次の図に示すように新しいトークンが提供されます。

オフラインになるライブデータストリーミングデータソースの不具合を確認します：

CSCvb67761 :ポート9443で「maxThreads」が枯渇した後のライブデータストリーミング送信元オフライン

CSCvb75279 :MIVRキーストアのパスワードが同期されていないため、LDストリーミングソースがオフラインになります

CSCvc45189 :再構築および復元後のライブデータストリーミングデータソースがオフラインです。

オフラインを示すUCCXデータソース：

CCXデータベースがオンラインであることを確認し、CCXのサービスアビリティページからCisco Unified CCX DatabaseサービスがIN SERVICEであることを確認します。

CCXの履歴データベース(db_cra)に接続しているUCCXデータソースも、データソース設定ページのパラメータの1つが正しくない場合はオフラインになります。図に示すように、すべてのフィールドが正しいことを確認します。正しくない場合は、データベースインスタンスに接続できません。

バージョン11.0までは、uccxhrcユーザを使用してデータベースに接続し、このユーザにはストアドプロシージャを実行する権限があります。

CUICはuccxhrcユーザを使用して、ストアドプロシージャを実行し、このユーザのパスワードをハードコードします。すべてのパラメーターが正しく

データソースがオフラインになっている場合でも、次のクレデンシャルでパスワードを更新できます。

ユーザ名:uccxhrc

パスワード：5:T{i,5e!KqD*8

CUICの下でパスワードを手動で更新した後、データソースをクリックして[UCCX]を選択し、[Edit]を選択し、テスト接続を実行して[Save]をクリックします（図を参照）。

バージョン11.5以降では、CCXデータベースに接続するためにuccxhrcユーザではなくuccxhrcユーザを使用しません。

uccxhruserのパスワードはパスワード管理を介して維持されます。[CCX Administration] > [Tools] > [Password Management] > [Historical Reporting User]。詳細については、パスワード管理のトピックを参照してください。

注意：11.5以降のuccxhrcユーザが存在しないため、version 11.5からpassword 5:T{i,5e!KqD*8を使用しないでください。11.5でuccxhrcユーザのパスワードを更新する場合は、特殊文字を使用しないでください。

不具合ID使用カッコ:CSCvf21099

既知の障害:

CSCvb72142 ：履歴レポーティングユーザのパスワードを変更すると、CUICが破損することがあります

CCX用CUICスタンドアロン

バージョン11.0のCCXは、既存の共存CUICに加えて、スタンドアロンCUICの統合をサポートします。

スタンドアロンCUICは、Unified CCXを含む複数のデータソースをサポートします。

StandaloneCuicはUCCX appadminページで設定でき、カスタマイズされたレポートの取得に使用でき、標準、拡張、プレミアムライセンスとともにインストールできます。

スタンドアロンCUICとUCCXの設定

1. CUICスタンドアロンにログインし、左側のドロワーから[データソース]を選択します。

2. [create and add UCCX datasource]を選択します。データベースのユーザIDはuccxhruserで、パスワードはパスワード管理ページで設定されます。

3. [Unified CCX Administrator]ページにログインします。

4. [システム]をクリックし、[スタンドアロンCUIC構成]を選択します。

5. 図に示すように、スタンドアロンCUICサーバのFQDN、データソース名（スタンドアロンCUICサーバで作成）、ユーザ名、およびパスワード（CUICサーバ）を入力します。

6. [Save] をクリックします。CUIC設定が保存され、成功メッセージが表示されます。

スタンドアロンCUICの統合に関する一般的なトラブルシューティング

- FQDNが正しいことを確認します。

- ネットワーク接続がUPで、CUICサーバがUCCXサーバから到達可能かどうかを確認します

- スタンドアロンCUICサーバに入力されたユーザ名またはパスワードが正しくない。

- スタンドアロンとUCCX内のデータソースに対して指定されたインスタンス名。

- [Serviceability]ページの[Cisco Unified CCX Database]サービスは[INSERVICE]である必要があります。