簡介

本文檔介紹Cisco PDART -適用於Cisco Prime基礎設施的Cisco Catalyst中心就緒工具。

必要條件

需求

本文件沒有特定需求。

採用元件

本文檔中的資訊基於Cisco Catalyst中心平台和Cisco Prime基礎設施。

本文中的資訊是根據特定實驗室環境內的裝置所建立。文中使用到的所有裝置皆從已清除（預設）的組態來啟動。如果您的網路運作中，請確保您瞭解任何指令可能造成的影響。

背景資訊

Cisco Prime基礎設施資料評估和準備工具(Cisco PDART)分析Cisco Prime基礎設施部署，並評估Cisco Catalyst Center是否支援當前部署。

PDART從以下角度評估Cisco Prime基礎設施：

1. 使用案例-此工具可自動檢查超過170個使用案例。它會檢查這些「使用案例」是使用中還是過去曾使用過。然後，它會根據Cisco Catalyst Center評估每個使用案例（僅限使用/使用）。它評估這些使用案例當前是否受支援、不受支援，或者是否在Cisco Catalyst Center的規劃圖上。另有23種使用案例需要手動驗證，這些均列於報告中。
2. 縮放引數-此工具可自動檢查九個「縮放」引數，並將縮放與目前部署支援的最大值進行比較。然後，它將這些擴展引數與各種Cisco Catalyst Center物理外形規格的建議擴展進行比較。
3. 報告-此工具可確定已使用和計畫的報告。它將這些報告與Cisco Catalyst Center中提供的報告進行比較，並評估這些報告當前是否受支援、不受支援或是否在規劃圖中。
4. 裝置相容性-此工具可以檢測所有受管裝置，並將每台裝置對映到Cisco Catalyst Center的受支援裝置清單。它會根據硬體相容性、軟體相容性和舊版支援來評估每個裝置。
5. 遷移就緒性檢查-此部分包括十項檢查，其中包括對Cisco Prime基礎設施裝置的基本運行狀況檢查，以及對已知遷移阻止程式的分析。（其他驗證即將推出。）
6. 無線模板-基於意圖（在PDART 3.01版中增加）-此工具可以確定Cisco Prime基礎設施推送的無線模板。它評估這些模板是否可以由Cisco Catalyst Center應用，以及Cisco Catalyst Center支援的屬性。
7. 無線模板-按裝置配置（在PDART 3.05版中增加）-此工具可以確定Cisco Prime基礎設施推送的無線模板。它根據Cisco Catalyst Center中提供的每個WLC配置（Brownfield無線自動化）功能評估這些模板。此功能支援隱含學習Catalyst Center上所有已發現(C9800) WLC的組態。

PDART是一種易於使用的工具，是只讀的，不會造成任何影響。它不會捕獲任何機密資訊，也不會在部署之外傳送任何資訊。PDART評估Cisco Catalyst Center 2.3.x版本的部署。

該工具的輸出是一個檔案TAR GZ，其中包含：

1. PDF 檔案-對當前Cisco Prime基礎設施部署和與Cisco Catalyst Center的對映的摘要評估。
2. Run log 檔案-包含控制檯運行日誌。
3. JSON 檔案-包含JSON格式的報告。
4. Debug Log 檔案-包含資料庫(DB)轉儲以瞭解有關設定的附加資訊（對故障排除非常有用）。
5. AP Log 檔案-所有存取點(AP)及其相容性的清單。

當透過UI執行PDART時，輸出兩個檔案：TAR GZ檔案和PDF檔案。

與Cisco Catalyst中心升級工程、銷售和CX中心TAC引擎團隊的內建合作。

工具需求

• PDART在Cisco Prime基礎設施上執行。
• CLI選項僅適用於Cisco Prime Infrastructure 3.5版本及更高版本。
• UBF選項僅適用於Cisco Prime Infrastructure 3.7版本及更高版本。
• 如果您有多個Cisco Prime部署，則必須在每個部署上執行PDART。
• PDART必須以使用者根使用者身份執行（僅要求從CLI執行PDART）。
  
• 如果Cisco Prime基礎設施部署是高可用性(HA)對（已配置HA功能），則使用在此處詳細介紹的步驟安裝PDART UBF（僅從UBF執行PDART的要求）。

工具執行

有兩種方法可執行該工具：

選項1：從CLI運行PDART執行檔

步驟 1.將執行檔pdart從Github複製到Cisco Prime基礎設施上的任意目錄。以下位置提供了最新版本的PDART執行檔：CiscoDevNet/PDART。

複製檔案的方法有兩種：

1. 檔案傳輸工具，例如Filezilla或WinSCP。
2. 如果Cisco Prime基礎設施具有Internet連線，則使用此命令下載檔案：

wget --no-check-certificate CiscoDevNet PDART

範例：

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

步驟 2.將檔案許可權變更為可執行檔。

[root@pi ~]# chmod 755 pdart

執行 Linux file 命令以確保您具有執行檔，並使用ls -l檢查chmod命令是否允許root使用者執行檔案 pdart.

file pdart
ls -l pdart

範例：

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

步驟3. （選擇性）驗證檔案PDF的雜湊，以確保已下載正確的檔案。

為確保已下載正確的檔案，請比較此頁末尾的MD5雜湊值或SHA256雜湊值。每個版本的PDART都可以有一組唯一的雜湊值。

步驟 3.1.MD5雜湊驗證。

使用命令md5sum（如下所示）。在您的Cisco Prime Infra或任何其他的Linux系統上生成雜湊，並將雜湊值與此頁末的值進行比較。 

    $ md5sum pdart
    52f429dd275e357fe3282600d38ba133 pdart

步驟 3.2.SHA256雜湊驗證。

使用命令sha256sum（如下所示）。在您的Cisco Prime Infra或任何其他的Linux系統上生成雜湊，並將雜湊值與此頁末的值進行比較。

    $ sha256sum pdart
    c91b6092ab4fa57adbe698a3c17f9146523bba5b0315222475aa4935662a0b6e pdart

步驟 4.從CLI執行檔案的單一命令（請確定您已以root使用者身份登入）。

 ./pdart

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

步驟 5.刀具會建立一個TAR GZ檔案，該檔案位於/localdisk/defaultRepo/pdart.d/位置。使用Filezilla或WinSCP可將檔案複製出Prime。TAR GZ檔案可以在複製之前或之後解除安裝。

此命令可以解壓縮Cisco Prime基礎設施上的檔案（可選步驟）。

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

選項2：透過UBF修補程式執行PDART

PDART可以使用這個方法透過UI執行。PDART執行檔是修補程式檔案(Updated Bundle File UBF)的一部分，必須從Cisco.com下載，上傳到您的Prime例項，然後安裝。根憑證不是此選項的必要條件。以下是詳細步驟：

步驟 1.確定您的軟體版本並從Cisco.com下載匹配的UBF。

下載以CATCAssesmentReadiness_ （下載檔案需要CCO登入）。其

3.10.x - 軟體下載Prime基礎設施版本3.10.1

3.9.x -軟體下載Prime基礎設施版本3.9.1

3.8.x -軟體下載Prime基礎設施版本3.8.1

3.7.x - 軟體下載Prime基礎設施版本3.7.1

以下是3.7.1的影像：

步驟 2.從本地系統上傳UBF檔案並安裝（需要Cisco Prime重新載入）。

一旦檔案下載到本地系統，就可以透過UI上載和安裝UBF檔案。從主選單導航至軟體更新頁面。

按一下Administration > Licenses and Software Updates > Software Update and then click Upload將該UBF檔案上傳到Cisco Prime。

瀏覽本地電腦以選擇所需的UBF檔案，然後按一下 Ok.

上傳檔案後，點選Install按鈕安裝UBF。

在彈出窗口中點選Yes，以重新啟動Cisco Prime基礎設施並安裝UBF。

Cisco Prime基礎設施重新啟動並且停止服務15到30分鐘。

步驟 3.導航到PDART螢幕（步驟3.1或3.2）。

步驟 3.1.安裝UBF之後，請導航到此URL，這會顯示PDART首頁。按一下RUN PDART TOOL以執行PDART。

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

步驟 3.2.安裝UBF之後，如果也安裝了Prime Data Migration Tool第5版，則可根據這些螢幕截圖，從漢堡選單啟動PDART。

步驟 4.從UI執行PDART。

這些熒幕擷取可引導您執行PDART：

按一下Execute PDART後，按鈕將變灰，並且Console Output狀態將更改為EXECUTION IN-PROGRESS。PDART通常需要5分鐘才能完成。對於擴展設定，根據受管裝置的數量和系統的負載，完成該設定最多可能需要15分鐘。

完成後， Console輸出狀態會變為Execution Successful。點選下載報告以檢視PDART PDF報告。

範例報表

此影像包含報表的第一頁，這是所有已執行檢查的摘要。後續頁面包含有關所執行檢查的更多詳細資訊。

PDART版本

PDART版本	意見
最高至0.09	所有評估均基於Cisco Catalyst Center 2.2.2.x版。UBF和Github。
1.01	所有評估（使用案例、裝置、規模、報告）現在都基於Cisco Catalyst Center 2.2.3.x版。所有AP及其相容性的新JSON檔案。平台部分改為遷移就緒性，包括CPU核心、總記憶體、CPU負載平均值、計畫的AP清單和位置、沒有任何經緯度設定的建築物、磁碟利用率和第2階段遷移工具安裝檢查。只限吉瑟布。
1.02	與PI 3.10的相容性。只限吉瑟布。
1.03	非受管裝置計數檢查、多個漏洞修復和裝置相容性崩潰。ISE伺服器遷移建議。只限吉瑟布。
1.05	包括錯誤修正。UBF和Github都支援。
2.01	所有評估均基於Cisco Catalyst Center 2.3.3.x版。舊版支援與其他移轉封鎖程式檢查。僅適用於Github。
2.02	此版本提供兩種形式，在CCO上作為UBF （更新3），在Github上作為執行檔提供。 刻度數與2.3.3.x版發佈的新數字一致。 UBF檔案為： Cisco DNACAsessmentReadiness_3_7_Update_03-1.0.3.ubf Cisco DNACAsessmentReadiness_3_8_Update_03-1.0.3.ubf Cisco DNACAsessmentReadiness_3_9_Update_03-1.0.3.ubf Cisco DNACAssesmentReadiness_3_10_Update_03-1.0.3.ub
2.03	次要錯誤修正，僅適用於Github。
2.04	次要錯誤修正，僅適用於Github。
3.01	所有評估均基於Cisco Catalyst Center 2.3.5.x版。 引入無線模板功能。 僅適用於Github。 MD5校驗和：fd31d1895b32bdd5bbe557b5b816e57c SHA256總和檢查碼： 16343616aadb63b676804e2b49cf1e93e142caede1003c889de462b2d6983ffc
3.02	所有評估均基於Cisco Catalyst Center 2.3.5.x版。更新PDART內的裝置相容性矩陣。 其他移轉檢查與修改： 由於不支援的特殊字元或開頭或結尾為空白字元而無法移轉的網站。 重複計畫的移轉檢查以包含位置。 無法遷移的裝置，因為它們屬於錯誤的組或錯誤的組型別。 在Github上提供，並作為UBF提供。 MD5校驗和：6f774cb32143f73333ad8960bcecd871 SHA256校驗和：78c82e2ebc2e00ac3fd9a98171bfa98c769a51d12b3fa98b73baaf97fd552236
3.03	將名稱更改為Cisco Catalyst Center。 只限吉瑟布。
3.05	所有評估均基於Cisco Catalyst Center 2.3.7.x版。 更新PDART內的裝置相容性矩陣。 DN3取代了DN2作為推薦裝置。 已增加每裝置無線模板檢查（僅限Catalyst 9800）。 Github和Software.Cisco.com上提供了細微的錯誤修復。

工具問題

如需該工具的任何幫助，請聯絡pdart-tool-support@cisco.com，並隨報告分享藍球和報告，以瞭解對報告輸出的所有問題。

如果將PDART檔案從Github.com成功下載到Cisco Prime基礎設施但未執行，則共用以下Linux命令的輸出：

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

如果PDART無法通過UI運行，則共用螢幕捕獲和任何失敗的日誌。