Executar uma verificação de integridade da replicação do banco de dados do CUCM

Introdução

Este documento descreve comandos importantes para verificar a replicação do banco de dados do Cisco Unified Communications Manager (CUCM) e suas saídas esperadas.

Pré-requisitos

Requisitos

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

• Cisco Unified Communications Manager

Componentes Utilizados

As informações neste documento são baseadas nestas versões de software:

• Cisco Unified Communications Manager versão 10.5.2.15900-8

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 banco de dados no CUCM é uma topologia totalmente em malha, o que significa que o editor e cada assinante se conectam logicamente a cada servidor no cluster e todos eles têm a capacidade de atualizar os dados entre eles.

Para verificar o status do banco de dados no CUCM, o acesso da Interface de linha de comando (CLI) deve ser concedido em cada um dos nós no cluster. Se a interface gráfica do usuário (GUI) estiver disponível, um relatório de status do banco de dados deverá ser gerado.

Para gerar um relatório de Status do banco de dados do Unified CM, navegue para Cisco Unified Reporting > Relatórios do sistema > Status do banco de dados do Unified CM. Selecione Gerar um novo relatório.

Verificação de conectividade

Para replicação de banco de dados, a conectividade entre servidores deve ser estabelecida corretamente em cada um dos nós envolvidos no cluster. Esses comandos permitem saber o status de cada um deles.

show network cluster

Use o comando show network cluster para confirmar se os nós são autenticados entre si. A saída do publicador contém entradas da tabela processnode. No entanto, todos os nós devem ser autenticados (verifique se a senha de segurança é a mesma em todos os nós).

Editor:

admin:show network cluster
10.1.89.30 CUCMv10SUB.alegarc2.lab CUCMv10SUB Subscriber callmanager DBSub authenticated using TCP since Mon Jul 1 13:44:09 2019
10.1.89.20 CUCM10.alegarc2.lab CUCM10 Publisher callmanager DBPub authenticated

Server Table (processnode) Entries
----------------------------------
10.1.89.20
10.1.89.30

Assinante:

admin:show network cluster
10.1.89.30 CUCMv10SUB.alegarc2.lab CUCMv10SUB Subscriber callmanager DBSub authenticated
10.1.89.20 CUCM10.alegarc2.lab CUCM10 Publisher callmanager DBPub authenticated using TCP since Mon Jul 1 13:44:19 2019

execute sql select * from processnode

A tabela Processnode deve listar todos os nós no cluster.

admin:run sql select * from processnode
pkid                                 name               mac systemnode description isactive nodeid tknodeusage ipv6name fklbmhubgroup tkprocessnoderole tkssomode
==================================== ================== === ========== =========== ======== ====== =========== ======== ============= ================= =========
00000000-1111-0000-0000-000000000000 EnterpriseWideData     t                      t        1      1                    NULL          1                 0
68b56caa-d320-4c94-9c5a-43c3ba6cb4b8 10.1.89.20             f          10.1.89.20  t        2      0                    NULL          1                 0
a6a92a62-8e66-cdfc-80fa-56a688d3dd58 10.1.89.30             f                      t        3      1                    NULL          1                 0

conectividade de rede utils <IP/nome do host>

O Publisher deve ser capaz de acessar todos os assinantes e o resultado da conectividade de rede deve ser concluído com êxito.

admin:utils network connectivity 10.1.89.30

This command can take up to 3 minutes to complete.
Continue (y/n)?y
Running test, please wait ...
......
Network connectivity test with 10.1.89.30 completed successfully.

Cada assinante deve acessar o Publicador e outros assinantes incluídos no resultado de conectividade de rede de cluster devem ser concluídos com êxito.

admin:utils network connectivity 10.1.89.20

This command can take up to 3 minutes to complete.
Continue (y/n)?y
Running test, please wait ...
.
Network connectivity test with 10.1.89.20 completed successfully.

No Relatório de status do banco de dados do Unified CM, a conectividade deve ser exibida como 1=Êxito para cada nó, conforme mostrado na imagem.

utils diagnose test

Verifica todos os componentes e retorna o valor aprovado/reprovado. Os componentes mais importantes para a funcionalidade de replicação de banco de dados são validate_network, ntp_reachability e ntp_stratum.

admin:utils diagnose test

Log file: platform/log/diag1.log

Starting diagnostic test(s)
===========================
test - disk_space : Passed (available: 1753 MB, used: 12413 MB)
skip - disk_files : This module must be run directly and off hours
test - service_manager : Passed
test - tomcat : Passed
test - tomcat_deadlocks : Passed
test - tomcat_keystore : Passed
test - tomcat_connectors : Passed
test - tomcat_threads : Passed
test - tomcat_memory : Passed
test - tomcat_sessions : Passed
skip - tomcat_heapdump : This module must be run directly and off hours
test - validate_network : Passed
test - raid : Passed
test - system_info : Passed (Collected system information in diagnostic log)
test - ntp_reachability : Passed
test - ntp_clock_drift : Passed
test - ntp_stratum : Passed
skip - sdl_fragmentation : This module must be run directly and off hours
skip - sdi_fragmentation : This module must be run directly and off hours

Diagnostics Completed


The final output will be in Log file: platform/log/diag1.log


Please use 'file view activelog platform/log/diag1.log' command to see the output

status NTP de utils

A Cisco recomenda altamente configurar um servidor Network Time Protocol (NTP) com Stratum-1, Stratum-2 ou Stratum-3 no editor do CUCM para garantir que o tempo do cluster seja sincronizado com uma fonte de tempo externa.

admin:utils ntp status
ntpd (pid 8609) is running...

     remote           refid      st t when poll reach   delay   offset  jitter
==============================================================================
*10.1.89.1       LOCAL(1)         2 u  935 1024  377    0.262    2.591   3.260


synchronised to NTP server (10.1.89.1) at stratum 3
time correct to within 32 ms
polling server every 1024 s

Current time in UTC is : Wed Jul 3 12:40:36 UTC 2019
Current time in America/Mexico_City is : Wed Jul 3 07:40:36 CDT 2019

O NTP para assinantes é o servidor do editor e deve estar visível como sincronizado.

admin:utils ntp status
ntpd (pid 30854) is running...

     remote           refid      st t when poll reach  delay   offset   jitter
==============================================================================
*10.1.89.20       10.1.89.1       3 u  179 1024  377   0.524   -1.793    1.739


synchronized to NTP server (10.1.89.20) at stratum 4
time correct to within 50 ms
polling server every 1024 s

Current time in UTC is : Wed Jul 3 12:41:46 UTC 2019
Current time in America/Mexico_City is : Wed Jul 3 07:41:46 CDT 2019

Verificação de serviços

Os serviços CUCM envolvidos na replicação de banco de dados são Cluster Manager, A Cisco DB e Cisco Database Layer Monitor.

lista de serviços utils

O comando utils service list exibe os serviços e seu status no nó CUCM. Esses serviços devem ser exibidos como INICIADOS.

• Gerenciador de Cluster [INICIADO]
• Um BD Cisco [INICIADO]
• Um Cisco DB Replicator [INICIADO]
• Monitor da camada de banco de dados Cisco [INICIADO]

Comandos do banco de dados

Os comandos de replicação de banco de dados devem ser executados no publicador.

status de replicação de utils

Esse comando dispara apenas a verificação do status do banco de dados. Para verificar seu progresso, use o comando utils dbreplication runtimestate.

admin:utils dbreplication status


Replication status check is now running in background.
Use command 'utils dbreplication runtimestate' to check its progress

The final output will be in file cm/trace/dbl/sdi/ReplicationStatus.2019_07_03_07_54_21.out

Please use "file view activelog cm/trace/dbl/sdi/ReplicationStatus.2019_07_03_07_54_21.out " command to see the output

utils dbreplication runtimestate

O comando Runtimestate mostra o progresso do status do banco de dados para que ele possa exibir uma Configuração de Replicação diferente para os nós enquanto estiver em andamento. Quando esse comando estiver COMPLETO, as saídas poderão ser verificadas e ele mostrará o status atual do banco de dados.

admin:utils dbreplication runtimestate

Server Time: Wed Jul 3 09:11:03 CDT 2019

Cluster Replication State: Replication status command started at: 2019-07-03-07-54
Replication status command COMPLETED 681 tables checked out of 681
Last Completed Table: devicenumplanmapremdestmap
No Errors or Mismatches found.

Use 'file view activelog cm/trace/dbl/sdi/ReplicationStatus.2019_07_03_07_54_21.out' to see the details


DB Version: ccm10_5_2_15900_8
Repltimeout set to: 300s
PROCESS option set to: 1

Cluster Detailed View from CUCM10 (2 Servers):

                                      PING      DB/RPC/   REPL.    Replication REPLICATION SETUP
SERVER-NAME         IP ADDRESS        (msec)    DbMon?    QUEUE    Group ID    (RTMT) & Details
-----------         ----------        ------    -------   -----    ----------- ------------------
CUCM10              10.1.89.20        0.013     Y/Y/Y     0        (g_2)       (2) Setup Completed
CUCMv10SUB          10.1.89.30        0.230     Y/Y/Y     0        (g_3)       (2) Setup Completed

O status do banco de dados é visível no Relatório de status do banco de dados do Unified CM, como mostrado na imagem.

Arquivos Hosts/Rhosts/Sqlhosts

Há três arquivos importantes associados ao banco de dados e eles devem ser os mesmos em cada um dos nós envolvidos. Para verificá-los a partir do CLI, é necessário acesso à raiz. No entanto, o Relatório de status do banco de dados do Unified CM também exibe essas informações, como mostrado na imagem.

Arquivo de log do histórico do sistema

A replicação do banco de dados pode ser danificada devido a desligamentos anormais e eles são visíveis no log de histórico do sistema.

Exemplo de desligamento anormal:

09/13/2019 15:29:01 | root: Boot 10.5.2.15900-8 Start
09/13/2019 16:55:24 | root: Boot 10.5.2.15900-8 Start

Exemplo de encerramento da energia - normal:

09/03/2019 14:51:51 | root: Restart 10.5.2.15900-8 Start
09/03/2019 14:52:27 | root: Boot 10.5.2.15900-8 Start

A reconstrução do servidor é sugerida quando o sistema sofreu um desligamento anormal e está documentada no ID de bug Cisco CSCth53322

Verificar

Caso os erros sejam visíveis quando esses parâmetros forem validados, sugere-se entrar em contato com o Centro de Assistência Técnica da Cisco (TAC) e fornecer as informações coletadas de cada nó no cluster para obter assistência adicional.

Informações Relacionadas

• Sincronização de Tempo NTP do Unified CM
• Procedimento para desligar ou reiniciar o sistema, versão 12.5(1)
• Recupere-se do desligamento anormal