Contents

Introduction

Informações de Apoio

Os estados de um serviço

Troubleshooting

Identificar o problema

Os serviços permanecem no estado STARTING

Serviços específicos não iniciados

Serviços de rede

Banco de dados (DB) da Cisco

Cisco Intercluster Sync Agent (ICSA)

Mecanismo de presença

Cisco Sync Agent

Serviços de recurso não iniciados

Serviço de diretório Cisco XCP

Cisco File Transfer Manager

Arquivador de Mensagens Cisco XCP

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

Introduction

Este documento descreve as diferentes etapas de solução de problemas a serem executadas quando alguns serviços dos serviços de Mensagem Instantânea e Presença (IM&P) da Cisco não tiverem sido iniciados normalmente.

Informações de Apoio

Os estados de um serviço

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

Iniciado

O serviço está ativo e em execução.

Iniciando

O serviço está na transição de Parar para Iniciado.

Parado

Os serviços não foram iniciados, talvez porque foram interrompidos manualmente ou não foram ativados.

Parando

O serviço está na transição de Iniciado para Parado.

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 permanecerão 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: lista de serviços utils

Note: Se os serviços estiverem no estado Iniciado, sinta-se à vontade para 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 desativado 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 pela GUI ou 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. Siga 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.

- Cisco Presence Datastore

- 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

- utils ha status

- 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 rastreamento 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 BD 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 replicador Cisco DB.

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 da camada de banco de dados da 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 errado) 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.

2. O servidor é afetado por um destes dois defeitos:

https://bst.cloudapps.cisco.com/bugsearch/bug/CSCvj09515/?rfs=iqvred

https://bst.cloudapps.cisco.com/bugsearch/bug/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

- utils ha status

- 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, caso contrário, eles precisarão ser iniciados primeiro:

- Cisco Presence Datastore

- 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 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á subclusterid como NULL.

- Solução:

Etapa 1. Executar o próximo comando: executar sql update enterprisenode set subclesterid=subclesterid_value_as_for_the_IM&P_Pub onde 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 em ambos os 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 por defeito: 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.

- Caso contrário, 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 a próxima URL está acessível em https://CUCM_OR_IM&P_FQDN_OR_IP.

6. Tente reinicializar o editor do CUCM e depois o editor do IM&P.

- Lembre-se de que o HA precisa ser desativado antes da reinicialização.

7. Execute a próxima consulta CLI no editor de IM&P: run sql select * from epassyncagentcfg.

8. Confirme se o endereço ccmpublisherip exibido é do Editor do CUCM.

9. Execute a próxima consulta no CUCM:

execute sql select applicationuser.pkid, applicationuser.name , credential.credentials a partir da credencial de junção interna applicationuser em applicationuser.pkid=credential.fkapplicationuser onde credential.tkcredential=3 e 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)

11. Se o axluser em epassyncagentcfg não for 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 acima 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.

- Cisco Sync Agent

- Cisco AXL Web Service

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 XMPP do Cisco XCP.

Mesmo que seu IM&P tenha esses serviços como ativados, eles não sã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 esse serviço, navegue até Cisco Unified CM IM and Presence Administration > Application > Third-Party Clients e defina as configurações para clientes XMPP de terceiros.

Use 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.

Informações adicionais para configurar o diretório XMPP de terceiros podem ser encontradas neste link.

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.

Informações adicionais para configurar a MFT podem ser encontradas neste link.

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, incluindo 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.

Informações adicionais para configurar o arquivo de mensagens podem ser encontradas neste link.

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.

Informações adicionais para configurar a federação XMPP podem ser encontradas neste link.