De documentatie van dit product is waar mogelijk geschreven met inclusief taalgebruik. Inclusief taalgebruik wordt in deze documentatie gedefinieerd als taal die geen discriminatie op basis van leeftijd, handicap, gender, etniciteit, seksuele oriëntatie, sociaaleconomische status of combinaties hiervan weerspiegelt. In deze documentatie kunnen uitzonderingen voorkomen vanwege bewoordingen die in de gebruikersinterfaces van de productsoftware zijn gecodeerd, die op het taalgebruik in de RFP-documentatie zijn gebaseerd of die worden gebruikt in een product van een externe partij waarnaar wordt verwezen. Lees meer over hoe Cisco gebruikmaakt van inclusief taalgebruik.
Cisco heeft dit document vertaald via een combinatie van machine- en menselijke technologie om onze gebruikers wereldwijd ondersteuningscontent te bieden in hun eigen taal. Houd er rekening mee dat zelfs de beste machinevertaling niet net zo nauwkeurig is als die van een professionele vertaler. Cisco Systems, Inc. is niet aansprakelijk voor de nauwkeurigheid van deze vertalingen en raadt aan altijd het oorspronkelijke Engelstalige document (link) te raadplegen.
In dit document worden de stappen beschreven die nodig zijn om problemen met Live Data in een PCCE-omgeving (Packaged Contact Center Enterprise) te configureren en op te lossen.
Cisco raadt kennis van de volgende onderwerpen aan:
PCCE
Finesse
Cisco Unified Intelligence Center (CUIC)
Live-gegevens
De informatie in dit document is gebaseerd op de volgende software- en hardware-versies:
PCCE-versie: 12.6
Finesse versie: 12.6
CUIC-LiveData Versie: 12.6
De informatie in dit document is gebaseerd op de apparaten in een specifieke laboratoriumomgeving. Alle apparaten die in dit document worden beschreven, hadden een opgeschoonde (standaard)configuratie. Als uw netwerk live is, moet u zorgen dat u de potentiële impact van elke opdracht begrijpt.
Live Data is een dataframework dat real-time events verwerkt met een hoge beschikbaarheid voor Live Data-rapporten. Live Data verwerkt voortdurend agent- en oproepgebeurtenissen van de perifere gateway en de router. Naarmate gebeurtenissen zich voordoen, worden real-time updates van Live Data voortdurend doorgestuurd naar rapportageclients van het Unified Intelligence Center. De PG en de Router pushen agent en roepen gebeurtenissen naar Live Data als de gebeurtenissen zich voordoen. Live Data verzamelt en verwerkt de gebeurtenissen vervolgens continu in de stream en publiceert de informatie. CUIC abonneert zich op de berichtenstroom om de evenementen in realtime te ontvangen en live datarapporten voortdurend bij te werken. Afzonderlijke statuswaarden, zoals agentstatussen, worden vernieuwd wanneer ze zich voordoen. Andere waarden, zoals aanroepen in wachtrij, worden ongeveer elke 3 seconden vernieuwd.
In Packaged CCE bevindt Live Data zich op een Cisco Voice Operating System Virtual Machine (VM). U kunt Live Data-rapporten insluiten in Finesse-agentdesktops.
Voor implementaties van 2000 agents
Voor implementaties van 4000 en meer agents
De actieve Live Data-server moet een TIP- en TOS-verbinding tot stand brengen met Routers en alle Agent-PG's. De in-actieve (stand-by) Live Data-server moet alleen een TOS-verbinding tot stand brengen met Routers en alle Agent-PG's.
Opmerking:
De Live Data-servers werken in de koudactieve of stand-bymodus. Er is op elk moment slechts één Live Data-server actief. De andere Live Data-server is stand-by. De stand-by Live Data-server bewaakt voortdurend de status van de actieve server. Wanneer de actieve server uitvalt, neemt de standby-server het over en wordt deze actief. De falende server wordt de standby-server wanneer deze klaar is om te dienen.
Live Data maakt gebruik van het TIP-transportprotocol om te communiceren met de Router- en PG-servers. De actieve Live Data-server maakt TIP-verbindingen met beide zijden van de router en PG's. De stand-by Live Data-server maakt geen TIP-verbindingen. Er is slechts één TIP-verbinding tegelijk actief, naar kant A of naar kant B. Wanneer de actieve TIP-verbinding mislukt, herstelt de actieve Live Data-server naar de inactieve TIP-verbinding.
Een Socket.IO-client maakt verbinding met beide zijden van de Live Data-server om de gebeurtenisstroom voor het Live Data-rapport (Socket.IO-stream) te ontvangen. Unified Intelligence Center-clients zijn een voorbeeld van een Socket.IO-client. De stand-by Live Data-server produceert ook de Socket.IO-stream per proxy vanaf de actieve server. Verlies van de hartslag van de Socket.IO-client leidt tot een storing in de Socket.IO-verbinding. De Socket.IO-client kan dan niet worden overgedragen naar de andere Live Data-server.
Opmerking: Wanneer een Live Data-failover plaatsvindt om een van de genoemde redenen en de stand-by Live Data-server de actieve server overneemt, worden de bestaande Live Data-rapporten en de rapportagemethoden gereset.
Voordat u Live Data implementeert, voert u de volgende controles uit:
Controle 1
Controleer vanaf de ICM-servers de DNS-zoekopdracht Vooruit en Achteruit voor de Live Data Publisher en Abonnee met behulp van de opdracht nslookup.
nslookup
nslookup
Controle 2
Controleer vanuit de CLI van de Live Data Server de DNS-zoekopdracht voor de Routers en PG's (controleer de A- en B-kant).
utils network host
Vervang <FQDN> door de openbare FQDN's van de Routers/PG's
utils network host
Vervang <IP> door het openbare IP-adres van de Routers/PG's (controleer zowel de A- als de B-kant)
Controle 3
Controleer de NTP-configuraties en vereisten voor een CCE-omgeving. Raadpleeg het gedeelte NTP en tijdsynchronisatie in de ontwerphandleiding voor de CCE-oplossing.
Controle 4
Zorg ervoor dat de configuratielimieten worden gevolgd volgens de CCE Solution Design Guide
Opmerking:
Controle 5
Certificaatuitwisseling voor Live Data in een PCCE-implementatie
Opmerking: als CA-ondertekende certificaten worden gebruikt in de CCE-implementatie - ICM, Finesse, CUIC, LD en IdS - (ondertekend door dezelfde certificeringsinstantie), kan deze controle worden overgeslagen.
Bij gebruik van zelf ondertekende certificaten
Voor implementaties van agents in 2000
Voor implementaties van 4000 en 12000 agents
Opmerking:
Controle 6
U MOET een volledig gekwalificeerde domeinnaam (FQDN) gebruiken voor alle configuratieopdrachten voor Live Data. Het gebruik van het IP-adres bij het configureren van Live Data kan problemen veroorzaken met de Live Data-service.
Controle 7
a. Typ voor alle ingestelde Live Data-opdrachten handmatig de wachtwoorden in plaats van een kopieer-en-plak-actie.
b. Ondersteunde tekenset voor CLI-opdrachten voor installatie van live gegevens
Wanneer u met de CLI werkt (en niet uitsluitend voor Live Data), kunt u gewone alfanumerieke tekens [0-9] [A-Z] [a-z] en deze extra tekens gebruiken:
Voor de implementatie van PCCE 2000 Agent is een CUIC-LD-IdS-cluster met gelijktijdige bewoners vereist. Voor PCCE 2000 Agent-implementaties is geen handmatige configuratie voor Live Data vereist. Tijdens het initialisatieproces gebruikt de 'CuicLiveDataConfigTask'-taak de LD-API's om een meerderheid van de configuraties te configureren.
Dit omvat:
Na initialisatie worden deze taken handmatig door de beheerder uitgevoerd:
Gedetailleerde stappen voor het configureren van CORS vindt u in de sectie Configure Cross Origin Resource Sharing (CORS) for Live Data van dit document.
Net als bij de 2000 Agent-implementatie is voor PCCE-lab-implementaties geen handmatige configuratie voor Live Data vereist. Tijdens het initialisatieproces gebruikt de 'CuicLiveDataConfigTask'-taak de LD-API's om een meerderheid van de configuraties te configureren.
Na initialisatie worden deze taken handmatig door de beheerder uitgevoerd:
Opmerking: voor PCCE 12.6.2 Lab Duplex Mode, zoals gedocumenteerd in Cisco bug ID CSCwh53057 .
Stap 1
Eerste configuratie voor live gegevens
Stap 2
Voer vanaf elk van de AW-systemen het hulpprogramma Lokale database initialiseren uit, gevolgd door een herstart van de Distributeursservice
Stap 3
Configureer een SQL-gebruiker op de AW DB om met Live Data te werken.
Op de primaire en secundaire AW DB-server > start SQL Server Management Studio (SSMS):
Stap 4
Voer de SQL-query uit op de AWDB voor de SQL-gebruiker die is geconfigureerd om met Live Data te werken.
USE master
GO
GRANT CONTROL ON CERTIFICATE :: UCCESymmetricKeyCertificate TO ""
GRANT VIEW DEFINITION ON SYMMETRIC KEY :: UCCESymmetricKey TO ""
Vervang <user> door de gebruikersnaam van de gebruiker die is gemaakt in stap 4.
Stap 5
Live-gegevens configureren met AW
set live-data aw-access primary
set live-data aw-access secondary
Waarbij
Deze opdracht vertelt Live Data hoe toegang te krijgen tot de primaire AW DB en de secundaire AW DB. De opdracht test ook automatisch de verbinding van Live Data naar de primaire of secundaire AW, controleert of de geconfigureerde gebruiker de juiste AW DB-toegang heeft en rapporteert de resultaten. (Teststatus moet 'Geslaagd' weergeven). U hoeft de AW DB niet te configureren voor zowel de Publisher als de Abonnee. De configuratie wordt gerepliceerd tussen de uitgever en abonnee.
Gebruik de opdracht om de geconfigureerde primaire en secundaire AW DB's te bekijken:
show live-data aw-access
Stap 6
Live-dataservers verbinden met Machine Service-records
set live-data machine-services
Met deze opdracht kunnen de LD-servers zich registreren in de tabel met systeemservices, zodat LD-servers kunnen worden gevonden. Dit registreert ook de referenties voor het aanroepen van LD API.
Vereisten die de gebruiker moet hebben om de opdracht Machine Services met succes uit te voeren:
Opmerking:
Stap 7
De Live Data-gegevensbron instellen in CUIC.
set live-data cuic-datasourceCUIC\
Waarbij
Zodra deze opdracht met succes is uitgevoerd, kunnen de primaire en secundaire Live Data-gegevensbronnen worden weergegeven onder het tabblad Datasources op de CUIC GUI.
Om deze configuratie te bekijken, gebruikt u de opdracht:
show live-data cuic-datasourceCUIC\
Stap 8
Download de Live Data rapporten van cisco.com en importeer de Live Data rapporten op de CUIC server.
Opmerking: De versie van de Live Data-rapporten MOET overeenkomen met de versie van uw centrale controller.
Stap 9
Op de CCE-beheerpagina (https://<AW-Server>/ceadmin), navigeert u naar het tabblad Desktop Settings >> Resources >> Desktop Layouts en vervangt u de standaard 'my-cuic-server' door de juiste CUIC Server FQDN.
Stap 10
Cross Origin Resource Sharing (CORS) configureren voor live gegevens.
a. Zorg er bij Finesse Publisher en Subscriber voor dat CORS is ingeschakeld met behulp van de opdracht Utils finesse cors status.
Als dit is uitgeschakeld, kunt u het inschakelen met behulp van de opdracht Hulpmiddelen finesse cors inschakelen.
b. Voer de CORS-opdrachten uit op alle CUIC-servers:
utils cuic cors enable
utils cuic cors allowed_origin add https://
utils cuic cors allowed_origin add https://
utils cuic cors allowed_origin add https://:8445
utils cuic cors allowed_origin add https://:8445
c. Voer de CORS-opdrachten uit op de servers van Live Data Publisher en Subscriber:
utils live-data cors enable
utils live-data cors allowed_origin add https://
utils live-data cors allowed_origin add https://
utils live-data cors allowed_origin add https://:8445
utils live-data cors allowed_origin add https://:8445
d. Om de CORS-configuraties te controleren:
Op alle CUIC-servers:
utils cuic cors status
utils cuic cors allowed_origin list
Live Data Publisher en Abonnee:
utils live-data cors status
utils live-data cors allowed_origin list
Opmerking:
Stap 12
Start alle CUIC/LD- en Finesse-servers opnieuw op met de CLI-opdracht:
utils system restart
Zorg ervoor dat alle Live Data-services zijn GESTART met behulp van de opdracht 'hulpprogramma's servicelijst'.
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]
Opmerking:
Zorg voor connectiviteit met de AW-servers met behulp van de opdracht:
show live-data aw-access
De teststatus moet 'Geslaagd' weergeven.
Controleer de status van het Live Data Cluster met de opdracht
show live-data failover
Clusterstatus | Beschrijving |
GEPAARD-ACTIEF |
De Live Data-server is actief en communiceert met de externe zijde. |
PARALLEL-STANDBY |
De Live Data-server staat in de stand-bymodus en communiceert met de externe zijde. |
GEÏSOLEERD-ACTIEF |
De Live Data-server is actief, maar kan niet communiceren met de externe zijde. |
GEÏSOLEERDE STANDBY |
De Live Data-server staat in de stand-bymodus, maar kan niet communiceren met de externe zijde. |
IN EENVOUDIGE MODUS |
De Live Data-server werkt in de simplexmodus. |
BUITEN BEDRIJF |
De Live Data-server is buiten gebruik. |
AANSLUITEN |
De Live Data-server probeert een handshake uit te voeren met de externe zijde. |
TESTEN |
De Live Data-server kan niet communiceren met de externe zijde en gebruikt de Test-Other-Side-procedure om te bepalen of de server zich in de status ISOLATED-ACTIVE of ISOLATED-STANDBY bevindt. |
UNAVAILABLE |
Live data wordt niet gebruikt. |
Opmerking: de status ISOLATED active/standby geeft aan dat er communicatie is tussen Live Data-servers. Dit betekent niet dat de Live Data-gegevensbron op CUIC offline is.
a. Als de opdracht 'live-data failover weergeven' de clusterstatus als NIET BESCHIKBAAR weergeeft.
Actie-items:
b. Als de opdracht 'live-data failover weergeven' de clusterstatus weergeeft als BUITEN BEDRIJF.
Actie-items
c. Als de opdracht 'live-data failover weergeven' de clusterstatus ISOLATED weergeeft.
Zorg ervoor dat de Streaming Live Data Datasource de juiste hosts weergeeft met behulp van de opdracht:
show live-data cuic-datasourceCUIC\
Als de 'show live-data cuic-datasource' de juiste configuraties weergeeft, maar Live Data Datasource offline op CUIC:
Opmerking: vanaf Live Data versie 12.6.2 worden de poorten 12005 en 12008 afgeschreven en verwijderd in toekomstige versies. De poort 443 wordt nu gebruikt voor Live Data Web Service en Live Data Socket.IO Service.
Controleer de poortconnectiviteit vanuit de Live Data Server CLI met behulp van de opdracht open poorten tonen.
show open ports regexp 4[0-5]03[45] (For Instance-0)
show open ports regexp 4[0-5]07[45] (For Instance-1)
Controleer de poortconnectiviteit via de opdrachtprompt op de Routers en PG's met behulp van de opdracht netstat.
netstat -an | findstr ""
OR
netstat -an | findstr 4[0-5]03[45] (For Instance-0)
netstat -an | findstr 4[0-5]07[45] (For Instance-1)
a. Als de poorten niet eens in de LUISTERTOESTAND blijken te zijn:
b. Indien de havens zich niet in de GEVESTIGDE staat bevinden en zich in de LUISTERENDE staat blijven bevinden:
a. Voer deze SQL-query uit op de AW-database om te controleren op het aantal agents dat per team is geconfigureerd:
Query uitvoeren tegen de awdb (geen invloed op de productie)
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. Voer deze SQL-query uit op de AW-database om te controleren of er per vaardigheidsgroep een aantal agents is geconfigureerd:
Query uitvoeren tegen de awdb (geen invloed op de productie)
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.
Als er problemen met Live-gegevens worden waargenomen na een upgrade, controleert u de configuratiewaarde voor 'DBM-onderhoud'.
Als deze optie is uitgeschakeld, schakelt u de configuratiewijzigingen in door DBM-onderhoud in te stellen op 0 en de Apache Tomcat-service op de AW-server opnieuw te starten.
Registratiepad: HKEY_LOCAL_MACHINE\SOFTWARE\Cisco Systems, Inc.\ICM\<instantienaam>\Router<A/B>\Router\CurrentVersion\Configuration\Global\DBMaintenance.
file get activelog livedata/logs recurs compress
Met deze opdracht worden logs verzameld voor alle componenten van Live Data
Als alternatief kunt u ook logs verzamelen voor de afzonderlijke Live Data-componenten.
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
Verzamel de logboeken van de browserconsole en het netwerk voor de duur van het probleem. Begin met het wissen van de cache, start de browser opnieuw op en leg de logs vanaf de aanmeldingstijd vast, waarbij de poging om het probleem te reproduceren wordt behandeld
Voor de Chrome/Edge-browser:
Voor de Firefox browser:
verchromen
Firefox
Opdracht om Packet Captures uit te voeren op VOS-servers:
Pakketopnamen verzamelen met RTMT:
Pakketopnamen verzamelen met CLI:
Packet Captures blijft op schijf staan totdat het wordt verwijderd. Het wordt aanbevolen om deze opnames periodiek te verwijderen.
12.6(1)
PCCE-beheer- en configuratiehandleiding
12.6(2)
Ontwerpgids voor oplossingen
PCCE-beheer- en configuratiehandleiding
Revisie | Publicatiedatum | Opmerkingen |
---|---|---|
2.0 |
27-Mar-2025
|
Eerste vrijgave |
1.0 |
05-Aug-2024
|
Eerste vrijgave |