PDF(1.5 MB) View with Adobe Reader on a variety of devices
ePub(1.6 MB) View in various apps on iPhone, iPad, Android, Sony Reader, or Windows Phone
Mobi (Kindle)(923.3 KB) View on Kindle device or Kindle app on multiple devices
Updated:July 21, 2023
The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
This document describes Cisco PDART - a Cisco DNA Center readiness tool for the Cisco Prime Infrastructure.
There are no specific requirements for this document.
The information in this document is based on the Cisco DNA Center platform and Cisco Prime Infrastructure.
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. If your network is live, ensure that you understand the potential impact of any command.
The Cisco PDART (Cisco Prime Infrastructure Cisco DNA Center Assessment & Readiness Tool) analyzes a Cisco Prime Infrastructure deployment and assesses whether Cisco DNA Center supports the current deployment.
The PDART assesses Cisco Prime Infrastructure from these perspectives:
Use Cases - This tool can check over 170 use cases automatically. It checks whether these Use Cases are in use or have been used in the past. It then assesses each Use Case (in use/used only) against the Cisco DNA Center. It evaluates whether these Use Cases are currently supported, not supported, or on the roadmap for the Cisco DNA Center. There are an additional 23 Use Cases that require manual verification and these are listed in the report.
Scale Parameters - This tool can check nine Scale parameters automatically and compares the scale with the maximum values supported for the current deployment. It then compares these Scale parameters with the recommended scale across various Cisco DNA Center physical form factors.
Reports - This tool can determine the used and scheduled Reports. It compares these Reports with those available with the Cisco DNA Center and evaluates whether these Reports are currently supported, not supported, or on the roadmap.
Device Compatibility - This tool can detect all the managed devices and map each device to the supported device list of the Cisco DNA Center. It assesses each device based on its hardware compatibility, software compatibility, and legacy support.
Migration Readiness Checks - This section includes ten checks that include basic health checks of the Cisco Prime Infrastructure Appliance, and an analysis of known migration blockers. (Additional validations can come soon.)
Templates (added in PDART version 3.01) - This tool can determine the Wireless Templates that have been pushed by the Cisco Prime Infrastructure. It evaluates whether these Templates can be applied by the Cisco DNA Center and the attributes supported by the Cisco DNA Center.
The PDART is an easy-to-use tool that is read-only and does not cause any impact. It does not capture any confidential information or send any information outside of the deployment. PDART assesses the deployment for 2.3.x release of the Cisco DNA Center
The output of the tool is aTAR GZfile that contains:
PDFfile - a summary assessment of the current Cisco Prime Infrastructure deployment and the mapping with the Cisco DNA Center
Run logfile - contains the console run logs
JSONfile - contains the report in a JSON format
Debug Logfile - contains database (DB) dumps for additional information on the setup (useful for troubleshooting)
AP Logfile - list of all the Access Point (AP) and their compatibility
When PDART is executed via UI, the output is two files; theTAR GZfile as well as thePDFfile.
Built-in collaboration with Cisco DNA Center Escalation Engineering, Sales, and CX Centers TAC Engines team.
PDART is executed on the Cisco Prime Infrastructure.
The CLI option works with Cisco Prime Infrastructure 3.5 version and later only.
The UBF option works with Cisco Prime Infrastructure 3.7 version and later only.
If you have multiple Cisco Prime Deployments, then PDART needs to be executed on each deployment.
PDART must be executed as user root (a requirement for PDART execution from CLI only).
If the Cisco Prime Infrastructure deployment is a High Availability (HA) pair (HA feature configured), then use the procedures detailed here for installing the PDART UBF (a requirement for PDART execution from UBF only).
There are two ways to run the tool:
Option 1: Run the PDART Executable from CLI
Step 1. Copy the executable file pdartfrom Github to any directory on the Cisco Prime Infrastructure. The latest version of the PDART executable is available at this location: CiscoDevNet / PDART.
There are two ways to copy the file:
A file transfer tool like Filezilla or WinSCP.
If the Cisco Prime Infrastructure has Internet connectivity, then use this command to download the file:
100%[=============================================================================================================================================================================================================>] 14,545,120 11.2MB/s in 1.2s
Step 3. (Optional) Validate the hash of the file pdart to ensure the right file has been downloaded.
To ensure the right file has been downloaded, compare either the MD5 hash or the SHA256 hash values which are available at the end of this page. Each version of PDART can have a unique set of hash values.
Step 3a. MD5 Hash verification.
Use the command md5sum (as listed). Generate the hash on your Cisco Prime Infra or any other Linux system and compare the hash value with the value at the end of this page.
Step 5. A singleTAR GZfile is created by the tool and is available at the location/localdisk/defaultRepo/pdart.d/. The file can be copied out of Prime with the use of Filezilla or WinSCP. TheTAR GZfile can be untared before or after the copy.
This command would untar the file on your Cisco Prime Infrastructure (an optional step).
PDART can be executed via the UI with the use of this method. The PDART executable is part of a patch fileUpdated Bundle File(UBF) that needs to be downloaded from Cisco.com, uploaded to your Prime Instance, and then installed. Root credentials are not a requirement for this option. These are the detailed steps:
Step 1. Identify your software version and download the UBF that matches from Cisco.com.
Download the file that starts withDNACAssessmentReadiness_(CCO log in is required to download the file).
Step 2. Upload theUBFfile from your local system and install it (Cisco Prime reload required).
Once the file is downloaded to the local system, theUBFfile can be uploaded and installed via the UI. From the main menu, navigate to the Software Update page.
ClickAdministration > Licenses and Software Updates > Software Update.
ClickUploadto upload theUBFfile to Cisco Prime.
Browse through the local computer to choose the requiredUBFfile and clickOk.
Once the file is uploaded, click on theInstallbutton to install the UBF.
ClickYesin the pop-up window to restart Cisco Prime Infrastructure and install the UBF.
Cisco Prime Infrastructure restarts and is out of service for 15 to 30 minutes.
Step 3. Navigate to the PDART screen (either step 3a or 3b).
Step 3a. Once the UBF is installed, navigate to this URL which brings up the PDART main page. ClickRUN PDART TOOLto execute PDART.
https://<Cisco Prime IP Address>/webacs/pdart.jsp
Step 3b. Once the UBF is installed, and if the Prime Data Migration Tool version 5 is also installed, PDART can be launched from the hamburger menu as per these screencaptures.
Step 4. Execute PDART from the UI.
These screen captures guide you through the execution of PDART:
PDART takes about 3-5 minutes to complete in most cases, but in a scaled setup, it can take up to 10 minutes to complete.
These options show up once PDART has completed execution.
ClickDownload PDART Reportto view the PDART PDF report or click theBack to Main Page, to go back to the main page to rerun PDART.
The image includes the first page of the report which is a summary of all the checks executed. Subsequent pages include more details on the checks executed.
Up to 0.09
All assessments are based on Cisco DNA Center version 2.2.2.x. UBF & Github.
All assessments (use case, device, scale, reports) are now based on Cisco DNA Center version 2.2.3.x. New JSON file for all APs and their compatibility. Platform section changed to Migration Readiness and includes CPU cores, Total memory, CPU load average, Planned AP list and location, buildings without any latitude/longitude settings, disk utilization & phase 2 migration tool installation checks. Github only.
Compatibility with PI 3.10. Github only.
Unmanaged devices count check, multiple bug fixes & crashes in device compatibility. ISE Server migration recommendations. Github only.
Includes bug fixes. Both UBF and Github support.
All assessments are based on Cisco DNA Center version 2.3.3.x. Legacy support and additional migration blocker checks. Available on Github only.
This version is available in both forms, as a UBF (update 3) on CCO and available as an executable on Github. Scale numbers are inline with the new numbers published for 2.3.3.x release.