はじめに

このドキュメントでは、Cisco Prime Infrastructure用のCisco Catalyst Centerレディネスツールである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. ワイヤレステンプレート – インテントベース（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 ファイル：現在の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 を実行して、実行可能ファイルが存在すること、およびchmodコマンドによってrootユーザがファイルを実行できるかどうかを確認するls -lを指定します 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の実行

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

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

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ファイルとその互換性。プラットフォームのセクションは移行準備に変更され、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経由で実行できない場合は、画面キャプチャと失敗したログを共有します。