本產品的文件集力求使用無偏見用語。針對本文件集的目的,無偏見係定義為未根據年齡、身心障礙、性別、種族身分、民族身分、性別傾向、社會經濟地位及交織性表示歧視的用語。由於本產品軟體使用者介面中硬式編碼的語言、根據 RFP 文件使用的語言,或引用第三方產品的語言,因此本文件中可能會出現例外狀況。深入瞭解思科如何使用包容性用語。
思科已使用電腦和人工技術翻譯本文件,讓全世界的使用者能夠以自己的語言理解支援內容。請注意,即使是最佳機器翻譯,也不如專業譯者翻譯的內容準確。Cisco Systems, Inc. 對這些翻譯的準確度概不負責,並建議一律查看原始英文文件(提供連結)。
本文檔介紹在Packaged Contact Center Enterprise (PCCE)環境中配置和排除Live Data問題所需的步驟。
思科建議您瞭解以下主題:
PCCE
Finse
思科整合情報中心(CUIC)
即時資料
本文中的資訊係根據以下軟體和硬體版本:
PCCE版本:12.6
Finesse版本:12.6
CUIC-LiveData版本:12.6
本文中的資訊是根據特定實驗室環境內的裝置所建立。文中使用到的所有裝置皆從已清除(預設)的組態來啟動。如果您的網路運作中,請確保您瞭解任何指令可能造成的影響。
Live Data是一個資料架構,它處理Live Data報表的高可用性的即時事件。Live Data持續處理來自外圍網關和路由器的座席和呼叫事件。當事件發生時,即時資料會持續向Unified Intelligence Center報告客戶端推送即時更新。PG和路由器在事件發生時將代理和呼叫事件推送到即時資料。然後,Live Data將持續聚合和處理流中的事件並發佈資訊。CUIC訂閱消息流以即時接收事件並持續更新Live Data報告。個別狀態值(例如代理程式狀態)會在發生時重新整理。其他值(例如隊列中的呼叫)大約每3秒刷新一次。
在Packaged CCE中,即時資料駐留在思科語音作業系統虛擬機器(VM)上。您可以在Finesse代理案頭中嵌入Live Data報表。
適用於2000代理部署
適用於4000及更高版本的代理部署
活動即時資料伺服器必須建立到路由器和所有代理PG的TIP和TOS連線。主用(備用)即時資料伺服器必須僅建立到路由器和所有代理PG的TOS連線。
附註:
Live Data伺服器以冷啟動或待命模式運作。任何時候只有一台活動資料伺服器處於活動狀態。另一台Live Data伺服器處於備用狀態。備用Live Data伺服器會持續監控作用中伺服器的狀態。當主用伺服器發生故障時,備用伺服器將接管並變為主用伺服器。當故障伺服器準備好提供服務時,它將成為備用伺服器。
Live Data使用TIP傳輸協定與路由器和PG伺服器通訊。活動即時資料伺服器與路由器和PG兩端建立TIP連線。待命即時資料伺服器不會建立任何TIP連線。一次只能啟動一個與A側或B側的TIP連線。當活動TIP連線失敗時,活動Live Data伺服器將恢復至空閒TIP連線。
Socket.IO客戶端連線到Live Data伺服器的任一端以接收Live Data報告事件流(Socket.IO流)。Unified Intelligence Center客戶端就是Socket.IO客戶端的一個示例。待命即時資料伺服器也會透過作用中伺服器的代理來產生Socket.IO串流。Socket.IO客戶端心跳丟失導致Socket.IO連線失敗。Socket.IO使用者端接著會容錯移轉至另一個Live Data伺服器。
在部署Live Data之前,請執行以下檢查:
檢查 1
在ICM伺服器中,使用nslookup命令驗證即時資料發佈伺服器和訂閱伺服器的正向和反向DNS查詢。
nslookup <Live-Data-Server-FQDN>
nslookup <Live-Data-Server-IP>
檢查 2
在即時資料伺服器CLI中,驗證路由器和PG的正向和反向DNS查詢(對A端和B端執行檢查)。
utils network host <FQDN>
將<FQDN>替換為路由器/PG的公共FQDN
utils network host <IP>
用路由器/PG的公有IP地址替換<IP>(對A端和B端執行檢查)
檢查 3
驗證CCE環境的NTP配置和要求。 請參閱《CCE解決方案設計手冊》中的「NTP和時間同步」部分。
檢查 4
確保按照《CCE解決方案設計手冊》遵守配置限制
附註:
檢查 5
PCCE部署中即時資料的證書交換
注意:如果跨越CCE部署(ICM、Finesse、CUIC、LD和IdS)(由同一證書頒發機構簽名)使用CA簽名證書,則可跳過此檢查。
使用自簽名證書時
適用於2000代理部署
適用於4000和12000代理部署
附註:
檢查 6
所有Live Data配置命令都必須使用完全限定域名(FQDN)。在配置即時資料時使用IP地址可能會導致即時資料服務出現問題。
檢查 7
a.對於所有set Live Data命令,請手動鍵入密碼,而非複製和貼上操作。
b. Live Data Installation CLI命令支援的字符集
使用CLI時(不限於Live Data),您可以使用純文數字字元[0-9] [A-Z] [a-z]和以下附加字元:
PCCE 2000代理部署需要共存CUIC-LD-IdS群集。PCCE 2000代理部署不需要手動配置Live Data。在初始化過程中,「CuicLiveDataConfigTask」任務使用LD API來配置大多數配置。
這包括:
初始化之後,這些工作將由管理員手動完成:
有關配置CORS的詳細步驟,請參閱本文檔的為即時資料配置跨源資源共用(CORS)部分。
與2000代理部署類似,PCCE實驗室部署不需要手動配置Live Data。在初始化過程中,「CuicLiveDataConfigTask」任務使用LD API來配置大多數配置。
初始化之後,這些工作將由管理員手動完成:
註:對於PCCE 12.6.2實驗室雙工模式,如Cisco bug ID CSCwh53057中所述。
步驟 1
即時資料的初始設定
步驟 2
從每台AW電腦運行初始化本地資料庫工具,然後重新啟動分發伺服器服務
步驟 3
在AW DB上配置SQL使用者以使用Live Data。
在主要和輔助AW DB伺服器上>啟動SQL Server Management Studio (SSMS):
步驟 4
針對設定使用Live Data的SQL使用者,在AWDB上執行SQL查詢。
USE master
GO
GRANT CONTROL ON CERTIFICATE :: UCCESymmetricKeyCertificate TO "<user>"
GRANT VIEW DEFINITION ON SYMMETRIC KEY :: UCCESymmetricKey TO "<user>"
用步驟4中建立的使用者的使用者名稱替換<user>。
步驟 5
使用AW配置即時資料
set live-data aw-access primary <aw1-server-fqdn> <port> <aw-database> <sql-user>
set live-data aw-access secondary <aw2-server-fqdn> <port> <aw-database> <sql-user>
其中
此命令告訴即時資料如何訪問主AW DB和輔助AW DB。該命令還會自動測試從Live Data到主要或輔助AW的連線,檢查配置的使用者是否具有適當的AW DB訪問許可權,並報告結果。(測試狀態必須顯示「成功」)。 您無需在發佈伺服器和訂閱伺服器上配置AW DB。在發佈伺服器和訂閱伺服器之間複製配置。
要檢視配置的主要AW和輔助AW DB,請使用命令:
show live-data aw-access
步驟 6
將Live資料伺服器連線到電腦服務記錄
set live-data machine-services <user@domain>
此命令允許LD伺服器向電腦服務表註冊自己,以便發現LD伺服器。這也會註冊用於呼叫LD API的認證。
使用者必須成功執行電腦服務命令的要求:
附註:
步驟 7
在CUIC中設定即時資料資料來源。
set live-data cuic-datasource <cuic-fqdn> <cuic-port> CUIC\<cuic-user>
其中
成功運行此命令後,可在CUIC GUI的Datasources頁籤下看到主要和輔助即時資料資料來源。
要檢視此配置,請使用以下命令:
show live-data cuic-datasource <cuic-fqdn> <cuic-port> CUIC\<cuic-user>
步驟 8
從cisco.com下載Live Data報告,然後將Live Data報告導入CUIC伺服器。
注意: Live Data報告的版本必須與中央控制器的版本匹配。
步驟 9
在CCE Administration頁面(https://<AW-Server>/cceadmin),導航到Desktop Settings >> Resources >> Desktop Layouts頁籤,並使用正確的CUIC Server FQDN替換預設的「my-cuic-server」。
步驟 10
設定即時資料的跨來源資源共用(CORS)。
a.在Finesse發佈伺服器和訂閱伺服器上,確保使用utils finesse cors status命令啟用CORS。
如果停用了此功能,則可以使用命令utils finesse cors enable啟用它。
b.在所有CUIC伺服器上執行CORS命令:
utils cuic cors enable
utils cuic cors allowed_origin add https://<finesse-publisher>
utils cuic cors allowed_origin add https://<finesse-subscriber>
utils cuic cors allowed_origin add https://<finesse-publisher>:8445
utils cuic cors allowed_origin add https://<finesse-subscriber>:8445
c.在即時資料發佈伺服器和訂閱伺服器上執行CORS命令:
utils live-data cors enable
utils live-data cors allowed_origin add https://<finesse-publisher>
utils live-data cors allowed_origin add https://<finesse-subscriber>
utils live-data cors allowed_origin add https://<finesse-publisher>:8445
utils live-data cors allowed_origin add https://<finesse-subscriber>:8445
d.要驗證CORS配置:
在所有CUIC伺服器上:
utils cuic cors status
utils cuic cors allowed_origin list
在即時資料發佈伺服器和訂閱伺服器上:
utils live-data cors status
utils live-data cors allowed_origin list
附註:
步驟 12
使用CLI命令重新啟動所有CUIC/LD和Finesse伺服器:
utils system restart
確保使用命令「utils service list」啟動所有Live Data服務。
CCE Live Data ActiveMQ Service[STARTED]
CCE Live Data Cassandra Service[STARTED]
CCE Live Data Event Store Service[STARTED]
CCE Live Data Socket.IO Service[STARTED]
CCE Live Data Storm DRPC Service[STARTED]
CCE Live Data Storm Nimbus Service[STARTED]
CCE Live Data Storm Supervisor Service[STARTED]
CCE Live Data Web Service[STARTED]
CCE Live Data Zookeeper Service[STARTED]
使用命令確保與AW伺服器的連線:
show live-data aw-access
測試狀態必須顯示「成功」。
使用指令驗證即時資料叢集狀態
show live-data failover
叢集狀態 | 說明 |
配對-活動 |
即時資料伺服器處於使用中狀態,並且正在和遠端通訊。 |
成對待命 |
Live Data伺服器處於備用狀態,正在與遠端端通訊。 |
隔離-活動 |
Live Data伺服器處於活動狀態,但無法與遠端端通訊。 |
隔離-備用 |
Live Data伺服器處於備用狀態,但無法與遠端端通訊。 |
SIMPLEXED-MODE |
Live Data伺服器以單工模式運作。 |
服務中斷 |
即時資料伺服器無法使用。 |
連線 |
Live Data伺服器正在嘗試與遠端端進行握手。 |
測試 |
Live Data伺服器無法與遠端端通訊,並且正在使用Test-Other-Side過程來確定是處於ISOLATED-ACTIVE還是ISOLATED-STANDBY狀態。 |
無法使用 |
未部署即時資料。 |
注意:「隔離的主用/備用」狀態表示「即時資料」伺服器之間的通訊。這不會導致CUIC上的Live Data資料來源離線。
a.如果「show live-data failover」命令顯示集群狀態為「不可用」。
行動專案:
b.如果「show live-data failover」命令顯示集群狀態為「服務中斷」。
行動專案
c.如果「show live-data failover」命令將集群狀態顯示為「隔離」。
使用下列命令確定串流即時資料資料資料來源反映了正確的主機:
show live-data cuic-datasource <cuic-fqdn> <cuic-port> CUIC\<cuic-user>
如果「show live-data cuic-datasource」顯示正確的配置,但Live Data資料來源在CUIC上顯示為離線:
注意:從Live Data版本12.6.2開始,以後發行版本中將不再支援並刪除埠12005和12008。埠443現在用於即時資料Web服務和即時資料Socket.IO服務。
使用show open ports命令從即時資料伺服器CLI驗證埠連通性。
show open ports regexp 4[0-5]03[45] (For Instance-0)
show open ports regexp 4[0-5]07[45] (For Instance-1)
使用netstat命令,在路由器和PG的命令提示符下檢驗埠連通性。
netstat -an | findstr "<LD-SideA-IP> <LD-SideB-IP>"
OR
netstat -an | findstr 4[0-5]03[45] (For Instance-0)
netstat -an | findstr 4[0-5]07[45] (For Instance-1)
a.如果埠甚至未顯示為LISTENING狀態:
b.如果埠未處於ESTABLISHED狀態並繼續處於LISTENING狀態:
a.在AW資料庫上執行此SQL查詢,以檢查每個團隊配置的代理數量:
針對awdb執行查詢(不影響生產)
Select TeamName = AT.EnterpriseName, NumAgentsOnTeam = COUNT(ATM.SkillTargetID), SupervisorName = Person.LastName + ', ' + Person.FirstName
FROM Agent_Team AT LEFT OUTER JOIN
(Select * from Agent ) Agent ON AT.PriSupervisorSkillTargetID = Agent.SkillTargetID LEFT OUTER JOIN Person ON Person.PersonID = Agent.PersonID,
Agent_Team_Member ATM
WHERE ATM.AgentTeamID = AT.AgentTeamID
GROUP BY AT.EnterpriseName, Person.LastName + ', ' + Person.FirstName
ORDER BY AT.EnterpriseName
b.在AW資料庫上執行此SQL查詢,以檢查每個技能組配置的座席數:
針對awdb執行查詢(不影響生產)
Select Skill_Group.EnterpriseName, NumAgentsInSG = COUNT(Skill_Group_Member.AgentSkillTargetID)
FROM Skill_Group, Skill_Group_Member
WHERE Deleted = 'N' AND Skill_Group.SkillTargetID = Skill_Group_Member.SkillGroupSkillTargetID
GROUP BY EnterpriseName;
c.
如果在升級後看到Live Data問題,請檢查「DBMaintenance」配置值。
如果已停用,則透過將DBMaintenance設定為0來啟用配置更改,並在AW伺服器上重新啟動Apache Tomcat服務。
登錄檔路徑:HKEY_LOCAL_MACHINE\SOFTWARE\Cisco Systems, Inc.\ICM\<例項名稱>\Router<A/B>\Router\CurrentVersion\Configuration\Global\DBMaintenance。
file get activelog livedata/logs recurs compress
此命令收集所有Live Data元件的日誌
或者,您也可以收集個別即時資料元件的記錄。
CCE Live Data ActiveMQ
file get activelog livedata/logs/livedata-activemq
CCE Live Data Cassandra Service
file get activelog livedata/logs/livedata-cassandra
CCE Live Data Event Store Service
file get activelog livedata/logs/livedata-event-store
CCE Live Data Socket.IO Service
file get activelog livedata/logs/socketio-service
CCE Live Data Storm Services
file get activelog livedata/logs/livedata-storm
CCE Live Data Web Service
file get activelog livedata/logs/livedata-web
CCE Live Data Zookeeper Service
file get activelog livedata/logs/livedata-zookeeper
Intelligence Center Reporting Service
file get activelog cuic/logs/ recurs compress
收集持續時間問題的瀏覽器控制檯和網路日誌。從清除快取開始,重新啟動瀏覽器,然後從登入時間開始擷取記錄,涵蓋重現問題的嘗試
對於Chrome/Edge瀏覽器:
對於Firefox瀏覽器:
在VOS伺服器上運行資料包捕獲的命令:
使用RTMT收集資料包捕獲:
使用CLI收集資料包捕獲:
封包擷取會保留在磁碟上,直到刪除為止。建議定期刪除這些捕獲。
12.6(1)
12.6(2)
修訂 | 發佈日期 | 意見 |
---|---|---|
1.0 |
05-Aug-2024 |
初始版本 |