Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

Cisco 디바이스 에이전트

Cisco NX-OS 디바이스 에이전트 개요

디바이스 시스템 에이전트를 설치하는 기본 방법은 Apstra GUI에서 왔지만 CLI에서 Apstra 에이전트를 수동으로 설치할 수 있습니다 . 드문 예외에서만 에이전트를 수동으로 설치해야 하므로 더 많은 노력이 필요하며 오류가 발생하기 쉽습니다. 에이전트를 수동으로 설치하기 전에 다양한 디바이스 상태, 구성 단계 및 에이전트 작업을 심층적으로 이해해야 합니다. 도움이 필요하면 Juniper 지원부에 문의하십시오.

참고:

또한 Apstra ZTP 를 사용하여 스위치에서 에이전트를 자동으로 부팅하고 설치하고 사전 필수 구성을 할 수도 있습니다. Apstra ZTP를 사용하는 것은 에이전트를 수동으로 설치하는 것보다 규모에 따라 지원이 더 간단하고 쉽습니다.

Cisco 디바이스에 에이전트를 수동으로 설치하려면 다음 단계가 포함됩니다.

  • 손님 쉘 디스크 크기, 메모리 및 cpu를 업데이트 한 다음 손님 쉘을 활성화 / 재부팅합니다.
  • 디바이스 에이전트를 설치합니다.
  • aos.config 파일을 업데이트합니다.
  • 서비스를 시작합니다.
주의:

Cisco GuestShell은 Apstra 고유의 분할되지 않습니다. 게스트 쉘에 호스팅하는 다른 애플리케이션이 있는 경우 게스트 쉘의 변경 사항이 영향을 줄 수 있습니다.

주의:

"부트스트랩" 또는 "프리스틴" 구성의 명령은 패브릭 구축 중에 추가된 Apstra 구성을 방해할 수 있습니다.

Apstra가 사용하는 MTU보다 낮은 값으로 NX-OS "system jumbomtu"를 구성하면 Apstra MTU 명령이 실패합니다.

디바이스 구성 요구 사항

VRF, NXAPI, GuestShell, 관리 VRF 생성 등 다음과 같은 순서로 디바이스를 구성합니다. 에이전트-서버 통신을 허용하기 위해 Apstra의 디바이스 에이전트는 VRF 이름을 management사용합니다. 실행 중인 구성에 이러한 줄이 나타나는지 확인합니다.

크기 조정 및 게스트 쉘 활성화

  1. 디스크 공간, 메모리 및 CPU의 크기를 조정하려면 다음 명령을 실행합니다.
  2. guestshell이 활성화되지 않은 경우 명령을 guestshell enable 실행하여 변경 사항을 활성화합니다.
  3. 게스트 쉘이 이미 활성화된 경우 명령을 guestshell reboot 실행하여 쉘을 다시 시작하고 변경 사항을 활성화합니다.
  4. 명령을 switch# show guestshell detail 실행하고 게스트 쉘이 활성화되었는지 확인합니다.

에이전트 설치 관리자 다운로드

Apstra 서버에서 HTTPS를 통해 설치 에이전트를 쉽게 복사할 수 있습니다. 다운로드한 후 다운로드한 복사본의 MD5sum이 Apstra 매장과 일치하는지 확인합니다.

참고:

에이전트 파일을 검색하려면 Cisco 디바이스가 HTTPS를 사용하여 Apstra 서버에 연결됩니다. 진행하기 전에 이 연결이 작동하는지 확인합니다.

Apstra는 Apstra 서버의 에이전트와 함께 배송됩니다. 이를 , 또는 volatile: 파일 시스템 위치로 복사할 /volatile수 있습니다. Apstra는 Apstra 서버의 폴더에 /home/admin md5sum 파일을 제공합니다.

aos_server_ip 아래 실행 파일에서 변수와 aos_version 을(를) 대체합니다. Apstra 서버 버전(예: 4.1.0-115)의 경우 플랫폼 > 정보로 이동합니다.

파일이 올바르게 다운로드되었는지 확인합니다.

Cisco 디바이스 에이전트 설치

참고:

문제가 발생할 경우 최신 변경 사항을 저장하기 위해 명령을 copy running-config startup-config 실행하는 것이 좋습니다.

Cisco NX-OS 스위치 게스트 쉘에서 명령을 실행하여 아래와 같이 에이전트를 설치합니다.

에이전트 구성 파일 업데이트 및 서비스 시작

에이전트를 설치한 후 서비스를 시작하기 전에 파일을 업데이트 aos.conf 하여 서버에 연결합니다.

에 위치한 /etc/aos/aos.confCisco NX-OS 디바이스 에이전트 구성 파일을 구성합니다. 매개 변수는 Apstra 디바이스 에이전트 구성 파일을 참조하십시오.

파일을 업데이트한 후 명령을 service aos start 실행하여 Apstra 디바이스 에이전트를 시작합니다.

Apstra 서버에서 Apstra 디바이스 활성화

Apstra 디바이스 에이전트가 Apstra와 통신할 때, Apstra는 '디바이스 키'를 사용하여 자신을 식별합니다. Cisco NXOS 스위치의 경우 디바이스 키는 관리 인터페이스 'eth0'의 MAC 주소.

디바이스 구축

Apstra GUI의 왼쪽 탐색 메뉴에서 매니지드 디바이스를 > 디바이스로 이동합니다. 에이전트가 실행 중이면 이 목록에 나타나며 표준 절차에 따라 GUI를 사용하여 청사진에 승인하고 할당할 수 있습니다.

Apstra 디바이스 에이전트 재설정

Apstra 에이전트를 어떤 이유로 재설정해야 하는 경우(블루프린트 변경, 재구매, 백업에서 디바이스 복원 등) Apstra 에이전트 메타데이터를 지우고, 디바이스를 다시 등록하고, 청사진에 다시 구축하는 것이 가장 좋습니다.

Apstra 디바이스 에이전트 제거

에이전트를 제거하려면 GUI를 사용하여 표준 절차에 따라 청사진에서 먼저 설치하지 않고 할당 해제합니다. 또한 매니지드 디바이스 페이지에서 완전히 삭제할 수도 있습니다.

NX-OS에서 Apstra 패키지를 제거하려면 손님 쉘을 파괴하십시오. 다른 애플리케이션이 게스트쉘을 사용하지 않는 경우에만 이 작업을 수행합니다.

Apstra EEM 스크립트 제거

Apstra 디바이스 에이전트는 텔레메트리를 지원하기 위해 일부 이벤트 관리자 애플릿을 설치합니다. 이를 안전하게 제거할 수 있습니다.

C9K-172-20-65-5(구성)# 이벤트 관리자 AOS_PROTO_VSH_LAUNCH C9K-172-20-65-5(구성)# 이벤트 관리자 애플릿 AOS_STATS_VSH_LAUNCH C9K-172-20-65-65-없음 5 (구성)# 이벤트 매니저 applet aos_bgp_applet C9K-172-20-65-5 (구성)# 이벤트 관리자 applet aos_ifdown_applet C9K-172-20-65-5 (구성)# 이벤트 관리자 applet aos_ifup_applet

Cisco 에이전트 문제 해결

Apstra 에이전트는 NXOS 게스트 쉘(guestshell)에서 실행되어 기본 bash 및 Linux 환경과 상호 작용합니다. Apstra가 작동하는 내부 Linux Container(LXC)입니다. LXC에서 Apstra는 NXAPI 및 기타 방법을 사용하여 NXOS와 직접 통신합니다. 보안상의 이유로 Cisco는 LXC 인터페이스의 상당 부분을 NXOS 디바이스의 나머지 부분과 분리하므로, 더 많은 문제 해결 명령을 수행하려면 게스트 쉘 bash 프롬프트에 드롭해야 합니다.

게스트 쉘이 NX-OS에서 실행되고 있는지 확인 Apstra 에이전트는 NXOS Guest Shell에서 실행되어 기본 bash 및 linux 환경과 상호 작용합니다. Apstra가 작동하는 내부 Linux Container(LXC)입니다. 게스트 쉘이 활성화되고 실행되는지 확인하고 있습니다.

등록 서비스 표시

Apstra에 대한 네트워크 연결성 확인

게스트 쉘 내에서 Apstra 서버로 ping하여 ICMP 핑을 확인합니다. VRF의 컨텍스트 내에서 명령을 실행할 때 명령을 chvrf <vrf> 사용할 때 명령을 사용합니다. 이 경우 VRF입니다 management .

에이전트 설치 확인

Apstra 디바이스 에이전트 패키지가 설치되었는지 확인합니다. NXOS에서 Apstra 에이전트는 게스트 쉘 인스턴스가 시작될 때 시작하도록 /etc/rc.d/init.d/aos 설치합니다.

Apstra 에이전트가 실행 중인지 확인

'서비스' 명령으로 실행 시스템 상태를 확인하고 'ps' 명령으로 실행 프로세스를 확인합니다. 우리는 aos_agent 제대로 실행되고 있는지 확인하려고합니다.

/etc/aos에 파일 존재 확인

게스트 쉘 아래에 Apstra는 /etc/aos 아래에 다수의 구성 파일을 저장합니다.

/var/log/aos의 Apstra 데이터 확인

Apstra는 내부 데이터베이스를 /var/log/aos에 기록합니다.

Apstra 에이전트 버전 결정

Apstra 에이전트 버전은 /etc/aos/version에서 제공됩니다. 이 명령을 실행하기 전에 aos 서비스에 연결해야 합니다.

DNS 확인 실패

Apstra 에이전트는 metadb 연결의 DNS 확인에 민감합니다. /etc/aos/aos.conf의 IP 및/또는 DNS가 디바이스 eth0 관리 포트에서 연결할 수 있는지 확인합니다.

Apstra Service는 Cisco NX-OS에서 시작하는 데 오랜 시간이 걸립니다.

Cisco NX-OS의 GuestShell이 LXC 컨테이너 내에서 NXAPI를 초기화하는 데는 몇 분이 소요됩니다. 이것은 정상입니다. 이 지연을 감리하기 위해 Apstra 스크립트 초기화에 대기 지연이 추가되었습니다.

Apstra 중단 및 오류 없는 문제(MGMT VRF)

손님이 관리 VRF 뒤에 올바르게 있는지 확인합니다.

기본적으로 'ping' 명령을 실행할 때 Apstra 서버를 핑할 수 없습니다.

아래 - 글로벌 기본 라우팅 테이블 172.20.156.3에서 Apstra 서버로 핑이 실패하겠지만 게스트 셸에서 성공할 것으로 예상합니다.

NX-OS 게스트 쉘에서 MGMT VRF 확인