Problemen oplossen met DHCP-relais in ACI met lokale eindpunten

Inleiding

Dit document beschrijft de probleemoplossing van DHCP Relay in ACI Fabrics.

Afkortingen

• BD: Bridge-domein
• EPG: Eindpuntgroep
• ExEPG: externe eindpuntgroep
• VRF: Virtuele routering en doorsturen
• Klasse-ID of pcTag: tag die een EPG identificeert
• DHCP: Dynamic Host Configuration Protocol
• SVI: geschakelde virtuele interface

Vereisten

Voor dit artikel is het aan te raden dat je algemene kennis hebt van deze onderwerpen:

• DHCP concepten en workflow (DORA proces)
• ACI-concepten: toegangsbeleid, eindpuntleren, contracten en L3out
• Het DHCP-relaybeleid moet al zijn gemaakt

Gebruikte componenten

Deze probleemoplossingsoefening werd gemaakt op ACI versie 6.0 (8f) met behulp van de tweede generatie Nexus-switches N9K-C93180YC-EX en N9K-C93240YC-FX2.

Alle opdrachten in dit artikel werden uitgevoerd in een laboratoriumomgeving en met behulp van RFC1819 voor IP-adressering. Als uw netwerk live is, zorg er dan voor dat u de potentiële impact van een opdracht begrijpt en zorg ervoor dat u de opdracht in kwestie afstemt op uw specifieke behoeften.

De informatie in dit document is gebaseerd op de apparaten in een specifieke laboratoriumomgeving. Alle apparaten die in dit document worden beschreven, hadden een opgeschoonde (standaard)configuratie. Als uw netwerk live is, moet u zorgen dat u de potentiële impact van elke opdracht begrijpt.

Aanbevelingen voor probleemoplossing

Eindpuntleren

Als de eindpunten niet zijn aangeleerd, valideert u het statische poortbeleid, zoals switch-, interface- en VLAN-configuraties. Bevestig voor virtuele servers dat de poortgroep correct is geïmplementeerd en aan de VM is toegewezen.

Beleidsimplementatie

Zorg ervoor dat het DHCP Relay Policy (dhcpRelayP) en het DHCP Relay Label (dhcpLbl) correct zijn geconfigureerd en worden gebruikt door het juiste Bridge Domain (BD). Eigendomsregels voor etiketteringsbeleid zijn:

• Eigendom van de gebruiker: alleen die huurder kan het beleid gebruiken
• Gezamenlijk huurderseigendom: Alle huurders kunnen het beleid gebruiken, maar de DHCP-server moet worden geleerd op een gemeenschappelijke EPG
• Eigendom van infra-tenant: alle huurders kunnen het beleid gebruiken en de DHCP-server kan overal in de fabric worden geleerd

Als de onderliggende klasse dhcpRtLblDefToRelayP ontbreekt onder het bovenliggende beleid van dhcpRelayP, wordt het relaybeleid niet door BD gebruikt en zijn corrigerende maatregelen vereist.

Bereikbaarheid host

De DHCP-client moet bereikbaar zijn vanaf de SVI van de BD. Indien onbereikbaar, controleer contracten en routeringsconfiguraties om connectiviteit te garanderen.

Eindpunt leren en routeren

Zorg ervoor dat de DHCP-server bereikbaar is vanaf de SVI van het Bridge-domein waar de client zich bevindt. 

iping -V [ tenant : VRF ] -S [ SVI IP of the Client ] [ DHCP server IP]

Leaf101# iping -V tz:VRF1 -S 172.16.19.1 172.16.18.100
PING 172.16.18.100 (172.16.18.100) from 172.16.19.1: 56 data bytes
64 bytes from 172.16.18.100: icmp_seq=0 ttl=64 time=0.912 ms
64 bytes from 172.16.18.100: icmp_seq=1 ttl=64 time=0.706 ms
64 bytes from 172.16.18.100: icmp_seq=2 ttl=64 time=0.643 ms
64 bytes from 172.16.18.100: icmp_seq=3 ttl=64 time=0.689 ms
64 bytes from 172.16.18.100: icmp_seq=4 ttl=64 time=0.717 ms

--- 172.16.18.100 ping statistics ---
5 packets transmitted, 5 packets received, 0.00% packet loss
round-trip min/avg/max = 0.643/0.733/0.912 ms

Zowel DHCP-clients als DHCP-servers moeten worden aangeleerd als eindpunten wanneer ze onder een EPG worden geconfigureerd. Om te valideren dat deze eindpunten correct zijn geleerd, kunt u de tabel met eindpuntmanagers in het blad controleren. 

show system internal epm endpoint [ip | mac] [ DHCP server IP | DHCP client MAC]

Leaf101# show system internal epm endpoint ip 172.16.18.100

MAC : 0050.56b7.80cf ::: Num IPs : 1
IP# 0 : 172.16.18.100 ::: IP# 0 flags : ::: l3-sw-hit: No
Vlan id : 12 ::: Vlan vnid : 8535 ::: VRF name : tz:VRF1
BD vnid : 15400880 ::: VRF vnid : 2981888
Phy If : 0x1a02c000 ::: Tunnel If : 0
Interface : Ethernet1/45
Flags : 0x80004c04 ::: sclass : 16402 ::: Ref count : 5
EP Create Timestamp : 09/11/2025 17:37:15.158380
EP Update Timestamp : 09/11/2025 19:17:41.261985
EP Flags : local|IP|MAC|sclass|timer|

::::

•••

Leaf101# show system internal epm endpoint mac 0050.56b7.33ee

MAC : 0050.56b7.33ee ::: Num IPs : 0
Vlan id : 25 ::: Vlan vnid : 8494 ::: VRF name : tz:VRF1
BD vnid : 15630228 ::: VRF vnid : 2981888
Phy If : 0x1a02c000 ::: Tunnel If : 0
Interface : Ethernet1/45
Flags : 0x80004804 ::: sclass : 32780 ::: Ref count : 4
EP Create Timestamp : 09/11/2025 17:33:36.158122
EP Update Timestamp : 09/11/2025 19:17:41.258478
EP Flags : local|MAC|sclass|timer|

::::

Beleidsvalidatie

Bij het valideren van een DHCP Relay-beleid kunnen deze belangrijke kenmerken worden bevestigd:

• Naam: De ID van het DHCP-relaybeleid.
• Eigenaar: de huurder waaronder het beleid is geconfigureerd, met vermelding van de zichtbaarheid reikwijdte beperkt tot die huurder.
• Adres: Het IP-adres van de DHCP-server waarnaar DHCP-verzoeken worden doorgestuurd.
• Locatie van de DHCP-server: gevalideerd door middel van tags zoals epgDn, bdDefDn en ctxDefDn om een correcte koppeling met de EPG, bridge domain en VRF te garanderen.
• Staat van het beleid: het beleid moet in een gevormde staat zijn, wat aangeeft dat het correct is geïmplementeerd en actief is in de structuur.

Deze validatie wordt uitgevoerd door moquery's op de APIC uit te voeren om te bevestigen dat het DHCP-relaybeleid correct is gemaakt, gekoppeld aan de juiste huurders en correct is gekoppeld aan de relevante brugdomeinen. Deze stap helpt misconfiguraties vroegtijdig te identificeren en voorkomt DHCP-relayfouten die worden veroorzaakt door ontbrekende of onjuiste beleidsimplementatie.

moquery -c dhcpRelayP -f 'dhcp.RelayP.dn*"[ tenant name ].*[ DHCP Relay Policy name ]"' -x rsp-subtree=children

APIC# moquery -c dhcpRelayP -f 'dhcp.RelayP.dn*"tz.*Relay"' -x rsp-subtree=children
Total Objects shown: 1

# dhcp.RelayP
name : tz-DHCP_Relay
<-- cut for brevity-->
dn : uni/tn-tz/relayp-tz-DHCP_Relay
<-- cut for brevity-->
owner : tenant
<-- cut for brevity-->
rn : relayp-tz-DHCP_Relay

# dhcp.ProvDhcp
epgDn : uni/tn-tz/ap-AP1/epg-EPG1
addr : 172.16.18.100
bdDefDn : uni/bd-[uni/tn-tz/BD-BD1]-isSvc-no
<-- cut for brevity-->
ctxDefDn : uni/ctx-[uni/tn-tz/ctx-VRF1]
ctxDefStQual : none
ctxSeg : 2981888
descr : 
dn : uni/tn-tz/relayp-tz-DHCP_Relay/provdhcp-[uni/tn-tz/ap-AP1/epg-EPG1]
l3CtxEncap : vxlan-2981888
<-- cut for brevity-->
name : EPG1
<-- cut for brevity-->
pcTag : 16402
<-- cut for brevity-->

# dhcp.RsProv
tDn : uni/tn-tz/ap-AP1/epg-EPG1
addr : 172.16.18.1
<-- cut for brevity-->
state : formed

Zodra een DHCP-relaybeleid is gekoppeld aan het Bridge Domain (BD) van de client, wordt automatisch een corresponderend DHCP-labelbeleid gemaakt. Dit DHCP-labelbeleid fungeert als een koppeling tussen het DHCP-relaybeleid en de BD, waardoor de relayfunctionaliteit mogelijk wordt.

U kunt het DHCP-labelbeleid controleren met de APIC CLI met een opdracht zoals:

moquery -c dhcpLbl -f 'dhcp.Lbl.dn*"[ tenant ].*[ DHCP Relay Policy name]"'

APIC# moquery -c dhcpLbl -f 'dhcp.Lbl.dn*"tz.*Relay"'
Total Objects shown: 1

# dhcp.Lbl
name : tz-DHCP_Relay
annotation : 
childAction : 
descr : 
dn : uni/tn-tz/BD-BD2/dhcplbl-tz-DHCP_Relay
extMngdBy : 
lcOwn : local
modTs : 2025-09-11T16:30:03.016+00:00
monPolDn : uni/tn-common/monepg-default
nameAlias : 
owner : tenant
ownerKey : 
ownerTag : 
rn : dhcplbl-tz-DHCP_Relay
status : modified
tag : yellow-green
uid : 15374
userdom : :all:

Hiermee wordt het object DHCP Label weergegeven dat is gekoppeld aan de BD.

Als het DHCP-relaybeleid correct is geconfigureerd, krijgt het een onderliggend object waar het DHCP-label wordt verbruikt, dat kan worden geverifieerd met:

APIC# moquery -c dhcpRelayP -f 'dhcp.RelayP.dn*"tz.*Relay"' -x rsp-subtree=children rsp-subtree-class=dhcpRtLblDefToRelayP
Total Objects shown: 1

# dhcp.RelayP
name : tz-DHCP_Relay
annotation : 
childAction : 
descr : 
dn : uni/tn-tz/relayp-tz-DHCP_Relay
extMngdBy : 
lcOwn : local
modTs : 2025-09-11T16:10:56.421+00:00
mode : visible
monPolDn : uni/tn-common/monepg-default
nameAlias : 
owner : tenant
ownerKey : 
ownerTag : 
rn : relayp-tz-DHCP_Relay
status : modified
uid : 15374
userdom : :all:

# dhcp.RtLblDefToRelayP
tDn : uni/bd-[uni/tn-tz/BD-BD2]-isSvc-no/dhcplbldef-tz-DHCP_Relay
childAction : deleteNonPresent
dn : uni/tn-tz/relayp-tz-DHCP_Relay/rtlblDefToRelayP-[uni/bd-[uni/tn-tz/BD-BD2]-isSvc-no/dhcplbldef-tz-DHCP_Relay]
lcOwn : local
modTs : 2025-09-11T16:30:03.106+00:00
rn : rtlblDefToRelayP-[uni/bd-[uni/tn-tz/BD-BD2]-isSvc-no/dhcplbldef-tz-DHCP_Relay]
status : 
tCl : dhcpLblDef

DHCP-pakkettracering

ACI registreert alle DHCP-pakketten die naar de CPU zijn verzonden in traceringsbestanden, die kunnen worden geanalyseerd om problemen met het DHCP-proces Discover, Offer, Request en Acknowledge (DORA) op te lossen. Gebruik deze opdracht om DHCP-pakketsporen te bekijken:

show dhcp internal event-history traces

Tip: één DHCP-pakket genereert meer dan 100 traceringsitems. Het wordt ten zeerste aanbevolen om grep te gebruiken met reguliere expressies om relevante uitvoer te filteren voor een efficiënte analyse.

Tijdens de DHCP-traceeranalyse in Cisco ACI kunnen verschillende belangrijke kenmerken worden bevestigd om een goede werking van het DHCP-relais te garanderen:

• Suboptie circuit-id toevoegen:

Geeft aan dat DHCP Option 82 aan het pakket wordt toegevoegd, wat essentieel is voor informatie over de relay-agent.

• GI-adres:

Geeft het IP-adres van de DHCP-server weer dat is geconfigureerd in het relaybeleid van DHCP.

• Adres helper:

Het SVI IP-adres dat door het relais wordt gebruikt om de DHCP-server te bereiken.

• Client en server zijn in dezelfde VRF:

Bevestigt dat zowel de DHCP-client als de server tot dezelfde VRF-context behoren.

• MSG:

Het type DHCP-bericht dat is waargenomen, zoals Ontdekken, Aanbod, Aanvraag of Ack.

• CTX-naam:

De VRF-naam waarin het DHCP-labelbeleid is geconfigureerd.

• Smac:

Het MAC adres van de DHCP client.

• UDP src/dst-poort:

De gebruikte DHCP-poorten zijn doorgaans 68 voor clients en 67 voor servers.

Leaf101# show dhcp internal event-history traces | grep -A34 -B70 "00 50 56 b7 33 ee" | egrep "(Rec.*pkt.*intf|ip add|UDP|packet vlan|IfIndex|interface:|[DS]mac|ctx.*is.*:|Pkt.*ID|relay_handle.*(ifindex|msg|from.*ctx)|relayback|relay_send.*(ifindex|Client.*Server)|Adding option82|Mac addr|dhcp_get_vlan|Add.*suboption.*epg_vnid|Helper|Outgoing|gi.*is|Cross-vrf|Sending.*Server|Relaying.*DHCP)" | head -29

2) 2025 Sep 11 04:14:46.660433 _relay_handle_packet_from_pkt_mgr: 480 : Relaying the DHCP pkt on intf: Vlan24
28) 2025 Sep 11 04:14:46.659985 _relay_add_circuitid_rmtid_msiteinfo: 3354 : Add circuit id suboption: if_index: Ethernet1/45 (1a02c000) , svlan: 24, option def id: 0 epg_vnid 8529.
••
31) 2025 Sep 11 04:14:46.659934 _relay_add_option82: 3151 : Mac addr is 28:6f:7f:eb:54:9f
32) 2025 Sep 11 04:14:46.659930 _relay_add_option82: 3147 : Adding option82 suboptions
35) 2025 Sep 11 04:14:46.659924 _relay_send_packet: 1975 : gi address is 172.16.18.1
••
37) 2025 Sep 11 04:14:46.659921 _relay_send_packet: 1965 : Helper address is 172.16.18.100
38) 2025 Sep 11 04:14:46.659918 _relay_send_packet: 1956 : Client and Server are in the same VRF
39) 2025 Sep 11 04:14:46.659793 _relay_send_packet: 1898 : ifindex is Vlan24
40) 2025 Sep 11 04:14:46.659786 _relay_send_packet: 1833 : dhcp_relay_send_packet: relayback_ifindex is Ethernet1/45
••
42) 2025 Sep 11 04:14:46.659730 _relay_handle_packet_from_pkt_mgr: 447 : DHCPDISCOVER msg
43) 2025 Sep 11 04:14:46.659728 _relay_handle_packet_from_pkt_mgr: 438 : ifindex is Vlan24
••
61) 2025 Sep 11 04:14:46.657274 _snoop_handle_istack_packet: 1763 : ctx name is tz:VRF1
64) 2025 Sep 11 04:14:46.657062 _snoop_handle_istack_packet: 1751 :  Smac = [00 50 56 b7 33 ee ]
65) 2025 Sep 11 04:14:46.657057 _snoop_handle_istack_packet: 1749 : Dmac = [ff ff ff ff ff ff ];
68) 2025 Sep 11 04:14:46.657050 _snoop_handle_istack_packet: 1737 : Logical interface: Vlan24
72) 2025 Sep 11 04:14:46.657044 _snoop_handle_istack_packet: 1721 : Physical interface: Ethernet1/45
••
86) 2025 Sep 11 04:14:46.657024 _snoop_handle_istack_packet: 1669 : UDP src port 68 UDP dst port 67
88) 2025 Sep 11 04:14:46.657021 _snoop_handle_istack_packet: 1577 : destination ip address 255.255.255.255
89) 2025 Sep 11 04:14:46.657018 _snoop_handle_istack_packet: 1574 : source ip address 0.0.0.0
95) 2025 Sep 11 04:14:46.656991 _snoop_handle_istack_packet: 1533 : Received pkt on Vlan 25  intf Ethernet1/45

Veelvoorkomende problemen

Probleem 1: L3out stille daling

• Probleem

Wanneer een L3Out een vPC-interface gebruikt om een buurrelatie met een aangrenzende router te vormen, verzendt elke switch pakketten met behulp van zijn eigen vTEP. Als de vPC-peer een DHCP-aanbieding ontvangt met een vTEP-adres dat niet het zijne is, stuurt deze het pakket door de fabric, waardoor de initiator vTEP het zonder foutlogboeken stilletjes laat vallen.

Om te controleren op dergelijke druppels, gebruikt u deze opdracht:

show dhcp internal event-history traces | egrep “(failed|Drop).*packet" | head

Leaf101# show dhcp internal event-history traces | egrep "(failed|Drop).*packet" | head

53) 2025 Sep 10 04:14:26.685020 _snoop_handle_istack_packet: 1881 : Drop DHCP DISCOVER/REQUEST packet because it is for a BD SVI, and recvd from fabric facing intf.
172) 2025 Sep 10 04:14:23.792669 _snoop_handle_istack_packet: 1881 : Drop DHCP DISCOVER/REQUEST packet because it is for a BD SVI, and recvd from fabric facing intf.
239) 2025 Sep 10 04:14:22.516679 _snoop_handle_istack_packet: 1881 : Drop DHCP DISCOVER/REQUEST packet because it is for a BD SVI, and recvd from fabric facing intf.
444) 2025 Sep 10 04:14:17.055216 _snoop_handle_istack_packet: 1881 : Drop DHCP DISCOVER/REQUEST packet because it is for a BD SVI, and recvd from fabric facing intf.
563) 2025 Sep 10 04:14:14.450437 _snoop_handle_istack_packet: 1881 : Drop DHCP DISCOVER/REQUEST packet because it is for a BD SVI, and recvd from fabric facing intf.
736) 2025 Sep 10 04:14:09.056993 _snoop_handle_istack_packet: 1881 : Drop DHCP DISCOVER/REQUEST packet because it is for a BD SVI, and recvd from fabric facing intf.
803) 2025 Sep 10 04:14:07.344467 _snoop_handle_istack_packet: 1881 : Drop DHCP DISCOVER/REQUEST packet because it is for a BD SVI, and recvd from fabric facing intf.
906) 2025 Sep 10 04:14:06.290135 _snoop_handle_istack_packet: 1881 : Drop DHCP DISCOVER/REQUEST packet because it is for a BD SVI, and recvd from fabric facing intf.
1025) 2025 Sep 10 04:14:03.770388 _snoop_handle_istack_packet: 1881 : Drop DHCP DISCOVER/REQUEST packet because it is for a BD SVI, and recvd from fabric facing intf.
1094) 2025 Sep 10 04:14:03.234017 _snoop_handle_istack_packet: 1881 : Drop DHCP DISCOVER/REQUEST packet because it is for a BD SVI, and recvd from fabric facing intf.

• Oplossing

Navigeer naar Tenants > [ tenant name ] > Networking > L3outs > [ L3out name ] > Logical Node Profile > [ LNP name ] > Logical Interface Profile [ LIP name ] > SVI > [ SVI policy]

Als u daar bent, maakt of opent u het secundaire IP-adres en schakelt u het selectievakje DHCP-relais inschakelen in.

Dit zal de berichten dwingen om te worden verzonden met behulp van het vPC-adres in plaats van de lokale vTEP en pakketten worden doorgestuurd zoals verwacht.

Probleem 2: DHCP-server ondersteunt optie 82 niet

Optie 82 is van cruciaal belang in VXLAN-omgevingen zoals ACI, waarbij een circuit wordt gemaakt tussen het bronblad en de bestemming op basis van vTEP-adressen. Het omvat:

• Circuit ID: Inkomende interface, VLAN en EPG VNID waar de DHCP-detectie wordt gezien.
• Remote ID: TEP-adres van de switch die de ontdekking heeft ontvangen.

Als optie 82 ontbreekt, worden DHCP-relaypakketten verwijderd. Valideer de aanwezigheid van optie 82 op het blad dat is aangesloten op de DHCP-server door de DHCP-traceringslogs te controleren op fouten die wijzen op ontbrekende optie 82.

Met deze opdracht wordt de leaf switch gevalideerd waarmee de DCHP-server is verbonden en worden de aanbiedingen met een geldige DHCP-optie 82 ontvangen

Leaf101# show dhcp internal event-history traces | egrep “(failed|Drop).*packet" | head

67) 2025 Sep 10 05:16:52.336785 _relay_handle_packet: 1478 : dhcp_relay_handle_packet: DHCP UDP failed to relay packet back to client - Unknown error -1
68) 2025 Sep 10 05:16:52.336772 _relayback_response: 929 : dhcp_relayback_response : option 82 not present. Drop the packet
479) 2025 Sep 10 05:11:07.308085 _relay_handle_packet: 1478 : dhcp_relay_handle_packet: DHCP UDP failed to relay packet back to client - Unknown error -1
480) 2025 Sep 10 05:11:07.308073 _relayback_response: 929 : dhcp_relayback_response : option 82 not present. Drop the packet
891) 2025 Sep 10 05:10:22.312386 _relay_handle_packet: 1478 : dhcp_relay_handle_packet: DHCP UDP failed to relay packet back to client - Unknown error -1
892) 2025 Sep 10 05:10:22.312374 _relayback_response: 929 : dhcp_relayback_response : option 82 not present. Drop the packet
1303) 2025 Sep 10 05:09:37.309888 _relay_handle_packet: 1478 : dhcp_relay_handle_packet: DHCP UDP failed to relay packet back to client - Unknown error -1
1304) 2025 Sep 10 05:09:37.309874 _relayback_response: 929 : dhcp_relayback_response : option 82 not present. Drop the packet
1715) 2025 Sep 10 05:08:52.295721 _relay_handle_packet: 1478 : dhcp_relay_handle_packet: DHCP UDP failed to relay packet back to client - Unknown error -1
1716) 2025 Sep 10 05:08:52.295709 _relayback_response: 929 : dhcp_relayback_response : option 82 not present. Drop the packet

Referenties

DHCP Relay diepe probleemoplossing in ACI Fabric - TACDCN-2017