Solucionar problemas da Web (GUI) do CUCM

Introdução

Este documento descreve os motivos pelos quais a página de usuário e as páginas da Web do Cisco Unified Communications Manager (CUCM) não são exibidas ou geram erros.

Pré-requisitos

Requisitos

A Cisco recomenda que você tenha conhecimento do CUCM.

Componentes Utilizados

As informações neste documento são baseadas nas versões 7.x/8.x/9.x/10.x do CUCM.

As informações neste documento foram criadas a partir de dispositivos em um ambiente de laboratório específico. Todos os dispositivos utilizados neste documento foram iniciados com uma configuração (padrão) inicial. Se a rede estiver ativa, certifique-se de que você entenda o impacto potencial de qualquer comando.

Diagrama de fluxo

O fluxograma para acesso à Web no CUCM é mostrado aqui:

Problema 1: Erro de comunicação do banco de dados

Quando você tenta fazer login na página da Web do CUCM Admin a partir do Publisher, o "Erro de comunicação do banco de dados" é recebido.

Você pode fazer login na página da Web de administração do CUCM a partir do assinante, mas qualquer alteração no CUCM causa um destes erros:

"Erro ao recuperar informações do banco de dados. java.sql.SQLException: nenhuma permissão DELETE." ou "Falha ao adicionar. O privilégio Inserir é necessário para esta operação."

Esse problema pode ocorrer quando você tenta fazer logon no servidor do Publisher depois que são feitas alterações no servidor do Publisher, como quando o nome do host ou o endereço IP é alterado pela CLI ou pela página de administração do sistema operacional (SO).

Nesse caso, reverta as alterações feitas de volta para a configuração antiga para permitir que você faça login.

Se nenhuma alteração tiver sido feita no Publicador CUCM e você ainda receber a mensagem Database Communications Error, verifique estes itens:

• Insira o comando utils dbreplication runtimestate para verificar o Status de replicação de BD.

Confirme se o status da replicação é 2 em todos os nós sem erros ou incompatibilidades.

• Determine se um serviço de banco de dados (DB) da Cisco está em execução no momento. Um Cisco DB não iniciado no Publisher também pode causar esse problema.

O erro/sintoma no Assinante é diferente porque o Assinante usa seu próprio processo de BD A Cisco, que é executado corretamente. No entanto, quando você tenta atualizar a configuração, o Assinante entra em contato com um Cisco DB no Publicador que não funciona e também causa um erro no Assinante. Além disso, a incapacidade de acessar a página CUCM do Publisher é possivelmente devido a um erro de comunicação do banco de dados em que o Informix não aceita mais conexões.

O comando utils dbreplication runtimestate não funciona:

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'

Esse problema também é documentado pela ID de bug da Cisco CSCtl74037. A solução alternativa é digitar estes comandos na CLI:

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

e interrompa o serviço Cisco Express Forwarding (CEF) na página de facilidade de manutenção.

Insira o comando utils service start A Cisco DB para iniciar o serviço A Cisco DB.

Se o serviço não for iniciado, ligue para o Cisco Technical Assistance Center (TAC) para iniciar o serviço a partir da raiz. O TAC verifica o problema com o acesso à raiz. Em alguns casos, se o DB estiver corrompido, será necessário recriar o CUCM.

Problema 2: A conexão com o servidor não pode ser estabelecida (não é possível acessar o nó remoto)

Você não pode acessar os outros nós do CUCM na página Manutenção do CUCM em que está conectado no momento.

Escolha Cisco Unified Serviceability > Ferramentas > Recursos do Centro de Controle/Serviços de Rede > Selecionar Servidor > Ir.

A mensagem de erro exibida é "Não é possível estabelecer conexão com o servidor (não é possível acessar o nó remoto)."

Solução

Faça login em cada nó do CUCM separadamente para acessar os serviços Serviceability e Ativate/Deactivate.

Solução

1. Verifique se o certificado Tomcat expirou. (Escolha Cisco OS Administration > Security > Certificate Management > tomcat.pem). Se expirado, gere novamente o certificado Tomcat e reinicie o serviço Tomcat.
   • Se você usar um certificado assinado por uma autoridade de certificação (CA), obtenha a solicitação de assinatura de certificado (CSR) do Tomcat novamente assinada pela CA, carregue-a novamente e reinicie o serviço Cisco Tomcat com o comando utils service restart Cisco Tomcat.
   • Se você usar um certificado autoassinado no servidor afetado, gere novamente o certificado Tomcat com o comando set cert regen tomcat da CLI ou do administrador do sistema operacional e reinicie o serviço Cisco Tomcat com o comando utils service restart Cisco Tomcat.

     Este defeito conhecido está documentado na ID de bug Cisco CSCth44399.

2. Confirme a validade dos certificados Tomcat. Verifique se o certificado de confiança Tomcat do nó problemático está no outro nó. Se ele não estiver no nó, baixe o certificado de confiança Tomcat do nó problemático e carregue-o para o outro nó como confiança Tomcat. Em seguida, gere novamente o certificado Tomcat no nó problemático e reinicie o serviço Tomcat em ambos os nós.

Problema 3: A conexão com o servidor não pode ser estabelecida (erro desconhecido)

Você não pode acessar os outros nós do CUCM na página Manutenção do CUCM em que está conectado no momento. Escolha Cisco Unified Serviceability > Ferramentas > Ativação de serviços/Recurso do centro de controle/Serviços de rede > Selecionar servidor > Ir.

A mensagem de erro exibida é "Connection to the Server cannot be established (Unknown Error)" (A conexão com o servidor não pode ser estabelecida (erro desconhecido)).

Solução

Faça login em cada nó do CUCM separadamente para acessar os serviços Serviceability e Ativate/Deactivate.

Solução

1. Insira o comando utils dbreplication runtimestate para verificar se há problemas de replicação no cluster CUCM.
2. Reinicie o serviço Tomcat com o comando utils service restart Cisco Tomcat.
3. Verifique se há incompatibilidades de número de série de certificados Tomcat (tomcat-trust) nos nós.
4. Escolha Cisco OS Administration > Security > Certificate Management > tomcat.pem e verifique se o certificado Tomcat expirou. Se expirado, gere novamente o certificado Tomcat e reinicie o serviço Tomcat.
   • Se você usar um certificado assinado pela CA, obtenha o CSR do Tomcat novamente assinado pela CA, carregue-o novamente e reinicie o serviço Cisco Tomcat com o comando utils service restart Cisco Tomcat.
   • Se você usar um certificado autoassinado no servidor afetado, gere novamente o certificado Tomcat com o comando set cert regen tomcat da CLI ou do administrador do sistema operacional e reinicie o serviço Cisco Tomcat com o comando utils service restart Cisco Tomcat.

     Esses defeitos conhecidos estão documentados no bug da Cisco ID CSCui29232 e no bug da Cisco ID CSCud67438.

Problema 4: A conexão com o servidor não pode ser estabelecida (exceção de certificado)

Você não pode acessar os outros nós do CUCM na página Manutenção do CUCM em que está conectado no momento.

Escolha Cisco Unified Serviceability > Ferramentas > Ativação de serviços/Recurso do centro de controle/Serviços de rede > Selecionar servidor > Ir.

A mensagem de erro exibida é "A conexão com o servidor não pode ser estabelecida (exceção de certificado)".

Solução

Faça login em cada nó do CUCM separadamente para acessar os serviços Serviceability e Ativate/Deactivate.

Solução

1. Insira o comando utils dbreplication runtimestate para verificar se há problemas de replicação no cluster CUCM.
2. Reinicie o serviço Tomcat com o comando utils service restart Cisco Tomcat.
3. Verifique se há incompatibilidades de número de série de certificados Tomcat (tomcat-trust) nos nós.
4. Escolha Cisco OS Administration > Security > Certificate Management > tomcat.pem e verifique se o certificado Tomcat expirou. Se expirado, gere novamente o certificado Tomcat e reinicie o serviço Tomcat.
   • Se você usar um certificado assinado pela CA, obtenha o CSR do Tomcat novamente assinado pela CA, carregue-o novamente e reinicie o serviço Cisco Tomcat com o comando utils service restart Cisco Tomcat.
   • Se você usar um certificado autoassinado no servidor afetado, gere novamente o certificado Tomcat com o comando set cert regen tomcat da CLI ou do administrador do sistema operacional e reinicie o serviço Tomcat da Cisco com o comando utils service restart Cisco Tomcat.

     Este defeito conhecido está documentado na ID de bug da Cisco CSCup10995.

Problema 5: Acesso muito lento à GUI

O acesso à Web/GUI do CUCM no Publisher e no Subscriber é muito lento.

Solução

1. O administrador do CUCM sempre consulta o banco de dados do editor quando disponível. Consulte o diagrama na seção Diagrama de fluxo.
2. Verifique se há problemas/atrasos na rede. Isso acontece se o agrupamento for feito em uma rede de longa distância (WAN).
3. Reinicie o Cisco Tomcat Service a partir do CLI/Secure Shell (SSH) com o comando utils service restart Cisco Tomcat.
4. Programe uma janela de manutenção e reinicialize os nós do CUCM.
5. Se o problema ocorrer novamente, entre em contato com o TAC com estes registros:
   • Rastreamentos do Call Manager (Detalhados)
   • Registros do Tomcat (registros da saída do comando file get ativelog tomcat/logs/* da CLI)
   • Log do Aplicativo Visualizador de Eventos
   • Logs do sistema do Visualizador de Eventos
   • Registros Perfmon do coletor de dados do servidor de informações em tempo real (RIS) da Cisco
   • Logs do Gerenciador de Serviços
   • Saída desses comandos do CLI do 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

   • Registros do Cisco Integrated Management Controller (CIMC) 

Esses defeitos conhecidos estão documentados no bug da Cisco ID CSCub02337 e no bug da Cisco ID CSCui86571.

Problema 6: Não é possível copiar/colar a senha na página de login do usuário final

Copiar/colar no campo Senha na página de login do usuário final do CUCM não funciona.

Não há suporte para a operação de colagem da senha no campo Senha na página de login do usuário final do CUCM.

Isso não funciona com o Internet Explorer (IE), Firefox ou Chrome.

Não é permitido copiar/colar a senha nas páginas do usuário final devido ao risco de segurança. Isso é adicionado como parte do CUCM versão 9.1.2 e posterior.

No entanto, observou-se que a função de copiar/colar ainda funciona com algumas versões do CUCM 10.x, que está documentado no bug da Cisco ID CSCus84153 e no bug da Cisco ID CSCus84152.

Problema 7: Não é possível acessar o ELM com Firefox e Chrome

Você não pode acessar o Enterprise License Manager (ELM) com o Firefox e o Chrome, mas isso funciona bem com o IE. Quando você faz login no ELM com Firefox ou Chrome, nenhuma das opções está disponível.

Este defeito conhecido está documentado na ID de bug Cisco CSCul30396.

Esse problema foi corrigido nas versões do CUCM 9.1.2.11900-10 e posteriores. O ELM pode ser acessado com o Firefox, IE e Chrome.

Problema 8: A página da Web é desconectada automaticamente

A página da Web do CUCM é desconectada automaticamente após o tempo limite ocioso expirar.

Você pode definir o tempo limite da página da Web com esses comandos na CLI do CUCM.

show webapp session timeout
set webapp session timeout

admin:set webapp session timeout ?

Sintaxe

set webapp session timeout minutes

Minutos é obrigatório e corresponde ao número de minutos após os quais as sessões são declaradas inválidas. O intervalo é 5 a 99999.

admin:set webapp session timeout 5

Se você continuar com essa operação, ele definirá o timeout de sessão para sessões da Web como 5 minutos após o serviço Cisco Tomcat ter sido reiniciado ou após o servidor ter sido reinicializado.

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

O serviço Cisco Tomcat precisa ser reiniciado para que as alterações entrem em vigor imediatamente. Isso desconecta as sessões da Web ativas.

Continue (y/n)?y

Não pressione Ctrl-C enquanto o serviço é REINICIADO. Se o serviço não tiver sido reiniciado corretamente, insira o mesmo comando novamente.

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]

O serviço Cisco Tomcat foi reiniciado com êxito. Tempo limite de novas sessões da Web após 5 minutos. O tempo limite de sessão atual usado para sessões da Web e aplicativos é de 5 minutos.

Problema 9: Não é possível acessar a página da Web do administrador/usuário do CUCM

Você não pode acessar a página da Web Admin/Usuário do CUCM.

1. Verifique se as credenciais do usuário estão corretas. Se você inseriu as credenciais incorretas, você recebe este erro.

   

2. Verifique se o Usuário tem as permissões corretas (Funções e Grupos de Usuários) configuradas. Se não estiverem configurados corretamente, a página da Web solicitará a página de logon novamente sem mensagens de erro.

Problema 10: O agente local não responde, o agente principal ou local está inoperante

Você não pode acessar nenhuma opção na página Sistema de recuperação de desastres (DRS) do CUCM após fazer login. 

"O Agente Local não responde." Isso pode ocorrer devido a um agente principal ou local inoperante. 

1. Verifique o certificado IPsec e confirme a validade. Se ele tiver expirado, gere novamente o certificado IPsec. 
2. Reinicie o serviço Cisco DRF Primary e DRF Local.

Informações Relacionadas

• Suporte Técnico e Documentação - Cisco Systems