Solucionar problemas de serviços que não iniciam no IM&P

Introdução

Este documento descreve as etapas a serem seguidas quando um serviço do Cisco Instant Message and Presence (IM&P) não é iniciado como esperado.

Informações de Apoio

Os estados de um serviço

Os Serviços IM&P têm os seguintes estados:

Lembre-se de que após uma reinicialização do nó IM&P, o próximo aviso será gerado e poderá ser encontrado na Interface Gráfica do Usuário (GUI) se você navegar até a página Notificações ou através da Interface de Linha de Comando (CLI):

O Cisco IM and Presence Data Monitor detectou que a replicação do banco de dados não está completa e/ou que a sincronização do Cisco Sync Agent a partir do Cisco Unified Communications Manager não está completa. Alguns serviços podem permanecer no estado "Iniciando" até que a replicação e a sincronização do Cisco Sync Agent sejam concluídas com êxito.

A mensagem não significa necessariamente que os serviços permanecem no estado Iniciando desde que o alerta é gerado. Isso é esperado quando o Monitor de Dados de IM&P começa a monitorar os serviços assim que o IM&P sai de uma reinicialização ou inicialização. A primeira coisa que o serviço de monitoramento detecta é que todos os serviços principais estão no processo de inicialização, o que aciona a mensagem.

Para confirmar o estado real dos serviços, execute o comando utils service list.

Note: Se os serviços estiverem no estado Iniciado, não hesite em excluir o alerta para manter os Alertas de notificação limpos.

Troubleshooting

Identificar o problema

A primeira etapa para solucionar problemas dos serviços não iniciados é entender quais serviços são aqueles que não foram iniciados.

É importante validar a legenda que aparece no lado direito dos serviços interrompidos, normalmente você pode identificar:

• Serviço não ativado: Isso significa que o serviço de recurso não foi ativado e isso precisa ser feito primeiro.

• Comandos fora de serviço: Esta mensagem aparece após uma reinicialização do servidor e se o HA não foi desabilitado ou se determinados serviços foram reiniciados, e essa ação causou a interrupção manual de outros serviços. Em outros cenários, quando o administrador de rede interrompe manualmente o serviço, essa mensagem é mostrada. A solução aqui é iniciar os serviços manualmente a partir da GUI ou da CLI.

• NOTRUNNING:Esta mensagem é exibida quando há um erro com os serviços e não é possível iniciar. Às vezes, essa mensagem é vista após a tentativa de iniciar o serviço manualmente. A primeira tentativa é iniciar o serviço manualmente. No entanto, se essa ação não funcionar, as próximas etapas da solução de problemas deverão ser executadas. Use este guia para ajudá-lo a resolver os serviços que não estão sendo iniciados.

Os serviços permanecem no estado STARTING

Um dos problemas mais comuns encontrados no Assinante IM&P após uma reinicialização é ver quase todos os serviços no estado INICIANDO, enquanto o Publicador IM&P mostra todos os serviços como INICIADOS.

A causa comum desse comportamento é dada por uma reinicialização do Assinante IM&P quando a Alta Disponibilidade (HA) não foi desabilitada dos Grupos de Redundância de Presença.

Solução

Etapa 1. Desative a alta disponibilidade nos Grupos de redundância de presença, navegue para a página de administração do CUCM > Sistema.

Etapa 2. Executar o próximo comando em ambos os nós IM&P: desabilitar monitor de sincronização de replicação.

Etapa 3. Aguarde cerca de 5 minutos e execute o próximo comando: utils service list novamente para confirmar que os serviços foram iniciados agora.

Etapa 4. Verifique se todos os serviços estão INICIADOS no assinante e execute o próximo comando em ambos os nós IM&P: set replication-sync monitor enable.

Etapa 5. Reative a Alta Disponibilidade dos Grupos de Redundância de Presença.

Serviços Específicos Não Iniciados

Serviços de rede

Embora incomum, houve situações em que alguns serviços de rede não começam no editor de IM&P, são eles:

• Agente de perfil de cliente da Cisco
• Roteador XCP (Extensible Communications Platform) da Cisco
• Cisco XCP Config Manager
• Armazenamentos de dados de rota e presença da Cisco

Aviso: os serviços XCP, Presence Engine e Proxy SIP não podem ser iniciados, pois eles dependem dos serviços de rede listados. Isso faz com que o banco de dados de mensagens instantâneas (IMDB) não seja replicado e os usuários do Jabber não consigam fazer login.

Solução

Os serviços podem ser iniciados por meio da interface da Web (Navegue até IM and Presence Serviceability > Tools > Control Center - Network Services > Look for the IM and Presence Services) ou por meio da Interface de Linha de Comando (CLI), use o comando utils service start <name_of_the_service>.

Etapa 1. Desative a Alta Disponibilidade dos Grupos de Redundância de Presença.

Etapa 2. Inicie cada serviço manualmente estritamente na próxima ordem:

• Agente de perfil de cliente da Cisco
• Armazenamento de dados de rota Cisco
• Armazenamento de dados do Cisco Presence
• Cisco XCP Config Manager
• Cisco XCP Router

Note: Para que o Cisco Client Profile Agent seja iniciado, o Cisco Tomcat Service requer que ele seja iniciado.

Se as etapas anteriores não funcionaram, um caso do Cisco Technical Assistant Center (TAC) precisa ser aberto para Troubleshooting adicional. Tenha em mente que as próximas saídas e registros são necessários e.

1. Saídas CLI:
• show network cluster
• utils dbreplication runtimestate
• status de ha de utils
• lista ativa principal de utils
• lista de serviços utils
2. Logs/ Rastreamentos:
• Cisco Syslog Agent
• Registro de visualizador-aplicação de eventos
• Registro de sistemas do visualizador de eventos
• Qualquer um dos rastreamentos dos serviços que permanecem parados

Banco de dados (DB) da Cisco

Esse é um dos principais serviços do sistema.

aviso: Se esse serviço não for iniciado, o servidor não poderá acessar determinados recursos na página do servidor na Web, os usuários do Jabber e seus recursos ficarão comprometidos e a replicação do banco de dados será interrompida.

Causas:

As causas mais comuns identificadas para esse problema são:

• Alteração do nome do host, endereço IP ou domínio sem o processo de Diretrizes da Cisco.
• Corrupção dos arquivos após um desligamento anormal do sistema.

Solução:

Infelizmente, não há etapas de solução diretas se esse serviço não for iniciado. As sugestões são:

Etapa 1. Desative a Alta Disponibilidade dos Grupos de Redundância de Presença.

Etapa 2. Reinicie Um Cisco DB Replicator.

Etapa 3. Reinicie um Cisco DB, se ele permanecer no estado STARTING, tente pará-lo e iniciá-lo em seguida.

A melhor abordagem aqui é envolver o TAC da Cisco para investigação adicional, e as próximas informações são necessárias:

1. Saídas CLI:
• show tech network hosts
• show tech database dump
• show tech dbintegrity
• utils criam banco de dados de relatório
• utils conectividade de rede IM&P_node 1500
• Mostrar cluster de rede
• lista ativa principal de utils
2. Logs ou Rastreamentos:
• Monitor de camada de banco de dados Cisco
• Rastreamento da Biblioteca de Bancos de Dados da Cisco
• Serviço de notificação de banco de dados da Cisco
• Rastreamento do Cisco Database Replicator
• Serviço de banco de dados Cisco Informix
• Cisco Syslog Agent
• Registro de visualizador-aplicação de eventos
• Registro de sistemas do visualizador de eventos

Cisco Intercluster Sync Agent (ICSA)

aviso: Se esse serviço não for iniciado, o banco de dados de IM&P não poderá ser sincronizado nos nós de IM&P e nos clusters de IM&P (emparelhamento entre clusters).

Solução:

1. A Alta Disponibilidade está em um estado ruim (ou incorreto) e não permite que o serviço seja ativado.

Etapa 1. Você precisa desativar o HA, iniciar o serviço e depois reativar o HA.

• O servidor é afetado por um destes dois defeitos:
  • ID de bug da Cisco CSCvj09515
  • ID de bug Cisco CSCvq63308  

Se o serviço não for ativado, um caso de TAC deverá ser aberto para Troubleshooting adicional. Lembre-se de que as próximas saídas e registros são necessários.

1. Saídas CLI
• show network cluster
• utils dbreplication runtimestate
• status de ha de utils
• lista ativa principal de utils
• lista de serviços utils
2. Logs/ Rastreamentos
• Cisco Syslog Agent
• Registro de visualizador-aplicação de eventos
• Registro de sistemas do visualizador de eventos
• Cisco Service Recovery Manager
• Serviço Cisco Intercluster Sync Agent

Mecanismo de presença

Para o serviço Cisco Presence Engine, há várias variantes que devem ser consideradas para entender por que o serviço não é iniciado e como fazê-lo iniciar.

1. Abra uma CLI e execute o comando: utils service list validate se os próximos serviços estão no estado running, se não estiverem, eles precisarão ser iniciados primeiro:
• Armazenamento de dados do Cisco Presence
• Proxy SIP Cisco
• Cisco XCP Router
• Cisco Sync Agent

2. O motivo mais comum para o serviço Cisco Presence Engine (PE) não iniciar no Assinante IM&P é porque o Assinante IM&P não foi adicionado ao grupo de redundância de presença (PRG).

• Razão: O serviço PE está vinculado ao PRG e precisa ser adicionado para iniciar.
• Solução: Adicione o servidor ao PRG e aguarde cerca de 5 minutos para ver se ele é iniciado.
• Variantes: É provável que, após a aplicação da solução anterior, o PE pare em ambos os nós IM&P e a solução execute as próximas etapas:

Etapa 1. Mantenha o assinante do IM&P no PRG.

Etapa 2. Desative a Alta Disponibilidade no PRG.

Etapa 3. as próximas etapas precisam ser executadas no editor primeiro e depois no assinante

Etapa 4. Reinicie primeiro o Cisco SIP Proxy Service, aguarde até que ele seja iniciado.

Etapa 5. Reinicie o serviço Cisco PE, aguarde até que ele seja iniciado.

3. Se o Assinante IM&P já tiver sido adicionado ao PRG e o PE permanecer no estado STOPPED ou STARTING, isso poderá estar relacionado a uma incompatibilidade na Replicação de Banco de Dados entre os dois nós IM&P, execute o próximo comando run sql select * from enterprise node. A saída dessa consulta exibe o id do nó, o subclusterid do nó (que é o id PRG), o nome ou o endereço IP e outros valores. O foco é que ambos os nós IM&P compartilham o mesmo valor de subclusterid.

• Razão: Se a Replicação de Banco de Dados não tiver sido executada corretamente, o Assinante IM&P exibirá o subclusterid como NULL.
• Solução: 

Etapa 1. Executar o próximo comando: run sql update enterprisenode set subclesterid=subclesterid_value_as_for_the_IM&P_Pub where id=IM&P_Sub_id

Etapa 2. Execute novamente o próximo comando run sql select * from enterprise node e verifique se subclusterid tem o valor correto (o mesmo) para ambos os nós IM&P. O serviço deve iniciar por si só nos próximos 5 minutos, ou você pode tentar iniciá-lo manualmente.

• Recomendação: Abra um caso do Cisco TAC para executar essa alteração.

4. Se após a execução da solução de problemas anterior e todos os serviços forem iniciados, exceto o PE:

• Solução:

Etapa 1. Execute o comando: set replication-sync monitor disable nos nós IM&P.

Etapa 2. Aguarde cerca de 5 minutos e, se não for iniciado, tente iniciar o serviço manualmente, execute o próximo comando: utils service start Cisco Presence Engine.

Etapa 3. Execute o comando set replication-sync monitor enable.

5. Se o serviço PE ainda não puder ser iniciado, valide se o servidor está executando a versão 12.5, caso esteja, é altamente provável que ele seja afetado pelo bug da Cisco ID CSCvg94247.

Cisco Sync Agent

aviso: Se esse serviço não for iniciado, a Sincronização de tabelas de banco de dados do CUCM para o IM&P não será concluída, isso afetará principalmente a sincronização do usuário final no cluster.

Solução: Revise a próxima lista de verificação.

1. Verifique se os nós CUCM e IM e Presence estão na mesma versão. Se os servidores estiverem na versão 11.X ou posterior, eles precisarão ser executados na mesma versão da SU.
• Se não estiverem, verifique se ambos estão executando a mesma versão.
2. Verifique se o Cisco AXL Web Service no CUCM está no estado RUNNING.
• Se não estiver, inicie o Cisco AXL Web Service.
3. Verifique se o nó IM&P está listado na lista de servidores no CUCM.
• Se não estiver, será necessário recriar o Servidor IM&P. Se o servidor for adicionado de volta à entrada da lista de servidores, isso não terá efeito, pois uma ID específica será gerada para cada entrada adicionada, portanto, o IM&P permanecerá com uma ID antiga.
4. Verifique se os testes da solução de problemas na página do editor do CUCM em IM&P foram bem-sucedidos.
5. Verifique se o próximo Uniform Resource Locator (URL) está acessível com o URL: https://CUCM_OR_IM&P_FQDN_OR_IP
6. Tente reinicializar o editor do CUCM e, em seguida, o editor do IM&P.
• Lembre-se de que o HA precisa ser desativado antes da reinicialização.
7. Executar a próxima consulta CLI no editor de IM&P: execute sql select * from epassyncagentcfg .
8. Confirme se o endereço ccmpublisherip exibido é do Editor do CUCM.
9. Execute a próxima consulta no 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. Valide as próximas informações:
• nome de usuário (no CUCM) = axluser (em IM&P)
• pkid (em CUCM) = cucm_axluser_pkid (em IM&P)
• credenciais (no CUCM) = axlpassword (em IM&P)

10. Se o axluser em epassyncagentcfg não puder ser encontrado na lista de usuários do CUCM, crie um novo usuário do aplicativo no lado do CUCM igual ao antigo axluser com a senha anterior, se conhecida.

Se as ações anteriores não ajudarem a resolver o problema, você precisará entrar em contato com o TAC da Cisco para obter mais soluções de problemas. Lembre-se de que as próximas saídas e registros são necessários.

Saídas CLI (do Editor do CUCM e IM&P):

• Mostrar cluster de rede
• Utils dbreplication runtimestate
• Status dos utils ha
• Lista ativa principal de utils
• Lista de serviços Utils
• executar sql select * de epassyncagentcfg (Somente no IM&P)
• execute 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' (Somente no CUCM)

Logs/ Rastreamentos:

• Cisco Syslog Agent.
• Registro de visualizador-aplicação de eventos.
• Registro de sistemas do visualizador de eventos.
• Agente de Sincronização Cisco.
• Serviço Web Cisco AXL.

Cisco XCP Config Manager

O Cisco XCP Config Manager é um serviço principal que lida com todos os componentes do XCP dentro do Servidor IM&P. Mesmo que a maioria dos serviços XCP, incluindo o Roteador XCP, esteja no estado RUNNING, esse serviço pode estar no estado STOPPED, fazendo com que o Gerenciador de conexões XCP, o Gerenciador de serviços Web XCP permaneça parado ou até mesmo falhe na sincronização com outros servidores, como o Expressways (para MRA).

Primeiro, confirme se a Replicação de banco de dados Informix está em um estado correto:

status de replicação de utils

utils dbreplication runtimestate

Se tudo estiver bem, desative a Alta Disponibilidade e tente reiniciar o serviço. Se isso falhar, desative o recurso de monitoramento de sincronização:

desabilitar monitor de sincronização de replicação

Em seguida, tente iniciar o serviço novamente. Obtenha os registros do Cisco XCP Config Manager via Real-Time Monitor Tool (RTMT) ou CLI:

file view ativelog /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

 Se esse for o caso, você acertou o ID de bug Cisco CSCur com defeito25679 O XCP Config Manager e os serviços XCP não estão sendo iniciados em IM&P e você precisa entrar em contato com o Cisco TAC para aplicar a solução.

Serviços de Recurso Não Iniciados

Os próximos serviços são desativados por padrão, a menos que você use o recurso de cada serviço:

• Serviço de diretório Cisco XCP
• Gerenciador de transferência de arquivos XCP da Cisco
• Arquivos de Mensagens do Cisco XCP e Federação do Cisco XCP XMPP

Mesmo que seu IM&P tenha esses serviços como ativados, os serviços não serão iniciados a menos que você configure cada recurso para cada serviço.

Serviço de diretório Cisco XCP

O Cisco XCP Diretory Service suporta a integração de clientes XMPP (Extensible Messaging and Presence Protocol) com o diretório LDAP (Lightweight Diretory Access Protocol) para permitir que os usuários pesquisem e adicionem contatos do diretório LDAP.

Para iniciar este serviço:

1. Navegue até Cisco Unified CM IM and Presence Administration > Aplicativo > Clientes de Terceiros.

2. Defina as configurações para clientes XMPP de terceiros.

Você usa o serviço de diretório Cisco XCP para permitir que usuários de um cliente XMPP de terceiros pesquisem e adicionem contatos do diretório LDAP.

Para obter informações adicionais para configurar o diretório XMPP de terceiros, consulte Ativar o serviço de diretório Cisco XCP.

Cisco File Transfer Manager

Este serviço permite usar uma solução de transferência de arquivos no servidor chamada transferência de arquivos gerenciada.

A Transferência de arquivos gerenciada (MFT) permite que um cliente do Serviço de mensagens instantâneas e presença, como o Cisco Jabber, transfira arquivos para outros usuários, grupo ad-hoc, bate-papos e bate-papo persistente.

O serviço não será iniciado se a configuração da MFT não estiver em vigor.

Para obter informações adicionais para configurar o diretório XMPP de terceiros, consulte Como configurar a transferência de arquivos gerenciados no CUCM CM IM/Presence 10.5?

Arquivador de Mensagens Cisco XCP

O serviço Arquivador de Mensagens do Cisco XCP oferece suporte ao recurso de Conformidade de Mensagens Instantâneas. O recurso Conformidade de Mensagens Instantâneas registra todas as mensagens enviadas para e do servidor de Mensagens Instantâneas e Presença, que inclui mensagens ponto a ponto e mensagens de salas de bate-papo ad-hoc (temporárias) e permanentes para o recurso Bate-papo. As mensagens são registradas em um banco de dados externo suportado pela Cisco.

O serviço não é iniciado se a configuração para conformidade não estiver em vigor.

Para obter informações adicionais sobre como configurar o Arquivo de Mensagens, consulte Conformidade de Mensagens Instantâneas para o Serviço IM e Presence, Versão 12.5(1).

Gerenciador de Conexões de Federação XMPP do Cisco XCP

O Cisco XCP XMPP Federation Connection Manager oferece suporte à federação entre domínios com empresas de terceiros, como International Business Machines (IBM) Lotus Sametime, Cisco Webex Meeting Center, GoogleTalk e outra empresa de IM e Presence, por meio do protocolo XMPP.

Este serviço não é iniciado até que a federação XMPP seja configurada.

Para obter informações adicionais sobre como configurar o Arquivo de Mensagens, consulte o Interdomain Federation Guide for the IM and Presence Service, Release 12.5(1).

Informações Relacionadas

• Suporte técnico e downloads da Cisco