본문으로 건너뛰기

스위치

스위치 탐색, SSH 접속, 토폴로지 맵과 관련된 문제들입니다.

토폴로지 맵에 스위치가 보이지 않음​

스위치는 에이전트들의 LLDP 데이터로부터 자동 탐색됩니다. mac-nic-exporter 컨테이너가 원시 소켓으로 LLDP 패킷을 수동으로 스니핑하고 (내부에 lldpd가 따로 돌지 않습니다) 탐지된 네이버를 /metrics 엔드포인트에 노출합니다. 적어도 하나의 에이전트 NIC이 그 스위치를 가리키는 네이버 항목을 봤는지 확인하세요.

# 에이전트에서 — 메트릭 엔드포인트 확인 (호스트 네트워크, 포트 29500):
~$ curl -s http://localhost:29500/metrics | grep 'nic_lldp'

# 또는 탐색 로그를 살펴봅니다:
~$ docker logs mac-nic-exporter 2>&1 | grep -i lldp

아무 것도 보이지 않는다면 다음을 확인하세요. (a) 링크가 up인지, (b) 스위치 포트에서 lldpd (또는 동등 데몬)가 활성화되어 있는지, (c) 에이전트 컨테이너에 스니핑 소켓을 열기 위한 CAP_NET_RAW가 부여되어 있는지.

Web Terminal을 열 때 "Authentication failed"​

SWITCH_PASSWD_LIST의 SSH 비밀번호가 해당 스위치와 모두 맞지 않는 경우입니다.

~$ mac env set SWITCH_PASSWD_LIST=admin,123455,YourThirdPassword
~$ mac restart master

마스터는 스위치에 처음 연결할 때 비밀번호 목록을 순서대로 시도하고, 성공한 비밀번호를 캐시해 둡니다. 마스터를 재시작하면 캐시된 항목은 비워집니다.

브레이크아웃 변경 후 새 서브 포트가 보이지 않음​

config interface breakout 이후, MAC은 새 서브 포트가 IF-MIB에 나타나도록 스위치에 SSH로 접속해 on-box snmp 컨테이너를 재시작시킵니다. 30초가 지나도 보이지 않는다면, 마스터 측 switch-exporter 캐시를 강제로 새로고침하세요.

# 마스터에서:
~$ docker restart mac-switch-exporter

그래도 새 서브 포트가 보이지 않으면, 스위치에 직접 로그인해 SNMP 데몬이 정상인지 확인합니다 — sudo docker ps | grep snmp.

BGP 피어가 "Active 상태에서 정체"​

거의 항상 스위치 쪽의 L3 도달성 문제이거나 AS 번호 불일치입니다 — MAC이 진단해 줄 수 있는 영역이 아닙니다. 스위치 패널의 Console 탭 (Web Terminal)에서 show bgp summary, show ip route <peer-ip> 같은 벤더 고유 명령으로 직접 점검하세요.

토폴로지에 "n servers not in topology" 배너가 뜸​

해당 서버들은 에이전트로 등록되어 있지만, 관리 중인 스위치와 일치하는 LLDP 네이버가 없는 경우입니다. 흔한 원인은 다음과 같습니다.

  • 스위치가 아직 관리 대상이 아닌 경우 — 해당 스위치의 SSH 자격 증명이 유효한지 확인합니다.
  • 링크가 다운된 경우 — 케이블 / SFP를 점검한 뒤, 마스터에서 docker restart mac-switch-exporter로 재탐색을 강제합니다.
  • 스위치 포트에서 LLDP TX가 꺼져 있는 경우 — 에이전트에서 lldpctl을 실행하거나 스위치에서 show lldp neighbors로 확인합니다.