Nota técnica sobre los orígenes de datos CUIC para UCCX

Introducción

 En este documento se describen los diversos orígenes de datos de la página de administración de Cisco Unified Intelligence Center (CUIC) en la solución Unified Contact Center Express (UCCX), sus funciones, configuración y técnicas de resolución de problemas.

El comportamiento del origen de datos de CUIC ha cambiado con respecto a las versiones, y este artículo describe el comportamiento visto desde la versión UCCX 11.5(1) en adelante.

Descripción general de orígenes de datos CUIC

El origen de datos es el nombre dado a la conexión entre un servidor y una base de datos que permite al servidor ejecutar consultas SQL en la base de datos.
La conexión realizada aquí es una conexión JDBC.

Configuración del origen de datos de CUIC UCCX

Como se muestra en la imagen, la aplicación CUIC co-residente para CCX tiene 3 tipos de orígenes de datos integrados ya preconfigurados. 

Origen de datos CUIC

Se trata de un origen de datos basado en consultas y es la conexión de base de datos a la base de datos CUIC (cuic_data) sobre el puerto TCP 1500 y utiliza el usuario cuic_report para ejecutar consultas en la base de datos CUIC.

Origen de datos UCCX

También es un origen de datos basado en consultas y es la conexión de base de datos a la base de datos CCX (db_cra) sobre el puerto TCP 1504 y utiliza UCCX Historical Reporting user (uccxhruser) para obtener informes. CUIC y UCCX son orígenes de datos de Informix y se pueden editar.

Origen de datos de streaming en directo

Se trata de una conexión de socket web no basada en consultas que se utiliza para datos en directo y no se puede editar, lo que significa que no se pueden cambiar los parámetros manualmente.

Este origen de datos sondea continuamente el servicio SocketIO del motor UCCX para obtener los resultados de datos en directo del administrador de datos en tiempo real (RTDM) del motor UCCX. Esto siempre apunta al nodo local, ya que obtiene los resultados del servicio Engine principal.

Interacción de administración de contraseñas 

Cambios de versiones anteriores

Hasta UCCX 11.0, el origen de datos de UCCX utiliza al usuario uccxhrc como usuario de base de datos predeterminado para recuperar datos históricos y mostrarlos en CUIC, como se muestra en la imagen.

Como se muestra en la imagen, cuando se inicia UCCX 11.5, el origen de datos utiliza uccxhruser como usuario de base de datos predeterminado para UCCX.

                                                                                                                       

También puede utilizar uccxhruser para conectar a cualquier usuario de base de datos externo a UCCX, para extraer datos históricos (por ejemplo: Servidor de informes de terceros o Cisco WorkForce Optimization (WFO).

Usuario de Informes históricos (uccxhruser)

Este usuario puede conectarse a los almacenes de datos de configuración, histórico y de repositorio (CDS, HDS y RDS) y tiene estos privilegios:

• Acceso de sólo lectura a las tablas Histórico, Configuración y Repositorio.
• Ejecutar procedimientos almacenados.
• Crear nuevos procedimientos almacenados.

Como la versión 11.5 utiliza este usuario para el origen de datos de UCCX, para actualizar la contraseña, navegue hasta

Barra de menús de Unified CCX Administration > Tools > Password Management > Historical Reporting User.

cambia la contraseña para el origen de datos UCCX automáticamente para los informes históricos con CUIC.

En una configuración HA, este cambio no se propaga al otro nodo, por lo que es necesario actualizarlo en ambos nodos.
Además, en las configuraciones de HA, puede Verificar la consistencia al hacer clic en el icono en la página Administración de Contraseña para confirmar que las contraseñas coinciden en ambos nodos y son consistentes en todo el clúster. 

La incoherencia de la contraseña puede hacer que el origen de datos se desconecte después de la redirección (por ejemplo: Luego de la conmutación por fallas).

Redirección del host de origen de datos UCCX en HA

Cisco recomienda apuntar el origen de datos UCCX al nodo secundario actual para extraer informes, de modo que se evite la carga adicional en el servicio Engine principal.
En ocasiones, la ejecución de informes históricos puede alcanzar un pico de uso de la CPU en el proceso uccxoninit, lo que toma una CPU excesiva y causa problemas de rendimiento en el servidor. Por lo tanto, esta recomendación para señalar el almacén de datos histórico al nodo secundario está en vigor.

A continuación, considere N1 como el nodo de editor UCCX (Nodo 1) y N2 como el nodo de suscriptor (Nodo 2).
En un escenario normal, ambos nodos tienen el origen de datos UCCX apuntando al mismo nodo.

Ejemplo: 

Si el origen de datos N1 apunta a N1, el origen de datos N2 también estará apuntando a N1. 

El comportamiento de redirección de los orígenes de datos difiere en diferentes versiones y a continuación se muestran algunos escenarios específicos de la versión:

Versiones anteriores de UCCX 10.5(1) y 10.6(1)

Cuando inicia sesión por primera vez en CUIC, el almacén de datos histórico debe apuntar manualmente al nodo secundario en función de la versión instalada.

Paso 1. Inicie sesión en CUIC.

Paso 2. Haga clic en el origen de datos.

Paso 3. Seleccione el origen de datos de UCCX.

Paso 4. Haga clic en Editar.

Paso 5. Cambie el Host de origen de datos al del nodo secundario (es decir, cambie el nombre de instancia al del nodo secundario). 

Paso 6. Haga clic en Probar conexión.

Paso 7. Haga clic en Guardar.

Situación 1: N1 es principal y el origen de datos apunta a N2 para ambos nodos.

Al cambiar la propiedad principal del nodo, no se produce la redirección del origen de datos de CCX y continúa señalando el mismo nodo en el que estaba apuntando antes del cambio en la propiedad principal.

Por lo tanto, aquí el origen de datos N1 y N2 continúa apuntando al N2, que ahora es el nodo principal después de la conmutación por fallas.

Antes y después de la conmutación por fallas, señala al mismo nodo N2, como se muestra en la imagen:

 

Escenario 2: N1 es primario y el origen de datos apunta a N2 para ambos nodos. El motor y la base de datos se apagan en N2.

Ahora, si el motor CCX en N2 se detiene, no se produce ningún cambio en el origen de datos, pero cuando la base de datos se apaga en N2, el origen de datos CCX no se redirige automáticamente a N1 y se desactiva con la marca RED-X. Ahora, para extraer el informe, la base de datos de subnodos debe ser llevada a una copia de seguridad o apuntar manualmente el origen de datos a la base de datos de nodos N1.

Antes y después de la conmutación por fallas, señala al mismo nodo N2, como se muestra en la imagen:

Versión 11.0(1) y 11.5(1)

El origen de datos de CCX señala automáticamente al nodo secundario una vez que completamos la instalación del nodo 2 para HA. No es necesario señalar manualmente el origen de datos al nodo secundario.

Escenario 1: N1 es primario y el origen de datos apunta a N2 para ambos nodos.

Ahora, al cambiar la propiedad primaria del nodo, se produce la redirección del origen de datos CCX y después del origen de datos de conmutación por fallas, señala a N1 (ahora secundario) para ambos nodos.

Antes de la conmutación por fallas, señala a N2.

Después de los puntos de conmutación por fallas a N1

Escenario 2: N1 es primario y el origen de datos apunta a N2 para ambos nodos. El motor y la base de datos se apagan en N2.

Ahora, si el motor en N2 se detiene, no hay ningún cambio en el origen de datos, sino el momento en que la base de datos se cierra en N2, el origen de datos de CCX se redirige automáticamente a N1.

Antes de detener la base de datos en N2

  Después de detener la base de datos en N2

Por lo tanto, el origen de datos general siempre apunta a la base de datos secundaria.

Origen de datos de streaming de datos en directo 

El informe Datos en directo utiliza este origen de datos de streaming. Se trata de un origen de datos preconfigurado preconfigurado preconfigurado en Unified Intelligence Center y los campos no se pueden editar. Los informes de datos en directo proporcionan estadísticas en tiempo real para agentes y supervisores. Los informes de datos en directo (tiempo real) para agentes y supervisores se pueden ejecutar en CUIC y también están disponibles en un escritorio preciso como gadgets. Los datos en directo los consume el servicio de informes de Intelligence Center.

En la página de listado de origen de datos, se muestra el nombre de host principal o la dirección IP. Este origen de datos realiza una conexión de socket web a través del puerto 12015 al servicio de E/S de socket que es responsable de la fuente de datos en directo, por lo que se trata de una conexión de flujo continua y siempre apunta al nodo actual, es decir, N1 apunta a IP/nombre de host de N1 y N2 puntos a IP/nombre de host de N2.

Básicamente, el servicio web de datos en directo se utiliza para realizar llamadas de descanso. Básicamente tiene soporte para tres llamadas de descanso.

• Token de autenticación: Se necesita el token para conectarse: realice una nueva conexión al servicio Socket IO.
  Los clientes envían un token para cada solicitud de conexión validada por el servicio de E/S del socket realizando una llamada de descanso al servicio web de datos en directo.
  
  
• Solicitud de instantánea: La solicitud de instantánea es solicitar al servicio de E/S del socket que envíe datos completos de instantáneas.
  
  
• URL de autenticación: Esta API de descanso proporciona la información, para este agente, que son los valores válidos para los que puede ver los datos en los informes de gadget LD.

Cuando inicia sesión inicialmente en CUIC, este origen de datos necesita certificados para ser aceptados en el puerto 12015. Una vez aceptado, obtiene el token del motor CCX sobre el puerto 9443 y después de la autenticación del token, se conecta. 

Este origen de datos que se desconecta por cualquier motivo provoca que todos los informes LD fallen.

Resolución de problemas comunes

Desde la base de datos CUIC puede consultar el origen de datos mediante la tabla cuicdatasource.
Cada origen de datos tiene id de unigue y es el mismo en todas las versiones. Este es el resultado CLI del sistema 11.0 con información importante en BOLDS
run sql select * from cuic_data:cuicdatasource

id CCCCCC00000000AAAAAA00000001
name CUIC
description Origen de datos para la base de datos CUIC local
type 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
última actualización 2015-10-14 18:35:15.615
versión 1
valor predeterminado de la partición
compartir permiso 3
minpoolsize 5
maxpoolsize 100
owner 11111111111111111111111111AAAA

id D7D7E1A610000132363635BD3F57F543
name UCCX
descripción
type 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
última actualización 2017-05-28 02:18:43.770
owner 11111111111111111111111111AAAA

id E1350DCC1000013F00001CB0A4E5B4B
nombre Origen de datos de streaming de datos en directo
description UCCX Live Data Streaming Data Source
streaming de tipo
dbhost localhost
dbport 9443
embaucador
timezoneid UTC
createdtime 2017-04-05 12:11:00.000
última actualización 2017-04-05 12:11:00.000
minpoolsize 5
maxpoolsize 100
owner 11111111111111111111111111AAAA
corredor
esquema/tiempo real del esquema topicamental
restuser LiveDataAdmin
restpassword ~12Live_Data!12
tokenurl livedata/token/new
websocketport 12015

3 filas recuperadas.

Solución de problemas de origen de datos de flujo de LD

Para que el origen de datos LD se conecte, primero debemos aceptar el certificado que ofrece en el puerto 12015 en el primer inicio de sesión en CUIC—>página de origen de datos:
Después de aceptar certificados, valida el token con el motor. En caso de que el origen de datos LD siga mostrándose desconectado a continuación, se debe ejecutar la comprobación:

• Verifique NTP usando utils ntp status : Los datos en directo dependen de NTP, ya que necesitan sincronizar los eventos en directo que se producen. Asegúrese siempre del estrato 5 de NTP.
• la prueba de diagnóstico de utils debe validar la red correctamente.
• El adaptador de red incorrecto utilizado durante la implementación de óvulos puede provocar una desconexión intermitente de los datos en directo.

Si las comprobaciones anteriores están bien, podemos validar si el origen de datos está recibiendo o no la solicitud de token autenticada. Ejecute esta url en broswer para verificar lo mismo:
https://FQDN-OF-SERVER.com:9443/livedata/token/new
nombre de usuario:LiveDataAdmin
contraseña:~12Live_Data!12

Si ejecutar directamente el url en el navegador da este error, confirma que CCX no proporciona el token de autenticación.
Firefox no puede establecer una conexión con el servidor en uccx.mapfregenelsigorta.com:9443.

Por lo tanto, es posible que esté ocultando el defecto CSCvb75279 y deben ponerse en contacto con el TAC para obtener una solución temporal.

Para UCCX 11.6 y versiones posteriores, utilice esta URL con el nombre de usuario y la contraseña uccxhruser para verificar si el origen de datos está recibiendo la solicitud de token autenticada o no.

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

nombre de usuario:uccxhruser
password: Introduzca la contraseña necesaria

  Una autenticación exitosa le proporciona un nuevo token como se muestra en la imagen:

Conozca el defecto del origen de datos de streaming de datos en directo que se desconecta:

CSCvb67761 : Origen de transmisión de datos en directo sin conexión después de que se agote 'maxThread' en el puerto 9443
CSCvb75279 : Contraseña del almacén de claves MIVR fuera de sincronización, lo que hace que el origen de flujo de LD se desconecte
CSCvc45189 : Origen de datos de streaming de datos en directo sin conexión después de la reconstrucción y restauración.

Origen de datos de UCCX que muestra sin conexión:

Asegúrese de que la base de datos de CCX esté en línea y verifique que el servicio de base de datos de Cisco Unified CCX esté EN SERVICIO desde la página de servicio de CCX.

El origen de datos de UCCX que se conecta a la base de datos histórica (db_cra) de CCX también puede desconectarse si uno de los parámetros con la página de configuración del patio de datos no es correcto. Asegúrese de que todos los campos sean correctos, como se muestra en la imagen, de lo contrario no podrá conectarse a la instancia de la base de datos.

                                                     

Hasta la versión 11.0 se utiliza el usuario uccxhrc para conectarse a la base de datos y este usuario tiene permisos para ejecutar procedimientos almacenados.

CUIC utiliza el usuario uccxhrc para ejecutar el procedimiento almacenado y la contraseña para este usuario está codificada. Así que en caso de que todos los parámetros sean correctos y

aun así, verá el origen de datos que se desconectará y podrá probar la actualización de la contraseña con estas credenciales:

Nombre de usuario: uccxhrc
Contraseña 5:T{i,5e!KqD*8

Después de actualizar la contraseña manualmente en CUIC, haga clic en datasource y seleccione UCCX y luego Edit, realice una conexión de prueba y haga clic en Save, como se muestra en la imagen:

                                                 

Desde la versión 11.5 no utiliza uccxhrc user sino uccxhruser para conectarse a la base de datos de CCX.

La contraseña para uccxhruser se mantiene mediante la administración de contraseñas: CCX Administration > Tools > Password Management > Historical Reporting User. Más información sobre este tema se encuentra en el tema de administración de contraseñas.

Precaución: No utilice la contraseña 5:T{i,5e!KqD*8 de la versión 11.5 ya que no hay ningún usuario uccxhrc que comience 11.5. Si está actualizando la contraseña uccxhruser en 11.5, intente mantener sin mucho uso de caracteres especiales y la contraseña no debe contener paréntesis "(". 

ID de defecto si se utiliza paréntesis: CSCvf21099

Defectos conocidos:

CSCvb72142 : Cambiar la contraseña de usuario de Informes históricos rompe a veces el CUIC

CUIC independiente para CCX

CCX de la versión 11.0 soporta la integración de CUIC independiente además de CUIC co-residente existente.

El CUIC independiente admite varios orígenes de datos, incluido Unified CCX.

StandaloneCuic se puede configurar en la página appadmin de UCCX y se puede utilizar para obtener informes personalizados y se puede instalar con licencias estándar, mejoradas y premium.

Configuración de CUIC independiente con UCCX 

      

1. Inicie sesión en CUIC independiente y seleccione Orígenes de datos en la sección izquierda.
2. Seleccione Crear y agregar el origen de datos UCCX. El ID de usuario de la base de datos es uccxhruser y la contraseña se establece en la página de administración de contraseñas:                                                                                                                                                                                                                                                                            
3. Inicie sesión en la página Administrador de Unified CCX.
4. Haga clic en System y luego seleccione Standalone CUIC configuration.
5. Como se muestra en la imagen, introduzca FQDN del servidor CUIC independiente, Nombre de origen de datos (creado en un servidor CUIC independiente), Nombre de usuario y Contraseña del servidor CUIC.                                                                           
6. Click Save. Las configuraciones de CUIC se guardan y se muestra un mensaje de confirmación.

Solución de problemas comunes con la integración de CUIC independiente

• Verifique que FQDN sea correcto.
• Verifique que la conectividad de red esté ACTIVA y si el servidor CUIC es accesible desde el servidor UCCX
• El nombre de usuario o la contraseña introducida para el servidor CUIC independiente es incorrecto.
• El nombre de instancia dado para el origen de datos con coincidencia independiente con el de UCCX.
• El servicio de base de datos de Cisco Unified CCX en la página Serviciabilidad debe ser INSERVICE.