本產品的文件集力求使用無偏見用語。針對本文件集的目的,無偏見係定義為未根據年齡、身心障礙、性別、種族身分、民族身分、性別傾向、社會經濟地位及交織性表示歧視的用語。由於本產品軟體使用者介面中硬式編碼的語言、根據 RFP 文件使用的語言,或引用第三方產品的語言,因此本文件中可能會出現例外狀況。深入瞭解思科如何使用包容性用語。
思科已使用電腦和人工技術翻譯本文件,讓全世界的使用者能夠以自己的語言理解支援內容。請注意,即使是最佳機器翻譯,也不如專業譯者翻譯的內容準確。Cisco Systems, Inc. 對這些翻譯的準確度概不負責,並建議一律查看原始英文文件(提供連結)。
本文檔介紹補救ACI故障F0467的後續步驟:invalid-vlan、invalid-path或encap-already-in-use。
ACI故障F0467會在不同的場景中標籤,但顯示每個故障的不同原因。
ACI故障F0467出現的最常見原因值包括:
ACI故障F0467的所有原因都可能影響交換機節點介面上的vlan部署。
作為主動ACI服務的一部分,此故障會受到主動監控。
如果您有與Intersight連線的ACI交換矩陣,則會代表您生成服務請求,以指明在Intersight連線的ACI交換矩陣中發現了此故障的例項。
故障描述明確表明「EpG未與域關聯,或者域未分配此VLAN」。
APIC# moquery -c faultInst -f 'fault.Inst.code=="F0467"' | grep lc_EPG
descr : Configuration failed for uni/tn-lc_TN/ap-lc_APP/epg-lc_EPG node 103 eth1/13 due to Invalid VLAN Configuration, debug message: invalid-vlan: vlan-421 :Either the EpG is not associated with a domain or the domain does not have this vlan assigned to it;
dn : topology/pod-1/node-103/local/svc-policyelem-id-0/uni/epp/fv-[uni/tn-lc_TN/ap-lc_APP/epg-lc_EPG]/node-103/stpathatt-[eth1/13]/nwissues/fault-F0467
枝葉節點上未部署訪問封裝VLAN 421:
Node-103# show vlan encap-id 421 extended
<<< Empty >>>
未建立EPG關聯的靜態路徑:
APIC# moquery -c l2RtDomIfConn | grep lc_EPG | grep dn
<<< Empty >>>
域lc_phys_dom將其與lc_EPG EPG關聯:
APIC# moquery -c fvRsDomAtt | grep -A 25 lc_EPG | grep rn
rn : rsdomAtt-[uni/phys-lc_phys_dom]
存在域到VLAN池的關聯:
APIC# moquery -c infraRsVlanNs | grep -A 15 lc_phys_dom | grep tDn
tDn : uni/infra/vlanns-[lc_vlan_pool]-static
Vlan池lc_vlan_pool的範圍僅包括VLAN 420。
APIC# moquery -c fvnsEncapBlk | grep lc_vlan_pool
dn : uni/infra/vlanns-[lc_vlan_pool]-static/from-[vlan-420]-to-[vlan-420]
vlan 421不在之前的池中,因此發生錯誤「invalid-vlan:vlan-421 :EpG未與域關聯,或者該域未分配此VLAN。」
在前面提到的方框圖中,此特定VLAN池引用被突出顯示:
將缺少的vlan 421新增到特定vlan範圍。
要封裝和域的VLAN池關聯(Fabric > Access Policies > Pool > VLAN > lc_vlan_pool):
新增vlan 421後的vlan池範圍驗證:
APIC# moquery -c fvnsEncapBlk | grep lc_vlan_pool
dn : uni/infra/vlanns-[lc_vlan_pool]-static/from-[vlan-420]-to-[vlan-420]
dn : uni/infra/vlanns-[lc_vlan_pool]-static/from-[vlan-421]-to-[vlan-421]
Fabric > Access Policies > Physical and External Domains> Physical Domains > lc_phys_dom:
[+]域與VLAN池的關聯:
APIC# moquery -c infraRsVlanNs | grep -A 15 lc_phys_dom | grep tDn
<< EMPTY >>
修正:包括缺少VLAN關聯
Fabric > Access Policies > Physical and External Domains> Physical Domains > lc_phys_dom:
在沒有相應的訪問策略允許正確應用該配置的情況下進行交換機/埠/VLAN宣告時,將引發此故障。
根據此故障的描述,訪問策略關係的另一個元素可能丟失。
EPG - lc_EPG到租戶的故障關聯> lc_TN > lc_AP > lc_EPG >故障>故障:
受影響的EPG、交換機節點ID和埠號在故障描述和dn中:
APIC# moquery -c faultInst -f 'fault.Inst.code=="F0467"' | grep lc_EPG
descr : Configuration failed for uni/tn-lc_TN/ap-lc_APP/epg-lc_EPG node 103 eth1/13 due to Invalid Path Configuration, debug message: invalid-path: Either the EpG/L3Out is not associated with a domain or the domain does not have this interface assigned to it;
dn : topology/pod-1/node-103/local/svc-policyelem-id-0/uni/epp/fv-[uni/tn-lc_TN/ap-lc_APP/epg-lc_EPG]/node-103/stpathatt-[eth1/13]/nwissues/fault-F0467
確認是否已部署VLAN。如果沒有,可以運行這些命令來隔離配置錯誤。
在這些命令中,lc_EPG是用於輸出過濾的EPG名稱。
枝葉節點上未部署Encap-vlan:
Node-103# show vlan encap-id 420 extended
<<< Empty >>>
[1] EPG關聯策略的靜態路徑為空:
APIC# moquery -c l2RtDomIfConn | grep lc_EPG | grep dn
<<<空>>>
[2]域與EPG的關聯:
APIC# moquery -c fvRsDomAtt | grep -A 25 lc_EPG | grep rn
rn : rsdomAtt-[uni/phys-lc_phys_dom]
[3]域與VLAN池的關聯:
APIC# moquery -c infraRsVlanNs | grep -A 15 lc_phys_dom | grep tDn
tDn : uni/infra/vlanns-[lc_vlan_pool]-static
[4] Vlan池範圍驗證:
APIC# moquery -c fvnsEncapBlk | grep lc_vlan_pool
dn : uni/infra/vlanns-[lc_vlan_pool]-static/from-[vlan-420]-to-[vlan-420]
[5]域與AAEP的關聯:
APIC# moquery -c infraRtDomP | grep lc_phys_dom
dn : uni/phys-lc_phys_dom/rtdomP-[uni/infra/attentp-lc_AAEP]
[6] AAEP到介面策略組關聯(IPG):
rtp-aci08-apic1# moquery -c infraRtAttEntP | grep lc_AAEP
dn : uni/infra/attentp-lc_AAEP/rtattEntP-[uni/infra/funcprof/accportgrp-lc_IPG]
[7] IPG與介面選擇器關聯:
APIC# moquery -c infraRsAccBaseGrp | grep -B 15 lc_IPG | grep dn
dn : uni/infra/accportprof-lead103_IP/hports-lc_Interface_Selector-typ-range/rsaccBaseGrp
[8]介面配置檔案與交換機配置檔案關聯:
APIC# moquery -c infraRsAccPortP | grep leaf103_IP | grep dn
dn : uni/infra/nprof-leaf103_SP/rsaccPortP-[uni/infra/accportprof-leaf103_IP]
如果給定靜態路徑配置,缺少任何相關的必需訪問策略,則會出現無效路徑原因。瀏覽潛在原因,逐跳驗證訪問策略:
交換矩陣>訪問策略>策略>全域性> AAEP > lc_AAEP:
[+] EPG關聯策略的靜態路徑為空:
APIC# moquery -c l2RtDomIfConn | grep lc_EPG | grep dn
<< EMPTY >>
[+]域與AAEP的關聯:
APIC# moquery -c infraRtDomP | grep lc_phys_dom
<< EMPTY >>
修正:要封裝和域的VLAN池關聯(Fabric > Access Policies > Pool > VLAN > lc_vlan_pool)
Fabric > Access Policies > Physical and External Domains> Physical Domains > lc_phys_dom:
Fabric > Access Policies > Interfaces > Leaf Interfaces > Policy Groups > Leaf Access Port > lc_IPG:
[+] EPG關聯策略的靜態路徑為空:
APIC# moquery -c l2RtDomIfConn | grep lc_EPG | grep dn
<< EMPTY >>
[+] IPG到AAEP的關聯為空:
APIC# moquery -c infraRsAttEntP | grep -A 15 lc_IPG | grep tDn
<< EMPTY >>
修正:缺少AAEP到IPG的關聯
Fabric > Access Policies > Interfaces > Leaf Interfaces > Policy Groups > Leaf Access Port > lc_IPG:
[+] IPG與AAEP關聯
APIC# moquery -c infraRsAttEntP | grep -A 15 lc_IPG | grep tDn
tDn : uni/infra/attentp-lc_AAEP
Fabric > Access Policies > Interfaces > Leaf Interfaces > Profiles > leaf103_IP > lc_Interface_Selector:
[+] IPG與介面選擇器關聯
APIC# moquery -c infraRsAccBaseGrp | grep -B 15 lc_IPG | grep dn
<< EMPTY >>
修正:介面選擇器與介面策略組關聯
[+] IPG與介面選擇器關聯:
APIC# moquery -c infraRsAccBaseGrp | grep -B 15 lc_IPG | grep dn
dn : uni/infra/accportprof-lead103_IP/hports-lc_Interface_Selector-typ-range/rsaccBaseGrp
Fabric > Access Policies > Interfaces > Leaf Interfaces > Profiles > leaf103_IP:
疑難排解:
APIC# moquery -c infraHPortS | grep leaf103_IP
<< EMPTY >>
修正:介面配置檔案與介面選擇器關聯
APIC# moquery -c infraHPortS | grep leaf103_IP
dn : uni/infra/accportprof-leaf103_IP/hports-lc_Interface_Selector-typ-range
交換矩陣>訪問策略>交換機>枝葉交換機>配置檔案>枝葉103_SP
APIC# moquery -c infraRsAccPortP | grep leaf103_IP | grep dn
<< EMPTY >>
修正:枝葉配置檔案與介面選擇器配置檔案關聯
[+]介面配置檔案與交換機配置檔案關聯:
APIC# moquery -c infraRsAccPortP | grep leaf103_IP | grep dn
dn : uni/infra/nprof-leaf103_SP/rsaccPortP-[uni/infra/accportprof-leaf103_IP]
預設情況下,VLAN具有全域性範圍。給定的VLAN ID只能用於給定枝葉交換機上的單個EPG。
在給定枝葉交換機內的多個EPG上重複使用同一VLAN的任何嘗試都會導致封裝已在使用的F0467故障。
Tenants > lc_TN > lc_AP > lc_EPG > Faults > Fault:
APIC# moquery -c faultInst -f 'fault.Inst.code=="F0467"' | grep lc_EPG
changeSet : configQual:encap-already-in-use, configSt:failed-to-apply, debugMessage:encap-already-in-use: Encap (vlan-420) is already in use by lc_TN_Dup:lc_APP:lc_EPG;, temporaryError:no
descr : Configuration failed for uni/tn-lc_TN/ap-lc_APP/epg-lc_EPG node 103 eth1/13 due to Encap Already Used in Another EPG, debug message: encap-already-in-use: Encap (vlan-420) is already in use by lc_TN_Dup:lc_APP:lc_EPG;
dn : topology/pod-1/node-103/local/svc-policyelem-id-0/uni/epp/fv-[uni/tn-lc_TN/ap-lc_APP/epg-lc_EPG]/node-103/stpathatt-[eth1/13]/nwissues/fault-F0467
[+]您可以確認已在其他租戶lc_TN_Dup上使用的封裝:
Node-103# show vlan extended | egrep "Encap|----|vlan-420"
VLAN Name Encap Ports
---- -------------------------------- ---------------- ------------------------
3 lc_TN_Dup:lc_APP:lc_EPG vlan-420 Eth1/13
從v1.1版本開始,您可以在給定枝葉交換機(或FEX)上部署具有相同VLAN封裝的多個EPG,如每埠VLAN配置指南中所述:
本節可作為功能設定的完整配置的參考指南。
租戶> lc_TN > lc_AP > lc_EPG >靜態埠:
[+]靜態埠到EPG的關聯策略:
APIC# moquery -c l2RtDomIfConn | grep lc_EPG | grep dn
dn : topology/pod-1/node-103/sys/ctx-[vxlan-2195458]/bd-[vxlan-16416666]/vlan-[vlan-420]/rtfvDomIfConn-[uni/epp/fv-[uni/tn-lc_TN/ap-lc_APP/epg-lc_EPG]/node-103/stpathatt-[eth1/13]/conndef/conn-[vlan-420]-[0.0.0.0]]
交換矩陣>訪問策略>策略>全域性> AAEP > lc_AAEP:
APIC# moquery -c fvIfConn -f 'fv.IfConn.encap=="vlan-420"' | grep dn
dn : uni/epp/fv-[uni/tn-lc_TN/ap-lc_APP/epg-lc_EPG]/node-103/attEntitypathatt-[lc_AAEP]/conndef/conn-[vlan-420]-[0.0.0.0]
租戶> lc_TN > lc_AP > lc_EPG >域:
[+]域lc_phys_dom已將其與EPG關聯。
APIC# moquery -c fvRsDomAtt | grep -A 25 lc_EPG | grep rn
rn : rsdomAtt-[uni/phys-lc_phys_dom]
Fabric > Access Policies > Physical and External Domains> Physical Domains > lc_phys_dom:
[+]域與AAEP的關聯:
APIC# moquery -c infraRtDomP | grep lc_phys_dom
dn : uni/phys-lc_phys_dom/rtdomP-[uni/infra/attentp-lc_AAEP]
[+]域與VLAN池的關聯
APIC# moquery -c infraRsVlanNs | grep -A 15 lc_phys_dom | grep tDn
tDn : uni/infra/vlanns-[lc_vlan_pool]-static
交換矩陣>訪問策略>池> VLAN > lc_vlan_pool:
[+] Vlan池範圍驗證:
APIC# moquery -c fvnsEncapBlk | grep lc_vlan_pool
dn : uni/infra/vlanns-[lc_vlan_pool]-static/from-[vlan-420]-to-[vlan-420]
[+]已使用lc_vlan_pool的域:
APIC# moquery -c fvnsRtVlanNs | grep lc_vlan_pool
dn : uni/infra/vlanns-[lc_pool]-dynamic/rtinfraVlanNs-[uni/phys-lc_phys_dom]
交換矩陣>訪問策略>策略>全域性> AAEP > lc_AAEP:
APIC# moquery -c infraRsDomP | grep lc_AAEP
dn : uni/infra/attentp-lc_AAEP/rsdomP-[uni/phys-lc_phys_dom]
Fabric > Access Policies > Interfaces > Leaf Interfaces > Policy Groups > Leaf Access Port > lc_IPG:
[+] IPG與AAEP的關聯:
APIC# moquery -c infraRsAttEntP | grep -A 15 lc_IPG | grep tDn
tDn : uni/infra/attentp-lc_AAEP
Fabric > Access Policies > Interfaces > Leaf Interfaces > Profiles > leaf103_IP:
APIC# moquery -c infraHPortS | grep leaf103_IP
dn : uni/infra/accportprof-leaf103_IP/hports-lc_Interface_Selector-typ-range
Fabric > Access Policies > Interfaces > Leaf Interfaces > Profiles > leaf103_IP > lc_Interface_Selector:
[+] IPG與介面選擇器關聯:
APIC# moquery -c infraRsAccBaseGrp | grep -B 15 lc_IPG | grep dn
dn : uni/infra/accportprof-lead103_IP/hports-lc_Interface_Selector-typ-range/rsaccBaseGrp
Fabric > Access Policies > Switches > Leaf Switches > Profiles > leaf103_SP:
[+]枝葉介面配置檔案與交換機配置檔案關聯:
APIC# moquery -c infraRsAccPortP | grep leaf103_IP | grep dn
dn : uni/infra/nprof-leaf103_SP/rsaccPortP-[uni/infra/accportprof-leaf103_IP]
[+]交換機配置檔案與交換機配置式組關聯:
APIC# moquery -c infraRsAccNodePGrp | grep -A 8 leaf103_SP | grep tDn
tDn : uni/infra/funcprof/accnodepgrp-leaf103_SPG
可以根據所關心的VLAN封裝過濾對fvIcConn類的查詢,以顯示部署VLAN的每個EPG/交換機/介面組合。
APIC# moquery -c fvIfConn -f 'fv.IfConn.encap=="vlan-420"' | grep dn
dn : uni/epp/fv-[uni/tn-lc_TN/ap-lc_APP/epg-lc_EPG]/node-103/stpathatt-[eth1/13]/conndef/conn-[vlan-420]-[0.0.0.0]
在任何交換機上運行show vlan extended,以檢查交換機上當前部署的VLAN,以及VLAN所繫結的EPG和介面。
encap-id xx過濾器在ACI版本4.2及更高版本中可用。
Node-103# show vlan encap-id 420 extended
VLAN Name Encap Ports
---- -------------------------------- ---------------- ------------------------
2 lc_TN:lc_APP:lc_EPG vlan-420 Eth1/13
ACI交換器節點中的每個VLAN都會對映到某個平台獨立(PI)VLAN,這是每個交換器節點的本地值。
接入封裝對映到名為「FD VLAN」的PI VLAN,而網橋域對映到名為「BD VLAN」的PI Vlan。
在交換機上運行show system internal epm vlan all,以顯示枝葉上部署的vlan清單。
Node-103# show vlan extended | egrep "Encap|----|1/13"
VLAN Name Encap Ports
---- -------------------------------- ---------------- ------------------------
2 lc_TN:lc_APP:lc_EPG vlan-420 Eth1/13 --> FD vlan 2
18 lc_TN:lc_BD vxlan-16416666 Eth1/13 --> BD vlan 18
可以使用show interface指令驗證FD vlan和BD vlan到介面的規劃:
Node-103# show interface eth 1/13 trunk | grep -A 2 Allowed
Port Vlans Allowed on Trunk
-----------------------------------------------------------------------------------
Eth1/13 2,18
如果使用BD SVI驗證第3層VLAN,則使用moquery class fvSubnet獲取子網的IP地址:
APIC# moquery -c fvSubnet | grep lc_BD
dn : uni/tn-lc_TN/BD-lc_BD/subnet-[10.10.10.254/24]
然後再次檢查show ip interface brief ,檢查匹配的IP地址以驗證VLAN和預期的VRF。
在本示例中,驗證來自上一個CLI輸出示例的「BD VLan 18」:
Node-103# show ip interface brief
...
IP Interface Status for VRF "lc_TN:lc_VRF"(16)
Interface Address Interface Status
vlan18 10.10.10.254/24 protocol-up/link-up/admin-up
此高級序列彙總了從VLAN靜態路徑API呼叫到交換機節點VLAN部署所涉及的步驟。
此方框圖顯示了訪問策略之間的關係,以確保成功部署交換機節點VLAN。
實際上,每個網路工程師都一直在研究訪問策略的想法;只有它們通過獨立裝置的CLI介面被定義為檔案中的文本。
當出現故障F0467時,首先瞭解訪問策略並確保正確配置這些策略非常重要。
每個命令輸出都提供一個變數,用於清單中的下一個命令。
本文檔中引用了這些命令來排除不同方案的故障。
節點 | 指令 | 目的 |
APIC | moquery -c faultInst -f 'fault.Inst.code=="F0467"' | 列出交換矩陣中當前處於活動狀態的所有F0467故障 |
moquery -c l2RtDomIfConn | grep <epg_name> | grep dn | 顯示與特定epg關聯的靜態/動態路徑。 | |
moquery -c fvRsDomAtt | grep -A 25<epg_name> | grep rn | 顯示與EPG關聯的域 | |
moquery -c infraRsVlanNs | grep -A 15 <dom_name> | grep tDn | 顯示與域關聯的vlan池名稱。域名是從上一個命令提取的 | |
moquery -c fvnsEncapBlk | grep <vlan_pool_name> | 顯示與特定vlan池關聯的vlan編號 | |
moquery -c infraRtDomP | grep <dom_name> | 顯示與域關聯的AEP | |
moquery -c infraRtAttEntP | grep <AEP_name> | 顯示與域關聯的介面配置檔案組(IPG) | |
moquery -c infraRsAccBaseGrp | grep -B 15 <IPG名稱> | grep dn | 顯示介面配置檔案組(IPG)與介面選擇器的關聯 | |
moquery -c infraRsAccPortP | grep <Interface_Sector> | grep dn | 顯示介面配置檔案與交換機配置檔案的關聯 | |
moquery -c fvIfConn -f 'fv.IfConn.encap=="<encap_vlan>"' | grep dn | 顯示交換矩陣上部署特定封裝VLAN的所有介面 | |
moquery -c fvnsRtVlanNs | grep <vlan_pool_name> | | grep dn | 顯示與VLAN池關聯的域 | |
moquery -c fv子網 | grep <BD_name> | 顯示與域關聯的svi IP | |
交換器 | show vlan encap-id <encap_vlan> extended | 顯示PI VLAN和租戶、應用配置檔案和EPG名稱的詳細資訊 |
show vlan extended | egrep "Encap|----|<埠:示例1/13>" | 顯示特定埠上VLAN的詳細資訊。 | |
show int eth <port> trunk | grep -A 2允許 | 顯示在特定埠上轉發的vlan。請注意,VLAN編號是內部VLAN編號。 | |
show ip int bri vrf <vrf> | 顯示為特定vrf部署的第3層介面 | |
show vpc brief | 顯示此交換機是VPC對的一部分時的vpc相關資訊。 |
修訂 | 發佈日期 | 意見 |
---|---|---|
2.0 |
21-Nov-2024 |
替代文字、格式設定、一些拼寫錯誤、標題錯誤、縮短標題 |
1.0 |
14-Sep-2023 |
初始版本 |