Inleiding

Dit document beschrijft Cisco PDART - een Cisco Catalyst Center-gereedschapshulpmiddel voor de Cisco Prime-infrastructuur.

Voorwaarden

Vereisten

Er zijn geen specifieke vereisten van toepassing op dit document.

Gebruikte componenten

De informatie in dit document is gebaseerd op het Cisco Catalyst Center-platform en de Cisco Prime-infrastructuur.

De informatie in dit document is gebaseerd op de apparaten in een specifieke laboratoriumomgeving. Alle apparaten die in dit document worden beschreven, hadden een opgeschoonde (standaard)configuratie. Als uw netwerk live is, moet u zorgen dat u de potentiële impact van elke opdracht begrijpt.

Achtergrondinformatie

De Cisco Prime Infrastructure Data Assessment & Readiness Tool (Cisco PDART) analyseert een Cisco Prime Infrastructure-implementatie en beoordeelt of het Cisco Catalyst Center de huidige implementatie ondersteunt.

In het PDART wordt de Cisco Prime Infrastructure vanuit deze perspectieven beoordeeld:

1. Use Cases - Deze tool kan meer dan 170 use cases automatisch controleren. Het controleert of deze Use Cases in gebruik zijn of in het verleden zijn gebruikt. Vervolgens wordt elke Use Case (alleen in gebruik/gebruikt) beoordeeld tegen het Cisco Catalyst Center. Het evalueert of deze Use Cases momenteel worden ondersteund, niet worden ondersteund of op de routekaart voor Cisco Catalyst Center worden geplaatst. Er zijn nog eens 23 gebruikscases die handmatige verificatie vereisen en deze worden in het rapport vermeld.
2. Schaalparameters - Met deze tool kunnen automatisch negen schaalparameters worden gecontroleerd en wordt de schaal vergeleken met de maximale waarden die worden ondersteund voor de huidige implementatie. Vervolgens worden deze schaalparameters vergeleken met de aanbevolen schaal voor verschillende fysieke formulierfactoren van Cisco Catalyst Center.
3. Rapporten - Dit hulpmiddel kan de gebruikte en geplande rapporten bepalen. Het vergelijkt deze rapporten met die beschikbaar bij het Cisco Catalyst Center en evalueert of deze rapporten momenteel worden ondersteund, niet worden ondersteund of op de routekaart zijn geïnstalleerd.
4. Apparaatcompatibiliteit - Met deze tool kunnen alle beheerde apparaten worden gedetecteerd en kan elk apparaat worden toegewezen aan de lijst met ondersteunde apparaten van Cisco Catalyst Center. Het beoordeelt elk apparaat op basis van de compatibiliteit van de hardware, de compatibiliteit van de software en de ondersteuning van de bestaande hardware.
5. Migratie Readiness Checks - Deze sectie omvat tien controles die fundamentele gezondheidscontroles van de Cisco Prime Infrastructure-applicatie omvatten, en een analyse van bekende migratieblokkers. (Aanvullende validaties kunnen snel komen.)
6. Templates (toegevoegd in PDART versie 3.01) - Deze tool kan de draadloze sjablonen bepalen die zijn gedrukt door de Cisco Prime-infrastructuur. Hiermee wordt geëvalueerd of deze sjablonen kunnen worden toegepast door het Cisco Catalyst Center en de kenmerken die worden ondersteund door Cisco Catalyst Center.

De PDART is een eenvoudig te gebruiken gereedschap dat alleen-lezen is en geen impact heeft. Het vangt geen vertrouwelijke informatie of verzendt geen informatie buiten de plaatsing. PDART beoordeelt de implementatie voor de 2.3.x release van Cisco Catalyst Center.

De uitvoer van het gereedschap is een TAR GZ bestand dat bevat:

1. PDF Bestand - een samenvattende beoordeling van de huidige implementatie van Cisco Prime-infrastructuur en de toewijzing ervan met Cisco Catalyst Center
2. Run log bestand - bevat de logbestanden van de console-run
3. JSON bestand - bevat het rapport in JSON-indeling
4. Debug Log bestand - bevat database (DB) dumps voor extra informatie over de setup (nuttig voor probleemoplossing)
5. AP Log bestand - lijst van alle access points (AP) en hun compatibiliteit

Wanneer PDART via UI wordt uitgevoerd, is de uitvoer twee bestanden; het TAR GZ bestand evenals het PDF bestand.

Ingebouwde samenwerking met het team Cisco Catalyst Center Escalation Engineering, Sales en CX Centers TAC Engines.

Vereisten gereedschap

• PDART wordt uitgevoerd op de Cisco Prime-infrastructuur.
• De CLI-optie werkt alleen met de versie van Cisco Prime Infrastructure 3.5 en hoger.
• De UBF-optie werkt alleen met de Cisco Prime Infrastructure 3.7-versie en hoger.
• Als u meerdere Cisco Prime-implementaties hebt, moet PDART bij elke implementatie worden uitgevoerd.
• PDART moet worden uitgevoerd als user root (een vereiste voor PDART-uitvoering alleen van CLI).
  
• Als de implementatie van Cisco Prime Infrastructure een paar met hoge beschikbaarheid (HA) is (HA-functie geconfigureerd), gebruikt u de hier gedetailleerde procedures voor de installatie van de PDART UBF (een vereiste voor de uitvoering van PDART van alleen UBF).

Gereedschapsuitvoering

U kunt het gereedschap op twee manieren uitvoeren:

Optie 1: Start de PDART Executable vanuit de CLI

Stap 1. Kopieer het uitvoerbare bestand pdart van Github naar een willekeurige map op de Cisco Prime-infrastructuur. De nieuwste versie van de PDART executable is beschikbaar op deze locatie: CiscoDevNet/PDART.

Er zijn twee manieren om het bestand te kopiëren:

1. Een bestandsoverdrachtgereedschap zoals Filezilla of WinSCP.
2. Als de Cisco Prime-infrastructuur internetconnectiviteit heeft, gebruikt u deze opdracht om het bestand te downloaden:

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

Voorbeeld:

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

Stap 2. Verander de bestands rechten in executable.

[root@pi ~]# chmod 755 pdart

Voer Linux file de opdracht uit om er zeker van te zijn dat u het uitvoerbare bestand en een ls -l hebt om te controleren of de chmod opdracht de hoofdgebruiker heeft toegestaan om het bestand uit te voeren pdart.

file pdart
ls -l pdart

Voorbeeld:

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

Stap 3. (Optioneel) Bevestig de hash van het bestand om er zeker van te zijn dat het juiste bestand is gedownload.

Om er zeker van te zijn dat het juiste bestand is gedownload, vergelijkt u de MD5-hash of de SHA256-hashwaarden die aan het einde van deze pagina beschikbaar zijn. Elke versie van PDART kan een unieke set hashwaarden hebben.

Stap 3.1. MD5 Hash verificatie.

Gebruik de opdracht md5sum (zoals weergegeven). Genereer de hash op uw Cisco Prime Info of een ander Linux systeem en vergelijk de hash waarde met de waarde aan het eind van deze pagina. 

    $ md5sum pdart
    52f429dd275e357fe3282600d38ba133 pdart

Stap 3.2. SHA256 Hashverificatie.

Gebruik de opdracht sha256sum (zoals weergegeven). Genereer de hash op uw Cisco Prime Info of een ander Linux systeem en vergelijk de hash waarde met de waarde aan het eind van deze pagina.

    $ sha256sum pdart
    c91b6092ab4fa57adbe698a3c17f9146523bba5b0315222475aa4935662a0b6e pdart

Stap 4. Eén opdracht om het bestand vanuit CLI uit te voeren (zorg ervoor dat u als gebruikersroot bent ingelogd).

 ./pdart

Voorbeelduitvoer van 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 ~]#

Stap 5. Er wordt één TAR GZ bestand gemaakt door het gereedschap en het is beschikbaar op de locatie /localdisk/defaultRepo/pdart.d/. Het bestand kan uit Prime gekopieerd worden met behulp van Filezilla of WinSCP. Het TAR GZ bestand kan voor of na de kopie worden uitgeschakeld.

Met deze opdracht kunt u het bestand op uw Cisco Prime-infrastructuur verwijderen (een optionele stap).

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

Optie 2: De PDART uitvoeren via UBF Patch

PDART kan via de UI worden uitgevoerd met behulp van deze methode. Het uitvoerbare PDART-bestand maakt deel uit van een patchbestand Updated Bundle File (UBF) dat moet worden gedownload van Cisco.com, geüpload naar uw Prime Instance en vervolgens moet worden geïnstalleerd. De geloofsbrieven van de wortel zijn geen vereiste voor deze optie. Dit zijn de gedetailleerde stappen:

Stap 1. Identificeer uw softwareversie en download de UBF die overeenkomt met Cisco.com.

Download het bestand dat begint met DNACAssessmentReadiness_(CCO-aanmelding is vereist om het bestand te kunnen downloaden).

3.10.1 - Software Download Prime Infrastructure release 3.10.1

3.9.1 - Software Download Prime Infrastructure release 3.9.1

3.8.1 - Software Download Prime Infrastructure release 3.8.1

3.7.1 - Software Download Prime Infrastructure release 3.7.1

Hier is een afbeelding van 3.8.1:

Primeubf381

Stap 2. Upload het UBF bestand vanaf uw lokale systeem en installeer het (opnieuw laden van Cisco Prime is vereist).

Zodra het bestand is gedownload naar het lokale systeem, kan het UBF bestand worden geüpload en geïnstalleerd via de UI. Ga vanuit het hoofdmenu naar de pagina Software Update.

KlikAdministration > Licenses and Software Updates > Software Update and then click Upload om het UBF bestand te uploaden naar Cisco Prime.

UBF Blader door de lokale computer om het gewenste bestand te kiezen en klik op Ok.

Klik na het uploaden van het bestand op de Install knop om de UBF te installeren.

Klik Yes in het pop-upvenster om Cisco Prime Infrastructure opnieuw te starten en de UBF te installeren.

Cisco Prime-infrastructuur start opnieuw op en is 15 tot 30 minuten buiten bedrijf.

Stap 3. Navigeer naar het PDART-scherm (Stap 3.1 of 3.2).

Stap 3.1. Wanneer de UBF is geïnstalleerd, navigeer dan naar deze URL die de PDART-hoofdpagina weergeeft. Klik RUN PDART TOOL om PDART uit te voeren.

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

Stap 3.2. Zodra de UBF is geïnstalleerd, en als de Prime Data Migration Tool versie 5 ook is geïnstalleerd, kan PDART vanaf het hamburgermenu worden gestart volgens deze schermopnamen.

Stap 4. Voer PDART uit vanuit de UI.

Dit scherm neemt u mee door de uitvoering van PDART:

PDART duurt ongeveer 3-5 minuten om in de meeste gevallen te voltooien, maar in een geschaalde installatie kan het tot 10 minuten duren om te voltooien.

Deze opties verschijnen zodra PDART de uitvoering heeft voltooid.

Klik om het PDF-rapport te bekijken of klik op de knop Download PDART Report om terug te gaan naar de Back to Main Pagehoofdpagina om het PDF-bestand opnieuw te starten.

Voorbeeldrapport

De afbeelding bevat de eerste pagina van het rapport, die een samenvatting is van alle uitgevoerde controles. De volgende pagina's bevatten meer informatie over de uitgevoerde controles.

PDART-versies

PDART versie	Opmerkingen
Tot 0,09	Alle beoordelingen zijn gebaseerd op Cisco Catalyst Center versie 2.2.2.x. UBF en Github.
1.01	Alle beoordelingen (gebruikscase, apparaat, schaal, rapporten) zijn nu gebaseerd op Cisco Catalyst Center versie 2.2.3.x. Nieuw JSON-bestand voor alle AP’s en hun compatibiliteit. De platformsectie veranderde in Migration Readiness en omvat cpu kernen, Totaal geheugen, cpu-lastgemiddelde, Geplande AP lijst en plaats, gebouwen zonder enige lengte/breedtegraad instellingen, schijfgebruik, en fase 2 de controles van de migratietool. Alleen Github.
1.02	Compatibiliteit met PI 3.10. Alleen Github.
1.03	Onbeheerde apparaten tellen controle, meerdere bug fixes, en crashes in apparaat compatibiliteit. Aanbevelingen voor ISE-servermigratie. Alleen Github.
1.05	Inclusief bugfixes. Zowel UBF als Github ondersteunen dit.
2.01	Alle beoordelingen zijn gebaseerd op Cisco Catalyst Center versie 2.3.3.x. Verouderde ondersteuning en extra controles van migratieblokkeerders. Alleen beschikbaar op Github.
2.02	Deze versie is beschikbaar in beide vormen, als een UBF (update 3) op CCO en beschikbaar als uitvoerbaar op Github. Schaalnummers zijn in overeenstemming met de nieuwe nummers die voor de 2.3.3.x-release zijn gepubliceerd. UBF-bestanden zijn: Cisco NAC-evaluatiegereedheid_3_7_Update_03-1.0.3.ubf Cisco NAC-evaluatiegereedheid_3_8_Update_03-1.0.3.ubf Cisco NAC-evaluatiegereedheid_3_9_Update_03-1.0.3.ubf Cisco NAC-evaluatiegereedheid_3_10_Update_03-1.0.3.ub
2.03	Kleine bug fixes en alleen beschikbaar op Github.
2.04	Kleine bug fixes en alleen beschikbaar op Github.
3.01	Alle beoordelingen zijn gebaseerd op Cisco Catalyst Center versie 2.3.5.x. Geïntroduceerde draadloze sjablonen functie. Alleen beschikbaar op Github. MD5-checksum: fd31d1895b32bdd5bbe557b5b816e57c SHA256-checksum: 16343616adb63b676804e2b49cf1e93e142caede1003c889de462b2d6983ffc
3.02	Alle beoordelingen zijn gebaseerd op Cisco Catalyst Center versie 2.3.5.x. De apparaatcompatibiliteitsmatrix in PDART wordt bijgewerkt. Aanvullende migratiecontroles en -wijzigingen: Plaatsen die niet kunnen worden gemigreerd vanwege niet-ondersteunde speciale tekens of die beginnen of eindigen met een lege ruimte. Dubbele geplande migratiecontrole om locaties op te nemen. Apparaten die niet kunnen worden gemigreerd omdat ze deel uitmaken van de verkeerde groep of het verkeerde groepstype. Beschikbaar op Github en als UBF. MD5-checksum: 6f74cb32143f73333ad8960bcecd871 SHA256-checksum: 78c82e2ebc2e00ac3fd9a98171bfa98c769a51d12b3fa98b73baaf97fd552236
3.03	De naam is gewijzigd in Cisco Catalyst Center. Alleen Github.

Problemen met het gereedschap

Neem contact op met pdart-tool-support@cisco.com voor assistentie met de tool.

Als het PDART-bestand is gedownload naar Cisco Prime Infrastructure maar niet wordt uitgevoerd, moet u de uitvoer van deze Linux opdrachten delen:

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

Als PDART niet via de UI kan worden uitgevoerd, dan deelt u het scherm en eventuele mislukte logs.