Dépanner les services qui ne démarrent pas sur IM&P

Introduction

Ce document décrit les étapes à suivre lorsqu'un service de messagerie instantanée et de présence Cisco (IM&P) ne démarre pas comme prévu.

Informations générales

Les états d'un service

Les services IM&P présentent les états suivants :

Gardez à l'esprit qu'après le redémarrage du noeud IM&P, l'avertissement suivant est généré et peut être trouvé soit sur l'interface graphique utilisateur (GUI) si vous accédez à la page Notifications, soit via l'interface de ligne de commande (CLI) :

Cisco IM and Presence Data Monitor a détecté que la réplication de la base de données n'est pas terminée et/ou que la synchronisation de Cisco Sync Agent à partir de Cisco Unified Communications Manager n'est pas terminée. Certains services peuvent rester à l'état « Démarrage » jusqu'à ce que la réplication et la synchronisation de Cisco Sync Agent soient correctement effectuées.

Le message ne signifie pas nécessairement que les services restent dans l'état Démarrage depuis que l'alerte est générée. Cela est attendu lorsque le moniteur de données IM&P commence à surveiller les services dès que le gestionnaire IM&P est redémarré ou amorcé. La première chose que le service de surveillance détecte est que tous les services principaux sont en cours de démarrage, ce qui déclenche le message.

Afin de confirmer l'état réel des services, exécutez la commande utils service list.

Remarque : Si les services sont dans l'état Started, n'hésitez pas à supprimer l'alerte pour garder les alertes de notification propres.

Dépannage

Identifier le problème

La première étape pour dépanner les services qui ne démarrent pas est de comprendre quels services sont ceux qui ne démarrent pas.

Il est important de valider la légende qui apparaît sur le côté droit des services qui sont arrêtés, généralement vous pouvez identifier :

• Service non activé : Cela signifie que le service de fonctionnalité n'a pas été activé et que vous devez d'abord le faire.

• Commandé hors service : Ce message apparaît après un redémarrage du serveur et si la haute disponibilité n'a pas été désactivée ou si certains services ont été redémarrés, et cette action a provoqué l'arrêt manuel d'autres services. Dans d'autres cas, lorsque l'administrateur réseau arrête manuellement le service, ce message s'affiche. La solution consiste à démarrer les services manuellement à partir de l'interface utilisateur graphique ou de l'interface de ligne de commande.

• NOTRUNNING : ce message s'affiche en cas d'erreur au niveau des services et d'impossibilité de démarrer. Ce message s'affiche parfois après que le service a été tenté de démarrer manuellement. La première tentative consiste à démarrer le service manuellement. Toutefois, si cette action ne fonctionne pas, les prochaines étapes de dépannage doivent être effectuées. Utilisez ce guide pour vous aider à résoudre les problèmes de démarrage des services.

Les services restent sur l'état STARTING

L'un des problèmes les plus courants rencontrés par l'abonné IM&P après un redémarrage consiste à afficher la quasi-totalité des services à l'état DÉMARRÉ, tandis que l'éditeur IM&P affiche tous les services comme DÉMARRÉ.

La cause courante de ce comportement est un redémarrage de l'abonné IM&P lorsque la haute disponibilité n'a pas été désactivée dans les groupes de redondance de présence.

Solution

Étape 1. Désactivez la haute disponibilité à partir des groupes de redondance de présence, accédez à la page CUCM Administration > System.

Étape 2. Exécutez la commande suivante sur les deux noeuds IM&P : set replication-sync monitor disable.

Étape 3. Attendez environ 5 minutes et exécutez la commande suivante : utils service list à nouveau pour confirmer que les services sont maintenant démarrés.

Étape 4. Vérifiez que tous les services sont DÉMARRÉS sur l'abonné, puis exécutez la commande suivante sur les deux noeuds IM&P : set replication-sync monitor enable.

Étape 5. Réactivez la haute disponibilité à partir des groupes de redondance de présence.

Les services spécifiques ne démarrent pas

Services réseau

Bien que peu fréquents, il y a eu des scénarios dans lesquels certains services réseau ne démarrent pas sur l'éditeur IM&P, à savoir :

• Agent de profil client Cisco
• Routeur Cisco XCP (Extensible Communications Platform)
• Gestionnaire de configuration Cisco XCP
• Datastores Cisco Route and Presence

Avertissement : les services XCP, Presence Engine et SIP Proxy ne peuvent pas démarrer, car ils dépendent des services réseau répertoriés. Cela empêche la réplication de la base de données de messages instantanés (IMDB) et empêche les utilisateurs Jabber de se connecter.

Solution

Les services peuvent être démarrés via l'interface Web (Naviguez jusqu'à IM and Presence Serviceability > Tools > Control Center - Network Services > Look for the IM and Presence Services) ou via l'interface de ligne de commande (CLI), utilisez la commande utils service start <name_of_the_service>.

Étape 1 : désactivation de la haute disponibilité à partir des groupes de redondance de présence

Étape 2. Démarrez chaque service manuellement uniquement dans l’ordre suivant :

• Agent de profil client Cisco
• Data store de routage Cisco
• Datastore Cisco Presence
• Gestionnaire de configuration Cisco XCP
• Routeur Cisco XCP

Remarque : Pour que Cisco Client Profile Agent démarre, le service Cisco Tomcat doit être démarré.

Si les étapes précédentes n'ont pas fonctionné, vous devez ouvrir un dossier auprès du Centre d'assistance technique Cisco (TAC) pour poursuivre le dépannage. Gardez à l'esprit que les résultats et les journaux suivants sont requis et.

1. Sorties CLI :
• show network cluster
• utils dbreplication runtimestate
• statut de haute disponibilité utils
• liste active du noyau utils
• liste de services utils
2. Journaux/traces :
• Agent Cisco Syslog
• Event Viewer-Application Log (journal d’événements pour l’application)
• Event Viewer-System Log (journal d’événements pour le système)
• Toutes les traces des services qui restent arrêtés

Base de données Cisco (DB)

Il s'agit de l'un des principaux services du système.

Avertissement : Si ce service ne démarre pas, le serveur ne peut pas accéder à certaines fonctionnalités de la page Web du serveur, les utilisateurs Jabber et leurs fonctionnalités sont compromis, la réplication de base de données est interrompue.

Causes :

Les causes les plus courantes de ce problème sont les suivantes :

• Changement du nom d'hôte, de l'adresse IP ou du domaine sans le processus des directives Cisco.
• Corruption des fichiers après un arrêt maladroit du système.

Solution :

Malheureusement, il n'y a pas d'étapes de solution simples si ce service ne démarre pas. Les suggestions sont les suivantes :

Étape 1 : désactivation de la haute disponibilité à partir des groupes de redondance de présence

Étape 2. Redémarrez Un Cisco DB Replicator.

Étape 3. Redémarrez Une base de données Cisco, si elle reste à l'état DÉMARRAGE, essayez de l'arrêter, puis de la démarrer.

La meilleure approche consiste ici à faire appel au TAC Cisco pour un examen plus approfondi, et les informations suivantes sont requises :

1. Sorties CLI :
• show tech network hosts
• show tech database dump
• show tech dbintégrité
• utils create report database
• utilise la connectivité réseau IM&P_node 1500
• Afficher le cluster réseau
• liste active du noyau utils
2. Journaux ou traces :
• Cisco Database Layer Monitor
• Cisco Database Library Trace
• Service de notification de base de données Cisco
• Suivi de Cisco Database Replicator
• Service de base de données Cisco Informix
• Agent Cisco Syslog
• Event Viewer-Application Log (journal d’événements pour l’application)
• Event Viewer-System Log (journal d’événements pour le système)

Cisco Intercluster Sync Agent (ICSA)

Avertissement : Si ce service ne démarre pas, la base de données IM&P ne peut pas être synchronisée entre les noeuds IM&P et les clusters IM&P (appairage inter-cluster).

Solution :

1. La haute disponibilité est dans un état incorrect (ou incorrect) et ne permet pas au service de s'activer.

Étape 1. Vous devez désactiver la haute disponibilité, démarrer le service, puis réactiver la haute disponibilité.

• Le serveur est affecté par l'un de ces deux défauts :
  • ID de bogue Cisco CSCvj09515
  • ID de bogue Cisco CSCvq63308  

Si le service ne s'active pas, vous devez ouvrir un dossier TAC pour poursuivre le dépannage. Gardez à l'esprit que les résultats et les journaux suivants sont nécessaires.

1. Sorties CLI
• show network cluster
• utils dbreplication runtimestate
• statut de haute disponibilité utils
• liste active du noyau utils
• liste de services utils
2. Journaux/ Traces
• Agent Cisco Syslog
• Event Viewer-Application Log (journal d’événements pour l’application)
• Event Viewer-System Log (journal d’événements pour le système)
• Cisco Service Recovery Manager
• Service Cisco Intercluster Sync Agent

Moteur de présence

Pour le service Cisco Presence Engine, plusieurs variantes doivent être prises en compte afin de comprendre pourquoi le service ne démarre pas et comment le faire démarrer.

1. Ouvrez une interface de ligne de commande et exécutez la commande : utils service list validate that the next services are in running state, if they are not, they need to be started first:
• Datastore Cisco Presence
• Proxy SIP Cisco
• Routeur Cisco XCP
• Agent Cisco Sync

2. La raison la plus courante pour laquelle le service Cisco Presence Engine (PE) ne démarre pas dans l'abonné IM&P est que l'abonné IM&P n'a pas été ajouté au groupe de redondance de présence (PRG).

• Motif : Le service PE est lié au PRG et doit être ajouté pour démarrer.
• Solution : Ajoutez le serveur au PRG et attendez environ 5 minutes pour voir s'il démarre.
• Variantes : Il est probable qu'après l'application de la solution précédente, le PE s'arrête sur les deux noeuds IM&P et que la solution doit effectuer les étapes suivantes :

Étape 1. Maintenez l'abonné IM&P dans le PRG.

Étape 2 : désactivation de la haute disponibilité à partir du PRG

Étape 3. Les étapes suivantes doivent d’abord être effectuées sur l’éditeur, puis sur l’abonné

Étape 4. Redémarrez d’abord le service proxy SIP Cisco, puis attendez qu’il démarre.

Étape 5. Redémarrez le service Cisco PE et attendez qu’il démarre.

3. Si l'abonné IM&P est déjà ajouté au PRG et que le PE reste à l'état STOPPED ou STARTING, cela peut être lié à une non-correspondance dans la réplication de base de données entre les deux noeuds IM&P, exécutez la commande run sql select * from enterprise node suivante. Le résultat de cette requête affiche l'id du noeud, le subclusterid du noeud (qui est l'id PRG), le nom ou l'adresse IP et d'autres valeurs. Vous devez vous concentrer sur le fait que les deux noeuds IM&P partagent la même valeur subclusterid.

• Motif : Si la réplication de base de données ne s'est pas effectuée correctement, l'abonné IM&P affiche l'ID de sous-cluster comme NULL.
• Solution : 

Étape 1. Exécutez la commande suivante : run sql update enterprisenode set subclesterid=subclesterid_value_as_for_the_IM&P_Pub where id=IM&P_Sub_id

Étape 2. Réexécutez la commande suivante run sql select * from enterprise node et assurez-vous que le subclusterid a la valeur correcte (identique) pour les deux noeuds IM&P. Le service doit démarrer automatiquement dans les 5 minutes à venir ou vous pouvez essayer de le démarrer manuellement.

• Recommandation : Ouvrez un dossier Cisco TAC pour effectuer cette modification.

4. Si, après le dépannage précédent, tous les services sont démarrés, à l’exception du PE :

• Solution :

Étape 1. Exécutez la commande : set replication-sync monitor disable sur les deux noeuds IM&P.

Étape 2. Patientez environ 5 minutes et, si vous ne démarrez pas le service manuellement, exécutez la commande suivante : utils service start Cisco Presence Engine.

Étape 3. Exécutez la commande set replication-sync monitor enable.

5. Si le service PE ne peut pas encore démarrer, vérifiez si le serveur exécute la version 12.5. Dans ce cas, il est très probable qu'il soit affecté par l'ID de bogue Cisco CSCvg94247.

Agent Cisco Sync

Avertissement : Si ce service ne démarre pas, la synchronisation des tables de base de données de CUCM vers IM&P n'est pas terminée, ce qui a principalement un impact sur la synchronisation de l'utilisateur final dans le cluster.

Solution : Consultez la liste de contrôle suivante.

1. Vérifiez que les noeuds CUCM et IM & Presence sont dans la même version. Si les serveurs sont dans la version 11.X ou ultérieure, ils doivent s'exécuter sur la même version de SU.
• Si ce n'est pas le cas, assurez-vous que les deux exécutent la même version.
2. Vérifiez que le service Web Cisco AXL sur CUCM est à l'état EN COURS D'EXÉCUTION.
• Si ce n'est pas le cas, démarrez le service Web Cisco AXL.
3. Vérifiez que le noeud IM&P figure dans la liste des serveurs sur CUCM.
• Si ce n'est pas le cas, une reconstruction du serveur IM&P est nécessaire. Si le serveur est rajouté à l'entrée de la liste des serveurs n'a aucun effet, car un ID spécifique est généré pour chaque entrée ajoutée, ainsi l'IM&P reste avec un ancien ID.
4. Vérifiez que les tests de dépannage de la page Éditeur CUCM sur IM&P ont réussi.
5. Vérifiez que l'URL suivante est accessible à l'aide de l'URL suivante : https://CUCM_OR_IM&P_FQDN_OR_IP
6. Essayez de redémarrer l'éditeur CUCM, puis IM&P Publisher.
• Gardez à l'esprit que la haute disponibilité doit être désactivée avant le redémarrage.
7. Exécutez la requête CLI suivante sur l'éditeur IM&P : exécutez sql select * à partir de epassyncagentcfg .
8. Vérifiez que l'adresse ip ccmpublisher affichée provient du serveur de publication CUCM.
9. Exécutez la requête suivante sur le CUCM :

run sql select applicationuser.pkid, applicationuser.name , credential.credentials from applicationuser inner join credential on applicationuser.pkid=credential.fkapplicationuser where credential.tkcredential=3 and applicationuser.name='axluser_displayed_from_epassyncagentcfg'

10. Validez les informations suivantes :
• username (Sur CUCM) = axluser (Sur IM&P)
• pkid (Sur CUCM) = cucm_axluser_pkid (Sur IM&P)
• informations d'identification (sur CUCM) = axlpassword (sur IM&P)

10. Si axluser dans epassyncagentcfg ne peut pas être trouvé dans la liste des utilisateurs CUCM, alors créez un nouvel utilisateur d'application côté CUCM identique à l'ancien axluser avec le mot de passe précédent, s'il est connu.

Si les actions précédentes n'aident pas à résoudre le problème, vous devez faire appel au TAC Cisco pour un dépannage plus approfondi. Gardez à l'esprit que les résultats et les journaux suivants sont nécessaires.

Sorties CLI (de CUCM Publisher et IM&P) :

• Afficher le cluster réseau
• Utilise la dbreplication runtimestate
• Utils ha status
• Utilise la liste active principale
• Liste de services Utils
• run sql select * from epassyncagentcfg (Uniquement sur IM&P)
• exécutez sql select applicationuser.pkid, applicationuser.name , credential.credentials from applicationuser inner join credential sur applicationuser.pkid=credential.fkapplicationuser où credential.tkcredential=3 et applicationuser.name='axluser_display_from_epassyncagentcfg' (Uniquement sur CUCM)

Journaux/traces :

• Agent Cisco Syslog.
• Observateur d'événements - Journal des applications.
• Observateur d'événements - Journal système.
• Agent de synchronisation Cisco.
• Service Web Cisco AXL.

Gestionnaire de configuration Cisco XCP

Cisco XCP Config Manager est un service principal qui gère tous les composants XCP au sein du serveur IM&P. Même si la plupart des services XCP, y compris le routeur XCP, sont à l’état EN COURS D’EXÉCUTION, ce service peut être à l’état ARRÊTÉ, ce qui fait que le Gestionnaire de connexion XCP, le Gestionnaire de service Web XCP est resté arrêté ou même n’a pas réussi à se synchroniser avec d’autres serveurs comme les Expressways (pour MRA).

Tout d'abord, vérifiez que l'état de la réplication de la base de données Informix est correct :

état de réplication utils

utils dbreplication runtimestate

Si tout va bien, désactivez la haute disponibilité et tentez de redémarrer le service. En cas d'échec, désactivez la fonction de surveillance de la synchronisation :

set replication-sync monitor disable

Ensuite, essayez à nouveau de démarrer le service. Obtenez les journaux de Cisco XCP Config Manager via l'outil RTMT (Real-Time Monitor Tool) ou l'interface de ligne de commande :

vue fichier activelog /epas/trace/xcpconfigmgr/log4j/xcpconfigmgr.log

And this is the most common scenario:

2024-12-11 14:20:52,650 FATAL [XCPConfigMgr] security.Log4jEncLogger - java.io.FileNotFoundException: /usr/local/platform/.security/CCMEncryption/keys/oldkeys.txt (No such file or directory)
2024-12-11 14:20:52,650 INFO  [XCPConfigMgr] security.Log4jEncLogger - CCMENC::ERROR : decryptPassword - recovery mechanism failed
2024-12-11 14:20:52,650 FATAL [XCPConfigMgr] security.Log4jEncLogger - javax.crypto.BadPaddingException: Error finalising cipher data: pad block corrupted
2024-12-11 14:20:52,195 INFO  [XCPConfigMgr] security.Log4jEncLogger - Entering decryptPassword
2024-12-11 14:20:52,196 INFO  [XCPConfigMgr] security.Log4jEncLogger - Use Dkey to decrypt data
2024-12-11 14:20:52,213 INFO  [Thread-12] dbl.Log4j - Name of appId:dbcli
2024-12-11 14:20:52,216 INFO  [Thread-12] dbl.Log4j - Name of appId:dbxcpconfig
2024-12-11 14:20:52,219 INFO  [Thread-12] dbl.Log4j - Name of appId:dbcli
2024-12-11 14:20:52,221 INFO  [Thread-12] dbl.Log4j - Name of appId:dbxcpconfig
2024-12-11 14:20:52,649 INFO  [XCPConfigMgr] security.Log4jEncLogger - CCMENC::ERROR : Dkey decryption failed. Use recovery mechanism to decrypt data.
2024-12-11 14:20:52,649 INFO  [XCPConfigMgr] security.Log4jEncLogger - Using static key to decrypt data
2024-12-11 14:20:52,650 INFO  [XCPConfigMgr] security.Log4jEncLogger - Exiting decryptPassword.fail
2024-12-11 14:20:52,650 FATAL [XCPConfigMgr] security.Log4jEncLogger - Decryption with static key failed as well. Fatal error javax.crypto.BadPaddingException: Error finalising cipher data: pad block corrupted
2024-12-11 14:20:52,650 INFO  [XCPConfigMgr] security.Log4jEncLogger - CCMENC::ERROR : static key decryption failed. Use old keys to decrypt data
2024-12-11 14:20:52,650 INFO  [XCPConfigMgr] security.Log4jEncLogger - Exiting DecryptPassword.fail. failed to read oldkey file

 Si c'est le cas, vous rencontrez le bogue Cisco CSCur25679 défectueux XCP Config Manager et XCP Services ne démarrant pas sur IM&P et vous devez contacter le TAC Cisco pour appliquer la solution de contournement.

Les services de fonctionnalités ne démarrent pas

Les services suivants sont désactivés par défaut, sauf si vous utilisez la fonctionnalité de chaque service :

• Service d'annuaire Cisco XCP
• Gestionnaire de transfert de fichiers Cisco XCP
• Archives de messages Cisco XCP et fédération XMPP Cisco XCP

Même si ces services sont activés dans votre MI&P, ils ne démarrent pas tant que vous n'avez pas configuré chaque fonctionnalité pour chaque service.

Service d'annuaire Cisco XCP

Le service d'annuaire Cisco XCP prend en charge l'intégration des clients XMPP (Extensible Messaging and Presence Protocol) avec l'annuaire LDAP (Lightweight Directory Access Protocol) pour permettre aux utilisateurs de rechercher et d'ajouter des contacts à partir de l'annuaire LDAP.

Pour démarrer ce service :

1. Accédez à Cisco Unified CM IM and Presence Administration > Application > Third-Party Clients.

2. Configurez les paramètres des clients XMPP tiers.

Le service d'annuaire Cisco XCP permet aux utilisateurs d'un client XMPP tiers de rechercher et d'ajouter des contacts à partir de l'annuaire LDAP.

Pour plus d'informations sur la configuration du répertoire XMPP tiers, reportez-vous à la section Activation du service d'annuaire Cisco XCP.

Gestionnaire de transfert de fichiers Cisco

Ce service vous permet d'utiliser une solution de transfert de fichiers côté serveur appelée transfert de fichiers géré.

La fonction MFT (Managed File Transfer) permet à un client de messagerie instantanée et de présence, tel que Cisco Jabber, de transférer des fichiers à d'autres utilisateurs, à un groupe ad hoc, à des discussions et à des discussions permanentes.

Le service ne démarre pas si la configuration de MFT n'est pas en place.

Pour plus d'informations sur la configuration du répertoire XMPP tiers, consultez Comment configurer le transfert de fichiers géré dans CUCM CM IM/Presence 10.5 ?

Cisco XCP Message Archiver

Le service Cisco XCP Message Archiver prend en charge la fonctionnalité de conformité de la messagerie instantanée. La fonctionnalité de conformité de la messagerie instantanée consigne tous les messages envoyés et reçus par le serveur de messagerie instantanée et de présence, y compris les messages point à point et les messages provenant de salles de discussion ad hoc (temporaires) et permanentes pour la fonctionnalité de discussion. Les messages sont consignés dans une base de données externe prise en charge par Cisco.

Le service ne démarre pas si la configuration pour la conformité n'est pas en place.

Pour plus d'informations sur la façon de configurer l'archivage des messages, consultez Instant Messaging Compliance for the IM and Presence Service, Release 12.5(1).

Gestionnaire de connexion de fédération XMPP Cisco XCP

Cisco XCP XMPP Federation Connection Manager prend en charge la fédération interdomaine avec des entreprises tierces telles qu'International Business Machines (IBM) Lotus Sametime, Cisco Webex Meeting Center, GoogleTalk et une autre entreprise IM and Presence, via le protocole XMPP.

Ce service ne démarre pas tant que la fédération XMPP n'est pas configurée.

Pour plus d'informations sur la façon de configurer l'archivage des messages, consultez le Guide de fédération interdomaine pour le service de messagerie instantanée et de présence, version 12.5(1).

Informations connexes

• Assistance technique de Cisco et téléchargements