Dépannage des problèmes CUCM Web (GUI)

Introduction

Ce document décrit les raisons pour lesquelles la page utilisateur et les pages Web de Cisco Unified Communications Manager (CUCM) ne s'affichent pas ou génèrent des erreurs.

Conditions préalables

Exigences

Cisco recommande que vous ayez connaissance de CUCM.

Composants utilisés

Les informations contenues dans ce document sont basées sur les versions 7.x/8.x/9.x/10.x de CUCM.

The information in this document was created from the devices in a specific lab environment. All of the devices used in this document started with a cleared (default) configuration. Si votre réseau est en ligne, assurez-vous de bien comprendre l’incidence possible des commandes.

Diagramme De Flux

L'organigramme de l'accès Web sur CUCM est présenté ici :

Problème 1 : erreur de communication de base de données

Lorsque vous tentez de vous connecter à la page Web CUCM Admin à partir de Publisher, l'erreur « Database communication error » est reçue.

Vous pouvez vous connecter à la page Web d'administration de CUCM à partir de l'Abonné, mais toute modification apportée à CUCM entraîne l'une des erreurs suivantes :

"Une erreur s'est produite lors de la récupération des informations de la base de données. java.sql.SQLException : Aucune autorisation DELETE." ou "Échec de l'ajout. Le privilège Insert est requis pour cette opération."

Ce problème peut se produire lorsque vous essayez de vous connecter au serveur après que des modifications ont été apportées au serveur de publication, par exemple lorsque le nom d'hôte ou l'adresse IP est modifié via l'interface de ligne de commande ou la page d'administration du système d'exploitation.

Dans ce cas, rétablissez les modifications apportées à l'ancienne configuration afin de vous permettre de vous connecter.

Si aucune modification n'a été apportée à CUCM Publisher et que vous recevez toujours le message d'erreur de communication de base de données, vérifiez les éléments suivants :

• Entrez la commande utils dbreplication runtimesstate afin de vérifier l'état de DBreplication.

Vérifiez que l'état de la réplication est égal à 2 sur tous les noeuds sans erreur ni incohérence.

• Déterminez si un service de base de données Cisco (DB) est actuellement exécuté. Une base de données Cisco non démarrée sur Publisher peut également provoquer ce problème.

Le symptôme d'erreur sur l'Abonné est différent, car l'Abonné utilise son propre processus de base de données A Cisco qui s'exécute correctement. Cependant, lorsque vous tentez de mettre à jour la configuration, l'Abonné contacte une base de données Cisco sur Publisher qui ne fonctionne pas et provoque également une erreur sur l'Abonné. En outre, l'impossibilité d'accéder à la page CUCM de Publisher est probablement due à une erreur de communication de base de données où Informix n'accepte plus aucune connexion.

La commande utils dbreplication runtimestate ne fonctionne pas :

admin:utils dbreplication runtimestate
File "/usr/local/cm/bin/DbReplRTstate.py", line 578, in ?
   fin = open(tfile, 'r')
IOError: [Errno 2] No such file or directory: 
'/var/log/active/cm/trace/dbl/sdi/getNodes'

Ce problème est également documenté par l'ID de bogue Cisco CSCtl74037. La solution de contournement consiste à entrer ces commandes à partir de l'interface de ligne de commande :

utils service stop A Cisco DB
utils service start A Cisco DB

et arrêtez le service Cisco Express Forwarding (CEF) à partir de la page de facilité de maintenance.

Entrez la commande utils service start A Cisco DB afin de démarrer le service A Cisco DB.

Si le service ne démarre pas, appelez le centre d'assistance technique Cisco (TAC) afin de démarrer le service à partir de la racine. Le TAC vérifie le problème d'accès racine. Dans quelques cas, si la base de données est corrompue, une reconstruction de CUCM est nécessaire.

Problème 2 : impossible d'établir la connexion au serveur (impossible d'accéder au noeud distant)

Vous ne pouvez pas accéder aux autres noeuds CUCM à partir de la page Serviceability du CUCM auquel vous êtes actuellement connecté.

Choisissez Cisco Unified Serviceability > Tools > Control Center Feature/Network Services > Select Server > Go.

Le message d'erreur affiché est « Connection to the Server cannot be established (Unable to access remote node) ».

Solution de contournement

Connectez-vous séparément à chaque noeud CUCM afin d'accéder aux services de maintenance et d'activation/désactivation.

Solution

1. Vérifiez si le certificat Tomcat a expiré. (Choisissez Cisco OS Administration > Security > Certificate Management > tomcat.pem). S'il a expiré, régénérez le certificat Tomcat et redémarrez le service Tomcat.
   • Si vous utilisez un certificat signé par une autorité de certification (CA), obtenez la demande de signature de certificat (CSR) Tomcat re-signée par l'autorité de certification, re-téléchargez-la à nouveau et redémarrez le service Cisco Tomcat avec la commande utils service restart Cisco Tomcat.
   • Si vous utilisez un certificat auto-signé sur le serveur affecté, régénérez le certificat Tomcat avec la commande set cert regen tomcat depuis l'interface de ligne de commande ou depuis OS Admin, puis redémarrez le service Cisco Tomcat avec la commande utils service restart Cisco Tomcat.

     Ce défaut connu est documenté dans l'ID de bogue Cisco CSCth44399.

2. Confirmez la validité des certificats Tomcat. Vérifiez si le certificat d'approbation Tomcat du noeud problématique se trouve sur l'autre noeud. S'il ne se trouve pas sur le noeud, téléchargez le certificat d'approbation Tomcat du noeud problématique et téléchargez-le vers l'autre noeud en tant qu'approbation Tomcat. Ensuite, régénérez le certificat Tomcat sur le noeud problématique et redémarrez le service Tomcat sur les deux noeuds.

Problème 3 : Impossible d'établir la connexion au serveur (erreur inconnue)

Vous ne pouvez pas accéder aux autres noeuds CUCM à partir de la page Serviceability du CUCM auquel vous êtes actuellement connecté. Choisissez Cisco Unified Serviceability > Tools > Service Activation/Control Center Feature/Network Services > Select Server > Go.

Le message d'erreur affiché est « La connexion au serveur ne peut pas être établie (erreur inconnue) ».

Solution de contournement

Connectez-vous séparément à chaque noeud CUCM afin d'accéder aux services de maintenance et d'activation/désactivation.

Solution

1. Entrez la commande utils dbreplication runtimestate pour vérifier les problèmes de réplication dans le cluster CUCM.
2. Redémarrez le service Tomcat avec la commande utils service restart Cisco Tomcat.
3. Recherchez les incohérences de numéro de série de certificat Tomcat (tomcat-trust) sur les noeuds.
4. Choisissez Cisco OS Administration > Security > Certificate Management > tomcat.pem et vérifiez si le certificat Tomcat a expiré. S'il a expiré, régénérez le certificat Tomcat et redémarrez le service Tomcat.
   • Si vous utilisez un certificat signé par une autorité de certification, faites signer à nouveau le CSR Tomcat par l'autorité de certification, rechargez-le et redémarrez le service Cisco Tomcat à l'aide de la commande utils service restart Cisco Tomcat.
   • Si vous utilisez un certificat auto-signé sur le serveur affecté, régénérez le certificat Tomcat avec la commande set cert regen tomcat depuis l'interface de ligne de commande ou depuis OS Admin, puis redémarrez le service Cisco Tomcat avec la commande utils service restart Cisco Tomcat.

     Ces défauts connus sont documentés dans l'ID de bogue Cisco CSCui29232 et l'ID de bogue Cisco CSCud67438.

Problème 4 : Impossible d'établir la connexion au serveur (exception de certificat)

Vous ne pouvez pas accéder aux autres noeuds CUCM à partir de la page Serviceability du CUCM auquel vous êtes actuellement connecté.

Choisissez Cisco Unified Serviceability > Tools > Service Activation/Control Center Feature/Network Services > Select Server > Go.

Le message d'erreur affiché est « Connection to the Server cannot be established (Certificate Exception) ».

Solution de contournement

Connectez-vous séparément à chaque noeud CUCM afin d'accéder aux services de maintenance et d'activation/désactivation.

Solution

1. Entrez la commande utils dbreplication runtimestate afin de vérifier tout problème de réplication dans le cluster CUCM.
2. Redémarrez le service Tomcat avec la commande utils service restart Cisco Tomcat.
3. Recherchez les incohérences de numéro de série de certificat Tomcat (tomcat-trust) sur les noeuds.
4. Choisissez Cisco OS Administration > Security > Certificate Management > tomcat.pem et vérifiez si le certificat Tomcat a expiré. S'il a expiré, régénérez le certificat Tomcat et redémarrez le service Tomcat.
   • Si vous utilisez un certificat signé par une autorité de certification, faites signer à nouveau le CSR Tomcat par l'autorité de certification, rechargez-le et redémarrez le service Cisco Tomcat à l'aide de la commande utils service restart Cisco Tomcat.
   • Si vous utilisez un certificat auto-signé sur le serveur affecté, régénérez le certificat Tomcat avec la commande set cert regen tomcat de l'interface de ligne de commande ou d'OS Admin, puis redémarrez Cisco le service Tomcat avec la commande utils service restart Cisco Tomcat.

     Ce défaut connu est documenté dans l'ID de bogue Cisco CSCup10995.

Problème 5 : accès à l'interface graphique très lent

L'accès Web/GUI de CUCM sur Publisher et Subscriber est très lent.

Solution

1. CUCM Admin interroge toujours la base de données de l'éditeur lorsqu'elle est disponible. Reportez-vous au schéma de la section Organigramme.
2. Vérifiez si le réseau présente des problèmes ou des retards. Cela se produit si la mise en grappe est effectuée sur un réseau étendu (WAN).
3. Redémarrez le service Cisco Tomcat à partir de l'interface de ligne de commande/Secure Shell (SSH) avec la commande utils service restart Cisco Tomcat.
4. Planifiez une fenêtre de maintenance et redémarrez les noeuds CUCM.
5. Si le problème se reproduit, contactez le centre d'assistance technique à l'aide des journaux suivants :
   • Suivi (détaillé) du Gestionnaire d'appels
   • Journaux Tomcat (journaux à partir du résultat de la commande file get activelog tomcat/logs/* de l'interface de ligne de commande)
   • Journal des applications Observateur d'événements
   • Journaux système de l'Observateur
   • Journaux de performances du collecteur de données Cisco RIS (Real-Time Information Server)
   • Journaux de Service Manager
   • Résultat de ces commandes à partir de l'interface de ligne de commande de CUCM :

     utils diagnose test
     utils ntp status
     show process load cpu
     show process load memory
     show process using-most cpu
     show process using-most memory
     utils core active list

   • Journaux du contrôleur de gestion intégré Cisco (CIMC) 

Ces défauts connus sont documentés dans l'ID de bogue Cisco CSCub02337 et l'ID de bogue Cisco CSCui86571.

Problème 6 : Impossible de copier/coller le mot de passe dans la page de connexion de l'utilisateur final

Copier/coller dans le champ Mot de passe de la page de connexion de l'utilisateur final CUCM ne fonctionne pas.

L'opération de collage du mot de passe dans le champ Mot de passe de la page de connexion de l'utilisateur final CUCM n'est pas prise en charge.

Cela ne fonctionne pas avec Internet Explorer (IE), Firefox ou Chrome.

Copier/coller le mot de passe n'est pas autorisé sur les pages utilisateur final en raison du risque de sécurité. Ceci est ajouté dans le cadre de CUCM version 9.1.2 et ultérieures.

Cependant, il a été remarqué que la fonction copier/coller fonctionne toujours avec quelques versions de CUCM 10.x, qui est documentée dans l'ID de bogue Cisco CSCus84153 et l'ID de bogue Cisco CSCus84152.

Problème 7 : Impossible d'accéder à ELM avec Firefox et Chrome

Vous ne pouvez pas accéder à Enterprise License Manager (ELM) avec Firefox et Chrome, mais cela fonctionne correctement avec IE. Lorsque vous vous connectez à ELM avec Firefox ou Chrome, aucune des options n'est disponible.

Ce défaut connu est documenté dans l'ID de bogue Cisco CSCul30396.

Ce problème a été corrigé dans les versions 9.1.2.11900-10 et ultérieures de CUCM. ELM est accessible avec Firefox, IE et Chrome.

Problème 8 : la page Web se déconnecte automatiquement

La page Web CUCM se déconnecte automatiquement après l'expiration de son délai d'inactivité.

Vous pouvez définir le délai d'expiration de la page Web avec ces commandes à partir de l'interface de ligne de commande de CUCM.

show webapp session timeout
set webapp session timeout

admin:set webapp session timeout ?

Syntaxe

set webapp session timeout minutes

Minutes est obligatoire et correspond au nombre de minutes après lesquelles les sessions sont déclarées invalides. La vitesse est comprise entre 5 et 99999.

admin:set webapp session timeout 5

Si vous poursuivez cette opération, le délai d'expiration de session pour les sessions Web est défini sur 5 minutes après le redémarrage du service Cisco Tomcat ou après le redémarrage du serveur.

Continue (y/n)?y
Tomcat session-timeout updated to 5 minutes.

Le service Cisco Tomcat doit être redémarré pour que les modifications prennent effet immédiatement. Cette opération déconnecte les sessions Web actives.

Continue (y/n)?y

N'appuyez pas sur Ctrl-C pendant que le service REDÉMARRE. Si le service n'a pas redémarré correctement, entrez à nouveau la même commande.

Service Manager is running

Cisco Tomcat[STOPPING]

Cisco Tomcat[STOPPING]

Cisco Tomcat[STOPPING]

Cisco Tomcat[STOPPING]

Commanded Out of Service

Cisco Tomcat[NOTRUNNING]

Service Manager is running

Cisco Tomcat[STARTING]

Cisco Tomcat[STARTING]

Cisco Tomcat[STARTED]

Le service Cisco Tomcat a redémarré avec succès. Les nouvelles sessions Web expirent après 5 minutes. Le délai d'expiration de session actuellement utilisé pour les sessions Web et les applications est de 5 minutes.

Problème 9 : Impossible d'accéder à la page Web Admin/User de CUCM

Vous ne pouvez pas accéder à la page Web Admin/User de CUCM.

1. Vérifiez si les informations d'identification de l'utilisateur sont correctes. Si vous avez saisi des informations d'identification incorrectes, vous recevez cette erreur.

   

2. Vérifiez si l'utilisateur dispose des autorisations correctes (rôles et groupes d'utilisateurs) configurées. Si elles ne sont pas correctement configurées, la page Web invite à nouveau la page de connexion sans aucun message d'erreur.

Problème 10 : L'agent local ne répond pas, l'agent principal ou local est arrêté

Vous ne pouvez accéder à aucune option de la page Disaster Recovery System (DRS) de CUCM après vous être connecté. 

"L'agent local ne répond pas." Cela est peut-être dû à l'arrêt de l'agent principal ou local. 

1. Vérifiez le certificat IPsec et confirmez la validité. S'il a expiré, régénérez le certificat IPsec. 
2. Redémarrez les services Cisco DRF Primary et DRF Local.

Informations connexes

• Assistance et documentation techniques - Cisco Systems