Gerar e extrair o arquivo RCA (pacote de suporte) do Cisco Catalyst Center (antigo Cisco DNA Center)

Introdução

Este documento descreve a criação e a extração do arquivo RCA (Root Cause Analysis, análise de causa raiz)/pacote de suporte do Catalyst Center (antigo Cisco DNA Center).

Informações de Apoio

O arquivo de análise de causa raiz (RCA) é um pacote de suporte gerado no Catalyst Center. Ele inclui as saídas de vários comandos e logs de serviço, fornecendo essencialmente um instantâneo do Catalyst Center. Ele permite que os engenheiros de suporte solucionem problemas e resolvam problemas mais rapidamente. Não inclui as saídas dos bancos de dados. Anteriormente, o arquivo RCA era gerado e baixado somente da CLI, mas isso foi alterado da versão 2.3.7.6. Todas as saídas de comando neste documento são relevantes da versão 2.3.3.x.

Gerando o arquivo de análise da causa raiz (RCA ou pacote de suporte)

A primeira etapa é gerar o arquivo RCA. Isso pode ser gerado na interface do usuário ou na CLI (Command Line Interface, interface de linha de comando).

Qualquer implantação de dispositivo físico (opção de interface do usuário)

A partir do 2.3.7.6, há uma nova opção para gerar o arquivo RCA a partir da IU do Catalyst Center, também conhecida como "Pacote de suporte" na IU. Além disso, há novas opções fornecidas na interface do usuário, como a capacidade de escolher o intervalo de tempo dos logs ou de escolher um pacote de logs específico do aplicativo. Essas opções estão disponíveis para todas as implantações de dispositivos físicos.

Note: Não é possível gerar um pacote de suporte da interface do usuário de um dispositivo virtual baseado em ESXi.

Passo 1: Clique na opção "Pacote de suporte" no menu Ajuda na barra superior.

Passo 2: Um novo pop-up mostra uma lista de pacotes de suporte que foram gerados anteriormente ou apenas a opção de criar um novo se este for o primeiro.

Passo 3: Clique em "Create Support Bundle" (Criar pacote de suporte) e outro novo pop-up será exibido. Um período de tempo pode ser selecionado para o pacote de suporte. Se o problema foi observado há 2 dias, escolha pelo menos um dia antes da data de início do pacote de suporte. O período de tempo máximo é definido para um mês por padrão a partir da hora atual. Verifique se "Categoria do sistema" está sempre selecionada. Com base no tipo de problema, é possível selecionar uma categoria de aplicativo adicional (opcional). O arquivo pode levar até 30 minutos para ser gerado (pode levar mais para implantações dimensionadas).

Note: É possível ver alguns arquivos de log sendo substituídos em menos de um mês, se as atividades/eventos ou os níveis de acesso estiverem altos.

Passo 4: Certifique-se de que um arquivo RCA completo seja capturado em razão do seu problema. Digite "true" na última opção antes de clicar no botão "Enviar", pois isso garante que saídas adicionais sejam capturadas.

Cluster de nó único / dispositivo virtual (opção CLI)

Faça login no CLI do Catalyst Center na porta 2222 e usemaglevcomo o nome de usuário. Em seguida, execute orcacomando para gerar o arquivo RCA. O arquivo RCA é gerado e armazenado nodata/rca. Geralmente, leva cerca de 30 minutos para criar o arquivo. O nome do arquivo tem o formatomaglev--rca-.tar.gz.

Note: Certifique-se de que o SSH ServerAliveInterval esteja habilitado com o intervalo do pacote no-op definido para cada 60 segundos ou um valor menor. Isso evita que as conexões SSH sejam fechadas prematuramente pelo servidor devido à inatividade.

Note: Para alterar o nome de usuário admin/administration ou o endereço IP do cluster, limpe o contexto usando o comando "sudo maglev context delete maglev-1" (Não aplicável ao dispositivo virtual baseado em ESXi).

Exemplo de menu de ajuda do comando rca

$ rca --help

Help:
rca - root cause analysis collection utilities

Usage: rca [COMMAND] [ARGS]...
Commands:
     clear - clear RCA files
      copy - copy rca files to specified location
      exec - collect RCA
      view - restricted filesystem view

Exemplo de uma RCA sendo gerada em um dispositivo físico

$ rca
===============================================================
VERIFYING SSH/SUDO ACCESS
===============================================================
[sudo] password for maglev: 
Done
changed ownership of '/data/rca/maglev-10.78.9.21-rca-2025-03-11_04-27-49_UTC.tar.gz' from root:root to maglev:maglev
===============================================================
VERIFYING ADMINISTRATION ACCESS
Please note that after 3 failed login attempts, diagnostic
collection will proceed, but not all diagnostics will be
collected.
===============================================================
WARNING: Current token has expired (2025-01-24T22:03:05+00:00Z).
The current time is: 2025-03-11T04:27:54Z
Continuing with login
[administration] password for 'admin': 
User 'admin' logged into 'kong-frontend.maglev-system.svc.cluster.local' successfully
===============================================================
RCA package created on Tue Mar 11 04:28:02 UTC 2025
===============================================================
2025-03-11 04:28:02 | INFO | Generating log for 'date'...
2025-03-11 04:28:02 | INFO | Node ISO type: full-iso

...

Created RCA package: /data/rca/maglev-10.78.9.21-rca-2025-03-11_04-27-49_UTC.tar.gz
2025-03-11 04:58:28 | INFO | Cleaning up RCA temp files...
[Tuesday Mar 11 04:58:30 UTC] maglev@10.78.9.21 (maglev-master-10-78-9-21)
$

Exemplo de uma RCA sendo gerada em um ESXi Virtual Appliance

$ rca
===============================================================
VERIFYING SSH/SUDO ACCESS
===============================================================
Done
===============================================================
RCA package created on Tue Mar 11 07:04:15 UTC 2025
===============================================================
2025-03-11 07:04:15 | INFO | Generating log for 'date'...
2025-03-11 07:04:15 | INFO | Generating log for 'sudo cat /root/.bash_history'...
2025-03-11 07:04:15 | INFO | Node ISO type: mks
/usr/local/bin/rca_scripts/network_diag.sh
...

Created RCA package: /data/rca/maglev-10.78.9.122-rca-2025-03-11_07-04-15_UTC.tar.gz
2025-03-11 07:23:23 | INFO | Cleaning up RCA temp files...
[Tuesday Mar 11 07:23:23 UTC] maglev@10.78.9.122 (maglev-master-10-78-9-122)
$

Cluster de três nós (opção CLI)

Faça login no CLI do Catalyst Center na porta 2222 e usemaglevcomo o nome de usuário. Em seguida, execute orcacomando para gerar o arquivo RCA. O arquivo RCA é gerado e armazenado nodata/rca. Geralmente, leva cerca de 30 minutos para criar o arquivo. O nome do arquivo tem o formatomaglev--rca-.tar.gz. Certifique-se de que um arquivo RCA seja coletado de todos os nós enquanto os serviços são distribuídos pelos nós. Se o Catalyst Center solicitar um endereço IP de cluster, esse pode ser qualquer endereço IP de nó/cluster acessível. Isso é necessário para obter o token de administrador, que por sua vez é necessário para algumas das saídas de comando.

Note: Certifique-se de que o SSH ServerAliveInterval esteja habilitado com o intervalo do pacote no-op definido para cada 60 segundos ou um valor menor. Isso evita que as conexões SSH sejam fechadas prematuramente pelo servidor devido à inatividade.

Note: Para alterar o nome de usuário admin/administration ou o endereço IP do cluster, limpe o contexto usando o comando "sudo maglev context delete maglev-1" (Não aplicável ao dispositivo virtual baseado em ESXi).

[Wed May 30 18:24:26 UTC] maglev@10.1.1.2 (maglev-master-10) ~
$  rca
 
===============================================================
Verifying ssh/sudo access
===============================================================
Done
 
===============================================================
Verifying administration access
===============================================================
Cluster: 10.1.1.3 
[administration] username for 'https://10.1.1.3:443': admin
[administration] password for 'admin': 
User 'admin' logged into '10.1.1.3' successfully
 
===============================================================
RCA package created on Wed May 30 18:24:44 UTC 2018
===============================================================
 
2018-05-30 18:24:44 | INFO | Generating log for 'date'...
tar: Removing leading `/' from member names
/etc/cron.d/
/etc/cron.d/run-remedyctl
...

Depois que o comando rca é executado, o endereço IP do cluster é armazenado em cache/home/maglev/.maglevconf(não visível no magshell) nesse nó. Na próxima vez que o comando rca for executado, o Catalyst Center usará o mesmo endereço IP de cluster para esse nó.

[Wed May 30 18:23:37 UTC] maglev@10.1.1.2 (maglev-master-10) ~
$ rca
[sudo] password for maglev: 
 
===============================================================
Verifying ssh/sudo access
===============================================================
Done
 
===============================================================
Verifying administration access
===============================================================
[administration] password for 'admin': <type the admin password>
User 'admin' logged into '10.1.1.3' successfully <-- it automatically logged into the cluster previously defined as the inter-cluster IP address
 
===============================================================
RCA package created on Wed May 30 18:23:46 UTC 2018
===============================================================
 
2018-05-30 18:23:46 | INFO | Generating log for 'date'...
tar: Removing leading `/' from member names
/etc/cron.d/
…

Exibindo o arquivo de Análise de Causa Raiz (RCA ou Pacote de Suporte)

Os arquivos dos pacotes de suporte/RCA podem ser visualizados na CLI ou na interface do usuário.

Exibindo os pacotes de RCA/suporte (opção de UI)

Note: Somente os pacotes de suporte gerados pela interface do usuário são visíveis aqui.

Clique na opção "Support Bundle" (Pacote de suporte) no menu de ajuda, disponível na barra superior, para visualizar todos os pacotes de suporte existentes e para visualizar o status desse arquivo. Se o arquivo ainda estiver sendo criado, o status exibirá um ícone "em andamento". O arquivo estará disponível para download ou upload quando o status estiver verde.

Exibindo os pacotes de suporte/RCA (opção CLI)

Note: Somente os pacotes de suporte/RCA gerados a partir do CLI são visíveis aqui.

Os pacotes RCA/Suporte são armazenados na pasta /data/rca. Eles podem ser visualizados através do comando "rca view" ou após o comando Linux.

$ rca view
total 1124652
-rwxr-xr-x 1 root root 1151639341 Feb 26 15:19 maglev-192.168.5.11-rca-2025-02-26_14-52-52_UTC.tar.gz

[Tuesday Mar 11 07:22:46 UTC] maglev@192.168.5.11 (maglev-master-192-168-5-11)
$

$ ls -lt data/rca/
total 1124652
-rwxr-xr-x 1 0 0 1151639341 Feb 26 15:19 maglev-192.168.5.11-rca-2025-02-26_14-52-52_UTC.tar.gz

[Tuesday Mar 11 07:23:06 UTC] maglev@192.168.5.11 (maglev-master-192-168-5-11)
$

Extraindo o arquivo de análise de causa raiz (RCA ou pacote de suporte)

Há várias maneiras de extrair o arquivo do Catalyst Center, com base no fato de ele ter sido gerado a partir da interface do usuário ou da CLI.

Iniciando a cópia do Catalyst Center para um caso de suporte da Cisco (opção de interface do usuário)

Há duas opções disponíveis para carregar o arquivo da interface do usuário. Para a segunda opção, o plug-in/extensão Chrome do Cisco Support Assistant Extension (CSAE) é usado.

Opção 1: Carregar da interface do usuário

Três botões de ação são apresentados para cada arquivo gerado a partir da interface do usuário. A ação à direita é carregar o arquivo no caso de suporte da Cisco. Aqui é necessária a senha para acessar o CXD. O nome de usuário é o número do caso de suporte da Cisco e a senha é um token exclusivo para cada caso de suporte da Cisco. O nome de usuário/senha está sempre presente em uma observação no início do caso de suporte da Cisco e também pode ser recuperado do Gerente de caso de suporte. Para obter mais detalhes sobre o token, consulte Uploads de arquivo do cliente para o Cisco Technical Assistance Center.

CarregamentodeArquivo1

Opção 2: Carregar da interface do usuário com a extensão CSAE instalada

Instale a extensão CASE no seu navegador Chrome ou Edge. Isso reprograma o recurso do botão de ação "seta para cima" e permite que o arquivo seja carregado em um caso de suporte da Cisco sem nenhuma credencial. Para obter mais detalhes, consulte a documentação do CASE.

Iniciando a cópia do arquivo de uma máquina Windows, Mac ou Linux (opção de interface do usuário)

Etapa 1. Faça download do WinSCP (somente Windows), FileZilla ou de seu cliente SCP/SFTP favorito.

Etapa 2. Forneça seu endereço IP do Catalyst Center com suas credenciais de CLI, escolha SCPou SFTP como o protocolo de arquivo e escolha o número de porta 2222.

Etapa 3. Navegue até adata/rcapasta.

Etapa 4. Copie o arquivo RCA para o computador local.

Observação: neste exemplo, o endereço IP do Catalyst Center é resolvido comomxc-dnac4.cisco.com. Substitua esse nome de host pelo FQDN (Fully Qualified Domain Name, Nome de domínio totalmente qualificado) ou pelo endereço IP do seu dispositivo Catalyst Center.

Iniciando a cópia do arquivo de uma máquina Mac ou Linux (opção CLI)

Etapa 1. Abra uma sessão de terminal e, em seguida, execute estas etapas para copiar o arquivo RCA chamadomaglev-10.78.9.21-rca-2025-01-14_08-48-51_UTC.tar.gzarmazenado no dispositivo Catalyst Center nodata/rcadiretório para o diretório de trabalho atual no seu computador.

rrahul@MY-MACBOOK ~ % scp -P 2222 maglev@10.78.9.21:data/rca/maglev-10.78.9.21-rca-2025-01-14_08-48-51_UTC.tar.gz .
Welcome to the Cisco DNA Center Appliance
maglev@10.78.9.21's password: 
maglev-10.78.9.21-rca-2025-01-14_08-48-51_UTC.tar.gz                                                                                                  100%  1485MB  32.3MB/s  00:45 
rrahul@MY-MACBOOK ~ % 

Iniciando a cópia do arquivo de um Catalyst Center para uma máquina Mac ou Linux (opção CLI)

Note: Certifique-se de que o SSH ServerAliveInterval esteja habilitado com o intervalo do pacote no-op definido para cada 60 segundos ou um valor menor. Isso evita que as conexões SSH sejam fechadas prematuramente pelo servidor devido à inatividade.

Na CLI do dispositivo Catalyst Center, use um desses comandos para copiar o arquivo, ambos usam SCP.  Há uma pequena diferença na sintaxe do comando, como mostrado nestes exemplos:

 $ scp data/rca/<RCA file name> <Mac/Linux username>@<Mac/Linux IP address>:<path to save the file>
OR
 $ rca copy
Help:
copy - copy rca files to specified location
Usage: rca copy [scp-options] --files file1 ... user@host2:file2

Aqui estão exemplos dos dois comandos a serem copiados de um Catalyst Center para um servidor:

$ scp data/rca/maglev-10.78.9.21-rca-2025-01-14_08-48-51_UTC.tar.gz rrahul@10.105.192.135:
rrahul@10.105.192.135's password: <Enter the destination password>
maglev-10.78.9.21-rca-2025-01-14_08-48-51_UTC.tar.gz                                                                                                100%  1485MB  106.6MB/s  00:13
[Thursday Mar 06 13:02:01 UTC] maglev@10.78.9.21 (maglev-master-10-78-9-21)
$

$ rca copy --files maglev-10.78.9.21-rca-2025-01-14_08-48-51_UTC.tar.gz rrahul@10.105.192.135:
rrahul@10.105.192.135's password: <Enter the destination password>
maglev-10.78.9.21-rca-2025-01-14_08-48-51_UTC.tar.gz                                                                                                100%  1485MB  106.1MB/s  00:13 
[Thursday Mar 06 13:10:31 UTC] maglev@10.78.9.21 (maglev-master-10-78-9-21)
$

Iniciando a cópia do arquivo do Catalyst Center para um caso de suporte da Cisco (opção CLI)

Note: Certifique-se de que o SSH ServerAliveInterval esteja habilitado com o intervalo do pacote no-op definido para cada 60 segundos ou um valor menor. Isso evita que as conexões SSH sejam fechadas prematuramente pelo servidor devido à inatividade.

Isso é semelhante à opção anterior, que utiliza o SCP, para realizar uma transferência de arquivo segura para cxd.cisco.com (o shell restrito impede o uso de outros comandos). O nome de usuário é o número do caso de suporte da Cisco e a senha é um token exclusivo para cada caso de suporte da Cisco. O nome de usuário/senha está sempre presente em uma observação no início do caso de suporte da Cisco e também pode ser recuperado do Gerente de caso de suporte. Para obter mais detalhes sobre o token, consulte Uploads de arquivo do cliente para o Cisco Technical Assistance Center.

$ rca copy --files maglev-10.1.1.233-rca-2024-03-06_14-07-36_UTC.tar.gz 6969XXXXX@cxd.cisco.com:/
FIPS mode initialized
Warning: Permanently added the ECDSA host key for IP address '10.209.135.105' to the list of known hosts.
6969XXXXX6@cxd.cisco.com's password: 
maglev-10.1.1.233-rca-2024-03-06_14-07-36_UTC.tar.gz

Iniciando a cópia do arquivo de uma máquina Mac ou Linux para um caso de suporte da Cisco (opção CLI)

Note: Esta seção é aplicável a um servidor Mac ou Linux. Ele não se aplica ao Catalyst Center desde a versão 2.3.

Há duas opções para fazer o upload de qualquer arquivo (incluindo o RCA) de sua máquina Mac ou Linux. Em ambas as opções, o nome de usuário é o número do caso de suporte da Cisco e a senha é um token exclusivo para cada caso de suporte da Cisco. O nome de usuário/senha está sempre presente em uma observação no início do caso de suporte da Cisco e também pode ser recuperado do Gerente de caso de suporte. Para obter mais detalhes sobre o token, consulte Uploads de arquivo do cliente para o Cisco Technical Assistance Center.

Exemplo de saída de um caso de suporte da Cisco:

Subject: 688046089: CXD Upload Credentials

You can now upload files to the case using FTP/FTPS/SCP/SFTP/HTTPS protocols and the following details:
Hostname: cxd.cisco.com
Username: 688046089
Password: gX***********P7

Opção 1. Carregue o arquivo via HTTPS (opção mais rápida e usa a porta 443)

Etapa 1. Teste se você tem conectividade da sua máquina Mac ou Linux paracxd.cisco.comvia porta 443. Aqui está uma maneira de executar o teste:

$ nc -zv cxd.cisco.com 443
Connection to cxd.cisco.com 443 port [tcp/https] succeeded!
$

Note: Se o teste falhar, você não poderá usar este método para carregar seu arquivo.

Etapa 2. Se o teste for bem-sucedido, carregue o arquivo via HTTPS com o uso desse comando (isso não funciona em um dispositivo Catalyst Center):

$ curl -T “” -u  https://cxd.cisco.com/home/ 

(Se quiser ver uma exibição mais detalhada do carregamento, adicione a-vopção. Por exemplo, "curl -vT…")

Por exemplo:

$ curl -T "./test.txt" -u 688046089 https://cxd.cisco.com/home/
Enter host password for user '688046089':  
[Tue Dec 10 13:35:47 UTC] maglev@10.1.1.1(maglev-master-1) ~
$

Opção 2. Carregue o arquivo via SCP (usa a porta 22)

Etapa 1. Teste se você tem conectividade da sua máquina Mac ou Linux paracxd.cisco.comvia porta 22. Aqui está uma maneira de executar o teste:

$ nc -zv cxd.cisco.com 22
Connection to cxd.cisco.com 22 port [tcp/ssh] succeeded!
$

Note: Se o teste falhar, você não poderá usar este método para carregar seu arquivo.

Etapa 2. Se o teste for bem-sucedido, carregue o arquivo via SCP com o uso deste comando:

$ scp  @cxd.cisco.com:

Por exemplo:

$ scp ./test.txt 688046089@cxd.cisco.com:
The authenticity of host 'cxd.cisco.com (X.X.X.X)' can't be established.
RSA key fingerprint is SHA256:3c8Vi3Ms2AITZlNzkBccR1pvE5ie9oMs64Uh0uhRado.
Are you sure you want to continue connecting (yes/no)? yes
Warning: Permanently added 'cxd.cisco.com,X.X.X.X' (RSA) to the list of known hosts.
688046089@cxd.cisco.com's password: 
test.txt                                                                                                                                                                                                        100%   39     0.0KB/s   00:00    

[Tue Dec 10 13:44:27 UTC] maglev@10.1.1.1  (maglev-master-1) ~
$