本文档介绍补救ACI故障F0467的后续步骤:invalid-vlan、invalid-path或encap-already-in-use。
ACI故障F0467会在不同的场景中标记,但显示每个故障的具体原因。
最常见的原因是出现ACI故障F0467时看到的值:
ACI故障F0467的所有原因都可能影响交换机节点接口上的vlan部署。
此故障作为主动ACI活动的一部分进行主动监控。
如果您有连接Intersight的ACI交换矩阵,则会代表您生成服务请求,以指示在Insight Connected 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池引用突出显示:

1.将缺少的vlan 421添加到特定vlan范围。
2. 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]

1.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 >>
2.修复:包括缺少的VLAN关联:

当在没有相应的访问策略允许正确应用配置的情况下进行交换机/端口/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]
如果给定静态路径配置而缺少任何相关的必需访问策略,则会出现无效路径原因。逐跳了解潜在原因,以验证访问策略:

1. Fabric > Access Policies > Policies > Global > AAEP > lc_AAEP:

[+] EPG关联策略的静态路径为空:
APIC# moquery -c l2RtDomIfConn | grep lc_EPG | grep dn
<< EMPTY >>
[+]域与AAEP的关联:
APIC# moquery -c infraRtDomP | grep lc_phys_dom
<< EMPTY >>
2.修复:Vlan池与封装和域关联(Fabric > Access Policies > Pool > VLAN > lc_vlan_pool)


1.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 >>
2.修复:缺少AAEP到IPG的关联

[+] IPG与AAEP关联
APIC# moquery -c infraRsAttEntP | grep -A 15 lc_IPG | grep tDn
tDn : uni/infra/attentp-lc_AAEP

1.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 >>
2.修复:接口选择器与接口策略组关联

[+]与接口选择器的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

1.Fabric > Access Policies > Interfaces > Leaf Interfaces > Profiles > leaf103_IP:

故障排除:
APIC# moquery -c infraHPortS | grep leaf103_IP
<< EMPTY >>
2.修复:接口配置文件与接口选择器关联:

APIC# moquery -c infraHPortS | grep leaf103_IP
dn : uni/infra/accportprof-leaf103_IP/hports-lc_Interface_Selector-typ-range

1.交换矩阵>访问策略>交换机>枝叶交换机>配置文件>枝叶103_SP

APIC# moquery -c infraRsAccPortP | grep leaf103_IP | grep dn
<< EMPTY >>
2.修复:枝叶配置文件与接口选择器配置文件关联:

[+]接口配置文件与交换机配置文件的关联:
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的任何尝试都会导致encap-already-in-use F467故障。
EPG到以下位置的故障关联: 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版本开始,您可以在Per Port VLAN配置指南中的给定枝叶交换机(或FEX)上部署具有相同VLAN封装的多个EPG:
本部分可用作功能设置完整配置的参考指南。
租户> 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]]
1. Fabric > Access Policies > Policies > Global > 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]
1. 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
1.交换矩阵>访问策略>池> 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]
1. Fabric > Access Policies > Policies > Global > AAEP > lc_AAEP:

APIC# moquery -c infraRsDomP | grep lc_AAEP
dn : uni/infra/attentp-lc_AAEP/rsdomP-[uni/phys-lc_phys_dom]
1. 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
1.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
1.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
1.交换矩阵>访问策略>交换机>枝叶交换机>配置文件>枝叶103_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,该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 to接口编程:
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_name> | 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 fvSubnet | grep <BD_name> |
显示与域关联的svi IP |
|
| 交换机 |
show vlan encap-id <encap_vlan> extended |
显示PI vlan和租户、应用配置文件和EPG名称的详细信息 |
| show vlan extended | egrep "Encap|----|<port:example 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相关信息。 |
| 版本 | 发布日期 | 备注 |
|---|---|---|
4.0 |
03-Sep-2026
|
更新的拼写/语法、插入水平线以分隔各部分的可读性、更新的备用文本和固定的CCW警报。 |
3.0 |
30-Nov-2024
|
已更正标题。 |
2.0 |
21-Nov-2024
|
替换文本、格式设置、一些拼写错误、标题错误、缩写标题 |
1.0 |
14-Sep-2023
|
初始版本 |