relay

DHCP relay configuration.

vrouter running config# vrf <vrf> dhcp relay

enabled

Enable/Disable DHCP relay on this VRF.

vrouter running config# vrf <vrf> dhcp relay
vrouter running relay# enabled true|false
Default value
true

handle-option

Handling of DHCPv4 packets that already contain relay agent options.

vrouter running config# vrf <vrf> dhcp relay
vrouter running relay# handle-option HANDLE-OPTION
HANDLE-OPTION values Description
append Append our own set of relay options to the packet, leaving the supplied option field intact.
replace Replace the existing agent option field.
forward Forward the packet unchanged.
discard Discard the packet.
Default value
append

drop-unmatched

If true, drop packets from upstream servers if they were generated in response to a different relay agent.

vrouter running config# vrf <vrf> dhcp relay
vrouter running relay# drop-unmatched true|false
Default value
false

hop-count

Maximum hop count before packets are discarded.

vrouter running config# vrf <vrf> dhcp relay
vrouter running relay# hop-count <0-255>
Default value
10

max-size

Maximum packet size to send to a DHCPv4 server. If a DHCP packet size surpasses this value it will be forwarded without appending relay agent information.

vrouter running config# vrf <vrf> dhcp relay
vrouter running relay# max-size <64-1400>
Default value
576

dhcp-server

Configuration of DHCP server to which DHCP queries should be relayed.

vrouter running config# vrf <vrf> dhcp relay dhcp-server <dhcp-server>
<dhcp-server> An IPv4 address.

enabled

Enable/Disable DHCP relay for this server.

vrouter running config# vrf <vrf> dhcp relay dhcp-server <dhcp-server>
vrouter running dhcp-server <dhcp-server># enabled true|false
Default value
true

interface

Interface(s) on which to listen to DHCPv4 queries. If ommitted, DHCP relay will listen on all broadcast interfaces.

vrouter running config# vrf <vrf> dhcp relay dhcp-server <dhcp-server>
vrouter running dhcp-server <dhcp-server># interface INTERFACE
INTERFACE An interface name.

handle-option

Handling of DHCPv4 packets that already contain relay agent options. Override the matching option in root context.

vrouter running config# vrf <vrf> dhcp relay dhcp-server <dhcp-server>
vrouter running dhcp-server <dhcp-server># handle-option HANDLE-OPTION
HANDLE-OPTION values Description
append Append our own set of relay options to the packet, leaving the supplied option field intact.
replace Replace the existing agent option field.
forward Forward the packet unchanged.
discard Discard the packet.

drop-unmatched

If true, drop packets from upstream servers if they were generated in response to a different relay agent. Override the matching option in root context.

vrouter running config# vrf <vrf> dhcp relay dhcp-server <dhcp-server>
vrouter running dhcp-server <dhcp-server># drop-unmatched true|false

hop-count

Maximum hop count before packets are discarded. Override the matching option in root context.

vrouter running config# vrf <vrf> dhcp relay dhcp-server <dhcp-server>
vrouter running dhcp-server <dhcp-server># hop-count <0-255>

max-size

Maximum packet size to send to a DHCPv4 server. If a DHCP packet size surpasses this value it will be forwarded without appending relay agent information. Override the matching option in root context.

vrouter running config# vrf <vrf> dhcp relay dhcp-server <dhcp-server>
vrouter running dhcp-server <dhcp-server># max-size <64-1400>

address (state only)

IP address of DHCP server to which DHCP queries should be relayed.

vrouter> show state vrf <vrf> dhcp relay dhcp-server <dhcp-server> address