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]である必要があります。