UCCX CUIC資料來源技術說明

簡介

 本檔案介紹Unified Contact Center Express(UCCX)解決方案中Cisco Unified Intelligence Center(CUIC)管理頁面上的各種資料來源、其功能、配置和故障排除技術。

CUIC資料來源行為隨發行版本而變化，這篇文章概括介紹了UCCX 11.5(1)發行版本以來的行為。

CUIC資料來源概述

資料來源是提供給伺服器與資料庫之間的連線的名稱，該連線使伺服器能夠在資料庫上運行SQL查詢。
此處建立的連線是JDBC連線。

CUIC UCCX資料來源配置

如圖所示，適用於CCX的共存CUIC應用已預配置3種型別的內建資料來源。 

CUIC資料來源

這是一個基於查詢的資料來源，是通過TCP埠1500與CUIC資料庫(cuic_data)的資料庫連線，並使用cuic_report使用者在CUIC資料庫上運行查詢。

UCCX資料來源

這也是基於查詢的資料來源，是通過TCP埠1504與CCX資料庫(db_cra)的資料庫連線，並使用UCCX歷史報告使用者(ucxhruser)來獲取報告。CUIC和UCCX都是Informix資料來源，並且是可編輯的。

即時資料流資料來源

這是用於Live Data的非基於查詢的Websocket連線，不可編輯，這意味著您無法手動更改其引數。

此資料來源繼續輪詢UCCX引擎的SocketIO服務，以從UCCX引擎的即時資料管理器(RTDM)獲取即時資料結果。 這始終指向本地節點，因為它從主引擎服務獲取結果。

密碼管理互動 

與早期版本相比的變化

在UCCX 11.0之前，UCCX資料來源使用ucxhrc使用者作為預設資料庫使用者來檢索歷史資料並將其顯示在CUIC上，如下圖所示。

如圖所示，當UCCX 11.5啟動時，資料來源使用ucxhruser作為UCCX的預設資料庫使用者。

                                                                                                                       

您還可以使用ucxhruser將任何外部資料庫使用者連線到UCCX，以提取歷史資料(例如：第三方報告伺服器或Cisco WorkForce Optimization(WFO)。

歷史報表使用者(ucxhruser)

此使用者可以連線到配置、歷史和儲存庫資料儲存庫（CDS、HDS和RDS），並具有以下許可權：

• 對歷史、配置和儲存庫表的只讀訪問許可權。
• 執行儲存過程。
• 建立新的儲存過程。

由於版本11.5將此使用者用於UCCX資料來源，為了更新密碼，請導航至

Unified CCX Administration選單欄> Tools > Password Management > Historical Reporting User。

它會自動更改UCCX資料來源的密碼，以便使用CUIC進行歷史報告。

在HA設定中，此更改不會傳播到另一個節點，因此需要在兩個節點上更新此更改。
此外，在HA設定中，按一下Password Management頁中的圖示可以按一下Check Consistency，以確認兩個節點上的密碼都匹配且跨群集保持一致。 

密碼不一致可能導致重定向後資料來源離線(例如：故障切換後)。

HA中UCCX資料來源主機的重定向

思科建議將UCCX資料來源指向當前輔助節點以拉取報告，從而防止主引擎服務承受額外負荷。
運行歷史報告有時會導致ucxoninit進程的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)

完成節點2的HA安裝後，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服務建立Web套接字連線，因此這是一個連續的流連線，並且始終指向當前節點，即N1指向N1的IP/主機名，N2指向N2的IP/主機名。

即時資料Web服務主要用於進行休息呼叫。基本上支援三通休息電話。

• 身份驗證令牌：需要標籤才能連線 — 建立與套接字IO服務的新連線。
  客戶端通過對Live Data Web服務進行REST呼叫，為每個由套接字IO服務驗證的連線請求傳送令牌。
  
  
• 快照請求：快照請求是請求套接字IO服務傳送完整的快照資料。
  
  
• 身份驗證URL:此Rest API為此代理提供資訊，這是他可在LD小工具報告中檢視其資料的有效值。

當您最初登入CUIC時，該資料來源需要通過埠12015接受證書。一旦接受，它就會通過埠9443從CCX引擎獲取令牌，在令牌身份驗證之後就會聯機。 

該資料來源由於任何原因而離線，將導致所有LD報告失敗。

常見問題故障排除

從CUIC資料庫，可以使用cuicdatasource表查詢資料來源。
每個資料來源都有統一ID，所有版本都相同。這是11.0系統的CLI輸出，其中包含BOLDS中的重要資訊
運行sql select * from cuic_data:cuicdatasource

id CCCCCCCC00000000AAAAAA00000001
名稱CUIC
本地CUIC資料庫的說明資料來源
鍵入Informix
dbhost ${HOSTNAME}
dbport 1500
dbuser cuic_reportuser
dbpassword {CUIC_DB_PASSWORD}
dbinstance ${INFORMIXSERVER}
dbname ${CUIC_DB_NAME}
UTF-8
jdbcdriverclass com.informix.jdbc.IfxDriver
timezoneid
createdtime 2010-01-27 14:48:14.368
拉斯圖普特日期2015-10-14 18:35:15.615
版本1
預設分割槽
共用許可權3
minpoolsize 5
maxpoolsize 100
所有者1111111111111111111111111111AAAA

id D7D7E1A610000132363635BD3F57F543
名稱UCCX
說明
鍵入Informix
dbhost 10.78.93.233
dbport 1504
dbuser ucxhruser
dbpassword cuicenc:85b5vBq+dMxeD1ZnIWIn9A==
dbinstance uccx_106_233_n2_uccx
dbname db_cra
UTF-8
jdbcdriverclass com.informix.jdbc.IfxDriver
timezoneid GMT
createdtime 2017-05-18 18:03:52.000
拉斯圖普特德2017-05-28 02:18:43.770
所有者1111111111111111111111111111AAAA

id E1350DCC1000013F000001CB0A4E5B4B
命名即時資料流資料來源
說明UCCX即時資料流資料來源
型別流
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
所有者1111111111111111111111111111AAAA
brokerurl
topicschemaurl realtime/schema
restuser LiveDataAdmin
restpassword ~12Live_Data!12
tokenurl livedata/token/new
websocketport 12015

檢索到3行。

排除LD流資料來源故障

若要使LD資料來源聯機，我們需要在首次登入CUIC—>資料來源頁面時首先接受它在埠12015上提供的證書：
接受證書後，它將進一步通過引擎驗證令牌。如果LD資料來源仍然顯示為離線，則應運行檢查：

• 使用實用程序ntp狀態檢查NTP:即時資料依賴於NTP，因為它需要同步發生的即時事件。始終確保NTP第5層。
• utils診斷測試應正確驗證網路。
• 部署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和ucxhruser使用者名稱和密碼驗證資料來源是否獲得令牌請求身份驗證。

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

使用者名稱：ucxhruser
密碼：輸入所需的密碼

  成功的驗證會為您提供新的令牌，如下圖所示：

知道即時資料流資料來源離線時的缺陷：

CSCvb67761 :埠9443上耗盡「maxThreads」後，即時資料流源離線
CSCvb75279 :MIVR金鑰庫密碼不同步，導致LD流源離線
CSCvc45189 :重建和恢復後離線即時資料流資料來源。

顯示離線的UCCX資料來源：

確保CCX資料庫處於聯機狀態，並從CCX的可服務性頁面驗證Cisco Unified CCX資料庫服務處於服務中。

如果資料來源配置頁中的某個引數不正確，連線到CCX的歷史資料庫(db_cra)的UCCX資料來源也可以離線。確保所有欄位都正確（如圖所示），否則將無法連線到資料庫例項。

                                                     

在11.0版之前，您使用ucxhrc使用者連線到資料庫，並且此使用者具有執行儲存過程的許可權。

CUIC使用ucxhrc使用者執行儲存過程，此使用者的密碼是硬編碼的。所以如果所有引數都是正確的

您仍然看到資料來源處於離線狀態，然後可以嘗試使用這些憑據更新密碼：

使用者名稱:ucxhrc
密碼:5:T{i，5e!KqD*8

在CUIC下手動更新密碼後，按一下datasource並選擇UCCX，然後選擇Edit，進行測試連線，然後按一下Save，如下圖所示：

                                                 

自11.5版起，您不使用ucxhrc使用者而使用ucxhruser連線到CCX資料庫。

ucxhruser的密碼通過密碼管理維護：CCX管理>工具>密碼管理>歷史報告使用者。有關密碼管理主題的詳細資訊。

注意：請勿使用來自版本11.5的密碼5:T{i，5e!KqD*8，因為從11.5開始，沒有任何ucxhrc使用者。如果您在11.5中更新ucxhruser密碼，請嘗試保留不多使用的特殊字元，並且密碼不應包含括弧「(」)。 

使用括弧時的缺陷ID:CSCvf21099

已知瑕疵:

CSCvb72142 :更改歷史報表使用者密碼有時會中斷CUIC

適用於CCX的CUIC獨立版

11.0版的CCX除了支援現有的共存CUIC外，還支援獨立CUIC的整合。

獨立CUIC支援多個資料來源，包括Unified CCX。

StandaloneCuic可在UCCX appadmin頁面上配置，可用於獲取自定義報告，並可安裝標準、增強和高級許可證。

使用UCCX配置獨立CUIC 

      

1. 登入到CUIC standalone，然後從左側抽屜中選擇Data Sources。
2. 選擇建立和新增UCCX資料來源。資料庫使用者ID為ucxhruser，密碼在密碼管理頁面上設定:                                                                                                                                                                                                                                                                            
3. 登入到Unified CCX Administrator頁面。
4. 按一下System，然後選擇Standalone CUIC configuration。
5. 如圖所示，輸入獨立CUIC伺服器的FQDN、資料來源名稱（在獨立CUIC伺服器中建立）、使用者名稱和密碼。                                                                           
6. 按一下「Save」。儲存了CUIC配置並顯示成功消息。

整合獨立CUIC的常見故障排除

• 驗證FQDN是否正確。
• 檢查網路連線是否為UP，以及是否可以從UCCX伺服器訪問CUIC伺服器
• 為獨立CUIC伺服器輸入的使用者名稱或密碼不正確。
• 為資料來源提供的例項名稱與UCCX中的例項名稱獨立匹配。
• Serviceability頁面下的Cisco Unified CCX資料庫服務應為INSERVICE。