Contenido

Introducción

Antecedentes

Los estados de un servicio

Troubleshoot

‘Identificar el problema’

Los servicios permanecen en el estado INICIAL

Los servicios específicos no se inician

Cisco Sync Agent

Administrador de configuración de Cisco XCP

Los servicios de funciones no se inician

Servicio de directorio XCP de Cisco

Cisco File Transfer Manager

Cisco XCP Message Archiver

Administrador de conexiones de federación XCP XMPP de Cisco

Información Relacionada

Introducción

Este documento describe los pasos a seguir cuando un servicio de Cisco Instant Message and Presence (IM&P) no se inicia como se esperaba.

Antecedentes

Los estados de un servicio

Los servicios de IM&P tienen los siguientes estados:

Iniciado

El servicio está activo y en ejecución.

Inicio

El servicio está en la transición de Detener a Iniciado.

Detenido

Los servicios no están iniciados, puede deberse a que se han detenido manualmente o a que no están activados.

Deteniendo

El servicio está en la transición de Iniciado a Detenido.

Tenga en cuenta que después de reiniciar el nodo IM&P, se genera la siguiente advertencia, que se puede encontrar en la interfaz gráfica de usuario (GUI) si se desplaza a la página Notificaciones o a través de la interfaz de línea de comandos (CLI):

El monitor de datos de presencia y mensajería instantánea de Cisco ha detectado que la replicación de la base de datos no está completa o que la sincronización del agente de sincronización de Cisco de Cisco Unified Communications Manager no está completa. Algunos servicios pueden permanecer en el estado "Iniciando" hasta que la replicación y la sincronización del Agente de sincronización de Cisco se completen correctamente.

El mensaje no significa necesariamente que los servicios permanezcan en el estado Starting desde que se generó la alerta. Esto se espera cuando el Monitor de datos de IM&P comience a monitorear los servicios tan pronto como IM&P surja de un reinicio o arranque. Lo primero que Monitor Service detecta es que todos los servicios principales están en proceso de inicio, lo que dispara el mensaje.

Para confirmar el estado real de los servicios, ejecute el comando utils service list.

Nota: Si los servicios están en el estado Iniciado, no dude en eliminar la alerta para mantener las Alertas de notificación limpias.

Troubleshoot

‘Identificar el problema’

El primer paso para solucionar el problema de Services not Starting es comprender qué servicios son los que no se han iniciado.

Es importante validar la leyenda que aparece en el lado derecho de los servicios que se detienen, comúnmente se puede identificar:

- Servicio no activado: Esto significa que el servicio de funciones no se activó y que es necesario realizarlo primero.

- Con orden fuera de servicio: Este mensaje aparece después de un reinicio del servidor y si HA no fue inhabilitado o si ciertos servicios fueron reiniciados, y esa acción causó la detención manual de otros servicios. En otros escenarios, cuando el administrador de la red detiene manualmente el servicio, se muestra este mensaje. La solución consiste en iniciar los servicios manualmente desde la GUI o la CLI.

- NOTRUNNING: este mensaje se muestra cuando hay un error con los servicios y no se puede iniciar. A veces, este mensaje aparece después de que se ha intentado iniciar el servicio manualmente. El primer intento consiste en iniciar el servicio manualmente; sin embargo, si esta acción no funciona, es necesario realizar los siguientes pasos de solución de problemas. Utilice esta guía como ayuda para resolver los problemas que impiden el inicio de los servicios.

Los servicios permanecen en el estado INICIAL

Uno de los problemas más comunes que se encuentran en el suscriptor de IM&P después de un reinicio es ver casi todos los servicios en estado STARTING, mientras que el editor de IM&P muestra todos los servicios como STARTED.

La causa común de este comportamiento viene dada por un reinicio del suscriptor de IM&P cuando la alta disponibilidad (HA) no se ha inhabilitado de los grupos de redundancia de presencia.

Solución

Paso 1. Desactive Alta Disponibilidad desde Grupos de Redundancia de Presencia y navegue hasta Página de Administración de CUCM > Sistema.

Paso 2. Ejecute el siguiente comando en ambos nodos de IM&P: set replication-sync monitor disable.

Paso 3. Espere alrededor de 5 minutos y ejecute el siguiente comando: utils service list nuevamente para confirmar que los servicios están ahora Iniciados.

Paso 4. Verifique que todos los servicios estén INICIADOS en el suscriptor y luego ejecute el siguiente comando en ambos nodos de IM&P: set replication-sync monitor enable.

Paso 5. Vuelva a habilitar la alta disponibilidad desde los grupos de redundancia de presencia.

Los servicios específicos no se inician

Servicios de red

Aunque poco frecuentes, ha habido casos en los que algunos servicios de red no se inician en el editor de IM&P, estos son:

- Cisco Client Profile Agent

- Router de la plataforma de comunicaciones extensibles (XCP) de Cisco

- Administrador de configuración de Cisco XCP

- Almacenes de datos de presencia y ruta de Cisco

Advertencia: los servicios XCP, Presence Engine y Proxy SIP no se pueden iniciar, ya que dependen de los servicios de red enumerados. Esto hace que la base de datos de mensajes instantáneos (IMDB) no se replique y que los usuarios de Jabber no puedan iniciar sesión.

Solución

Los servicios se pueden iniciar a través de la interfaz web (navegue hasta IM and Presence Serviceability > Tools > Control Center - Network Services > Look for the IM and Presence Services) o a través de la interfaz de línea de comandos (CLI), utilice el comando utils service start <name_of_the_service>.

Paso 1. Inhabilite la alta disponibilidad de los grupos de redundancia de presencia.

Paso 2. Inicie cada servicio manualmente estrictamente en el siguiente orden:

- Cisco Client Profile Agent

- Cisco Route Datastore

- Cisco Presence Datastore

- Administrador de configuración de Cisco XCP

- Router XCP de Cisco

Nota: Para que se inicie Cisco Client Profile Agent, es necesario que se inicie Cisco Tomcat Service.

Si los pasos anteriores no han funcionado, debe abrirse un caso de Cisco Technical Assistant Center (TAC) para obtener más información sobre la solución de problemas. Tenga en cuenta que los próximos resultados y registros son obligatorios y.

1. Salidas CLI:

- show network cluster

- utils dbreplication runtimestate

- estado de utils ha

- lista activa de núcleo de utils

- lista de servicios utils

2. Registros/ seguimientos:

- Agente Syslog de Cisco

- Visor de eventos: registros de aplicaciones

- Visor de eventos: registros del sistema

- Cualquiera de los seguimientos de los servicios que permanecen detenidos

Base de datos de Cisco (DB)

Este es uno de los principales servicios del sistema.

Advertencia: Si este servicio no se inicia, el servidor no puede acceder a determinadas funciones de la página web del servidor, los usuarios de Jabber y sus funciones se ven comprometidos y se interrumpe la replicación de la base de datos.

Causas:

Las causas más comunes identificadas para este problema son:

- Cambio del nombre de host, la dirección IP o el dominio sin el proceso de directrices de Cisco.

- Corrupción de los archivos después de un apagado incorrecto del sistema.

Solución:

Desafortunadamente, no hay pasos de solución directos si este servicio no se inicia. Las sugerencias son:

Paso 1. Inhabilite la alta disponibilidad de los grupos de redundancia de presencia.

Paso 2. Reinicie Un Cisco DB Replicator.

Paso 3. Reinicie A Cisco DB, si permanece en el estado STARTING, intente detenerlo y luego iniciarlo.

El mejor enfoque consiste en ponerse en contacto con el TAC de Cisco para llevar a cabo una investigación más detallada. Para ello, se necesita la siguiente información:

1. Salidas CLI:

- show tech network hosts

- show tech database dump

- show tech dbintegration

- utils crear base de datos de informes

- utiliza conectividad de red IM&P_node 1500

- Mostrar clúster de red

- lista activa de núcleo de utils

2. Registros o seguimientos:

- Cisco Database Layer Monitor

- Seguimiento de biblioteca de bases de datos Cisco

- Servicio de notificación de bases de datos Cisco

- Seguimiento de Cisco Database Replicator

- Servicio Cisco Informix Database

- Agente Syslog de Cisco

- Visor de eventos: registros de aplicaciones

- Visor de eventos: registros del sistema

Agente de sincronización interclúster de Cisco (ICSA)

Advertencia: Si este servicio no se inicia, la base de datos de IM&P no se puede sincronizar entre los nodos de IM&P y los clústeres de IM&P (iguales entre clústeres).

Solución:

1. La alta disponibilidad está en mal estado (o mal) y no permite que se active el servicio.

Paso 1. Debe inhabilitar el HA, iniciar el servicio y luego volver a habilitar el HA.

- El servidor está afectado por uno de estos dos defectos:

- ID de bug de Cisco CSCvj09515

- ID de bug de Cisco CSCvq63308

Si el servicio no se activa, debe abrirse un caso TAC para continuar con la resolución de problemas. Tenga en cuenta que los siguientes resultados y registros son obligatorios.

1. Salidas CLI

- show network cluster

- utils dbreplication runtimestate

- estado de utils ha

- lista activa de núcleo de utils

- lista de servicios utils

2. Registros/ seguimientos

- Agente Syslog de Cisco

- Visor de eventos: registros de aplicaciones

- Visor de eventos: registros del sistema

- Cisco Service Recovery Manager

- Servicio Cisco Intercluster Sync Agent

Motor de presencia

Para el servicio Cisco Presence Engine, hay varias variantes que deben tenerse en cuenta para comprender por qué no se inicia el servicio y cómo iniciarlo.

1. Abra una CLI y ejecute el comando: utils service list valide que los siguientes servicios se encuentran en estado de ejecución; si no lo están, es necesario que se inicien primero:

- Cisco Presence Datastore

- Proxy SIP de Cisco

- Router XCP de Cisco

- Cisco Sync Agent

2. El motivo más común por el que el servicio Cisco Presence Engine (PE) no se inicia en el suscriptor de IM&P es que el suscriptor de IM&P no se ha agregado al grupo de redundancia de presencia (PRG).

- Motivo: El servicio PE está vinculado al PRG y es necesario agregarlo para comenzar.

- Solución: Agregue el servidor al PRG y espere aproximadamente 5 minutos para ver si se inicia.

- Variantes: Es probable que después de aplicar la solución anterior, el PE se detenga en ambos nodos de IM&P y la solución sea realizar los siguientes pasos:

Paso 1. Mantenga el suscriptor de IM&P en el PRG.

Paso 2. Inhabilite High Availability desde PRG.

Paso 3. los siguientes pasos deben realizarse primero en el editor y luego en el suscriptor

Paso 4. Reinicie primero el servicio Cisco SIP Proxy, espere hasta que se inicie.

Paso 5. Reinicie el servicio de Cisco PE, espere hasta que se inicie.

3. Si el suscriptor de IM&P ya se ha agregado al PRG y el PE permanece en estado DETENIDO o INICIANDO, esto podría estar relacionado con una discordancia en la replicación de la base de datos entre los dos nodos de IM&P, ejecute el siguiente comando run sql select * from enterprise node. El resultado de esta consulta muestra el id del nodo, el subclusterid del nodo (que es el id del PRG), el nombre o la dirección IP y otros valores. En lo que desea centrarse es en que ambos nodos de IM&P compartan el mismo valor de subclúster.

- Motivo: Si la replicación de la base de datos no funcionó correctamente, el suscriptor de IM&P muestra el subclúster como NULL.

- Solución:

Paso 1. Ejecute el siguiente comando: run sql update enterprisenode set subclesterid=subclesterid_value_as_for_the_IM&P_Pub where id=IM&P_Sub_id

Paso 2. Vuelva a ejecutar el siguiente comando run sql select * from enterprise node y asegúrese de que subclusterid tenga el valor correcto (el mismo) para ambos nodos de IM&P. El servicio debe iniciarse por sí solo en los próximos 5 minutos o puede intentar iniciarlo manualmente.

- Recomendación: Abra un caso del TAC de Cisco para realizar este cambio.

4. Si después de la resolución de problemas anterior se ha realizado y se han iniciado todos los servicios, excepto el PE:

- Solución:

Paso 1. Ejecute el comando: set replication-sync monitor disable en ambos nodos IM&P.

Paso 2. Espere unos 5 minutos y, si no se inicia, intente iniciar el servicio manualmente, ejecute el siguiente comando: utils service start Cisco Presence Engine.

Paso 3. Ejecute el comando set replication-sync monitor enable.

5. Si el servicio PE aún no puede iniciarse, valide si el servidor está ejecutando la versión 12.5; si es así, es muy probable que se vea afectado por el Id. de error de Cisco CSCvg94247.

Cisco Sync Agent

Advertencia: Si este servicio no se inicia, no se completa la sincronización de las tablas de base de datos de CUCM a IM&P, lo que afecta principalmente a la sincronización del usuario final en el clúster.

Solución: Revise la siguiente lista de comprobación.

1. Verifique que ambos nodos CUCM y IM & Presence estén en la misma versión. Si los servidores se encuentran en la versión 11.X o posterior, es necesario que se ejecuten en la misma versión de SU.

- Si no es así, asegúrese de que ambos ejecuten la misma versión.

2. Verifique que el servicio web Cisco AXL en CUCM esté en estado RUNNING.

- Si no es así, inicie el servicio web Cisco AXL.

3. Compruebe que el nodo IM&P aparece en la lista de servidores de CUCM.

- Si no es así, es necesario volver a generar el servidor IM&P. Si se vuelve a agregar el servidor a la entrada de la lista de servidores, no surte ningún efecto, ya que se genera un ID específico para cada entrada agregada, por lo tanto, IM&P permanece con un ID antiguo.

4. Verifique que se hayan superado las pruebas del solucionador de problemas de la página del editor de CUCM en IM&P.

5. Verifique que se pueda acceder al siguiente localizador uniforme de recursos (URL) con la URL: https://CUCM_OR_IM&P_FQDN_OR_IP

6. Intente reiniciar el editor de CUCM y, a continuación, el editor de IM&P.

- Tenga en cuenta que el HA debe desactivarse antes del reinicio.

7. Ejecute la siguiente consulta de CLI en el editor de IM&P: ejecute sql select * from epassyncagentcfg .

8. Confirme que la dirección ccmpublierip mostrada pertenece al publicador de CUCM.

9. Ejecute la siguiente consulta en 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. Validar la siguiente información:

- username (On CUCM) = axluser (On IM&P)

- pkid (en CUCM) = cucm_axluser_pkid (en IM&P)

- credentials (On CUCM) = axlpassword (On IM&P)

10. Si no se encuentra el axluser en epassyncagentcfg en la lista de usuarios de CUCM, cree un nuevo usuario de aplicación en el lado de CUCM igual que el antiguo axluser con la contraseña anterior, si se conoce.

Si las acciones anteriores no ayudan a solucionar el problema, debe ponerse en contacto con el TAC de Cisco para obtener más información sobre la solución de problemas. Tenga en cuenta que los siguientes resultados y registros son obligatorios.

Salidas CLI (de CUCM Publisher e IM&P):

- Mostrar clúster de red

- Utils dbreplication runtimestate

- Utils tiene estado

- Lista activa de núcleo de utilidades

- Lista de servicios de Utils

- run sql select * from epassyncagentcfg (solo en IM&P)

- ejecute sql select applicationuser.pkid, applicationuser.name , credential.credentials from applicationuser inner join credential on applicationuser.pkid=credential.fkapplicationuser donde credential.tkcredential=3 y applicationuser.name='axluser_played_from_epassyncagentcfg' (solo en CUCM)

Registros/ seguimientos:

- Agente Syslog de Cisco.

- Visor de eventos: registros de aplicaciones.

- Visor de eventos: registros del sistema.

- Agente de sincronización de Cisco.

- Servicio web Cisco AXL.

Administrador de configuración de Cisco XCP

Cisco XCP Config Manager es un servicio principal que gestiona todos los componentes XCP del servidor IM&P. Aunque la mayoría de los servicios XCP, incluido el router XCP, se encuentran en estado EN EJECUCIÓN, este servicio puede estar en estado DETENIDO, lo que hace que el administrador de conexiones XCP, el administrador de servicios web XCP, permanezca detenido o incluso no pueda sincronizarse con otros servidores como Expressway (para MRA).

En primer lugar, compruebe que la replicación de la base de datos Informix está en un estado correcto:

estado de replicación de utils

utils dbreplication runtimestate

Si todo está correcto, desactive High Availability (Alta disponibilidad) e intente reiniciar el servicio. Si esto falla, desactive la función de supervisión de sincronización:

set replication-sync monitor disable

A continuación, vuelva a intentar iniciar el servicio. Obtenga los registros de Cisco XCP Config Manager a través de la Herramienta de supervisión en tiempo real (RTMT) o la CLI:

file view 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 ese es el caso, usted ingresó el defecto Cisco bug ID CSCur25679 XCP Config Manager y servicios XCP no comienzan en IM&P y debe ponerse en contacto con Cisco TAC para aplicar la solución alternativa.

Los servicios de funciones no se inician

Los siguientes servicios están deshabilitados de forma predeterminada a menos que utilice la función de cada servicio:

- Servicio de directorio XCP de Cisco

- Administrador de transferencia de archivos XCP de Cisco

- Cisco XCP Message Archives y Cisco XCP XMPP Federation

Aunque IM&P tenga activados estos servicios, estos no se iniciarán a menos que configure cada función para cada servicio.

Servicio de directorio XCP de Cisco

El servicio de directorio Cisco XCP admite la integración de clientes de protocolo extensible de mensajería y presencia (XMPP) con el directorio LDAP (protocolo ligero de acceso a directorios) para permitir a los usuarios buscar y agregar contactos desde el directorio LDAP.

Para iniciar este servicio:

1. Vaya a Cisco Unified CM IM and Presence Administration > Application > Third-Party Clients.

2. Configure las opciones para clientes XMPP de terceros.

El servicio de directorio XCP de Cisco permite a los usuarios de un cliente XMPP de terceros buscar y agregar contactos desde el directorio LDAP.

Para obtener información adicional para configurar el directorio XMPP de terceros, consulte Activación del servicio de directorio Cisco XCP.

Cisco File Transfer Manager

Este servicio le permite utilizar una solución de transferencia de archivos del servidor denominada transferencia de archivos administrada.

La transferencia de archivos administrada (MFT) permite a un cliente de servicios de mensajería instantánea y presencia, como Cisco Jabber, transferir archivos a otros usuarios, grupos ad-hoc, chats y chats persistentes.

El servicio no se inicia si la configuración para MFT no está en su lugar.

Para obtener información adicional sobre cómo configurar el directorio XMPP de terceros, consulte ¿Cómo configurar la transferencia de archivos administrada en CUCM CM IM/Presence 10.5?

Cisco XCP Message Archiver

El servicio Cisco XCP Message Archiver admite la función de cumplimiento de mensajería instantánea. La función de cumplimiento de IM registra todos los mensajes enviados desde y hacia el servidor de IM and Presence, que incluye mensajes punto a punto, y mensajes desde salas de chat ad-hoc (temporales) y permanentes para la función de chat. Los mensajes se registran en una base de datos externa compatible con Cisco.

El servicio no se inicia si no se ha establecido la configuración de conformidad.

Para obtener información adicional sobre cómo configurar Message Archive, consulte Conformidad con mensajería instantánea para IM and Presence Service, Release 12.5(1).

Administrador de conexiones de federación XCP XMPP de Cisco

Cisco XCP XMPP Federation Connection Manager admite la federación entre dominios con empresas de terceros, como International Business Machines (IBM), Lotus Sametime, Cisco Webex Meeting Center, GoogleTalk y otra empresa de IM and Presence, a través del protocolo XMPP.

Este servicio no se inicia hasta que se configura la federación XMPP.

Para obtener información adicional sobre cómo configurar Message Archive, consulte la Guía de federación entre dominios para IM and Presence Service, Release 12.5(1).

Información Relacionada

- Soporte técnico y descargas de Cisco