Introduzione

Questo documento descrive Cisco PDART - uno strumento di preparazione al Cisco Catalyst Center per Cisco Prime Infrastructure.

Prerequisiti

Requisiti

Nessun requisito specifico previsto per questo documento.

Componenti usati

Per la stesura del documento, sono stati usati la piattaforma Cisco Catalyst Center e Cisco Prime Infrastructure.

Le informazioni discusse in questo documento fanno riferimento a dispositivi usati in uno specifico ambiente di emulazione. Su tutti i dispositivi menzionati nel documento la configurazione è stata ripristinata ai valori predefiniti. Se la rete è operativa, valutare attentamente eventuali conseguenze derivanti dall'uso dei comandi.

Premesse

Lo strumento Cisco Prime Infrastructure Data Assessment & Readiness Tool (Cisco PDART) analizza un'implementazione di Cisco Prime Infrastructure e valuta se Cisco Catalyst Center supporta l'installazione corrente.

Il software PDART valuta Cisco Prime Infrastructure da queste prospettive:

1. Use Case - Questo strumento è in grado di controllare automaticamente oltre 170 casi di utilizzo. Controlla se questi Use Case sono in uso o sono stati utilizzati in passato. Infine, valuta ogni Use Case (solo in uso/utilizzato) in base al Cisco Catalyst Center. Valuta se questi Use Case sono attualmente supportati, non supportati o se sono inclusi nella roadmap per Cisco Catalyst Center. Sono disponibili altri 23 casi di utilizzo che richiedono una verifica manuale e sono elencati nel report.
2. Parametri scala (Scale Parameters) - Questo strumento consente di controllare automaticamente nove parametri di scala e di confrontare la scala con i valori massimi supportati per la distribuzione corrente. Vengono quindi confrontati i parametri Scale con la scala consigliata in diversi fattori di forma fisica di Cisco Catalyst Center.
3. Report: questo strumento consente di determinare i report utilizzati e pianificati. Confronta questi report con quelli disponibili nel Cisco Catalyst Center e valuta se sono attualmente supportati, non supportati o inclusi nella roadmap.
4. Compatibilità dispositivi - Questo strumento può rilevare tutti i dispositivi gestiti e mappare ciascun dispositivo all'elenco dei dispositivi supportati del Cisco Catalyst Center. Valuta ogni dispositivo in base alla compatibilità hardware, alla compatibilità software e al supporto delle versioni precedenti.
5. Controlli della fattibilità della migrazione: in questa sezione sono inclusi dieci controlli, tra cui controlli di base sullo stato di Cisco Prime Infrastructure Appliance e un'analisi dei blocchi della migrazione noti. (Ulteriori convalide saranno presto disponibili).
6. Modelli (aggiunti in PDART versione 3.01) - Questo strumento può determinare i Modelli wireless sottoposti a push da Cisco Prime Infrastructure. Valuta se questi modelli possono essere applicati dal Cisco Catalyst Center e gli attributi supportati dal Cisco Catalyst Center.

PDART è uno strumento facile da utilizzare, di sola lettura e senza alcun impatto. Non cattura informazioni riservate né invia informazioni al di fuori dell'installazione. PDART valuta l'implementazione per la versione 2.3.x di Cisco Catalyst Center.

L'output dello strumento è un TAR GZ file che contiene:

1. PDF file - una valutazione di riepilogo dell'implementazione corrente di Cisco Prime Infrastructure e della mappatura con Cisco Catalyst Center
2. Run log file - contiene i log di esecuzione della console
3. JSON file - contiene il report in formato JSON
4. Debug Log file - contiene i dump del database (DB) per ulteriori informazioni sull'installazione (utile per la risoluzione dei problemi)
5. AP Log file - elenco di tutti i punti di accesso (AP) e relativa compatibilità

Quando PDART viene eseguito tramite UI, l'output è costituito da due file, TAR GZ ovvero il file e il PDF file.

Collaborazione integrata con il team Cisco Catalyst Center Escalation Engineering, Sales e CX Centers TAC Engine.

Requisiti degli strumenti

• PDART viene eseguito su Cisco Prime Infrastructure.
• L'opzione CLI funziona solo con Cisco Prime Infrastructure versione 3.5 e successive.
• L'opzione UBF funziona solo con Cisco Prime Infrastructure versione 3.7 e successive.
• Se si dispone di più distribuzioni Cisco Prime, PDART deve essere eseguito su ciascuna distribuzione.
• PDART deve essere eseguito come utente root (requisito per l'esecuzione di PDART solo dalla CLI).
  
• Se l'implementazione di Cisco Prime Infrastructure è una coppia ad alta disponibilità (HA) (funzionalità HA configurata), utilizzare le procedure qui descritte per installare PDART UBF (requisito per l'esecuzione PDART solo da UBF).

Esecuzione dello strumento

Esistono due modi per eseguire lo strumento:

Opzione 1: eseguire l'eseguibile PDART dalla CLI

Passaggio 1. Copiare il file eseguibile pdart da Github in qualsiasi directory di Cisco Prime Infrastructure. L'ultima versione del file eseguibile PDART è disponibile al seguente indirizzo: CiscoDevNet/PDART.

Esistono due modi per copiare il file:

1. Strumento di trasferimento file come Filezilla o WinSCP.
2. Se Cisco Prime Infrastructure dispone di connettività Internet, utilizzare questo comando per scaricare il file:

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

Esempio:

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

Passaggio 2. Modificare le autorizzazioni del file in eseguibile.

[root@pi ~]# chmod 755 pdart

Eseguire Linux file il comando per assicurarsi di disporre del file eseguibile e di un comando ls -l per verificare se il chmod comando ha consentito all'utente root di eseguire il file pdart.

file pdart
ls -l pdart

Esempio:

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

Passaggio 3. (Facoltativo) Convalidare l'hash del file pdart per assicurarsi che sia stato scaricato il file corretto.

Per verificare che sia stato scaricato il file corretto, confrontare l'hash MD5 o SHA256 disponibili alla fine di questa pagina. Ogni versione di PDART può avere un set univoco di valori hash.

Passaggio 3.1. Verifica hash MD5.

Usare il comando md5sum (come elencato). Genera l'hash sul tuo Cisco Prime Infra o su qualsiasi altro sistema Linux e confronta il valore hash con il valore alla fine di questa pagina. 

    $ md5sum pdart
    52f429dd275e357fe3282600d38ba133 pdart

Passaggio 3.2. Verifica hash SHA256.

Utilizzare il comando sha256sum (come elencato). Genera l'hash sul tuo Cisco Prime Infra o su qualsiasi altro sistema Linux e confronta il valore hash con il valore alla fine di questa pagina.

    $ sha256sum pdart
    c91b6092ab4fa57adbe698a3c17f9146523bba5b0315222475aa4935662a0b6e pdart

Passaggio 4. Un unico comando per eseguire il file dalla CLI (verificare di aver eseguito l'accesso come utente root).

 ./pdart

Output di esempio da 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 ~]#

Passaggio 5. Un singolo TAR GZ file viene creato dallo strumento ed è disponibile nella /localdisk/defaultRepo/pdart.d/posizione. Il file può essere copiato fuori da Prime con l'uso di Filezilla o WinSCP. Il file può essere annullato prima o dopo la copia.TAR GZNota

Questo comando può estrarre il file dalla Cisco Prime Infrastructure (un passaggio opzionale).

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

Opzione 2: eseguire il PDART tramite patch UBF

PDART può essere eseguito tramite l'interfaccia utente utilizzando questo metodo. L'eseguibile PDART fa parte di un file di patch Updated Bundle File (UBF) che deve essere scaricato da Cisco.com, caricato in Prime Instance e quindi installato. Le credenziali radice non sono un requisito per questa opzione. Di seguito sono riportati i passaggi dettagliati:

Passaggio 1. Identificare la versione del software e scaricare l'UBF corrispondente da Cisco.com.

Scaricare il file che inizia con DNACAssessmentReadiness_(per scaricare il file è necessario l'accesso CCO).

3.10.1 - Download del software Prime Infrastructure release 3.10.1

3.9.1 - Download del software Prime Infrastructure release 3.9.1

3.8.1 - Download del software Prime Infrastructure release 3.8.1

3.7.1 - Download del software Prime Infrastructure release 3.7.1

Di seguito è riportata un'immagine della versione 3.8.1:

Primeubf381

Passaggio 2. Caricare il UBF file dal sistema locale e installarlo (è necessario Cisco Prime reload).

Una volta scaricato il file nel sistema locale, il file può essere caricato e installato tramite l'interfaccia utente (UI)UBF. Dal menu principale, passare alla pagina Software Update (Aggiornamento software).

Fare clic suAdministration > Licenses and Software Updates > Software Update and then click Upload per caricare il UBF file in Cisco Prime.

Sfogliare il computer locale per scegliere il UBF file richiesto e fare clic su Ok.

Una volta caricato il file, fare clic sul Install pulsante per installare l'UBF.

Fare clic Yes nella finestra popup per riavviare Cisco Prime Infrastructure e installare l'UBF.

Cisco Prime Infrastructure viene riavviato e rimane fuori servizio per 15-30 minuti.

Passaggio 3. Passare alla schermata PDART (punto 3.1 o 3.2).

Passaggio 3.1. Una volta installato l'UBF, passare a questo URL che visualizza la pagina principale PDART. Fare clic su RUN PDART TOOL per eseguire PDART.

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

Passaggio 3.2. Una volta installato l'UBF e se è installato anche Prime Data Migration Tool versione 5, è possibile avviare PDART dal menu hamburger come indicato in queste schermate.

Passaggio 4. Eseguire PDART dalla UI.

Queste schermate guidano l'utente attraverso l'esecuzione di PDART:

Nella maggior parte dei casi, il completamento di PDART richiede circa 3-5 minuti, ma in una configurazione scalabile può richiedere fino a 10 minuti.

Queste opzioni vengono visualizzate al termine dell'esecuzione di PDART.

Fare clic su Download PDART Report per visualizzare il report PDF PDART oppure fare clic su Back to Main Page, per tornare alla pagina principale ed eseguire nuovamente PDART.

Report di esempio

Nell'immagine è inclusa la prima pagina del report, ovvero un riepilogo di tutti i controlli eseguiti. Nelle pagine successive vengono forniti ulteriori dettagli sui controlli eseguiti.

Versioni PDART

Versione PDART	Commenti
Fino a 0,09	Tutte le valutazioni sono basate su Cisco Catalyst Center versione 2.2.2.x. UBF e Github.
1.01	Tutte le valutazioni (use case, dispositivo, scala, report) sono basate su Cisco Catalyst Center versione 2.2.3.x. Nuovo file JSON per tutti gli access point e relativa compatibilità. La sezione relativa alla piattaforma è stata modificata in Preparazione alla migrazione e include i core CPU, la memoria totale, la media del carico della CPU, l'elenco e la posizione dei punti di accesso pianificati, gli edifici senza impostazioni di latitudine/longitudine, l'utilizzo del disco e i controlli di installazione dello strumento di migrazione fase 2. Solo Github.
1.02	Compatibilità con PI 3.10. Solo Github.
1.03	Controllo del numero di dispositivi non gestiti, correzioni di più bug e arresti anomali della compatibilità dei dispositivi. Consigli per la migrazione a ISE Server. Solo Github.
1.05	Include le correzioni dei bug. Sia UBF che Github supportano.
2.01	Tutte le valutazioni sono basate su Cisco Catalyst Center versione 2.3.3.x. Controlli aggiuntivi del blocco della migrazione e del supporto legacy. Disponibile solo su Github.
2.02	Questa versione è disponibile in entrambi i formati, come UBF (aggiornamento 3) su CCO e come eseguibile su Github. I numeri di scala sono in linea con i nuovi numeri pubblicati per la release 2.3.3.x. I file UBF sono: 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	Correzioni di bug minori e disponibile solo su Github.
2.04	Correzioni di bug minori e disponibile solo su Github.
3.01	Tutte le valutazioni sono basate su Cisco Catalyst Center versione 2.3.5.x. È stata introdotta la funzionalità dei modelli wireless. Disponibile solo su Github. Checksum MD5: fd31d1895b32bdd5bbe55b5b816e57c Checksum SHA256: 16343616aadb63b676804e2b49cf1e93e142caede1003c889de462b2d6983ffc
3.02	Tutte le valutazioni sono basate su Cisco Catalyst Center versione 2.3.5.x. La matrice di compatibilità dei dispositivi in PDART viene aggiornata. Ulteriori controlli e modifiche sulla migrazione: Siti di cui non è possibile eseguire la migrazione a causa di caratteri speciali non supportati o che iniziano o terminano con uno spazio vuoto. Duplicare il controllo della migrazione pianificata per includere le ubicazioni. Dispositivi di cui non è possibile eseguire la migrazione perché fanno parte di un gruppo errato o perché appartengono a un tipo di gruppo errato. Disponibile su Github e come UBF. Checksum MD5: 6f774cb32143f7333ad8960bcecd871 Checksum SHA256: 78c82e2ebc2e00ac3fd9a98171bfa98c769a51d12b3fa98b73baaf97fd552236
3.03	Il nome è stato cambiato in Cisco Catalyst Center. Solo Github.

Problemi con lo strumento

Per assistenza sullo strumento, contattare pdart-tool-support@cisco.com.

Se il file PDART è stato scaricato in Cisco Prime Infrastructure correttamente ma non viene eseguito, condividere l'output di questi Linux comandi:

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

Se l'esecuzione di PDART non riesce tramite l'interfaccia utente, è necessario condividere le acquisizioni dello schermo e gli eventuali log non riusciti.