本文檔介紹以下思科以應用為中心的基礎設施(ACI)VMware Virtual Machine Manager(VMM)整合故障的修復後續步驟:故障F606347(VM控制器上的埠組新增或刪除失敗)、故障F606350(分散式虛擬交換機上的LACP Lag策略更新失敗)和故障F606391(在主機上找不到物理介面卡的鏈路層發現協定/思科發現協定鄰接資訊)。
在使用ACI VMM域與VMware vCenter和分散式虛擬交換機(DVS)整合的交換矩陣中會出現這些故障。ACI通過vCenter API連續同步策略(包括埠組生命週期、鏈路聚合控制協定(LACP)延遲策略和物理上行鏈路拓撲)與DVS。當同步失敗或缺少先決條件發現資訊時,ACI會引發這些錯誤,以暴露條件供操作員檢查。
當ACI在EPG到VMM域策略同步過程中未能新增或刪除VM控制器(例如VMware vCenter)上的埠組時,將引發此故障。當EPG與VMM域關聯或解除關聯時,APIC會指示VM控制器在分散式虛擬交換機(DVS)上建立或刪除相應的埠組。 如果管理此操作的有限狀態機(FSM)未成功完成,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控制器版本之間的通訊或相容性問題引起。聯絡思科技術協助中心(TAC)之前,請完成以下步驟。
埠組操作通過vCenter API執行。如果APIC無法訪問VM控制器,FSM將超時並引發故障。
apic1# show vmware domain name成功的HTTPS響應確認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欄位包含FSM錯誤詳細資訊,包括VM控制器名稱、VM域、VM提供程式以及觸發操作的EPG。使用此資訊將調查範圍縮小到所涉及的特定EPG和VMM域。
如果完成上述步驟後故障未清除,請收集以下資訊並使用Cisco TAC建立案例:
moquery輸出的完整故障DN和說明文本。當EPG與VMM域關聯時,ACI會通過vCenter API對DVS上的相應埠組進行程式設計。有限狀態機(FSM)任務CompEpPDAddorDelExtPol管理此生命週期操作。FSM會嘗試埠組新增或刪除並通過一組狀態轉換。如果任何狀態轉換失敗(例如,由於vCenter返回的API錯誤、超時或身份驗證失敗),FSM將標籤為FAILED,並在受影響的VM控制器的vmmCtrlr對象上引發故障F606347。
常見的故障情形包括:
當ACI嘗試通過vCenter API更新DVS上的LACP延遲策略並且操作失敗時,將引發此故障。ACI將LACP配置作為VMM域策略同步的一部分推送到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延遲或瞬時連線中斷可能導致此故障的單個例項。在許多情況下,重試會成功,故障會自行清除。
如果您觀察到重複或持續故障,請在聯絡思科技術協助中心(TAC)之前採取以下步驟:
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域介面策略組(infraAccPortGrp)關聯時,ACI會將該策略轉換為DVS LACP組配置,並將其推送到vCenter。推送操作失敗的原因可能有幾個:
當ACI在VMM域管理的主機上找不到物理網路介面卡(vmnic)的鏈路層發現協定(LLDP)或思科發現協定(CDP)鄰接資訊時,將引發此故障。ACI使用LLDP或CDP來發現哪個枝葉交換機埠物理連線到主機上的每個vmnic。如果沒有此鄰接資訊,ACI無法正確將VM流量從DVS對映到相應的枝葉埠,這將影響該主機上虛擬機器的策略部署和終端學習。
"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發現協定設定控制DVS是否通告和偵聽LLDP或CDP幀,這些協定是互斥的,如ACI VMM故障排除指南中所述。如果禁用此設定或設定為僅通告,則APIC無法從vCenter讀取鄰接資訊。
連線到主機(或主機所連線的上游接入交換機)的枝葉交換機介面必須啟用LLDP或CDP。在ACI中,LLDP和CDP由應用於相關埠上使用的介面策略組的介面策略控制。
leaf101# show lldp neighbors輸出列出每個介面及其發現的鄰居。主機的vmnic或上游接入交換機必須出現在預期介面的鄰居表中。如果輸出中缺少介面,則枝葉不會在該埠上接收LLDP幀,這表示在上游阻止了LLDP或在連線的裝置上禁用了LLDP。
leaf101# show cdp neighbors主機或上游交換機必須出現在預期介面的輸出中。
如果主機vmnic連線到中間物理接入交換機(不直接連線到ACI枝葉),則必須通過交換機轉發LLDP或CDP幀才能到達枝葉。在中間交換機上驗證以下內容:
更改配置後,驗證APIC現在是否可以解析主機的物理上行鏈路拓撲。在APIC GUI中,導航到VM Networking > VMware > [DVS Domain] > [DVS Name] > Hosts > [Host Name] > Physical Interfaces,並確認Discovered欄位顯示每個vmnic的枝葉埠。如果鄰接關係已正確解決,故障將自動清除。
您還可以查詢APIC REST API以檢查特定VMM域的鄰接對象:
apic# moquery -c compHv -x 'query-target-filter=eq(compHv.name,"hostname")'
該對compHv象表示VMM域中的虛擬機器監控程式主機。相關compNic對象表示物理介面卡。解析鄰接時,用peerDn對應葉compNic介面的DN填充對象的屬性。
如果在驗證以上所有三個配置點後未清除故障,請收集APIC技術支援檔案並聯絡思科TAC。
ACI VMM整合使用vCenter API檢索vCenter從DVS收集的LLDP和CDP鄰居資料。APIC讀取此資料,以構建哪個主機vmnic連線到哪個枝葉埠的對映。此對映用於:
當缺少鄰接資訊時,ACI會引發故障F606391,表明它無法驗證受影響主機的物理拓撲。虛擬機器連線仍可能在過渡期間正常工作(故障不會立即中斷資料轉發),但策略部署準確性和端點學習可靠性會降低。
要在解決故障F606391後防止其重複發生,請執行以下操作:
| 修訂 | 發佈日期 | 意見 |
|---|---|---|
1.0 |
04-May-2026
|
初始版本 |