Solucionar problemas de falha de backup do UCCX com mensagem de erro

Introdução

Este documento descreve como solucionar problemas de falha de backup do Unified Contact Center Express (UCCX) e exibir uma mensagem de erro.

Pré-requisitos

Requisitos

A Cisco recomenda que você tenha conhecimento destes tópicos:

• Unified Contact Center Express
• Acesso à CLI através do cliente SSH
• Compreensão de NTP

Componentes Utilizados

As informações aqui são baseadas nesta versão de software:

• UCCX 12.5.1

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.

Informações de Apoio

O UCCX parou o backup por meio da tarefa agendada. Quando você tenta executar um trabalho de backup manual, o backup falha com a mensagem de erro "ERRO: UCCX DBReplication is not set up propriamente, Backup completed unsuccessfully" (ERRO: a replicação do UCCX DBR não foi configurada corretamente, Backup concluído sem êxito).

Falha no backup do UCCX

Troubleshooting

Primeiro, você precisa confirmar a integridade dos servidores solicitando as saídas dos comandos CLI de todos os nós Pub e Sub:

• show status
• utils diagnose test
• show network cluster
• status NTP de utils
• status de replicação de utils
• utils dbreplication runtimestate
• utils uccx dbreplication status
• utils uccx database health check
• utils uccx health check all

Da saída desses comandos CLI, a maioria dos problemas está relacionada ao NTP ou à DBReplication.

Para obter o desempenho ideal, o nível de stratum recomendado para o PUB sincronizar com o servidor NTP é 4 e inferior. Um stratum maior que 5 pode causar problemas de sincronização que, por sua vez, afetariam a DBReplication. Você pode encontrar mais informações sobre Troubleshooting de NTP no artigo Troubleshooting de NTP no Unified Communications Manager. O artigo vinculado é para o Unified Communications Manager, mas se aplica a todas as ofertas de VOS.

Aqui estão as definições de DBReplication para entender qual é o valor que você gostaria de ver para o status de DBReplication.

Definições de status de DBReplication

Você pode saber mais sobre a solução de problemas de replicação do DBR no artigo Solução de problemas de replicação do banco de dados do CUCM. O artigo vinculado é para o Unified Communications Manager, mas também se aplica ao UCCX.

Observação: no artigo vinculado acima, alguns comandos específicos do UCCX não são mencionados. Como o artigo é mais específico para o CUCM. No entanto, o processo geral também se aplica ao UCCX. Por exemplo, utils uccx dbreplication repair all.

Neste cenário, a integridade do servidor UCCX estava boa.

Status de sincronização de NTP

Status de DBReplication

Coleta de logs

Depois de limpar a integridade e outros componentes que poderiam causar o problema, você pode continuar a coletar alguns dados adicionais nos logs que foram gerados durante a tentativa de backup com falha. Na mesma tela em que ele exibiu a mensagem de erro, você faz o download do arquivo de log do componente CCX que foi gerado e ele está alinhado com o backup com falha.

Log de CCXComponent

Análise de log

A partir dos registros.

Arquivo de log:
=====================================================
Servidor:
Recurso: UCCX
Componente: CCXCOMPONENT
Tempo Concluído: 21-10-01-12-03-21
Código do Resultado: 24-Falha na fita ao fazer backup do banco de dados UCCX
Cadeia de Resultado : ERRO
=====================================================

É capaz de fazer backup dos componentes, começa o backup.

2021-10-01 12:03:15 :INFO: ------------- Iniciar ------------- DB DoBackup(db_do_backup.py) do Unified CCX

Em seguida, verifica se há memória disponível.

2021-10-01 12:03:15 :INFO: Espaço livre disponível para backup de BD do Unified CCX = 85622509568 bytes
2021-10-01 12:03:15 :INFO: Foi encontrado espaço em disco suficiente para o backup DB do Unified CCX

Depois disso, ele detecta que é uma configuração de alta disponibilidade (HA).

2021-10-01 12:03:15 :INFO: Esta é a configuração de alta disponibilidade do UCCX
2021-10-01 12:03:15 :INFO: Há dois nós no cluster do Unified CCX

O backup foi iniciado.

2021-10-01 12:03:15 :INFO: HA - Nó do editor. Backup iniciado

2021-10-01 12:03:15 :INFO: Criando Backup em Fita do BD do Unified CCX...
2021-10-01 12:03:15 :INFO: Executando [source /opt/cisco/uccx/bin/uccx_ids.env ; ontape -v -s -L 0 -t STDIO > /common/drf/ccx_comps/uccx_db/ontape_uccx_backup.gz] ...

No entanto, falha nesta fase.

2021-10-01 12:03:19 :INFO: Resultados da execução de [source /opt/cisco/uccx/bin/uccx_ids.env ; ontape -v -s -L 0 -t STDIO > /common/drf/ccx_comps/uccx_db/ontape_uccx_backup.gz], returnCode :[256], Output :[Usando o filtro de backup e restauração /bin/gzip -c.
Falha no arquivamento - erro ISAM: erro durante o backup do arquivamento.

Fim do programa.]
2021-10-01 12:03:19 :INFO: Falha no backup em fita.
2021-10-01 12:03:19 :INFO: ----- Sair do Unified CCX DB DoBackup(db_do_backup.py) com returnCode = 24 : ----- sem êxito
2021/10/01 12:03:19: Falha do Script DB DO_Backup ao funcionar

Ação corretiva

Reinicie estes serviços na CLI:

• Serviços DRF Master e DRF Local
  • reinicialização do serviço do utils Cisco DRF Master (no PUB)
  • serviço utils reiniciar Cisco DRF Local (em ambos os nós)
• Serviço de banco de dados
  • O serviço utils reinicia o Cisco Unified CCX Database (em ambos os nós)

Observação: reiniciar esses serviços não tem impacto na funcionalidade principal dos servidores. No entanto, você pode executar os comandos durante uma janela de manutenção.

Depois disso, execute um backup manual e verifique o sucesso. Uma mensagem de êxito é exibida.

Backup Concluído

Após um backup manual bem-sucedido, a tarefa agendada também começa a funcionar.

Informações Relacionadas

• Solucionar problemas de NTP no Unified Communications Manager
• Solucionar problemas de replicação do banco de dados do CUCM
• Suporte técnico e downloads da Cisco