Introdução

Este documento descreve o Cisco PDART - uma ferramenta de prontidão do Cisco DNA Center para a Cisco Prime Infrastructure.

Pré-requisitos

Requisitos

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.

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.

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 físicos 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 lançadas em breve.)
6. Modelos (adicionados no PDART versão 3.01) - Essa ferramenta pode determinar os modelos sem fio que foram enviados pelo Cisco Prime Infrastructure. Ele avalia se esses Modelos podem ser aplicados pelo Cisco DNA Center e os atributos suportados pelo Cisco DNA Center.

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. O PDART avalia a implantação da versão 2.3.x do Cisco DNA Center

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 (útil para solução de problemas)
5. AP Logarquivo - lista de todos os pontos de acesso (APs) e sua compatibilidade

Quando 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

• O PDART é executado no Cisco Prime Infrastructure.
• A opção CLI funciona apenas com o Cisco Prime Infrastructure 3.5 e posterior.
• A opção UBF funciona apenas com o Cisco Prime Infrastructure 3.7 e posterior.
• Se você tiver várias implantações do Cisco Prime, o PDART precisará ser executado em cada implantação.
• O PDART deve ser executado como raiz do usuário (um requisito para a execução do PDART somente a partir do CLI).
  
• Se a implantação do Cisco Prime Infrastructure for um par de HA (High Availability, alta disponibilidade) (recurso HA configurado), use os procedimentos detalhados aqui para instalar a UBF do PDART (um requisito para a execução do 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. Copie 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: CiscoDevNet / PDART.

Há duas maneiras de copiar o arquivo:

1. Uma ferramenta de transferência de arquivos como Filezilla ou WinSCP.
2. 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)... 10.82.113.3
Connecting to github.com (github.com)|10.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)... 192.168.109.133, 192.168.108.133, 192.168.108.133, ...
Connecting to raw.githubusercontent.com (raw.githubusercontent.com)|192.168.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 as permissões de arquivo para 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. (Opcional) Valide o hash do arquivo pdart para garantir que o download do arquivo correto seja feito.

Para verificar se o arquivo correto foi baixado, compare os valores de hash MD5 ou SHA256 disponíveis ao final desta página. Cada versão do PDART pode ter um conjunto exclusivo de valores de hash.

Etapa 3a. Verificação de hash MD5.

Use o comando md5sum (conforme listado). Gere o hash em seu Cisco Prime Infra ou em qualquer outro sistema Linux e compare o valor do hash com o valor no final desta página. 

    $ md5sum pdart
    52f429dd275e357fe3282600d38ba133 pdart

Etapa 3b. Verificação de hash SHA256.

Use o comando sha256sum (conforme listado). Gere o hash em seu Cisco Prime Infra ou em qualquer outro sistema Linux e compare o valor do hash com o valor no final desta página. 

    $ sha256sum pdart
    c91b6092ab4fa57adbe698a3c17f9146523bba5b0315222475aa4935662a0b6e pdart

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

 ./pdart

Exemplo de saída do CLI:

[root@pi ~]# ./pdart
####################################################
###                                              ###
###          Welcome to Cisco PDART              ###
###               version: 3.01                  ###
###                                              ###
####################################################
###

## 
## Script Start Time: 2023-06-12_13:03:25 
##


###### 
## 
## Initiating DB Accessible Check ... 
##


# DB is accessible, continuing....

###### 
## 
## 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 - Wireless Templates checks...


## Report built for - Platform checks...


## 
## Script End Time: 2023-06-12_13:07:13 
##



******
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_2023-06-12_13-03-25.tar.gz
[root@pi ~]#

Etapa 5. Um únicoTAR GZé criado pela ferramenta e está disponível no local/localdisk/defaultRepo/pdart.d/. O arquivo pode ser copiado para fora 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_2023-06-12_13-03-25.tar.gz
PDART_report_2023-06-12_13-03-25.pdf
PDART_results_2023-06-12_13-03-25.json
PDART_runlog_2023-06-12_13-03-25.log
PDART_aps_2023-06-12_13-03-25.json
PDART_debuglog_2023-06-12_13-03-25.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 —> Download do software Prime Infrastructure Versão 3.10.1

3.9.1 —> Download do software Prime Infrastructure versão 3.9.1

3.8.1 —> Download do software Prime Infrastructure versão 3.8.1

3.7.1 —> Download do software Prime Infrastructure Versão 3.7.1

Aqui está uma imagem de 3.8.1:

Primeubf381

Etapa 2. Carregue oUBFdo 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 através da 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.

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

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

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

Etapa 3. Navegue até a tela PDART (etapa 3a ou 3b).

Etapa 3a. 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

Etapa 3b. Uma vez que o UBF é instalado, e se o Prime Data Migration Tool versão 5 também é instalado, o PDART pode ser iniciado a partir do menu do hambúrguer conforme essas capturas de tela.

Etapa 4. Execute o PDART na interface do usuário.

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

O PDART leva cerca 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 no botãoBack 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 são baseadas no Cisco DNA Center versão 2.2.2.x. UBF e Github.
1.01	Todas as avaliações (caso de uso, dispositivo, escala, relatórios) agora são baseadas no Cisco DNA Center versão 2.2.3.x. Novo arquivo JSON para todos os APs e sua compatibilidade. A seção da plataforma foi alterada para Preparação para migração e inclui núcleos da CPU, memória total, média de carga da CPU, lista e localização de APs planejados, 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 com PI 3.10. Apenas 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 no Cisco DNA Center versão 2.3.3.x. 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 2.3.3.x. Os arquivos UBF são: Cisco DNACAssessmentReadiness_3_7_Update_03-1.0.3.ubf Cisco DNACAssessmentReadiness_3_8_Update_03-1.0.3.ubf Cisco DNACAssessmentReadiness_3_9_Update_03-1.0.3.ubf Cisco DNACAssessmentReadiness_3_10_Update_03-1.0.3.ub
2.03	Pequenas correções de bugs e disponíveis somente no Github.
2.04	Pequenas correções de bugs e disponíveis somente no Github.
3.01	Todas as avaliações são baseadas no Cisco DNA Center versão 2.3.5.x. Introduziu o recurso de modelos sem fio. Disponível somente no Github. Soma de verificação MD5: fd31d1895b32bdd5bbe557b5b816e57c Soma de verificação SHA256: 16343616aadb63b676804e2b49cf1e93e142caede1003c889de462b2d6983ffc
3.02	Todas as avaliações são baseadas no Cisco DNA Center versão 2.3.5.x. A matriz de compatibilidade de dispositivos no PDART foi atualizada. Verificações e modificações adicionais de migração: Sites que não podem ser migrados devido a caracteres especiais sem suporte ou aqueles que começam ou terminam com um espaço em branco. Duplicar verificação de migração planejada para incluir locais. Dispositivos que não podem ser migrados porque fazem parte do grupo errado ou do tipo de grupo errado. Disponível no Github e como UBF Soma de verificação MD5: 6f774cb32143f73333ad8960bcecd871 Soma de verificação SHA256: 78c82e2ebc2e00ac3fd9a98171bfa98c769a51d12b3fa98b73baaf97fd552236

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 para o Cisco Prime Infrastructure, mas não for 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.