Solucionar problemas de erro de CRC da interface do Nexus 9000 com script

Introdução

Este documento descreve as etapas para executar o script CRC (Cyclic Redundancy Check, Verificação de redundância cíclica) do Nexus 9000, que identifica portas com erros de CRC e fornece etapas de correção.

Informações de Apoio

Os switches Cisco Nexus 9000 Series usam switching cut-through por padrão. O switching cut-through é onde um switch toma uma decisão de encaminhamento em um quadro e começa a encaminhar o quadro a partir de uma interface de saída assim que o switch tiver processado o suficiente do cabeçalho do quadro para tomar uma decisão de encaminhamento válida. Isso difere do switching store-and-forward, em que um switch armazena o quadro inteiro em buffer antes de encaminhá-lo para fora de uma interface de saída.

Para solucionar erros de CRC de interface, os valores incrementais de contadores de CRC e FCS (Frame Check Sequence) precisam ser revisados para solucionar erros de contadores de interface nesses switches.

Esse script automatiza a identificação de erros de CRC/FCS em switches ASIC (Application Specific Integrated Circuit, Circuito integrado específico de aplicativo) de escala de nuvem 9200 e 9300. Ele coleta os valores dos contadores de interface CRC e FCS em intervalos periódicos para ver se os erros são históricos ou ao vivo e fornece etapas de correção.

A execução do script é dividida em duas partes, onde,

1. O script de pesquisa (Script-1) coleta dados de erro de interface em arquivos a cada 10-30 para duração máxima de até sete dias.
2. O Script do Analisador (Script-2) analisa essas saídas e fornece saída tabular com interfaces que são a origem do erro, bem como interfaces que estão apenas encaminhando os pacotes estompados.

Execute o script-2 pelo menos após 30 minutos de execução do script-1, ou seja, pelo menos quando dois ou mais arquivos forem coletados como parte da execução do script-1.

O script coleta a saída desse conjunto de comandos e analisa a mesma para identificar a origem do CRC. Consulte o link na seção "Informações relacionadas".

switch#show interface

switch#show interface counters errors non-zero

switch#show interface hardware-mappings

switch# slot {x} show hardware internal tah counters asic {y}

Pré-requisitos

O script está disponível no Git. 

Ele precisa ser baixado e executado da máquina cliente (servidor de salto) com acesso de rede aos switches Nexus, onde a análise de erro de CRC é necessária.

Clique aqui para fazer o download do script.

Requisitos

Verifique se estes pré-requisitos estão instalados na máquina do cliente (servidor de salto):

1. Python3
2. Máquina cliente (servidor de salto) para ter acesso à rede para switches Nexus
3. Nexus_CRC_requirements.txt disponível no git para ser instalado na máquina cliente.
   (Esta é uma configuração única no host de salto do cliente. Esta etapa instala as bibliotecas python necessárias para o host de salto)

Etapas para instalar o requirements.txt

Etapa 1: Faça o download do arquivo NEXUS_CRC_requirements.txt

Etapa-2: Abrir a janela do terminal /prompt de comando

Etapa-3: Navegue até a pasta em que o NEXUS_CRC_requirements.txt está localizado e execute o comando:

            #pip install -r Nexus_CRC_requirements.txt

Após a instalação bem-sucedida, ela mostra a mensagem abaixo:

            Data e hora da instalação bem-sucedida: numerpy-1.21.2 pandas-1.3.2 paramiko-2.7.2 python-dateutil-2.8.2 stdiomask-0.0.5 tabulate-0.8.9 termcolor-1.1.0

Componentes Utilizados

O script é testado nestes servidores de salto:

• Windows-10 de 64 bits 
• MAC Monterey

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.

Produtos Relacionados

Este script tem como objetivo analisar erros de CRC para switches ASIC de escala de nuvem Nexus 9200 e 9300:

Plataformas aplicáveis: switches fixos Nexus 9200/9300

• N9K-C92160YC-X
• N9K-C92300YC
• N9K-C92304QC
• N9K-C92348GC-X
• N9K-C923C
• N9K-C9272Q
• N9K-C9332C
• N9K-C9364C
• N9K-C93108TC-EX
• N9K-C93108TC-EX-24
• N9K-C93180LC-EX
• N9K-C93180YC-EX
• N9K-C93180YC-EX-24
• N9K-C93108TC-FX
• N9K-C93108TC-FX-24
• N9K-C93180YC-FX
• N9K-C93180YC-FX-24
• N9K-C9348GC-FXP
• N9K-C93240YC-FX2
• N9K-C93216TC-FX2
• N9K-C933C-FX2
• N9K-C933C-FX2-E
• N9K-C93360YC-FX2
• N9K-C93180YC-FX3
• N9K-C93108TC-FX3P
• N9K-C93180YC-FX3S
• N9K-C9316D-GX
• N9K-C93600CD-GX
• N9K-C9364C-GX
• N9K-C9364D-GX2A
• N9K-C9332D-GX2B

Informações de Apoio

Os switches Cisco Nexus 9000 Series usam switching cut-through por padrão.

Os valores incrementais do contador de CRC e FCS precisam ser revisados para solucionar problemas de erros do contador de interface nesses switches.

Esse script automatiza a identificação de erros de CRC/FCS em switches ASIC de escala de nuvem 9200 e 9300. Ele coleta os valores dos contadores de interface CRC e FCS em intervalos periódicos para ver se os erros são históricos ou ao vivo e fornece etapas de correção.

A execução do script é dividida em duas partes, onde,

1. O script de pesquisa (Script-1) coleta dados de erro de interface em arquivos a cada 10-30 para duração máxima de até sete dias.
2. O Script do Analisador (Script-2) analisa essas saídas e fornece saída tabular com interfaces que são a origem do erro, bem como interfaces que estão apenas encaminhando os pacotes estompados.

Execute o script-2 pelo menos após 30 minutos de execução do script-1, ou seja, pelo menos quando dois ou mais arquivos forem coletados como parte da execução do script-1.

Etapas da execução do script

Execução de Script de Pesquisa (Script-1)

Essas etapas são para executar o script Poller, que coleta contadores de erro CRC /FCS em arquivos em intervalos periódicos.

Etapa-1: Abra o terminal /prompt de comando e execute "NEXUS_CRC_POLLER.py" :

#python3 NEXUS_CRC_POLLER.py

Entradas:
Insira o IP/FQDN do switch Nexus, nome de usuário e senha:

Etapa 2: digite o caminho para a pasta (local no host de salto), onde deseja salvar os arquivos:

Formato de pasta válido: 

            EXEMPLO: 

                Windows-> C:\Users\Admin\Desktop\Nexus\   

                MAC -> /Users/admin/Desktop/Nexus/ 

**OBSERVE que a coleta de dados e a execução do script serão afetadas se o formato da pasta não for o acima. Verifique também se a pasta onde deseja salvar os arquivos já existe**

Etapa-3: Digite a duração para a qual deseja executar o script: 

    Máximo - Sete dias

    Mínimo - Executar por pelo menos 30 minutos para coletar contadores CRC várias vezes e identificar incrementos

**O script coleta erros de interface a cada 10 a 30 minutos e salva os dados em arquivos no caminho especificado na entrada anterior. Hora de término do script de coleta de dados com base na Hora de Término fornecida na entrada**

Etapa-4: Se não houver erros no domínio, ele perguntará se o usuário ainda deseja continuar e coletar dados mais uma vez:

Execução do Script do Analisador (Script-2)

Essas etapas são para executar o script do analisador , que analisa os arquivos de erro CRC /FCS coletados pelo script de pesquisa e fornece etapas de correção.

Inicie a execução do script do Analisador (Script-2), quando houver pelo menos dois arquivos gerados como parte da execução do Script de Sondagem (Script-1) para comparar dados (ou seja, após aproximadamente 30 minutos da execução do script de Sondagem).

Mantenha a resolução da fonte da sessão do terminal em 100% para obter uma exibição tabular de saída apropriada.

Etapa-1: Abra o terminal /prompt de comando e execute "NEXUS_CRC_PARSER.py":

Digite o mesmo local de arquivo, onde você coletou dados do Script-1.

Exemplo:

     Insira o caminho absoluto da pasta onde os arquivos estão armazenados: /Users/regajjar/Desktop/CRC_NEXUS/ 

Revisão da Saída do Script do Analisador (Script-2)

Exemplo de tabela de execução e saída para a versão do switch >=10.2:

Exemplo de tabela de execução e saída para a versão do switch < 10.2:

Informações Relacionadas

Para compreender melhor a identificação de erros de CRC N9K, consulte: https://www.cisco.com/c/en/us/support/docs/switches/nexus-9000-series-switches/216239-nexus-9000-cloud-scale-asic-crc-identifi.html#anc12