Introduction

Este documento descreve o Cisco PDART - uma ferramenta de preparação do Cisco DNA Center para a infraestrutura principal da Cisco.

Prerequisites

Requirements

Não existem requisitos específicos para este documento.

Componentes Utilizados

As informações neste documento são baseadas na plataforma Cisco DNA Center e Cisco Prime Infrastructure.

The information in this document was created from the devices in a specific lab environment. All of the devices used in this document started with a cleared (default) configuration. Se a rede estiver ativa, certifique-se de que você entenda o impacto potencial de qualquer comando.

Informações de Apoio

O Cisco PDART (Cisco Prime Infrastructure Cisco DNA Center Assessment & Readiness Tool) analisa uma implantação do Cisco Prime Infrastructure e avalia se o Cisco DNA Center suporta a implantação atual.

O PDART avalia a Cisco Prime Infrastructure sob estas perspectivas:

1. Casos de uso - Essa ferramenta pode verificar mais de 170 casos de uso automaticamente. Ele verifica se esses casos de uso estão em uso ou foram usados no passado. Em seguida, ele avalia cada caso de uso (em uso/usado apenas) em relação ao Cisco DNA Center. Ele avalia se esses casos de uso são suportados no momento, não são suportados ou estão no roteiro do Cisco DNA Center. Há 23 casos de uso adicionais que exigem verificação manual, listados no relatório.
2. Parâmetros de Escala - Essa ferramenta pode verificar nove Parâmetros de Escala automaticamente e compara a escala com os valores máximos suportados para a implantação atual. Em seguida, ele compara esses parâmetros de escala com a escala recomendada em vários formatos do Cisco DNA Center.
3. Relatórios - Essa ferramenta pode determinar os relatórios usados e agendados. Ele compara esses relatórios com os disponíveis com o Cisco DNA Center e avalia se esses relatórios têm suporte no momento, não têm suporte ou estão no roteiro.
4. Compatibilidade de dispositivos - Essa ferramenta pode detectar todos os dispositivos gerenciados e mapear cada dispositivo para a lista de dispositivos suportados do Cisco DNA Center. Ele avalia cada dispositivo com base em sua compatibilidade de hardware e software.
5. Migration Readiness Checks - Essa ferramenta executa cinco verificações e determina a integridade atual do Cisco Prime Infrastructure Appliance. (As validações adicionais podem vir em breve.)

O PDART é uma ferramenta fácil de usar que é somente leitura e não causa nenhum impacto. Ele não captura nenhuma informação confidencial ou envia nenhuma informação fora da implantação.

A saída da ferramenta é um arquivo TAR GZ que contém:

1. Arquivo PDF - uma avaliação resumida da implantação atual do Cisco Prime Infrastructure e o mapeamento com o Cisco DNA Center
2. Executar arquivo de log - contém os logs de execução do console
3. Arquivo JSON - contém o relatório em formato JSON
4. Arquivo Debug Log - contém despejos de banco de dados (DB) para obter informações adicionais sobre a configuração
5. Arquivo de log do AP - lista de todos os pontos de acesso (AP) e sua compatibilidade

No caso de quando o PDART é executado via UI, a saída são dois arquivos, o TAR GZ e o PDF.

Colaboração integrada com a equipe Cisco DNA Center Escalation Engineering, Sales e CX Centers TAC Engines.

Requisitos da ferramenta

• Ele é executado na infraestrutura Cisco Prime
• A opção CLI funciona somente com a versão 3.5 do Cisco Prime Infrastructure e posterior
• A opção UBF funciona somente com a versão 3.7 do Cisco Prime Infrastructure e posterior
• Ele avalia a implantação da versão 2.2.3.x do Cisco DNA Center
• Se você tiver várias implantações Cisco Prime, o PDART precisará ser executado em cada implantação
• Ele deve ser executado como raiz do usuário (um requisito para execução de PDART somente da CLI)
  

Execução de ferramentas

Há duas maneiras de executar a ferramenta:

Opção 1: Execute o PDART Executable a partir da CLI

Etapa 1. Copie o arquivo executável pdart de Github para qualquer diretório no Cisco Prime Infrastructure. A versão mais recente do executável PDART está disponível neste local: https://github.com/CiscoDevNet/PDART/.

Há duas maneiras de copiar o arquivo:

a) Uma ferramenta de transferência de arquivos, como Filezilla ou WinSCP

b) Se o Cisco Prime Infrastructure tiver conectividade com a Internet, use este comando para baixar o arquivo:

wget --no-check-certificate https://github.com/CiscoDevNet/PDART/raw/main/pdart

Exemplo:

[root@pi ~]# wget --no-check-certificate https://github.com/CiscoDevNet/PDART/raw/main/pdart
--2021-07-16 00:23:44-- https://github.com/CiscoDevNet/PDART/raw/main/pdart
Resolving github.com (github.com)... 140.82.113.3
Connecting to github.com (github.com)|140.82.113.3|:443... connected.
HTTP request sent, awaiting response... 302 Found
Location: https://raw.githubusercontent.com/CiscoDevNet/PDART/main/pdart [following]
--2021-07-16 00:23:44-- https://raw.githubusercontent.com/CiscoDevNet/PDART/main/pdart
Resolving raw.githubusercontent.com (raw.githubusercontent.com)... 185.199.109.133, 185.199.108.133, 185.199.111.133, ...
Connecting to raw.githubusercontent.com (raw.githubusercontent.com)|185.199.109.133|:443... connected.
HTTP request sent, awaiting response... 200 OK
Length: 14545120 (14M) [application/octet-stream]
Saving to: ‘pdart’

100%[=============================================================================================================================================================================================================>] 14,545,120 11.2MB/s in 1.2s

2021-07-16 00:23:45 (11.2 MB/s) - ‘pdart’ saved [14545120/14545120]

[root@pi ~]#

Etapa 2. Altere o arquivo para um executável.

[root@pi ~]# chmod 755 pdart

Execute o comando Linux file para garantir que você tenha o executável e um 'ls -l' para verificar se o comando chmod permitiu ao usuário raiz executar o arquivo pdart.

file pdart
ls -l pdart

Exemplo:

[root@pi ~]# file pdart
pdart: ELF 64-bit LSB executable, x86-64, version 1 (SYSV), dynamically linked (uses shared libs), for GNU/Linux 2.6.32, BuildID[sha1]=294d1f19a085a730da19a6c55788ec08c2187039, stripped
[root@pi ~]# 
[root@pi ~]#  ls -l pdart
-rwxr-xr-x. 1 root root 14545120 Jul 16 00:23 pdart
[root@pi ~]# 

Etapa 3. Um único comando para executar o arquivo a partir da CLI (certifique-se de ter feito login como usuário 'root').

 ./pdart

Exemplo de saída da CLI:

[root@pi ~]# ./pdart

####################################################
###                                              ###
###          Welcome to Cisco PDART              ###
###             version: 1.05                    ###
###                                              ###
####################################################

## 
## Script Start Time: 2022-06-21_14:25:35  
##

######
## 
## Initiating Platform Checks ... 
## 


...



###### 
## 
## All Checks completed, building the PDF ... 
##


## Summary page built, working on the pages with the details...


## Report built for - Device compatibility checks...


## Report built for - Scale checks...


## Report built for - Use Case checks...


## Report built for - Reporting checks...


## Report built for - Platform checks...


## 
## Script End Time: 2022-06-21_14:29:33
## 

******
Cisco PDART Tool has successfully completed.
PDF report, run logs and a json of the results can be found at:

PDART tarfile - /localdisk/defaultRepo/pdart.d/PDART_2022-06-21_14-25-35.tar.gz 

[root@pi ~]#

Etapa 4. Um único arquivo TAR GZ é criado pela ferramenta e está disponível no local /localdisk/defaultRepo/pdart.d/. O arquivo pode ser copiado do Prime com o uso de Filezilla ou WinSCP. O arquivo TAR GZ pode ser removido antes ou depois da cópia.

Esse comando desencadearia o arquivo em sua infraestrutura Cisco Prime (uma etapa opcional).

[root@pi ~]# tar -xvf PDART_2022-06-21_14-25-35.tar.gz
PDART_report_2022-06-21_14-25-35.pdf
PDART_results_2022-06-21_14-25-35.json
PDART_runlog_2022-06-21_14-25-35.log
PDART_aps_2022-06-21_14-25-35.json
PDART_debuglog_2022-06-21_14-25-35.log
[root@pi ~]#

Opção 2: Execute a PDART via Patch UBF

A PDART pode ser executada através da interface do usuário com o uso desse método. O executável PDART faz parte de um arquivo de patch Updated Bundle File (UBF) que precisa ser baixado de Cisco.com, carregado para sua Prime Instance e instalado. As credenciais raiz não são um requisito para esta opção. Estas são as etapas detalhadas:

Etapa 1. Identifique a versão do software e faça o download da UBF correspondente em Cisco.com.

Baixe o arquivo que começa com DNACAssessmentReadiness_ (login CCO é necessário para fazer o download do arquivo).

3.9.0 ou 3.9.1 —> https://software.cisco.com/download/home/286326052/type/284272933/release/3.9.1

3.8.0 ou 3.8.1 —> https://software.cisco.com/download/home/286325039/type/284272933/release/3.8.1

3.7.0 ou 3.7.1 —> https://software.cisco.com/download/home/286324413/type/284272933/release/3.7.1

Aqui está uma imagem do 3.9.1:

Etapa 2. Carregue o arquivo UBF do sistema local e instale-o (é necessário recarregar o Cisco Prime).

Depois que o arquivo é baixado para o sistema local, o arquivo UBF pode ser carregado e instalado através da IU. No menu principal, navegue até a página Atualização de software. Clique em Administration> Licenses and Software Updates > Software Update (Administração> Atualizações de software> Atualização de software).

Clique em Upload para carregar o arquivo UBF no Cisco Prime.

Navegue pelo computador local para escolher o arquivo UBF necessário e clique em Ok.

Quando o arquivo for carregado, clique no botão Install (Instalar) para instalar a UBF.

Clique em Sim na janela pop-up para reiniciar o Cisco Prime e instalar a UBF.

O Cisco Prime é reiniciado e está fora de serviço por 15 a 30 minutos.

Etapa 3. Navegue até a tela PDART e execute PDART a partir daqui.

Quando o UBF estiver instalado, navegue até este URL que exibe a página principal do PDART. Clique em RUN PDART TOOL para executar PDART.

https://<Cisco Prime IP Address>/webacs/pdart.jsp

Estas capturas de tela o guiam pela execução do PDART:

A PDART leva de 3 a 5 minutos para ser concluída na maioria dos casos, mas em uma configuração dimensionada pode levar até 10 minutos para ser concluída.

Essas opções são exibidas quando o PDART conclui a execução.

Clique em Download PDART Report para exibir o relatório PDF do PDART ou clique em Back to Main Page (Voltar à página principal) para voltar à página principal para executar novamente o PDART.

Exemplo de relatório

A imagem inclui a primeira página do relatório, que é um resumo de todas as verificações executadas. As páginas subsequentes incluem mais detalhes sobre as verificações executadas.

Versões de PDART

Versão do PDART	Comentários
Até 0,09	Todas as avaliações são baseadas no DNA Center versão 2.2.2.x.UBF & Github.
1.01	Todas as avaliações (caso de uso, dispositivo, escala, relatórios) agora são baseadas no DNA Center versão 2.2.3.x. Novo arquivo JSON para todos os APs e sua compatibilidade. A seção 'Plataforma' foi alterada para 'Preparação para migração' e inclui núcleos de CPU, memória total, média de carga da CPU, lista e local planejados de AP, edifícios sem nenhuma configuração de latitude/longitude, utilização de disco e verificações de instalação da ferramenta de migração de fase 2apenas Github.
1.02	Compatibilidade com PI 3.10.Github apenas.
1.03	Verificação de contagem de dispositivos não gerenciados, várias correções de bugs e falhas na compatibilidade do dispositivo. Recomendações de migração do ISE Server. Apenas Github.

Problemas com a ferramenta

Entre em contato com pdart-tool-support@cisco.com para obter assistência sobre a ferramenta.

Se o arquivo PDART tiver sido baixado para o Cisco Prime com êxito, mas não for executado, compartilhe a saída desses comandos Linux:

file pdart
ls -l pdart

Se a PDART não for executada através da IU, compartilhe as capturas de tela e os registros com falha.