Introduction

Ce document décrit le PDART de Cisco, un outil de préparation du centre Cisco DNA pour l'infrastructure principale de Cisco.

Conditions préalables

Conditions requises

Aucune spécification déterminée n'est requise pour ce document.

Components Used

Les informations contenues dans ce document sont basées sur la plate-forme Cisco DNA Center et l'infrastructure 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. Si votre réseau est en ligne, assurez-vous de bien comprendre l’incidence possible des commandes.

Informations générales

Cisco PDART (Cisco Prime Infrastructure Cisco DNA Center Assessment & Readiness Tool) analyse un déploiement d'infrastructure Cisco Prime et évalue si Cisco DNA Center prend en charge le déploiement actuel.

Le PDART évalue l'infrastructure Cisco Prime selon les points de vue suivants :

1. Cas d'utilisation : cet outil peut vérifier automatiquement plus de 170 cas d'utilisation. Il vérifie si ces cas d'utilisation sont utilisés ou ont été utilisés dans le passé. Il évalue ensuite chaque cas d'utilisation (en cours d'utilisation/utilisé uniquement) par rapport au Cisco DNA Center. Il évalue si ces cas d'utilisation sont actuellement pris en charge, non pris en charge ou sur la feuille de route pour Cisco DNA Center. Il existe 23 autres cas d'utilisation nécessitant une vérification manuelle, qui sont répertoriés dans le rapport.
2. Paramètres d'échelle : cet outil peut vérifier automatiquement neuf paramètres d'échelle et les comparer aux valeurs maximales prises en charge pour le déploiement en cours. Il compare ensuite ces paramètres d'échelle avec l'échelle recommandée pour différents facteurs de forme Cisco DNA Center.
3. Rapports - Cet outil peut déterminer les rapports utilisés et planifiés. Il compare ces rapports à ceux disponibles avec Cisco DNA Center et évalue si ces rapports sont actuellement pris en charge, non pris en charge ou sur la feuille de route.
4. Compatibilité des périphériques : cet outil peut détecter tous les périphériques gérés et mapper chaque périphérique à la liste des périphériques pris en charge de Cisco DNA Center. Il évalue chaque périphérique en fonction de sa compatibilité matérielle, de sa compatibilité logicielle et de sa prise en charge héritée.
5. Contrôles de préparation à la migration : cette section comprend dix contrôles qui incluent des contrôles de base de l'intégrité de l'appliance d'infrastructure Cisco Prime et une analyse des bloqueurs de migration connus. (D'autres validations seront bientôt disponibles.)

Le PDART est un outil facile à utiliser qui est en lecture seule et n'a aucun impact. Il ne saisit aucune information confidentielle et n'envoie aucune information en dehors du déploiement.

Le résultat de l'outil est unTAR GZfichier qui contient :

1. PDFfichier : évaluation sommaire du déploiement actuel de l'infrastructure Cisco Prime et du mappage avec Cisco DNA Center
2. Run logfichier - contient les journaux d'exécution de la console
3. JSONfichier - contient le rapport au format JSON
4. Debug Logfichier - contient des vidages de base de données (DB) pour plus d'informations sur l'installation
5. AP Logfichier - liste de tous les points d'accès (AP) et leur compatibilité

Dans le cas où PDART est exécuté via l'interface utilisateur, le résultat est deux fichiers, leTAR GZainsi que le fichierPDFfichier.

Collaboration intégrée avec l'équipe Cisco DNA Center Escalation Engineering, Sales et CX Centers TAC Engines.

Besoins en outils

• Il est exécuté sur l'infrastructure Cisco Prime
• L'option CLI fonctionne uniquement avec Cisco Prime Infrastructure 3.5 et versions ultérieures
• L'option UBF fonctionne uniquement avec Cisco Prime Infrastructure 3.7 et versions ultérieures
• Il évalue le déploiement de la version 2.3.3.x de Cisco DNA Center
• Si vous disposez de plusieurs déploiements Cisco Prime, le programme PDART doit être exécuté sur chaque déploiement
• Il doit être exécuté en tant que racine utilisateur (une condition requise pour l'exécution de PDART à partir de l'interface de ligne de commande uniquement)
  
• Si le déploiement de l'infrastructure Cisco Prime est une paire haute disponibilité (fonctionnalité de haute disponibilité configurée), alors ces procédures détaillées ici pour installer le PDART UBF (une exigence pour l'exécution du PDART à partir du UBF seulement).

Exécution des outils

Il existe deux façons d'exécuter l'outil :

Option 1 : Exécuter l'exécutable PDART depuis CLI

Étape 1 : copie du fichier exécutable pdartdepuis Github vers n'importe quel répertoire de l'infrastructure Cisco Prime. La dernière version de l'exécutable PDART est disponible à l'adresse suivante : https://github.com/CiscoDevNet/PDART/.

Il existe deux façons de copier le fichier :

a) Un outil de transfert de fichiers comme Filezilla ou WinSCP

b) Si l'infrastructure Cisco Prime dispose d'une connectivité Internet, utilisez cette commande pour télécharger le fichier :

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

Exemple :

[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 ~]#

Étape 2. Remplacer le fichier par un exécutable

[root@pi ~]# chmod 755 pdart

Exécutez la commandeLinux filepour vous assurer que vous disposez de l'exécutable et d'un 'ls -l' pour vérifier sichmoda permis à l'utilisateur racine d'exécuter le fichierpdart.

file pdart
ls -l pdart

Exemple :

[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 ~]# 

Étape 3. Une seule commande pour exécuter le fichier à partir de l’interface de ligne de commande (vérifiez que vous vous êtes connecté en tant qu’utilisateur « root »).

 ./pdart

Exemple de résultat de 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 ~]#

Étape 4. Un seulTAR GZest créé par l'outil et est disponible à l'emplacement/localdisk/defaultRepo/pdart.d/. Le fichier peut être copié à partir de Prime avec l'utilisation de Filezilla ou WinSCP. LesTAR GZpeut être dédémarré avant ou après la copie.

Cette commande permet de décompresser le fichier sur votre infrastructure Cisco Prime (étape facultative).

[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 ~]#

Option 2 : Exécuter le PDART via le correctif UBF

PDART peut être exécuté via l'interface utilisateur à l'aide de cette méthode. L'exécutable PDART fait partie d'un fichier de correctifUpdated Bundle File(UBF) qui doit être téléchargé depuis Cisco.com, téléchargé sur votre instance Prime, puis installé. Les informations d'identification racine ne sont pas requises pour cette option. Voici les étapes détaillées :

Étape 1. Identifiez la version de votre logiciel et téléchargez le fichier UBF correspondant à partir de Cisco.com.

Téléchargez le fichier qui commence parDNACAssessmentReadiness_(Vous devez vous connecter à CCO pour télécharger le fichier).

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

Voici une image de 3.8.1 :

Primeubf381

Étape 2. Téléchargez leUBFà partir de votre système local et installez-le (rechargement Cisco Prime requis).

Une fois le fichier téléchargé sur le système local, leUBFpeut être téléchargé et installé via l'interface utilisateur. Dans le menu principal, accédez à la page Software Update. CliquerAdministration > Licenses and Software Updates > Software Update.

CliquerUploadpour télécharger leUBFvers Cisco Prime.

Parcourez l'ordinateur local pour sélectionner lesUBFet cliquez surOk.

Une fois le fichier téléchargé, cliquez sur le boutonInstallpour installer l'UBF.

CliquerYesdans la fenêtre contextuelle pour redémarrer Cisco Prime et installer l'UBF.

Cisco Prime redémarre et est hors service pendant 15 à 30 minutes.

Étape 3. Accédez à l'écran PDART et exécutez-le à partir de cet écran.

Une fois l'UBF installé, accédez à cette URL qui affiche la page principale de PDART. CliquerRUN PDART TOOLpour exécuter le PDART.

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

Ces captures d'écran vous guident tout au long de l'exécution de PDART :

Dans la plupart des cas, l'exécution du PDART prend environ 3 à 5 minutes, mais dans une configuration à l'échelle, elle peut prendre jusqu'à 10 minutes.

Ces options s'affichent une fois l'exécution de PDART terminée.

CliquerDownload PDART Reportpour afficher le rapport PDF PDART ou cliquez sur le boutonBack to Main Page, pour revenir à la page principale et réexécuter PDART.

Exemple de rapport

L'image comprend la première page du rapport qui est un résumé de toutes les vérifications effectuées. Les pages suivantes contiennent plus de détails sur les vérifications effectuées.

Versions PDART

Version PDART	Commentaires
Jusqu'à 0,09	Toutes les évaluations sont basées sur la version 2.2.2.x de DNA Center. UBF et Github.
1.01	Toutes les évaluations (cas d'utilisation, appareil, échelle, rapports) sont désormais basées sur la version 2.2.3.x du DNA Center. Nouveau fichier JSON pour tous les AP et leur compatibilité. La section « Plate-forme » est devenue « Préparation à la migration » et inclut les coeurs de CPU, la mémoire totale, la charge moyenne de CPU, la liste et l'emplacement planifiés des points d'accès, les bâtiments sans paramètres de latitude/longitude, l'utilisation du disque et les contrôles d'installation de l'outil de migration de phase 2. Github uniquement.
1.02	Compatibilité avec PI 3.10. Github uniquement.
1.03	Vérification du nombre de périphériques non gérés, correctifs de bogues multiples et pannes dans la compatibilité des périphériques. Recommandations de migration du serveur ISE. Github uniquement.
1.05	Inclut des corrections de bogues. UBF et Github prennent en charge.
2.01	Toutes les évaluations sont basées sur la version 2.3.3.x de DNA Center. Prise en charge héritée et vérifications supplémentaires du bloqueur de migration. Disponible sur Github uniquement
2.02	Cette version est disponible sous les deux formes, en UBF (mise à jour 3) sur CCO et en exécutable sur Github Les numéros d'échelle correspondent aux nouveaux numéros publiés pour la version du Guardian

Problèmes avec l'outil

Contactez pdart-tool-support@cisco.com pour obtenir de l'aide sur cet outil.

Si le fichier PDART a été téléchargé sur Cisco Prime mais ne s'exécute pas correctement, partagez le résultat de cesLinuxcommandes :

file pdart
ls -l pdart
log files in /localdisk/defaultRepo/pdart.d/
tool run logs seen on screen (in case of CLI version) 

Si l'exécution de PDART échoue via l'interface utilisateur, partagez les captures d'écran et les journaux qui ont échoué.