El conjunto de documentos para este producto aspira al uso de un lenguaje no discriminatorio. A los fines de esta documentación, "no discriminatorio" se refiere al lenguaje que no implica discriminación por motivos de edad, discapacidad, género, identidad de raza, identidad étnica, orientación sexual, nivel socioeconómico e interseccionalidad. Puede haber excepciones en la documentación debido al lenguaje que se encuentra ya en las interfaces de usuario del software del producto, el lenguaje utilizado en función de la documentación de la RFP o el lenguaje utilizado por un producto de terceros al que se hace referencia. Obtenga más información sobre cómo Cisco utiliza el lenguaje inclusivo.
Cisco ha traducido este documento combinando la traducción automática y los recursos humanos a fin de ofrecer a nuestros usuarios en todo el mundo contenido en su propio idioma. Tenga en cuenta que incluso la mejor traducción automática podría no ser tan precisa como la proporcionada por un traductor profesional. Cisco Systems, Inc. no asume ninguna responsabilidad por la precisión de estas traducciones y recomienda remitirse siempre al documento original escrito en inglés (insertar vínculo URL).
Este documento describe los pasos necesarios para configurar y solucionar problemas de datos en directo en un entorno de Unified Contact Center Enterprise (UCCE).
Cisco recomienda que tenga conocimiento sobre estos temas:
Cisco Unified Contact Center Enterprise (UCCE)
La información que contiene este documento se basa en las siguientes versiones de software y hardware.
Versión de ICM: 12.6
Versión Finesse: 12.6
Versión de CUIC/Live Data: 12.6
La información que contiene este documento se creó a partir de los dispositivos en un ambiente de laboratorio específico. Todos los dispositivos que se utilizan en este documento se pusieron en funcionamiento con una configuración verificada (predeterminada). Si tiene una red en vivo, asegúrese de entender el posible impacto de cualquier comando.
Live Data es un marco de datos que procesa eventos en tiempo real con alta disponibilidad para informes de Live Data. Live Data procesa continuamente los eventos de agente y llamada desde la puerta de enlace del periférico y el router. A medida que se producen los eventos, Live Data envía continuamente actualizaciones en tiempo real a los clientes de informes de Unified Intelligence Center. El PG y el router envían los eventos de agente y llamada a Live Data a medida que se producen los eventos. Live Data agrega y procesa continuamente los eventos en flujo y publica la información. CUIC se suscribe a la secuencia de mensajes para recibir los eventos en tiempo real y actualizar continuamente los informes de datos en directo. Los valores de estado individuales, como los estados de agente, se actualizan a medida que se producen. Otros valores, como las llamadas en cola, se actualizan aproximadamente cada 3 segundos.
En Unified CCE, los datos en directo residen en una máquina virtual (VM) del sistema operativo de voz de Cisco. Puede incrustar informes de datos en directo en escritorios de agentes Finesse.
Para 2000 implementaciones de agentes
Para implementaciones de agentes de 4000 o superiores
El servidor de Live Data activo debe establecer una conexión TIP y TOS con los routers y todos los PG de agente. El servidor de datos en directo en activo (en espera) debe establecer solamente la conexión TOS con los routers y todos los PG de agente.
Nota:
Los servidores Live Data funcionan en modo activo en frío o en modo de espera. Solo hay un servidor de Live Data activo en cada momento. El otro servidor de Live Data está en espera. El servidor de Live Data en espera supervisa constantemente el estado del servidor activo. Cuando el servidor activo falla, el servidor en espera toma el control y se vuelve activo. El servidor que falla se convierte en el servidor en espera cuando está listo para servir.
Live Data utiliza el protocolo de transporte TIP para comunicarse con el router y los servidores PG. El servidor de datos en directo activo establece conexiones TIP a ambos lados del router y a los PG. El servidor de Live Data en espera no establece ninguna conexión TIP. Sólo hay una conexión TIP activa a la vez, ya sea al Lado A o al Lado B. Cuando falla la conexión TIP activa, el servidor Live Data activo se recupera en la conexión TIP inactiva.
Un cliente SocketIO se conecta a ambos lados del servidor de datos en directo para recibir la secuencia de eventos de informe de datos en directo (secuencia SocketIO). Los clientes de Unified Intelligence Center son un ejemplo de un cliente SocketIO. El servidor de Live Data en espera también produce el flujo SocketIO por proxy desde el servidor activo. Las pérdidas de latidos del cliente SocketIO provocan un error de conexión SocketIO. El cliente SocketIO conmuta por error al otro servidor de datos en directo.
Antes de implementar Live Data, realice estas comprobaciones:
Comprobación 1
Desde los servidores ICM, verifique la búsqueda de DNS directo e inverso para el editor y el suscriptor de datos en directo, usando el comando nslookup.
nslookup <Live-Data-Server-FQDN>
nslookup <Live-Data-Server-IP>
Comprobación 2
Desde la CLI de Live Data Server, verifique la búsqueda de DNS directo e inverso para los routers y PG (realice comprobaciones para el lado A y el lado B).
utils network host <FQDN>
Reemplace <FQDN> por el FQDN público de los routers/PG
utils network host <IP>
Sustituya <IP> por la dirección IP pública de los routers/PG (efectúe las comprobaciones para los lados A y B)
Comprobación 3
Verifique las configuraciones NTP y los requisitos para un entorno CCE. Consulte la sección NTP y sincronización horaria de la Guía de diseño de soluciones de CCE.
Comprobación 4
Asegúrese de que se respetan los límites de configuración según la guía de diseño de soluciones de CCE
Nota:
Comprobación 5
Intercambio de certificados para datos en directo en una implementación de UCCE
Nota: si se están utilizando certificados firmados por CA en toda la implementación de CCE (ICM, Finesse, CUIC, LD e IdS) (firmados por la misma autoridad de certificados), se puede omitir esta comprobación.
Al utilizar certificados autofirmados
Para 2000 implementaciones de agentes
Para implementaciones de agentes 4000 y 12000
Nota:
Comprobación 6
DEBE utilizar un nombre de dominio completo (FQDN) para todos los comandos de configuración de datos en directo. El uso de la dirección IP al configurar datos en directo puede causar problemas con el servicio de datos en directo.
Comprobación 7
a. Para todos los comandos set Live Data, escriba manualmente las contraseñas en lugar de una acción de copiar y pegar.
b. Conjunto de caracteres compatible para comandos CLI de instalación de Live Data
Al trabajar con CLI (y no exclusivamente para datos en directo), puede utilizar caracteres alfanuméricos normales [0-9] [A-Z] [a-z] y estos caracteres adicionales:
Paso 1
Asegúrese de que el tipo de implementación correcto esté configurado en Administración de CCE en Infraestructura > Configuración de implementación (https://<AW-Server>/cceadmin).
Paso 2
Agregue el servidor al inventario de CCE.
Para las implementaciones de 2000 Agent, agregue el clúster CUIC-LD-IdS co-residente seleccionando la opción CUIC-LD-IdS Publisher.
Para implementaciones de 4000 agentes y superiores, agregue el clúster de CUIC independiente seleccionando la opción Publicador de Unified Intelligence Center.
Nota: para implementaciones de agentes de 4000 o superiores, los servidores de datos en directo se agregan al inventario mediante el comando set live-data machine-services.
Paso 3
Utilice el comando set live-data reporting-interval <reporting-interval-in-minutes> para establecer el intervalo de informes de datos en directo en minutos.
Utilice el comando show live-data reporting-interval para ver la configuración actual del intervalo de informes.
Paso 4
Configure un usuario SQL en AW DB para trabajar con datos en directo
En el servidor AW DB principal y secundario > inicie SQL Server Management Studio (SSMS):
Paso 5
Ejecute la consulta SQL para el usuario SQL configurado para trabajar con datos en directo.
USE master
GO
GRANT CONTROL ON CERTIFICATE :: UCCESymmetricKeyCertificate TO "<user>"
GRANT VIEW DEFINITION ON SYMMETRIC KEY :: UCCESymmetricKey TO "<user>"
Reemplace <user> por el nombre de usuario del usuario creado en el Paso 4.
Paso 6
Configuración de datos en directo con 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>
Where
Este comando indica a Live Data cómo acceder a AW DB principal y a AW DB secundaria. El comando también prueba automáticamente la conexión de Live Data con el AW principal o secundario, verifica si el usuario configurado tiene el acceso AW DB apropiado e informa los resultados. (El estado de la prueba debe ser 'Correcto'). No es necesario configurar AW DB en los servidores Live Data Publisher y Subscriber. La configuración se replica entre el editor de datos en directo y el nodo de suscriptor.
Para ver las bases de datos AW principales y secundarias configuradas, utilice el comando:
show live-data aw-access
Paso 7
Conectar servidores de datos en directo a registros de servicio de máquina (solo para implementaciones de agentes de 4000 o superiores)
set live-data machine-services <user@domain>
Este comando permite que los servidores LD se registren a sí mismos en la tabla de servicios de máquinas para que los servidores LD sean detectables. Esto también registra las credenciales para llamar a la API de datos en directo.
Requisitos que debe tener el usuario para ejecutar correctamente el comando machine services:
Nota:
Paso 8
Configure el origen de datos de datos en directo en CUIC.
set live-data cuic-datasource <cuic-fqdn> <cuic-port> CUIC\<cuic-user>
Where
Una vez que este comando se ejecuta correctamente, los orígenes de datos en directo primarios y secundarios se pueden ver en la ficha Orígenes de datos de la GUI de CUIC.
Para ver la configuración del origen de datos de Live Data, utilice el comando:
show live-data cuic-datasource <cuic-fqdn> <cuic-port> CUIC\<cuic-user>
Paso 9
Descargue los informes de datos en directo de cisco.com e importe los informes de datos en directo en el servidor de CUIC.
Nota: Los informes de datos en directo DEBEN coincidir con la versión de su controlador central.
Paso 10
En la página Cisco Finesse Administration (https://<Finesse>/cfadmin), vaya a la ficha Finesse Desktop Layout (Diseño del escritorio de Finesse) y sustituya el valor predeterminado "my-cuic-server" por el FQDN del servidor de CUIC correcto.
Paso 11
Configurar el uso compartido de recursos entre orígenes (CORS) para datos en directo
a. En Finesse Publisher y Subscriber, asegúrese de que CORS esté habilitado mediante el comando utils finesse cors status.
Si está inhabilitado, puede habilitarlo usando el comando utils finesse cors enable.
b. Ejecute los comandos CORS en todos los servidores CUIC:
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. Ejecute los comandos CORS en los servidores Live Data Publisher y Subscriber:
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. Para verificar la configuración del CORS:
En todos los servidores CUIC:
utils cuic cors status
utils cuic cors allowed_origin list
En Live Data Publisher y Subscriber:
utils live-data cors status
utils live-data cors allowed_origin list
Nota:
Paso 12
Reinicie todos los servidores CUIC/LD y Finesse mediante el comando CLI:
utils system restart
Asegúrese de que todos los servicios de datos en directo se INICIAN mediante el comando 'utils service list'.
CCE Live Data ActiveMQ Service[STARTED]
CCE Live Data Cassandra Service[STARTED]
CCE Live Data Event Store Service[STARTED]
CCE Live Data SocketIO 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]
Asegúrese de la conectividad a los servidores AW mediante el comando:
show live-data aw-access
El estado de la prueba debe mostrar 'Correcto'.
Verifique el estado de Live Data Cluster mediante el comando
show live-data failover
Estado del clúster | Descripción |
EMPAREJADO-ACTIVO |
El servidor de datos en directo se encuentra en estado activo y se está comunicando con el lado remoto. |
PAIRED-STANDBY |
El servidor de datos en directo se encuentra en estado de espera y se está comunicando con el lado remoto. |
AISLADO-ACTIVO |
El servidor de datos en directo está en estado activo, pero no puede comunicarse con el lado remoto. |
AISLADO EN ESPERA |
El servidor de datos en directo está en estado de espera, pero no puede comunicarse con el lado remoto. |
SIMPLEXED-MODE |
El servidor Live Data funciona en modo simple. |
FUERA DE SERVICIO |
El servidor Live Data está fuera de servicio. |
Conectado |
El servidor de datos en directo está intentando establecer una comunicación con el lado remoto. |
PRUEBA |
El servidor de datos en directo no puede comunicarse con el lado remoto y está utilizando el procedimiento Test-Other-Side para determinar si debe estar en el estado AISLADO-ACTIVO o AISLADO-EN ESPERA. |
NO DISPONIBLE |
Live Data no está implementado. |
Nota: El estado activo/en espera AISLADO indica una comunicación entre servidores de datos en directo. Esto no hace que el origen de datos de Live Data en CUIC esté desconectado.
a. Si el comando 'show live-data failover' muestra el estado del clúster como NO DISPONIBLE.
Elementos de acción:
b. Si el comando 'show live-data failover' muestra el estado del clúster como FUERA DE SERVICIO.
Elementos de acción
c. Si el comando 'show live-data failover' muestra el estado del clúster como AISLADO.
Asegúrese de que el origen de datos de transmisión en directo refleje los hosts correctos mediante el comando:
show live-data cuic-datasource <cuic-fqdn> <cuic-port> CUIC\<cuic-user>
Si 'show live-data cuic-datasource' muestra las configuraciones correctas, pero Live Data Datasource muestra offline en CUIC:
Nota: a partir de la versión 12.6.2 de Live Data, los puertos 12005 y 12008 quedan obsoletos y se quitarán en futuras versiones. El puerto 443 se utiliza ahora para el servicio web Live Data y el servicio Live Data SocketIO.
Verifique la conectividad del puerto desde la CLI de Live Data Server mediante el comando show open ports.
show open ports regexp 4[0-5]03[45] (For Instance-0)
show open ports regexp 4[0-5]07[45] (For Instance-1)
Verifique la conectividad del puerto desde el símbolo del sistema en los routers y PG mediante el comando netstat.
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. Si los puertos ni siquiera muestran estar en el estado LISTENING:
b. Si los puertos no están en el estado ESTABLISHED y continúan en el estado LISTENING:
a. Consulta SQL para comprobar el número de agentes configurados por equipo:
Ejecutar consulta contra el awdb (sin impacto en la producción)
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. Consulta SQL para comprobar el número de agentes configurados por grupo de habilidades:
Ejecutar consulta contra el awdb (sin impacto en la producción)
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.
Si se observan problemas con Live Data después de una actualización, verifique el valor de configuración 'DBMainmaintenance'.
Si está inhabilitado, habilitando los cambios de configuración configurando DBMainmaintenance en 0 y reinicie el servicio Apache Tomcat en el servidor AW.
Ruta del Registro: HKEY_LOCAL_MACHINE\SOFTWARE\Cisco Systems, Inc.\ICM\<nombre de instancia>\Router<A/B>\Router\CurrentVersion\Configuration\Global\DBMaintenance.
file get activelog livedata/logs recurs compress
Este comando recopila los registros de todos los componentes de Live Data
Como alternativa, también puede recopilar registros de los componentes individuales de 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 SocketIO 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
Recopile los registros de la Consola del explorador y de la red para el problema de duración. Comience borrando la caché, reinicie el navegador y capture los registros desde el inicio de sesión en adelante, cubriendo el intento de reproducir el problema
Para el navegador Chrome/Edge:
Para el navegador Firefox:
Comando para ejecutar capturas de paquetes en servidores VOS:
Recopilar capturas de paquetes mediante RTMT:
Recopilar capturas de paquetes mediante CLI:
Las capturas de paquetes permanecen en el disco hasta que se eliminan. Se recomienda eliminar estas capturas periódicamente.
12.6(1)
Guía de diseño de soluciones
Guía de instalación y actualización
12.6(2)
Guía de diseño de soluciones
Guía de instalación y actualización
Revisión | Fecha de publicación | Comentarios |
---|---|---|
1.0 |
14-Feb-2024 |
Versión inicial |