はじめに

このドキュメントでは、Cisco Prime Infrastructure用のCisco Catalyst Center ReadinessツールであるCisco PDARTについて説明します。

前提条件

要件

このドキュメントに関する固有の要件はありません。

使用するコンポーネント

このドキュメントの情報は、Cisco Catalyst CenterプラットフォームおよびCisco Prime Infrastructureに基づくものです。

このドキュメントの情報は、特定のラボ環境にあるデバイスに基づいて作成されました。このドキュメントで使用するすべてのデバイスは、クリアな（デフォルト）設定で作業を開始しています。本稼働中のネットワークでは、各コマンドによって起こる可能性がある影響を十分確認してください。

背景説明

Cisco Prime Infrastructure Data Assessment & Readiness Tool(Cisco PDART)は、Cisco Prime Infrastructureの導入状況を分析し、Cisco Catalyst Centerが現在の導入状況をサポートしているかどうかを評価します。

PDARTは、次の観点からCisco Prime Infrastructureを評価します。

1. ユースケース – このツールは、170を超えるユースケースを自動的にチェックできます。これらのユースケースが使用中であるか、過去に使用されたかどうかを確認します。次に、各ユースケース（使用中/使用専用）をCisco Catalyst Centerに対して評価します。これらのユースケースが現在サポートされているか、サポートされていないか、またはCisco Catalyst Centerのロードマップ上にあるかを評価します。さらに、手動による検証を必要とする23のユースケースがあり、これらはレポートにリストされています。
2. スケールパラメータ：このツールは、9つのスケールパラメータを自動的にチェックし、スケールを現在の展開でサポートされている最大値と比較します。次に、これらのスケールパラメータを、Cisco Catalyst Centerのさまざまな物理フォームファクタで推奨されるスケールと比較します。
3. レポート：このツールは、使用されているレポートとスケジュール済みのレポートを判別できます。これらのレポートとCisco Catalyst Centerで利用可能なレポートを比較し、これらのレポートが現在サポートされている、サポートされていない、またはロードマップ上のいずれであるかを評価します。
4. デバイスの互換性：このツールは、すべての管理対象デバイスを検出し、各デバイスをCisco Catalyst Centerのサポート対象デバイスリストにマッピングできます。ハードウェアの互換性、ソフトウェアの互換性、およびレガシーサポートに基づいて各デバイスを評価します。
5. 移行準備チェック：このセクションには、Cisco Prime Infrastructureアプライアンスの基本的なヘルスチェックや既知の移行ブロッカーの分析を含む10のチェックが含まれます。（追加の検証が間もなく行われる可能性があります）。
6. Wireless Templates - Intent Based（PDARTバージョン3.01で追加）：このツールを使用すると、Cisco Prime Infrastructureによってプッシュされたワイヤレステンプレートを判別できます。また、これらのテンプレートをCisco Catalyst Centerで適用できるかどうか、およびCisco Catalyst Centerでサポートされる属性を評価します。
7. Wireless Templates - Per Device Configuration（PDARTバージョン3.05で追加）：このツールを使用すると、Cisco Prime Infrastructureによってプッシュされたワイヤレステンプレートを判別できます。また、Cisco Catalyst Centerで使用可能なPer WLC Configuration(Brownfield Wireless Automation)機能に対してこれらのテンプレートを評価します。この機能は、Catalyst Centerで検出されたすべての(C9800)WLCの設定の暗黙的な学習をサポートします。

PDARTは、読み取り専用で影響を与えない使いやすいツールです。機密情報を取得したり、展開外に情報を送信したりすることはありません。PDARTは、Cisco Catalyst Centerの2.3.xリリースの導入を評価します。

このツールの出力は、次の内容を含む「TAR GZ」ファイルです。

1. PDF file：現在のCisco Prime Infrastructure導入のサマリー評価およびCisco Catalyst Centerとのマッピング。
2. Run log file：コンソール実行ログが含まれます。
3. JSON file：レポートがJSON形式で含まれます。
4. Debug Log file：セットアップに関する追加情報のためのデータベース(DB)ダンプが含まれています（トラブルシューティングに役立ちます）。
5. AP Log file：すべてのアクセスポイント(AP)とその互換性のリスト。

PDARTがUI経由で実行されると、出力はTAR GZファイルとPDFファイルの2つのファイルになります。

Cisco Catalyst Center Escalation Engineering、Sales、およびCX Centers TAC Enginesチームとのコラボレーション機能を内蔵

ツール要件

• PDARTはCisco Prime Infrastructureで実行されます。
• CLIオプションは、Cisco Prime Infrastructure 3.5バージョン以降でのみ機能します。
• UBFオプションは、Cisco Prime Infrastructure 3.7バージョン以降でのみ機能します。
• 複数のCisco Primeを導入している場合は、導入ごとにPDARTを実行する必要があります。
• PDARTは、ユーザrootとして実行する必要があります（CLIからのPDART実行の要件のみ）。
  
• Cisco Prime Infrastructure(PI)導入がハイアベイラビリティ(HA)ペア（HA機能が設定されている）の場合、PDART UBFをインストールするためのここで説明する手順を使用します（UBFのみからPDARTを実行する要件）。

ツールの実行

このツールを実行するには、次の2つの方法があります。

オプション1:CLIからPDART実行可能ファイルを実行する

ステップ 1：実行可能ファイルpdartをGithubからCisco Prime Infrastructure上の任意のディレクトリにコピーします。最新バージョンのPDART実行可能ファイルは、CiscoDevNet/PDARTから入手できます。

ファイルをコピーするには、次の2つの方法があります。

1. FilezillaやWinSCPなどのファイル転送ツール。
2. Cisco Prime Infrastructureにインターネット接続がある場合は、次のコマンドを使用してファイルをダウンロードします。

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:（オプション）正しいファイルがダウンロードされていることを確認するために、ファイルpdartのハッシュを検証します。

正しいファイルがダウンロードされたことを確認するには、このページの最後にある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：ツールによって1つのTAR GZファイルが作成され、/localdisk/defaultRepo/pdart.d/の場所で使用できます。ファイルは、FilezillaまたはWinSCPを使用してPrimeからコピーできます。TAR GZファイルは、コピーの前または後に解凍できます。

このコマンドを使用すると、Cisco Prime Infrastructureでファイルを解凍できます（オプションの手順）。

[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を実行する

この方法を使用すると、UIを介してPDARTを実行できます。PDART実行可能ファイルは、パッチファイル(Updated Bundle File UBF)の一部であり、Cisco.comからダウンロードしてPrimeインスタンスにアップロードし、インストールする必要があります。ルートクレデンシャルは、このオプションの要件ではありません。次に詳細な手順を示します。

ステップ 1：ソフトウェアバージョンを確認し、Cisco.comから一致するUBFをダウンロードします。

CATCAssessmentReadiness_で始まるファイルをダウンロードします。 （ファイルをダウンロードするには、CCOログインが必要です）。 「

3.10.x:ソフトウェアダウンロードPrime Infrastructureリリース3.10.1

3.9.x:ソフトウェアダウンロードPrime Infrastructureリリース3.9.1

3.8.x:ソフトウェアダウンロードPrime Infrastructureリリース3.8.1

3.7.x:ソフトウェアダウンロードPrime Infrastructureリリース3.7.1

3.7.1のイメージを次に示します。

ステップ 2：ローカルシステムから「UBF」ファイルをアップロードしてインストールします（Cisco Primeのリロードが必要）。

ファイルがローカルシステムにダウンロードされたら、UIを使用してUBFファイルをアップロードおよびインストールできます。メインメニューから、Software Updateページに移動します。

Administration > Licenses and Software Updates > Software Update and then click Uploadをクリックして、UBFファイルをCisco Primeにアップロードします。

ローカルコンピュータを参照して必要なUBFファイルを選択し、 Ok.

ファイルがアップロードされたら、「Install」ボタンをクリックしてUBFをインストールします。

ポップアップウィンドウでYesをクリックし、Cisco Prime Infrastructureを再起動してUBFをインストールします。

Cisco Prime Infrastructureが再起動し、15 ～ 30分間サービスが停止します。

ステップ 3：PDART画面に移動します（ステップ3.1または3.2）。

ステップ 3.1：UBFがインストールされたら、このURLに移動して、PDARTのメインページを表示します。PDARTを実行するには、RUN PDART TOOLをクリックします。

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

ステップ 3.2：UBFがインストールされ、Prime Data Migration Toolバージョン5もインストールされている場合は、次の画面キャプチャに従ってハンバーガーメニューからPDARTを起動できます。

ステップ 4：UIからPDARTを実行します。

次のスクリーンキャプチャは、PDARTの実行をガイドします。

Execute PDARTをクリックすると、ボタンがグレー表示になり、コンソール出力のステータスがEXECUTION IN-PROGRESSに変わります。PDARTは通常、完了までに最大5分かかります。スケールセットアップの場合、管理対象デバイスの数とシステムの負荷に基づいて、完了までに最大15分かかります。

完了すると、コンソール出力のステータスが「Execution Successful」に変わります。Download Reportをクリックして、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ファイルとその互換性。プラットフォームのセクションはMigration Readinessに変更され、CPUコア、合計メモリ、CPU負荷平均、計画されたAPのリストと場所、緯度/経度の設定がない建物、ディスク使用率、フェーズ2移行ツールのインストールチェックが含まれます。Githubのみ。
1.02	PI 3.10との互換性Githubのみ。
1.03	アンマネージドデバイスの数の確認、複数のバグ修正、デバイスの互換性でのクラッシュ。ISEサーバ移行の推奨事項Githubのみ。
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 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	軽微なバグ修正と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に変更。 Githubのみ。
3.05	すべてのアセスメントは、Cisco Catalyst Centerバージョン2.3.7.xに基づいています。 PDART内のデバイス互換性マトリックスが更新されます。 DN3はDN2に代わる推奨アプライアンスです。 デバイスごとのワイヤレステンプレートチェックが追加されました（Catalyst 9800のみ）。 マイナーなバグ修正とGithubとSoftware.Cisco.comで利用可能。

ツールに関する問題

このツールのサポートについては、pdart-tool-support@cisco.comに問い合わせ、レポートの出力に関する問題のレポートとともにtarballを共有してください。

PDARTファイルがGithub.comからCisco Prime Infrastructureに正常にダウンロードされたが、実行されない場合は、次の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経由で実行できない場合は、画面キャプチャと失敗したログを共有します。