소개

이 문서에서는 Cisco Prime Infrastructure를 위한 Cisco Catalyst Center 준비 툴인 Cisco PDART에 대해 설명합니다.

사전 요구 사항

요구 사항

이 문서에 대한 특정 요건이 없습니다.

사용되는 구성 요소

이 문서의 정보는 Cisco Catalyst Center 플랫폼과 Cisco Prime Infrastructure를 기반으로 합니다.

이 문서의 정보는 특정 랩 환경의 디바이스를 토대로 작성되었습니다. 이 문서에 사용된 모든 디바이스는 초기화된(기본) 컨피그레이션으로 시작되었습니다. 현재 네트워크가 작동 중인 경우 모든 명령의 잠재적인 영향을 미리 숙지하시기 바랍니다.

배경 정보

Cisco PDART(Cisco Prime Infrastructure Data Assessment & Readiness Tool)는 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. Reports(보고서) - 이 툴은 사용된 보고서와 예약된 보고서를 확인할 수 있습니다. 이 보고서는 Cisco Catalyst Center에서 제공하는 보고서와 비교되며, 이러한 보고서가 현재 지원되는지, 지원되지 않는지 또는 로드맵에 있는지를 평가합니다.
4. 디바이스 호환성 - 이 툴은 관리되는 모든 디바이스를 탐지하고 각 디바이스를 Cisco Catalyst Center의 지원되는 디바이스 목록에 매핑할 수 있습니다. 하드웨어 호환성, 소프트웨어 호환성, 레거시 지원을 기반으로 각 디바이스를 평가합니다.
5. 마이그레이션 준비도 검사 - 이 섹션에는 Cisco Prime Infrastructure Appliance의 기본 상태 검사와 알려진 마이그레이션 차단 분석을 포함하는 10가지 검사가 포함됩니다. (추가 검증이 곧 제공될 수 있습니다.)
6. 무선 템플릿 - 의도 기반(PDART 버전 3.01에 추가됨) - 이 툴은 Cisco Prime Infrastructure에서 푸시한 무선 템플릿을 확인할 수 있습니다. Cisco Catalyst Center에서 이러한 템플릿을 적용할 수 있는지, 그리고 Cisco Catalyst Center에서 지원하는 특성을 평가합니다.
7. 무선 템플릿 - 디바이스 컨피그레이션별(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 파일 - 설정에 대한 추가 정보를 보려면 데이터베이스(DB) 덤프를 포함합니다(문제 해결에 유용함).
5. AP Log file - 모든 액세스 포인트(AP) 및 해당 호환성의 목록입니다.

UI를 통해 PDART를 실행할 경우, 출력은 2개의 파일, 즉 TAR GZ 파일과 파일이 PDF 됩니다.

Cisco Catalyst Center Escalation Engineering, Sales 및 CX Centers TAC Engines 팀과의 내장형 협업

툴 요구 사항

• PDART는 Cisco Prime Infrastructure에서 실행됩니다.
• CLI 옵션은 Cisco Prime Infrastructure 3.5 버전 이상에서만 작동합니다.
• UVF 옵션은 Cisco Prime Infrastructure 3.7 버전 이상에서만 작동합니다.
• Cisco Prime Deployments가 여러 개인 경우 각 구축에서 PDART를 실행해야 합니다.
• PDART는 사용자 루트로 실행되어야 합니다(CLI에서 PDART를 실행하는 경우에만 필요).
  
• Cisco Prime Infrastructure 구축이 HA(High Availability) 쌍(HA 기능이 구성됨)인 경우 PDART UBF를 설치하기 위해 여기에 설명된 절차를 사용합니다(UBF에서 PDART를 실행하기 위한 요건).

도구 실행

도구를 실행하는 방법에는 두 가지가 있습니다.

옵션 1: CLI에서 PDART 실행 파일 실행

1단계. Github의 실행 파일pdart을 Cisco Prime Infrastructure의 디렉토리로 복사합니다. PDART 실행 파일의 최신 버전은 CiscoDevNet/PDART에서 사용할 수 있습니다.

파일을 복사하는 방법에는 두 가지가 있습니다.

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 명령이 루트 사용자에게 파일 실행을 허용했는지 확인합니다. 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단계. (선택 사항) 올바른 파일이 다운로드되었는지 확인하기 위해 파일 패킷의 해시를 검증합니다.

올바른 파일이 다운로드되었는지 확인하려면 이 페이지의 끝에 있는 MD5 해시 또는 SHA256 해시 값을 비교합니다. 각 버전의 PDART는 고유한 해시 값 집합을 가질 수 있습니다.

3.1단계. MD5 해시 확인.

나열된 md5sum 명령을 사용합니다. Cisco Prime Infrastructure 또는 기타 Linux 시스템에서 해시를 생성하고 해시 값을 이 페이지 끝에 있는 값과 비교합니다. 

    $ md5sum pdart
    52f429dd275e357fe3282600d38ba133 pdart

3.2단계. SHA256 해시 확인.

나열된 sha256sum 명령을 사용합니다. Cisco Prime Infrastructure 또는 기타 Linux 시스템에서 해시를 생성하고 해시 값을 이 페이지 끝에 있는 값과 비교합니다.

    $ sha256sum pdart
    c91b6092ab4fa57adbe698a3c17f9146523bba5b0315222475aa4935662a0b6e pdart

4단계. CLI에서 파일을 실행하는 단일 명령(사용자 루트로 로그인했는지 확인).

 ./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 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 실행 파일은 Cisco.com에서 다운로드하고 Prime Instance에 업로드한 다음 설치해야 하는 UVF(패치 파일)의 Updated Bundle File 일부입니다. 루트 자격 증명은 이 옵션의 요구 사항이 아닙니다. 자세한 단계는 다음과 같습니다.

1단계. 소프트웨어 버전을 확인하고 Cisco.com에서 일치하는 UVF를 다운로드합니다.

CATCAssmentReadiness_로 시작하는 파일을 다운로드합니다. (파일을 다운로드하려면 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 다시 로드 필요).

파일이 로컬 시스템에 다운로드되면 파일을 UBF 업로드하고 UI를 통해 설치할 수 있습니다. 주 메뉴에서 소프트웨어 업데이트 페이지로 이동합니다.

Administration > Licenses and Software Updates > Software Update and then click Upload 파일을 Cisco Prime에 업로드하려면 UBF 를 클릭합니다.

로컬 컴퓨터를 탐색하여 필요한 파일을 UBF 선택하고 Ok.

파일이 업로드되면 버튼을 클릭하여 Install UBF를 설치합니다.

Cisco Yes Prime Infrastructure를 다시 시작하고 UBF를 설치하려면 팝업 창을 클릭합니다.

Cisco Prime Infrastructure가 재시작되고 15~30분 동안 서비스가 중단됩니다.

3단계. PDART 화면(3.1단계 또는 3.2단계)으로 이동합니다.

3.1단계. UVF가 설치되면 이 URL로 이동하여 PDART 기본 페이지를 표시합니다. PDARTRUN PDART TOOL를 실행하려면 를 클릭합니다.

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

3.2단계. UVF가 설치되면 Prime Data Migration Tool 버전 5도 설치되면 이 화면 캡처에 따라 햄버거 메뉴에서 PDART를 실행할 수 있습니다.

4단계. UI에서 PDART를 실행합니다.

다음 화면에서는 PDART 실행 과정을 안내합니다.

PDART 실행을 클릭하면 버튼이 회색으로 표시되고 콘솔 출력 상태가 EXECUTION IN-PROGRESS로 변경됩니다. PDART는 일반적으로 완료하는 데 최대 5분이 소요됩니다. 확장형 설정의 경우 관리되는 디바이스 수 및 시스템의 로드를 기준으로 완료하는 데 최대 15분이 걸릴 수 있습니다.

완료되면 Console Output(콘솔 출력) 상태가 Execution Successful(실행 성공)로 변경됩니다. PDART PDF 보고서를 보려면 Download Report(보고서 다운로드)를 클릭합니다.

샘플 보고서

이 그림에는 실행된 모든 검사의 요약인 보고서의 첫 번째 페이지가 포함됩니다. 후속 페이지에는 실행된 체크에 대한 자세한 내용이 포함되어 있습니다.

PDART 버전

PDART 버전	의견
최대 0.09	모든 평가는 Cisco Catalyst Center 버전 2.2.2.x를 기반으로 합니다. UVF와 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	버그 픽스를 포함합니다. UVF와 Github 모두 지원됩니다.
2.01	모든 평가는 Cisco Catalyst Center 버전 2.3.3.x를 기반으로 합니다. 레거시 지원 및 추가 마이그레이션 차단 확인 Github에서만 사용할 수 있습니다.
2.02	이 버전은 CCO에서 UVF(업데이트 3)로, Github에서 실행 파일로 사용할 수 있는 두 가지 형태로 제공됩니다. 확장 번호는 2.3.3.x 릴리스에 대해 게시된 새 번호와 인라인입니다. UVF 파일은 다음과 같습니다. Cisco DNACAssmentReadiness_3_7_Update_03-1.0.3.uvf Cisco DNACAssmentReadiness_3_8_Update_03-1.0.3.uvf Cisco DNACAssmentReadiness_3_9_Update_03-1.0.3.uvf Cisco DNACA평가Readiness_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 및 UVF에서 사용 가능 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 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를 통해 실행되지 않을 경우 화면 캡처 및 실패한 로그를 공유합니다.