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 에이전트를 수동으로 설치할 있습니다. 드문 예외 경우에만 에이전트를 수동으로 설치해야 하므로 더 많은 노력이 필요하고 오류가 발생하기 쉽습니다. 에이전트를 수동으로 설치하기 전에 다양한 디바이스 상태, 구성 단계 및 에이전트 작업을 심층적으로 이해해야 합니다. 도움이 필요하면 주니퍼 지원에 문의하십시오.

참고:

또한 Apstra ZTP 를 사용하여 스위치에 에이전트와 필수 구성 요소를 자동으로 부팅하고 설치할 수 있습니다. Apstra ZTP를 사용하면 에이전트를 수동으로 설치하는 것보다 더 간단하고 대규모로 지원하기가 쉽습니다.

Cisco 디바이스용 에이전트를 수동으로 설치하려면 다음 단계를 수행해야 합니다.

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

Cisco GuestShell은 Apstra와 고유하게 분할되지 않습니다. 게스트 셸에서 호스팅하는 다른 응용 프로그램이 있는 경우 게스트 셸의 변경 사항이 영향을 줄 수 있습니다.

주의:

"Bootstrap" 또는 "Pristine" 구성의 명령은 패브릭 구축 중에 추가된 Apstra 구성을 방해할 수 있습니다.

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

디바이스 구성 요구 사항

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

게스트 셸 크기 조정 및 사용

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

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

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

참고:

에이전트 파일을 검색하기 위해 Cisco 디바이스는 HTTPS를 사용하여 Apstra 서버에 연결합니다. 계속하기 전에 이 연결이 작동하는지 확인하십시오.

Apstra는 Apstra 서버의 에이전트와 함께 제공됩니다. 또는 파일 시스템 위치에 복사할 /volatilevolatile: 수 있습니다. 또한 Apstra는 Apstra 서버의 폴더에 md5sum 파일과 /home/admin 함께 제공됩니다.

aos_server_ip 아래 실행 파일에서 변수 및 aos_version 을(를) 교체합니다. (Apstra GUI에서 Apstra 서버 버전을 확인하려면 플랫폼 > 정보로 이동하십시오.)

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

Cisco Device Agent 설치

참고:

문제가 발생할 경우를 대비하여 명령을 copy running-config startup-config 실행하여 최신 변경 내용을 저장하는 것이 좋습니다.

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

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

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

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

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

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

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

장치 배포

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

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

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

Apstra Device Agent 제거

에이전트를 제거하려면 먼저 GUI를 사용하여 표준 절차에 따라 블루프린트에서 에이전트를 배포 해제하고 할당을 취소합니다. 관리되는 장치 페이지에서 완전히 삭제할 수도 있습니다.

NX-OS에서 Apstra 패키지를 제거하려면 guesthell을 삭제합니다. 다른 응용 프로그램이 게스트 헬을 사용하지 않는 경우에만이 작업을 수행하십시오.

Apstra EEM 스크립트 제거

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

C9K-172-20-65-5(config)# 이벤트 관리자 애플릿 없음 AOS_PROTO_VSH_LAUNCH C9K-172-20-65-5(config)# 이벤트 관리자 애플릿 없음 AOS_STATS_VSH_LAUNCH C9K-172-20-65-5(config)# 이벤트 관리자 애플릿 없음 aos_bgp_applet C9K-172-20-65-5(config)# 이벤트 관리자 애플릿 없음 aos_ifdown_applet C9K-172-20-65-5(config)# 이벤트 관리자 애플릿 없음 aos_ifup_applet

Cisco 에이전트 문제 해결

Apstra 에이전트는 NXOS 게스트 셸에서 실행되어 기본 bash 및 Linux 환경과 상호 작용합니다. 이는 Apstra가 작동하는 내부 리눅스 컨테이너(LXC)입니다. LXC에서 Apstra는 NXAPI 및 기타 방법을 사용하여 NXOS와 직접 통신합니다. 보안상의 이유로 Cisco는 LXC 인터페이스의 대부분을 NXOS 디바이스의 나머지 부분과 분리하여 분할하므로 게스트 셸 bash 프롬프트로 이동하여 추가 문제 해결 명령을 수행해야 합니다.

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

등록된 서비스 표시

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

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

에이전트 설치 확인

Apstra 디바이스 에이전트 패키지가 설치되어 있는지 확인합니다. NXOS에서 Apstra 에이전트는 게스트 셸 인스턴스가 시작될 때 시작하기 위해 설치됩니다 /etc/rc.d/init.d/aos .

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

'service' 명령으로 실행 중인 시스템 상태를 확인하고, '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 확인에 민감합니다. 디바이스 eth0 관리 포트에서 /etc/aos/aos.conf의 IP 및/또는 DNS에 연결할 수 있는지 확인합니다.

Cisco NX-OS에서 Apstra 서비스를 시작하는 데 시간이 오래 걸림

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

Apstra 오류 없이 중지(MGMT VRF)

게스트 셸이 관리 VRF 뒤에 제대로 있는지 확인합니다.

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

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

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