이 문서에서는 다음 Cisco ACI(Application Centric Infrastructure) VMware VMM(Virtual Machine Manager) 통합 결함을 해결하기 위한 다음 단계에 대해 설명합니다. fault F606347(VM 컨트롤러에서 포트 그룹 추가 또는 삭제 실패), fault F606350(분산된 가상 스위치에서 LACP 지연 정책 업데이트 실패), fault F606391(호스트의 물리적 어댑터에 대한 Link Layer Discovery Protocol/Cisco Discovery Protocol 인접성 정보를 찾을 수 없음)
이러한 결함은 ACI VMM 도메인을 VMware vCenter 및 DVS(Distributed Virtual Switch)와 통합하는 패브릭에서 발생합니다. ACI는 vCenter API를 통해 포트 그룹 라이프사이클, LACP(Link Aggregation Control Protocol) 지연 정책, 물리적 업링크 토폴로지 등의 정책을 DVS와 지속적으로 동기화합니다. 해당 동기화가 실패하거나 필수 구성 요소 검색 정보가 누락된 경우 ACI는 이러한 오류를 발생시켜 운영자 검토 조건을 표시합니다.
이 결함은 ACI가 EPG-VMM 도메인 정책 동기화의 일부로 VM 컨트롤러(예: VMware vCenter)에 포트 그룹을 추가하거나 삭제하지 못할 때 제기됩니다. EPG가 VMM 도메인과 연결되거나 VMM 도메인에서 분리된 경우, APIC는 VM 컨트롤러에 DVS(Distributed Virtual Switch)에서 해당 포트 그룹을 생성하거나 제거하도록 지시합니다. 이 작업을 관리하는 FSM(Finite State Machine)이 성공적으로 완료되지 않으면 ACI는 영향을 받는 VMM 도메인 컨트롤러 개체에서 결함 F606347을 발생시킵니다.
"Code" : "F606347", "Description" : "[FSM:FAILED]: Addition or Deletion of Port Group for: (uni/tn-<TENANT>/ap-<APP-PROFILE>/epg-<EPG>) Tenant: <TENANT> associated with either EPG:(Ap: <APP-PROFILE> Epg: <EPG>) or Services:(LDevInst: EPpInfo: ) on VM Controller: <VMC> VM Domain: <VMM-NAME> VM Provider: <VM-Provider>, failed with error: (TASK:ifc:vmmmgr:CompEpPDAddorDelExtPol)", "Dn" : "uni/vmmp-<VM-Provider>/dom-<VMM-NAME>/ctrlr-[<VMC>]/fault-F606347"
이 결함은 ACI 버전과 VM 컨트롤러 버전 간의 통신 또는 호환성 문제로 인해 발생하는 경우가 가장 많습니다. Cisco TAC(Technical Assistance Center)에 문의하기 전에 다음 단계를 수행하십시오.
포트 그룹 작업은 vCenter API를 통해 실행됩니다. APIC에서 VM 컨트롤러에 연결할 수 없는 경우 FSM이 시간 초과되고 결함이 제기됩니다.
apic1# show vmware domain nameHTTPS 응답에 성공하면 APIC에서 vCenter에 인증할 수 있음을 확인합니다. 연결 실패 또는 인증 오류는 포트 그룹 작업이 성공하기 전에 네트워크 또는 자격 증명 문제를 해결해야 함을 나타냅니다.| grep " Leader" <VMM-NAME> apic2 Leader apic2# pingPING <VC-IP> (<VC-IP>) 56(84) bytes of data. 64 bytes from <VC-IP>: icmp_seq=1 ttl=63 time=0.312 ms ^C apic2# curl -k -X POST -H 'Accept: application/json' --basic \ -u @vsphere.local: \ https:// /rest/com/vmware/cis/session
VMM 도메인에 구성된 vCenter 계정은 유효해야 하며 DVS에서 포트 그룹을 만들고 삭제할 수 있는 충분한 권한이 있어야 합니다.
ACI 소프트웨어 버전과 VM 컨트롤러 버전 간의 비호환성으로 인해 포트 그룹 API 호출이 자동으로 실패하거나 APIC FSM에서 복구할 수 없는 예기치 않은 오류가 반환될 수 있습니다.
apic# moquery -c faultInst -x 'query-target-filter=eq(faultInst.code,"F606347")'출력의 description 필드에는 VM 컨트롤러 이름, VM 도메인, VM 제공자 및 작업을 트리거한 EPG를 비롯한 FSM 오류 세부사항이 포함됩니다. 이 정보를 사용하여 관련된 특정 EPG 및 VMM 도메인으로 조사의 범위를 좁힐 수 있습니다.
위의 단계를 완료해도 결함이 제거되지 않을 경우, 다음 정보를 수집하여 Cisco TAC에 케이스를 여십시오.
제공되는 전체 결함 DN 및 설명 텍스트EPG가 VMM 도메인과 연결된 경우 ACI는 vCenter API를 통해 DVS에 해당 포트 그룹을 프로그래밍합니다. FSM(Finite State Machine) 작업 CompEpPDAddorDelExtPol은 이 수명 주기 작업을 관리합니다. FSM은 포트 그룹 추가 또는 삭제를 시도하고 상태 집합을 통해 전환합니다. 상태 전환이 실패할 경우(예: vCenter에서 반환한 API 오류, 시간 초과 또는 인증 실패) FSM이 FAILED로 표시되고 F606347 오류가 발생한 VM 컨트롤러의 vmmCtrlr 개체에서 발생합니다.
일반적인 장애 시나리오는 다음과 같습니다.
이 결함은 ACI가 vCenter API를 통해 DVS에서 LACP 지연 정책을 업데이트하려고 시도했지만 작업이 실패했을 때 제기됩니다. ACI는 VMM 도메인 정책 동기화의 일부로 LACP 컨피그레이션을 DVS에 푸시하며, 특히 LACP 정책이 DVS에 연결된 VMM 도메인과 연결된 경우 이러한 기능을 수행합니다. 업데이트를 적용할 수 없는 경우 ACI는 영향을 받는 리프 노드에 대해 결함 F606350을 제기합니다.
"Code" : "F606350", "Description" : "Updating LACP Lag Policy at DVS failed.", "Dn" : "topology/pod-<podId>/node-<leafNodeId>/local/svc-policyelem-id-0/uni/epp/fv-[uni/vmmp-VMware/dom-<domainName>]/node-<leafNodeId>/stpathatt-[<interface>]/conndef/conn-[<vxlan>]-[0.0.0.0]/fault-F606350"
이 작업은 ACI에 의해 자동으로 재시도됩니다. APIC과 vCenter 간의 일시적인 vCenter API 지연 또는 일시적인 연결 중단으로 인해 이 결함의 단일 인스턴스가 발생할 수 있습니다. 대부분의 경우 재시도가 성공하고 결함은 자체적으로 지워집니다.
반복적으로 또는 지속적으로 장애가 발생하는 경우 Cisco TAC(Technical Assistance Center)에 문의하기 전에 다음 단계를 수행하십시오.
apic1# show vmware domain name shared-dvs | grep " Leader"
shared-vc apic2 Leader
apic2# nslookup
apic2# ping
PING () 56(84) bytes of data.
64 bytes from : icmp_seq=1 ttl=63 time=0.237 ms
64 bytes from : icmp_seq=2 ttl=63 time=0.406 ms
^C
--- ping statistics ---
2 packets transmitted, 2 received, 0% packet loss, time 1000ms
rtt min/avg/max/mdev = 0.237/0.321/0.406/0.084 ms
apic2# curl -k -X POST -H 'Accept: application/json' --basic -u @vsphere.local: https:///rest/com/vmware/cis/session > cookie.txt
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
0 0 0 0 0 0 0 0 --:--:-- --:--:-- --:--:-- 0
100 408 0 408 0 0 1393 0 --:--:-- --:--:-- --:--:-- 1397
ACI VMM 통합에서는 vCenter API를 사용하여 패브릭을 대신하여 DVS 컨피그레이션을 프로그래밍합니다. LACP 정책이 VMM Domain Interface Policy Group(VMM Domain Interface Policy Group)infraAccPortGrp과 연결된 경우 ACI는 정책을 DVS LACP 그룹 컨피그레이션으로 변환하고 vCenter로 푸시합니다. 푸시 작업은 다음과 같은 몇 가지 이유로 실패할 수 있습니다.
이 결함은 ACI가 VMM 도메인에서 관리되는 호스트의 물리적 네트워크 어댑터(vmnic)에 대한 LLDP(Link Layer Discovery Protocol) 또는 CDP(Cisco Discovery Protocol) 인접성 정보를 찾을 수 없을 때 발생합니다. ACI는 LLDP 또는 CDP를 사용하여 어떤 leaf 스위치 포트가 호스트의 각 vmnic에 물리적으로 연결되어 있는지 확인합니다. 이 인접성 정보가 없으면 ACI는 DVS의 VM 트래픽을 해당 리프 포트에 올바르게 매핑할 수 없습니다. 이는 해당 호스트의 가상 머신에 대한 정책 구축 및 엔드포인트 학습에 영향을 줍니다.
"Code" : "F606391", "Description" : "LLDP/CDP Adjacency information not found for physical adapters on the host.", "Dn" : "topology/pod-<podId>/node-<leafNodeId>/local/svc-policyelem-id-0/uni/epp/fv-[uni/vmmp-VMware/dom-<domainName>]/node-<leafNodeId>/stpathatt-[<interface>]/conndef/conn-[<vxlan>]-[0.0.0.0]/fault-F606391"
이 결함은 경로의 세 지점에서 LLDP 또는 CDP 구성을 수동으로 검증해야 합니다. vCenter의 DVS, ESXi 호스트 및 물리적 리프 스위치 다음 단계를 순서대로 진행합니다.
DVS Discovery Protocol 설정은 DVS가 LLDP 또는 CDP 프레임을 광고하고 수신 대기할지 여부를 제어합니다. 이러한 프로토콜은 ACI VMM 문제 해결 가이드에 설명된 대로 상호 배타적입니다. 이 설정을 사용하지 않거나 Advertise Only로 설정하면 APIC에서 vCenter에서 인접성 정보를 읽을 수 없습니다.
호스트(또는 호스트가 연결하는 업스트림 액세스 스위치)에 연결된 리프 스위치 인터페이스에는 LLDP 또는 CDP가 활성화되어 있어야 합니다. ACI에서 LLDP 및 CDP는 관련 포트에서 사용되는 인터페이스 정책 그룹에 적용된 인터페이스 정책에 의해 제어됩니다.
leaf101# show lldp neighbors출력에는 각 인터페이스 및 검색된 인접 디바이스가 나열됩니다. 호스트의 vmnic 또는 업스트림 액세스 스위치는 예상 인터페이스의 네이버 테이블에 나타나야 합니다. 인터페이스가 출력에서 누락된 경우 leaf는 해당 포트에서 LLDP 프레임을 수신하지 않습니다. 이는 LLDP가 연결된 디바이스에서 업스트림으로 차단되거나 비활성화되었음을 나타냅니다.
leaf101# show cdp neighbors호스트 또는 업스트림 스위치가 예상 인터페이스의 출력에 표시되어야 합니다.
호스트 vmnic가 중간 물리적 액세스 스위치(ACI leaf에 직접 연결되지 않음)에 연결되는 경우 leaf에 도달하려면 LLDP 또는 CDP 프레임이 해당 스위치를 통해 전달되어야 합니다. 중간 스위치에서 다음을 확인합니다.
컨피그레이션을 변경한 후 APIC에서 호스트의 물리적 업링크 토폴로지를 확인할 수 있는지 확인합니다. APIC GUI에서 VM Networking(VM 네트워킹) > VMware > [DVS Domain] > [DVS Name] > Hosts(호스트) > [Host Name] > Physical Interfaces(물리적 인터페이스)로 이동하고 Discovered(검색된) 필드에 각 vmnic에 대한 leaf 포트가 표시되는지 확인합니다. 인접성이 올바르게 해결되면 결함은 자동으로 지워집니다.
특정 VMM 도메인에 대한 인접성 개체를 확인하기 위해 APIC REST API를 쿼리할 수도 있습니다.
apic# moquery -c compHv -x 'query-target-filter=eq(compHv.name,"hostname")'
개체compHv는 VMM 도메인 내의 하이퍼바이저 호스트를 나타냅니다. 관련 compNic 객체는 물리적 어댑터를 나타냅니다. 인접성이 확인되면 객체peerDn의 속성이 compNic 해당 leaf 인터페이스의 DN으로 채워집니다.
위의 3가지 컨피그레이션 포인트를 모두 검증한 후에도 결함이 제거되지 않을 경우, APIC 기술 지원 파일을 수집하고 Cisco TAC에 문의하십시오.
ACI VMM 통합에서는 vCenter API를 사용하여 vCenter가 DVS에서 수집하는 LLDP 및 CDP 네이버 데이터를 검색합니다. APIC는 호스트 vmnic가 어떤 리프 포트에 연결하는지에 대한 맵을 구축하기 위해 이 데이터를 읽습니다. 이 매핑을 사용하여 다음을 수행할 수 있습니다.
인접성 정보가 누락되면 ACI에서 결함 F606391을 발생시켜 영향을 받는 호스트에 대한 물리적 토폴로지를 검증할 수 없음을 알립니다. 가상 머신 연결이 중간에 계속 작동할 수 있습니다. 이 결함으로 인해 데이터 전달이 즉시 중단되지는 않지만 정책 구축 정확도와 엔드포인트 학습 신뢰도가 저하됩니다.
결함 F606391이 해결된 후 재발하지 않도록 하려면
| 개정 | 게시 날짜 | 의견 |
|---|---|---|
1.0 |
04-May-2026
|
최초 릴리스 |