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. Draadloze sjablonen - Intent Based (toegevoegd in PDART versie 3.01) - Deze tool kan de draadloze sjablonen bepalen die door de Cisco Prime-infrastructuur zijn geduwd. 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.
7. Draadloze sjablonen - Configuratie per apparaat (toegevoegd in PDART versie 3.05) - Dit gereedschap kan de draadloze sjablonen bepalen die door de Cisco Prime-infrastructuur zijn geduwd. Het evalueert of deze sjablonen met de Per WLC Configuration (Brownfield Wireless Automation) functie beschikbaar zijn in Cisco Catalyst Center. Deze eigenschap steunt impliciet leren van configuraties voor allen die (C9800) WLCs op Catalyst Center worden ontdekt.

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 CiscoDevNet 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 pdart 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 CATAsementReadiness_ (Voor het downloaden van het bestand is CCO-aanmelding vereist.) Het

3.10.x - Software Download Prime Infrastructure release 3.10.1

3.9.x - Software Download Prime Infrastructure release 3.9.1

3.8.x - Software Download Prime Infrastructure release 3.8.1

3.7.x - Software Download Prime Infrastructure release 3.7.1

Hier is een afbeelding van 3.7.1:

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 vanuit de UI uit.

Dit scherm neemt u mee door de uitvoering van PDART:

Zodra het tabblad Uitvoeren is aangeklikt, wordt de knop grijs weergegeven en verandert de uitvoerstatus van de console in UITVOERING. PDART duurt meestal 5 minuten. Voor een geschaalde installatie kan het tot 15 minuten duren, afhankelijk van het aantal beheerde apparaten en de lading op het systeem.

Na voltooiing verandert de uitgangsstatus van de console in Uitvoering Succesvol. Klik op Rapport downloaden om het PDF-PDF-rapport te bekijken.

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.
3.05	Alle beoordelingen zijn gebaseerd op Cisco Catalyst Center versie 2.3.7.x. De apparaatcompatibiliteitsmatrix in PDART wordt bijgewerkt. DN3 vervangt DN2 als aanbevolen apparaat. Draadloze sjablonen per apparaat controleren toegevoegd (alleen Catalyst 9800). Kleine bugfixes en beschikbaar op Github en Software.Cisco.com.

Problemen met het gereedschap

Neem contact op met pdart-tool-support@cisco.com voor hulp met het gereedschap en deel de tarball samen met het rapport voor eventuele zorgen met de output van het rapport.

Als het PDART-bestand met succes is gedownload van Github.com 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.