Introdução

Este documento descreve o Cisco PDART - uma ferramenta de prontidão do Cisco Catalyst 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 Catalyst 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 Prime Infrastructure Data Assessment & Readiness Tool (Cisco PDART) analisa uma implantação do Cisco Prime Infrastructure e avalia se o Cisco Catalyst 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 Catalyst 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 Catalyst 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 Catalyst Center.
3. Relatórios - Essa ferramenta pode determinar os relatórios usados e agendados. Ele compara esses relatórios com os disponíveis no Cisco Catalyst 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 suportados do Cisco Catalyst 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 sem fio - baseados em intenção (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 Catalyst Center e os atributos suportados pelo Cisco Catalyst Center.
7. Modelos sem fio - Configuração por dispositivo (adicionado no PDART versão 3.05) - Essa ferramenta pode determinar os modelos sem fio que foram enviados pelo Cisco Prime Infrastructure. Ele avalia se esses modelos em relação ao recurso de configuração por WLC (Brownfield Wireless Automation) disponível no Cisco Catalyst Center. Esse recurso suporta o aprendizado implícito de configurações para todas as WLCs descobertas (C9800) no Catalyst 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 Catalyst Center.

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

1. PDF arquivo - uma avaliação resumida da implantação atual do Cisco Prime Infrastructure e o mapeamento com o Cisco Catalyst Center.
2. Run log arquivo - contém os logs de execução do console.
3. JSON arquivo - contém o relatório em um formato JSON.
4. Debug Log arquivo - 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 Log file - lista de todos os pontos de acesso (AP) e sua compatibilidade.

Quando o PDART é executado via interface do usuário, a saída são dois arquivos; o TAR GZ arquivo e o PDF arquivo.

Colaboração integrada com a equipe de engenharia de escalonamento, vendas e mecanismos TAC dos centros CX.

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 a versão 3.7 e posterior do Cisco Prime Infrastructure.
• Se você tiver várias implantações do Cisco Prime, o PDART deverá 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 da CLI

Etapa 1. Copie o arquivo executável pdart do Github para qualquer diretório no Cisco Prime Infrastructure. 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 CiscoDevNet 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 Linux file o comando para garantir que você tenha o executável e um ls -l para verificar se o chmod comando permitiu que o usuário raiz executasse 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. (Opcional) Valide o hash do pdart do arquivo para garantir que o download do arquivo correto tenha sido feito.

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

Etapa 3.1. 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 3.2. 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 único TAR GZ arquivo é 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 GZ arquivo pode ser desmarcado antes ou depois da cópia.

Esse comando pode descompactar 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 patch Updated Bundle File (UBF) que deve 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.

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

3.10.x - Download do software Prime Infrastructure Versão 3.10.1

3.9.x - Download do software Prime Infrastructure versão 3.9.1

3.8.x - Download do software Prime Infrastructure versão 3.8.1

3.7.x - Download do software Prime Infrastructure versão 3.7.1

Aqui está uma imagem de 3.7.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 UBF 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.

CliqueAdministration > Licenses and Software Updates > Software Update and then click Upload para carregar o arquivo no Cisco PrimeUBF.

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

Depois que o arquivo for carregado, clique no Install botão para instalar o UBF.

Clique Yes na 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 3.1 ou 3.2).

Etapa 3.1. Depois que o UBF estiver instalado, navegue para essa URL que exibe a página principal do PDART. Clique RUN PDART TOOL para executar o PDART.

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

Etapa 3.2. 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:

Depois de clicar em Executar PDART, o botão fica esmaecido e o status da Saída do Console muda para EXECUÇÃO EM ANDAMENTO. O PDART geralmente leva até 5 minutos para ser concluído. Para uma configuração em escala, pode levar até 15 minutos para ser concluída com base no número de dispositivos gerenciados e na carga do sistema.

Depois de concluído, o status da Saída do Console é alterado para Execução bem-sucedida. Clique em Download do relatório para visualizar o relatório PDF PDART.

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 Catalyst 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 Catalyst 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 de CPU, memória total, média de carga de 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 Catalyst 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 Catalyst 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 Catalyst Center versão 2.3.5.x. A matriz de compatibilidade de dispositivos no PDART é 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
3.03	Alterado o nome para Cisco Catalyst Center. Apenas Github.
3.05	Todas as avaliações são baseadas no Cisco Catalyst Center versão 2.3.7.x. A matriz de compatibilidade de dispositivos no PDART é atualizada. O DN3 substitui o DN2 como o dispositivo recomendado. Verificação de Modelos Sem Fio adicionada por dispositivo (somente Catalyst 9800). Pequenas correções de bugs e disponíveis no Github e Software.Cisco.com.

Problemas com a ferramenta

Entre em contato com pdart-tool-support@cisco.com para obter assistência com a ferramenta e compartilhe o tarball com o relatório para quaisquer preocupações com o resultado do relatório.

Se o arquivo PDART foi baixado de Github.com para o Cisco Prime Infrastructure com êxito, mas não for executado, compartilhe a saída destes Linux comandos:

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.