Note technique sur les sources de données CUIC pour UCCX

Introduction

 Ce document décrit les différentes sources de données de la page Administration de Cisco Unified Intelligence Center (CUIC) de la solution Unified Contact Center Express (UCCX), leurs fonctionnalités, leur configuration et leurs techniques de dépannage.

Le comportement de la source de données CUIC a changé au fil des versions, et cet article décrit le comportement tel qu'il a été observé à partir de la version UCCX 11.5(1).

Présentation des sources de données CUIC

Source de données est le nom donné à la connexion entre un serveur et une base de données qui permet au serveur d'exécuter des requêtes SQL sur la base de données.
La connexion établie ici est une connexion JDBC.

Configuration de la source de données CUIC UCCX

Comme l'illustre l'image, l'application CUIC co-résidente pour CCX dispose de 3 types de sources de données intégrées déjà préconfigurées. 

Source de données CUIC

Il s'agit d'une source de données basée sur des requêtes et de la connexion de base de données à la base de données CUIC (cuic_data) sur le port TCP 1500 et utilise l'utilisateur cuic_report pour exécuter des requêtes sur la base de données CUIC.

Source de données UCCX

Il s'agit également d'une source de données basée sur des requêtes et de la connexion de base de données à la base de données CCX (db_cra) sur le port TCP 1504 et utilise UCCX Historical reporting user (uccxhruser) pour extraire des rapports. CUIC et UCCX sont des sources de données Informix et peuvent être modifiées.

Source de données de flux de données en direct

Il s'agit d'une connexion de socket Web non basée sur des requêtes utilisée pour les données en direct et non modifiable, ce qui signifie que vous ne pouvez pas modifier ses paramètres manuellement.

Cette source de données interroge en permanence le service SocketIO du moteur UCCX afin d'extraire les résultats de données en direct du gestionnaire de données en temps réel (RTDM) du moteur UCCX. Cela pointe toujours vers le noeud local, car il récupère les résultats du service principal du moteur.

Interaction de gestion des mots de passe 

Modifications des versions antérieures

Jusqu'à UCCX 11.0, la source de données UCCX utilise l'utilisateur uccxhrc comme utilisateur de base de données par défaut pour récupérer les données historiques et les afficher sur CUIC, comme illustré dans l'image.

Comme le montre l'image, lorsque UCCX 11.5 démarre, la source de données utilise uccxhruser comme utilisateur de base de données par défaut pour UCCX.

                                                                                                                       

Vous pouvez également utiliser l'utilisateur uccxhruser pour connecter n'importe quel utilisateur de base de données externe à UCCX, pour extraire les données historiques (p. ex. : Un serveur de rapports tiers ou Cisco WorkForce Optimization (WFO).

Utilisateur de rapports historiques (uccxhruser)

Cet utilisateur peut se connecter aux data stores de configuration, d'historique et de référentiel (CDS, HDS et RDS) et dispose des privilèges suivants :

• Accès en lecture seule aux tables Historique, Configuration et Référentiel.
• Exécuter les procédures stockées.
• Créer de nouvelles procédures stockées.

Comme la version 11.5 utilise cet utilisateur pour la source de données UCCX, afin de mettre à jour le mot de passe, accédez à

Barre de menus Administration Unified CCX > Outils > Gestion des mots de passe > Utilisateur de rapports historiques.

il modifie automatiquement le mot de passe de la source de données UCCX pour les rapports historiques avec CUIC.

Dans une configuration de haute disponibilité, cette modification n'est pas propagée à l'autre noeud. Il est donc nécessaire de la mettre à jour sur les deux noeuds.
En outre, dans les configurations HA, vous pouvez vérifier la cohérence lorsque vous cliquez sur l'icône dans la page Gestion des mots de passe pour confirmer que les mots de passe correspondent sur les deux noeuds et sont cohérents dans le cluster. 

L'incohérence du mot de passe peut entraîner la mise hors ligne de la source de données après la redirection (par exemple : Après basculement).

Redirection de l'hôte de source de données UCCX dans HA

Cisco recommande de pointer la source de données UCCX vers le noeud secondaire actuel pour extraire les rapports, afin d'éviter une charge supplémentaire sur le service moteur principal.
L'exécution de rapports historiques peut parfois faire un pic d'utilisation du CPU sur le processus uccxoninit, ce qui prend trop de CPU et cause des problèmes de performances sur le serveur. Par conséquent, cette recommandation de pointer le datastore historique vers le noeud secondaire est en place.

Considérez ici N1 comme le noeud éditeur UCCX (noeud 1) et N2 comme le noeud abonné (noeud 2).
Dans un scénario normal, les deux noeuds ont la source de données UCCX pointant vers le même noeud.

Exemple : 

Si la source de données N1 pointe vers N1, la source de données N2 pointe également vers N1. 

Le comportement de redirection des sources de données diffère dans différentes versions et voici quelques-uns des scénarios spécifiques à la version :

Versions 10.5(1) et 10.6(1) précédentes d'UCCX

Lorsque vous vous connectez pour la première fois à CUIC, le data store historique doit être pointé manuellement sur le noeud secondaire en fonction de la version installée.

Étape 1. Connectez-vous à CUIC.

Étape 2. Cliquez sur la source de données.

Étape 3. Sélectionnez la source de données UCCX.

Étape 4. Cliquez sur Modifier.

Étape 5. Remplacez l'hôte de source de données par celui du noeud secondaire (c'est-à-dire remplacer le nom de l'instance par celui du noeud secondaire). 

Étape 6. Cliquez sur Tester la connexion.

Étape 7. Cliquez sur Enregistrer.

Scénario 1 : N1 est principal et la source de données pointe vers N2 pour les deux noeuds.

Lors du changement de propriété principale du noeud, la redirection de la source de données CCX ne se produit pas et continue de pointer vers le même noeud où il était indiqué avant le changement de propriété principale.

Ici, la source de données N1 et N2 continue à pointer vers N2, qui est maintenant le noeud principal après le basculement.

Avant et après le basculement, il pointe vers le même noeud N2, comme illustré sur l'image :

 

Scénario 2 : N1 est principal et la source de données pointe vers N2 pour les deux noeuds. Arrêt du moteur et de la base de données sur N2.

Maintenant, si le moteur CCX sur N2 s'arrête, il n'y a pas de changement sur la source de données, mais moment où la base de données s'arrête sur N2, la source de données CCX ne se redirige pas automatiquement vers N1 et descend avec la marque red-X. Maintenant, pour extraire la base de données du sous-noeud de rapport, vous devez récupérer ou pointer manuellement la source de données vers la base de données du noeud N1.

Avant et après le basculement, il pointe vers le même noeud N2, comme illustré sur l'image :

Version 11.0(1) et 11.5(1)

La source de données CCX pointe automatiquement vers le noeud secondaire une fois l'installation du noeud 2 pour HA terminée. Il n'est pas nécessaire de pointer manuellement la source de données vers le noeud secondaire.

Scénario 1 : N1 est principal et la source de données pointe vers N2 pour les deux noeuds.

Maintenant, lors du changement de propriété principale du noeud, la redirection de la source de données CCX se produit et après la source de données de basculement, elle pointe vers N1 (désormais secondaire) pour les deux noeuds.

Avant le basculement, le point est N2.

Après le basculement pointe vers N1

Scénario 2 : N1 est principal et la source de données pointe vers N2 pour les deux noeuds. Arrêt du moteur et de la base de données sur N2.

Maintenant, si le moteur de N2 s'arrête, il n'y a pas de changement sur la source de données, mais moment où la base de données s'arrête sur N2, la source de données CCX redirige automatiquement vers N1.

Avant d'arrêter la base de données sur N2

  Après avoir arrêté la base de données sur N2

Ainsi, la source de données globale pointe toujours vers la base de données secondaire.

Source de données de flux de données en direct 

Le rapport de données en direct utilise cette source de données en continu. Il s'agit d'une source de données de stock préconfigurée dans Unified Intelligence Center et les champs ne peuvent pas être modifiés. Les rapports de données en direct fournissent des statistiques en temps réel pour l'agent et le superviseur. Les rapports de données en direct (temps réel) pour les agents et les superviseurs peuvent être exécutés dans CUIC et également disponibles sur le bureau finesse sous forme de gadgets. Les données en direct sont consommées par le service Intelligence Center Reporting.

Sur la page de liste des sources de données, le nom d'hôte principal ou l'adresse IP s'affiche. Cette source de données établit une connexion de socket Web sur le port 12015 au service d'E/S de socket qui est responsable du flux de données en direct. Il s'agit donc d'une connexion de flux continu et pointe toujours vers le noeud actuel, c'est-à-dire N1 pointe vers IP/hostname de N1 et N2 pointe vers IP/hostname de N2.

Le service Web de données en direct est essentiellement utilisé pour passer des appels de repos. En gros, il prend en charge trois appels de repos.

• Jeton d'authentification : Le jeton est requis pour la connexion : établissez une nouvelle connexion au service d'E/S de socket.
  Les clients envoient un jeton pour chaque demande de connexion validée par le service d'E/S de socket en effectuant un appel de repos au service Web de données en direct.
  
  
• Demande de snapshot : La demande de capture instantanée consiste à demander au service d'E/S du socket d'envoyer des données de capture instantanée complètes.
  
  
• URL d'authentification : Cette API restante fournit les informations pour cet agent qui sont les valeurs valides pour lesquelles il peut afficher les données dans les rapports de gadget LD.

Lorsque vous vous connectez initialement à CUIC, cette source de données a besoin de certificats pour être acceptée sur le port 12015. Une fois accepté, il récupère le jeton à partir du moteur CCX sur le port 9443 et après authentification du jeton, il se met en ligne. 

Cette source de données qui se déconnecte pour une raison quelconque provoque l'échec de tous les rapports LD.

Dépannage des problèmes courants

À partir de la base de données CUIC, vous pouvez interroger la source de données à l'aide de la table cuicdatasource.
Chaque source de données possède un ID unique et est identique pour toutes les versions. Voici la sortie CLI du système 11.0 avec des informations importantes dans BOLDS
exécuter sql select * à partir de cuic_data:cuicdatasource

id CCCCCC0000000AAAAAAAA000000001
nom CUIC
description Source de données pour la base de données CUIC locale
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
créatedtime 2010-01-27 14:48:14.368
mis à jour le 10/15/2014 à 18:35:15.615
version 1
partition par défaut
autorisation de partage 3
minpoolsize 5
maxpoolsize 100
propriétaire 1111111111111111111111111111111AAAA

id D7D7E1A610000132363635BD3F57F543
nom UCCX
description
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
créatedtime 2017-05-18 18:03:52.000
mise à jour le 28/05/2017 02:18:43.770
propriétaire 1111111111111111111111111111111AAAA

id E1350DCC1000013F000001CB0A4E5B4B
Nom Source de données de diffusion de données en continu
description UCCX Live Data Streaming Data Source
Type Streaming
dbhost localhost
dbport 9443
dbuser
timezoneid UTC
créatedtime 2017-04-05 12:11:00.000
mise à jour 2017-04-05 12:11:00.000
minpoolsize 5
maxpoolsize 100
propriétaire 1111111111111111111111111111111AAAA
brokerurl
topicschema realtime/schema
restuser LiveDataAdmin
restpassword ~12Live_Data !12
tokenurl livedata/token/new
websocketport 12015

3 lignes récupérées.

Dépannage de la source de données de diffusion LD

Pour que la source de données LD puisse être mise en ligne, nous devons d'abord accepter le certificat qu'elle offre sur le port 12015 lors de la première connexion à la page CUIC—>source de données :
Après avoir accepté les certificats, il valide ensuite le jeton avec le moteur. Dans le cas où la source de données LD affiche toujours hors connexion en dessous de la vérification doit être exécutée :

• Vérifiez NTP à l'aide de l'état ntp utils : Les données en direct dépendent de NTP car elles doivent synchroniser les événements en direct qui se produisent. Assurez-vous toujours de la strate 5 NTP.
• Le test de diagnostic utils doit valider correctement le réseau.
• Une carte réseau incorrecte utilisée lors du déploiement d'ovules peut provoquer une déconnexion intermittente des données en direct.

Si les vérifications ci-dessus sont correctes, nous pouvons valider si la source de données obtient ou non l'autorisation de la demande de jeton. Exécutez cette URL dans le navigateur pour vérifier la même chose :
https://FQDN-OF-SERVER.com:9443/livedata/token/new
nom d'utilisateur:LiveDataAdmin
mot de passe :~12Données_dynamique !12

Si l'exécution au-dessus de l'url directement dans le navigateur donne cette erreur, il confirme que CCX ne fournit pas de jeton d'authentification.
Firefox ne peut pas établir de connexion au serveur sur uccx.mapfregenelsigorta.com : 9443.

Il y a donc des chances que vous rencontriez un défaut CSCvb75279 et doivent contacter le centre d'assistance technique pour trouver une solution.

Pour UCCX 11.6 et les versions ultérieures, utilisez cette URL avec le nom d'utilisateur et le mot de passe uccxhruser pour vérifier si la source de données obtient ou non l'authentification de la demande de jeton.

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

nom d'utilisateur:uccxhruser
password (mot de passe) : Saisissez le mot de passe requis

  Une authentification réussie vous donne un nouveau jeton comme illustré dans l'image :

Défaut de détection de la source de données de diffusion de données en direct hors connexion :

CSCvb67761 :: Source de flux de données en direct hors connexion après épuisement de 'maxThreads' sur le port 9443
CSCvb75279 :: Mot de passe du magasin de clés MIVR hors synchronisation, ce qui rend la source de diffusion LD hors connexion
CSCvc45189 :: Source de données de diffusion en continu en direct hors ligne après reconstruction et restauration.

Source de données UCCX : Hors connexion :

Vérifiez que la base de données CCX est en ligne et que le service de base de données Cisco Unified CCX est EN SERVICE depuis la page de maintenance de CCX.

La source de données UCCX se connectant à la base de données historique (db_cra) de CCX peut également se déconnecter si l'un des paramètres de la page de configuration de la base de données n'est pas correct. Assurez-vous que tous les champs sont corrects, comme le montre l'image, sinon il ne peut pas se connecter à l'instance de base de données.

                                                     

Jusqu'à la version 11.0, vous utilisez uccxhrc pour vous connecter à la base de données et cet utilisateur a les autorisations d'exécuter des procédures stockées.

CUIC utilise uccxhrc user pour exécuter la procédure stockée et le mot de passe de cet utilisateur est codé en dur. Donc au cas où tous les paramètres sont corrects et

toujours que la source de données est hors connexion, la mise à jour du mot de passe avec ces informations d'identification peut être tentée :

username (nom d’utilisateur) : uccxhrc
Mot de passe : 5:T{i,5e ! KqD*8

Après avoir mis à jour manuellement le mot de passe sous CUIC, cliquez dans la source de données et sélectionnez UCCX, puis Modifier, effectuez une connexion de test et cliquez sur Enregistrer, comme illustré dans l'image :

                                                 

À partir de la version 11.5, vous n'utilisez pas uccxhrc user plutôt uccxhruser pour vous connecter à la base de données CCX.

Le mot de passe de uccxhruser est maintenu via la gestion des mots de passe : CCX Administration > Tools > Password Management > Historical Reporting User. Pour plus d'informations, reportez-vous à la rubrique relative à la gestion des mots de passe.

MISE EN GARDE: N'utilisez pas le mot de passe 5:T{i,5e ! KqD*8 à partir de la version 11.5, car aucun utilisateur uccxhrc ne démarre 11.5. Si vous mettez à jour le mot de passe uccxhruser dans 11.5, essayez de garder avec peu d'utilisation des caractères spéciaux et le mot de passe ne doit pas contenir de parenthèses "(« . 

ID de défaut si parenthèse utilisée : CSCvf21099

Défauts connus:

CSCvb72142 : La modification du mot de passe utilisateur des rapports historiques rompt parfois CUIC

CUIC autonome pour CCX

CCX de la version 11.0 prend en charge l'intégration de CUIC autonome en plus de CUIC corésident déjà existant.

Le CUIC autonome prend en charge plusieurs sources de données, y compris Unified CCX.

StandaloneCuic peut être configuré sur la page d'application UCCX et peut être utilisé pour obtenir un rapport personnalisé et peut être installé avec des licences standard, améliorées et premium.

Configuration de CUIC autonome avec UCCX 

      

1. Connectez-vous au CUIC autonome et sélectionnez Sources de données dans le tiroir de gauche.
2. Sélectionnez Créer et ajouter une source de données UCCX. L'ID utilisateur de base de données est uccxhruser et le mot de passe est défini sur la page de gestion des mots de passe :                                                                                                                                                                                                                                                                            
3. Connectez-vous à la page Unified CCX Administrator.
4. Cliquez sur Système, puis sélectionnez Configuration CUIC autonome.
5. Comme l'illustre l'image, saisissez le nom de domaine complet du serveur CUIC autonome, le nom de source de données (créé dans le serveur CUIC autonome), le nom d'utilisateur et le mot de passe du serveur CUIC.                                                                           
6. Click Save. Les configurations CUIC sont enregistrées et un message de réussite s'affiche.

Dépannage commun avec intégration de CUIC autonome

• Vérifiez que le nom de domaine complet (FQDN) est correct.
• Vérifiez que la connectivité réseau est activée et si le serveur CUIC est accessible à partir du serveur UCCX
• Le nom d'utilisateur ou le mot de passe entré pour le serveur CUIC autonome est incorrect.
• Le nom d'instance donné pour la source de données avec une correspondance autonome avec celui de UCCX.
• Le service de base de données Cisco Unified CCX sous la page Serviceability doit être INSERVICE.