Contents

Introduction

Prerequisites

Requirements

Componentes Utilizados

Informações de Apoio

Requisitos da ferramenta

Execução da ferramenta

Opção 1: Execute o executável PDART a partir do CLI

Opção 2: Executar o PDART via Patch UBF

Relatório de exemplo

Versões de PDART

Problemas com a ferramenta

Introduction

Este documento descreve o Cisco PDART - uma ferramenta de prontidã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 na infraestrutura Cisco Prime.

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 oferece suporte à 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 (somente em uso/usado) 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á mais 23 casos de uso que exigem verificação manual e estão listados no relatório.

2. Parâmetros de escala - Esta 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 relatórios disponíveis no Cisco DNA Center e avalia se eles são suportados no momento, não são suportados 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 compatíveis do Cisco DNA Center. Ele avalia cada dispositivo com base em sua compatibilidade de hardware, compatibilidade de software e suporte herdado.

5. Verificações de preparação para migração - Esta seção inclui dez verificações que incluem verificações básicas de integridade do Cisco Prime Infrastructure Appliance e uma análise de bloqueadores de migração conhecidos. (Validações adicionais poderão ser feitas 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 para fora da implantação.

A saída da ferramenta é umaTAR GZarquivo que contém:

1. PDFarquivo - uma avaliação resumida da implantação atual do Cisco Prime Infrastructure e o mapeamento com o Cisco DNA Center

2. Run logarquivo - contém os logs de execução do console

3. JSONarquivo - contém o relatório em um formato JSON

4. Debug Logarquivo - contém despejos do banco de dados (DB) para obter informações adicionais sobre a configuração

5. AP Logarquivo - lista de todos os pontos de acesso (AP) e sua compatibilidade

No caso em que o PDART é executado via interface do usuário, a saída são dois arquivos, oTAR GZbem como oPDFarquivo.

Colaboração integrada com a equipe de engenharia de escalação, vendas e mecanismos TAC dos centros CX da Cisco DNA Center.

Requisitos da ferramenta

- Ele é executado na infraestrutura Cisco Prime

- A opção CLI funciona com o Cisco Prime Infrastructure versão 3.5 e posterior apenas

- A opção UBF funciona com o Cisco Prime Infrastructure versão 3.7 e posterior apenas

- Ele avalia a implantação da versão 2.3.3.x do Cisco DNA Center

- Se você tiver várias implantações do Cisco Prime, o PDART precisará ser executado em cada implantação

- Ele deve ser executado como raiz do usuário (um requisito para a execução de PDART somente a partir da CLI)

- Se a implantação do Cisco Prime Infrastructure for um par HA (recurso de alta disponibilidade configurado), esses procedimentos detalhados aqui para instalar o PDART UBF (um requisito para execução de PDART somente a partir do UBF).

Execução da ferramenta

Há duas maneiras de executar a ferramenta:

Opção 1: Execute o executável PDART a partir do CLI

Etapa 1. Copiar o arquivo executável pdartdo Github para qualquer diretório na infraestrutura Cisco Prime. 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 fazer download do 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. Alterar o arquivo para um executável.

[root@pi ~]# chmod 755 pdart

Execute o comandoLinux filepara garantir que você tenha o executável e um 'ls -l' para verificar se o comandochmodpermitiu que o usuário raiz executasse o arquivopdart.

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 do CLI (certifique-se de ter efetuado login como usuário 'root').

./pdart

Exemplo de saída do 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 únicoTAR 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 TAR GZpode ser desmarcado antes ou depois da cópia.

Esse comando descompacta 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: Executar o PDART via Patch UBF

O PDART pode ser executado via interface do usuário com o uso desse método. O executável PDART faz parte de um arquivo de patchUpdated Bundle File(UBF) que precisa ser baixado de Cisco.com, carregado para sua instância Prime e, em seguida, 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 seu software e faça o download do UBF correspondente em Cisco.com.

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

3.10.1 —> https://software.cisco.com/download/home/286329246/type/284272933/release/3.10.1

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

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

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

Aqui está uma imagem de 3.8.1:

Primeubf381

Etapa 2. Fazer upload doUBFdo sistema local e instalá-lo (é necessário recarregar o Cisco Prime).

Depois que o arquivo é baixado para o sistema local, oUBFo arquivo pode ser carregado e instalado pela interface do usuário. No menu principal, navegue até a página Atualização de software. Clique emAdministration > Licenses and Software Updates > Software Update.

Clique emUploadpara carregar oUBFpara o Cisco Prime.

Navegue pelo computador local para escolher oUBFe clique emOk.

Quando o arquivo for carregado, clique no botãoInstallpara instalar a UBF.

Clique emYesna janela pop-up para reiniciar o Cisco Prime e instalar o UBF.

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

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

Uma vez que o UBF esteja instalado, navegue para este URL que traz a página principal do PDART. Clique emRUN PDART TOOLpara executar o PDART.

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

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

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

Essas opções são exibidas quando o PDART tiver concluído a execução.

Clique emDownload PDART Reportpara exibir o relatório PDART PDF ou clique noBack to Main Page, para voltar à página principal e executar o PDART novamente.

Relatório de exemplo

A imagem inclui a primeira página do relatório, que é um resumo de todas as verificações executadas. As páginas seguintes 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 se baseiam na versão 2.2.2.x do DNA Center. UBF e Github.

1.01

Todas as avaliações (caso de uso, dispositivo, escala, relatórios) agora se baseiam 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 de CPU, lista e localização de AP planejadas, prédios sem configurações de latitude/longitude, utilização de disco e verificações de instalação da ferramenta de migração da fase 2. Apenas Github.

1.02

Compatibilidade apenas com PI 3.10 Github.

1.03

Verificação de contagem de dispositivos não gerenciados, várias correções de bugs e falhas na compatibilidade de dispositivos. Recomendações de migração do ISE Server. Apenas Github.

1.05

Inclui correções de bugs. O UBF e o Github são compatíveis.

2.01

Todas as avaliações são baseadas na versão 2.3.3.x do DNA Center. Suporte a versões antigas e verificações adicionais do bloqueador de migração. Disponível somente no Github

2.02

Esta versão está disponível em ambas as formas, como UBF (atualização 3) no CCO e disponível como um executável no Github

Os números de escala estão alinhados com os novos números publicados para a versão Guardian

Problemas com a ferramenta

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

Se o arquivo PDART foi baixado com êxito no Cisco Prime, mas não é executado, compartilhe a saída dessesLinuxcomandos:

file pdart

ls -l pdart

log files in /localdisk/defaultRepo/pdart.d/

tool run logs seen on screen (in case of CLI version)

Se o PDART falhar ao ser executado via interface do usuário, compartilhe as capturas de tela e todos os logs com falha.