소개
CLICommandCollector 는 APIC에서 실행할 수 있으며, 사용자가 CLI command를 검색하고 APP UI의 단일 지점에서 동시에 여러 ACI 노드(APIC/Spine/Leaf)의 command 출력을 수집할 수 있는 ACI APP입니다.
다운로드: https://dcappcenter.cisco.com
이 APP에는 다음과 같은 몇 가지 이점이 있습니다.
-사용자는 여러 ACI 노드에서 command 출력을 수집할 때 여러 terminal window를 열고 각 window에 command를 입력할 필요가 없습니다.
-선택한 노드에 대한 command 집합이 포함된 custom ᅟimport 파일을 사용하면 사용자는 파일을 import 하기만 하면 command 집합에서 쉽게 출력을 수집할 수 있습니다. 이는 사용자가 동일한 command 세트에서 여러 번 출력을 수집해야 하거나 TAC이 고객에게 특정 노드에서 특정 command 출력을 수집하도록 요청할 때 유용합니다.
-Template 기능을 이용하면, template(이슈 유형)과 해당 노드를 선택하기만 하면 이슈 유형에 해당하는 command 출력을 쉽게 수집할 수 있습니다.
데모용 비디오(사운드 없음)
사용방법 및 특징
전제 조건
처음 사용할 때 설정 메뉴에서 관리자 자격 증명(username/password)을 저장해야 합니다. 이 자격 증명은 APIC에 대한 API access 및 각 노드에 대한 SSH access 에 사용됩니다.
이제 APP 사용할 준비가 되었습니다! 다음과 같이 CLI 출력을 수집하는데 3개의 옵션이 있습니다.
command 선택 메뉴(option1)
command를 검색하여 각 역할(APIC, Leaf, Spine(box), Spine(Chassis))별로 수집할 command를 선택할 수 있습니다. 또한 선택한 command을 수집할 노드를 선택해야 합니다. 역할별로 다음 shell 유형에 대한 command가 지원됩니다.
APIC: moquery, show, acidiag
Leaf: ish, vsh, vsh_lc
Spine(Box): ish, vsh, vsh_lc
Spine(Chassis): ish, vsh, linecard, fabric module
command 선택 메뉴의 마지막 단계에서는 출력을 수집할 command와 command를 수집할 노드를 확인할 수 있습니다. submit 버튼을 클릭하면 APP의 백엔드가 동작하여 선택한 노드에서 해당 command 출력을 수집하고, command 수집 후 결과 메뉴가 자동으로 표시되어 수집된 log를 확인할 수 있습니다.
command 선택 메뉴에서 submit 버튼 전에 export 버튼을 클릭하고 command 및 노드 정보가 포함된 파일을 저장하면 나중에 Import 메뉴에서 동일한 노드에서 동일한 command를 수집하는 데 다시 사용할 수 있습니다.
ᅟImport 메뉴 (command 수집을 위한 option2)
Import 메뉴에서는 Command Selection 메뉴에서 export한 파일과 command 및 노드 목록을 사용자 정의한 파일을 export 할 수 있습니다. 파일을 export 하면 command나 노드를 수동으로 선택할 필요가 없습니다. 또한 지원되는 YAML 형식의 샘플이 각 역할에 대해 메뉴 페이지의 오른쪽 패널에 표시되며, 이 패널을 클릭하여 내용을 텍스트 영역에서 편집할 수도 있습니다.
Template 메뉴 (command 수집을 위한 option3)
해당 이슈에 대해 수집해야 하는 각 역할에 대한 command 목록을 포함하는 몇 가지 이슈 template 을 준비합니다.
아래 template 메뉴에서 template 을 선택합니다.
드롭다운 목록에서 문제를 선택하고 선택 버튼을 클릭하면 문제에 대해 선택된 command와 함께 command 선택 메뉴 페이지가 표시됩니다. 그 다음, 각 역할에 대한 command가 수집될 노드를 선택하고 submit 버튼을 클릭하면 APP이 출력을 수집합니다.
Template 이름을 입력하고 만들기 버튼을 클릭한 다음, 각 역할에 대한 command 를 선택하여 "Create Template"에서 사용자 지정 template 을 만들 수도 있습니다.
Result 메뉴
APP이 선택한 command 출력 수집을 완료하면 이 메뉴 페이지가 자동으로 표시됩니다. 드롭다운에서 노드를 선택하면 수집된 출력이 아래에 표시됩니다. 오른쪽 상단의 플러스 버튼을 클릭하면 추가 노드에 대한 결과 보기가 나타납니다. 최대 4개의 노드에 대한 결과를 동시에 가로로 표시할 수 있습니다.
각 노드의 상단에 있는 모두 다운로드 버튼과 오른쪽 상단의 다운로드 아이콘 버튼을 사용하여 각각 모든 노드와 각 노드에 대한 명령 출력을 파일로 다운로드할 수 있습니다.
"/data2/logs/cisco_CLICommandCollector/" 디렉토리에서 결과 파일을 다운로드할 수도 있습니다. 결과 파일의 이름은 "C3_<timestamp>_<hostname>.txt"와 같이 지정됩니다.
Settings 메뉴
위에서 설명한 대로 APP를 처음 사용할 때 여기에 자격 증명을 저장해야 합니다.
고급 모드에서는 내장된 기본 command 목록 DB 외에 각 역할에 대한 command 목록을 포함하는 새 DB를 생성할 수 있습니다. 이 사용자 지정 DB는 버전/플랫폼 간에 사용 가능한 command의 차이를 이해하고 이를 처리해야 하는 경우에만 사용해야 합니다.
Help 메뉴
이 메뉴는 각 기능에 대한 스크린샷이 있는 APP의 'How To' 페이지입니다.
이상 ACI CliCommandCollector 사용법에 대하여 정리해보았습니다.
Cisco ACI 사용자 분들께 도움이 되었으면 합니다.