Gere e extraia o arquivo RCA do Cisco DNA Center

Introdução

Este documento descreve como criar e extrair o arquivo de análise da causa raiz (RCA) do Cisco Digital Network Architecture (DNA) Center.

Informações de Apoio

Você deve ter acesso de CLI ao Cisco DNA Center. Para fazer logon no Cisco DNA Center com a CLI, você deve se conectar via Secure Socket Shell (SSH) ao endereço IP de gerenciamento do seu Cisco DNA Center com o  maglev como o nome de usuário na porta  2222.

Cuidado com o recurso de shell restrito que foi adicionado ao 2.3.2.x, que não permite executar vários comandos até que você o desative. Para desabilitar temporariamente o shell restrito, consulte este documento.

Gerar o arquivo RCA em um cluster de nó único

Etapa 1. Faça login na CLI do Cisco DNA Center na porta 2222. Use o  maglev como o nome de usuário, a menos que o nome de usuário tenha sido modificado no momento da configuração inicial. Em seguida, execute o comando  rca comando.

[Tue Sep 11 15:08:48 UTC] maglev@10.1.1.1 (maglev-master-1) ~
$ sudo rca
[sudo] password for maglev: 

===============================================================
Verifying ssh/sudo access
===============================================================
Done

===============================================================
Verifying administration access
===============================================================
[administration] password for 'admin': 
    
    
User 'admin' logged into 'kong-frontend.maglev-system.svc.cluster.local' successfully

===============================================================
RCA package created on Tue Sep 11 15:32:47 UTC 2018
===============================================================

2018-09-11 15:32:47 | INFO | Generating log for 'date'...
tar: Removing leading `/' from member names
/etc/cron.d/
/etc/cron.d/clean-journal-files

    
    
/data/rca/maglev-x.x.x.x-rca-2018-09-11_15-32-40_UTC/docker_inspect_k8s_platform-ui_platform-ui-2963217120-rxv5d_maglev-system_1a09eb87-9f00-11e8-9d42-005d73c0c790_0.log
/data/rca/maglev-x.x.x.x-rca-2018-09-11_15-32-40_UTC/sudo_ethtool_calife1d52fff20.log
2018-09-11 15:43:14 | INFO | Cleaning up RCA temp files...

Created RCA package: /data/rca/maglev-x.x.x.x-rca-2018-09-11_15-32-40_UTC.tar.gz

[Tue Sep 11 15:43:14 UTC] maglev@10.1.1.1 (maglev-master-1) ~

Nas versões mais recentes do Cisco DNA Center (2.3.4.x e posterior), você pode executar  $ rca copy.

$ 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

Observação: o arquivo RCA é gerado e armazenado em  /data/rca. Geralmente, leva cerca de 20 minutos para criar o arquivo. O nome do arquivo deve ter este formato:  maglev- -rca .tar.gz .

Gerar o arquivo RCA em um cluster N-Node

Dica: quando você tem um cluster funcional de n nós, os serviços são distribuídos. Quando os serviços são distribuídos, o RCA de um nó individual não inclui logs de serviços que são executados em outros nós. Por exemplo, se você tiver o serviço A executado no nó 1 e obtiver o RCA do nó 2, os registros do serviço A não serão incluídos. Portanto, é recomendável capturar e incluir o arquivo RCA de todos os nós no cluster quando o TAC solicitar um  RCA arquivo.

Quando você tiver um cluster de 3 nós e executar o  rca em qualquer dispositivo, o Cisco DNA Center solicita um endereço IP do cluster. No prompt, insira o endereço IP entre clusters do nó do qual deseja recuperar o RCA.

Neste exemplo, os endereços IP entre clusters estão no intervalo 10.1.1.0/29.

[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 de executar o  rca  , os endereços IP entre clusters especificados serão armazenados em cache  /home/maglev/.maglevconf. Na próxima vez que você executar o  rca , o Cisco DNA Center usa o mesmo nó para obter as informações da RCA.

[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/
… rca continued…

Se precisar executar o  rca em um nó diferente, você deve excluir o contexto configurado no Cisco DNA Center. Em seguida, você será solicitado a escolher um novo endereço IP entre clusters e poderá definir o endereço IP do outro nó.

[Wed May 30 18:24:10 UTC] maglev@10.1.1.2 (maglev-master-10) ~
$ sudo maglev context delete maglev-1
Removed command line context 'maglev-1'
 
[Wed May 30 18:24:18 UTC] maglev@10.1.1.2 (maglev-master-10) ~
$ more /home/maglev/.maglevconf
;---------------------------------------------------------------------
; Modified by Maglev: Wed, 30 May 2018 18:24:18 UTC
; maglev 73529
;---------------------------------------------------------------------
 
[global]
 
 
[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.2 <-- now it asks for the new cluster IP address
[administration] username for 'https://10.1.1.2:443': admin
[administration] password for 'admin': <type your admin password>
User 'admin' logged into '10.1.1.2' 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

Extraia o arquivo RCA em um computador com Windows

Etapa 1. Baixe o WinSCP ou seu cliente SCP favorito.

Etapa 2. Faça login no Cisco DNA Center com suas credenciais de CLI e selecione  SCP como o protocolo de arquivo e escolha o número de porta 2222.

Etapa 3. Navegue até a página  /data/rca pasta.

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

Extraia o arquivo RCA em um computador Mac ou Linux

Observação: neste exemplo, o endereço IP do Cisco DNA Center resolve para mxc-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 dispositivo Cisco DNA Center.

Etapa 1. Abra uma sessão de terminal e execute estas etapas para copiar o arquivo RCA chamado  maglev-10.1.1.4-rca-2018-09-11_15-32-40_UTC.tar.gz armazenada no dispositivo Cisco DNA Center no  /data/rca para o diretório de trabalho atual no computador.

ALECARRA-M-P1Z8:~ alecarra$ scp -P 2222 maglev@mxc-dnac4.cisco.com:/data/rca/maglev-10.1.1.4-rca-2018-09-11_15-32-40_UTC.tar.gz ./
Welcome to the Maglev Appliance
maglev@mxc-dnac4.cisco.com's password: <type your maglev password>
maglev-10.1.1.4-rca-2018-09-11_15-32-40_UTC.tar.gz                                                                                                    100%  335MB   3.3MB/s   01:41    
ALECARRA-M-P1Z8:~ alecarra$ 

Envie o arquivo RCA para um computador Mac ou Linux

Na CLI do dispositivo Cisco DNA Center, use esta sintaxe:

 $ scp /data/rca/<RCA file name> <Mac/Linux username>@<Mac/Linux IP address>:<path to save the file>

Aqui está um exemplo do comando usado no laboratório:

$ scp /data/rca/maglev-10.1.1.4-rca-2018-09-11_15-32-40_UTC.tar.gz alecarra@10.24.133.238:/Users/alecarra/Documents/DNA
The authenticity of host '10.24.133.238 (10.24.133.238)' can't be established.
ECDSA key fingerprint is SHA256:u660kUomvMParNkcPIm7oXrDp84rilP5CM9wCWCFOAE.
Are you sure you want to continue connecting (yes/no)? yes
Warning: Permanently added '10.24.133.238' (ECDSA) to the list of known hosts.
Password: 
    
    
maglev-10.1.1.4-rca-2018-09-11_15-32-40_UTC.tar.gz                                                                                                    100%  335MB   3.7MB/s   01:32    

Carregar o arquivo RCA em um TAC SR

Você pode usar a ferramenta Carregador de arquivo de caso para carregar o arquivo RCA em uma Solicitação de serviço (SR) do TAC que existe em seu computador através de um navegador. Especifique o número do caso quando necessário. 

Envie o arquivo RCA para o TAC SR

Há duas opções para carregar um arquivo (como o RCA) diretamente de um dispositivo Cisco DNA Center para um TAC SR. Em ambas as opções, o nome de usuário é o número de SR e a senha é um token exclusivo para cada SR. O nome de usuário/senha está sempre presente em uma nota no início do seu SR, e também pode ser recuperado do SCM. 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 SR:

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. Carregar o arquivo via HTTPS (opção mais rápida e usa a porta 443)

Etapa 1. Teste se você tem conectividade do dispositivo Cisco DNA Center para  cxd.cisco.com via porta 443. Esta é uma maneira de executar o teste:

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

Observação: se o teste falhar, você não poderá usar este método para fazer upload do arquivo.

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

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

(Se quiser ver uma exibição mais detalhada do carregamento, adicione o  -v opçã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. Fazer upload do arquivo via SCP (usa a porta 22)

Etapa 1. Teste se você tem conectividade do dispositivo Cisco DNA Center para  cxd.cisco.com via porta 22. Esta é uma maneira de executar o teste:

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

Observação: se o teste falhar, você não poderá usar este método para fazer upload do 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) ~
$