relay¶
DHCP relay configuration.
vsr running config# vrf <vrf> dhcp relay
enabled (pushed)¶
Enable/Disable DHCP relay on this VRF.
vsr running config# vrf <vrf> dhcp relay
vsr running relay# enabled true|false
- Default value
true
handle-option¶
Handling of DHCPv4 packets that already contain relay agent options.
vsr running config# vrf <vrf> dhcp relay
vsr running relay# handle-option HANDLE-OPTION
|
Description |
|---|---|
|
Append our own set of relay options to the packet, leaving the supplied option field intact. |
|
Replace the existing agent option field. |
|
Forward the packet unchanged. |
|
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.
vsr running config# vrf <vrf> dhcp relay
vsr running relay# drop-unmatched true|false
- Default value
false
hop-count¶
Maximum hop count before packets are discarded.
vsr running config# vrf <vrf> dhcp relay
vsr 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.
vsr running config# vrf <vrf> dhcp relay
vsr running relay# max-size <64-1400>
- Default value
576
dhcp-server¶
Configuration of DHCP server to which DHCP queries should be relayed.
vsr running config# vrf <vrf> dhcp relay dhcp-server <dhcp-server>
|
An IPv4 address. |
enabled (pushed)¶
Enable/Disable DHCP relay for this server.
vsr running config# vrf <vrf> dhcp relay dhcp-server <dhcp-server>
vsr 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.
vsr running config# vrf <vrf> dhcp relay dhcp-server <dhcp-server>
vsr running dhcp-server <dhcp-server># interface INTERFACE
|
An interface name. |
server-interface¶
Interface used for communication between this relay and the DHCP server. If omitted, and if the relay and server are on the same IP network, an appropriate value will be auto-detected.
vsr running config# vrf <vrf> dhcp relay dhcp-server <dhcp-server>
vsr running dhcp-server <dhcp-server># server-interface SERVER-INTERFACE
|
An interface name. |
handle-option¶
Handling of DHCPv4 packets that already contain relay agent options. Override the matching option in root context.
vsr running config# vrf <vrf> dhcp relay dhcp-server <dhcp-server>
vsr running dhcp-server <dhcp-server># handle-option HANDLE-OPTION
|
Description |
|---|---|
|
Append our own set of relay options to the packet, leaving the supplied option field intact. |
|
Replace the existing agent option field. |
|
Forward the packet unchanged. |
|
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.
vsr running config# vrf <vrf> dhcp relay dhcp-server <dhcp-server>
vsr 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.
vsr running config# vrf <vrf> dhcp relay dhcp-server <dhcp-server>
vsr 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.
vsr running config# vrf <vrf> dhcp relay dhcp-server <dhcp-server>
vsr running dhcp-server <dhcp-server># max-size <64-1400>
counters (state only)¶
Statistics for DHCP relay.
discover (state only)¶
Number of DHCP discover messages.
vsr> show state vrf <vrf> dhcp relay dhcp-server <dhcp-server> counters discover
offer (state only)¶
Number of DHCP offer messages.
vsr> show state vrf <vrf> dhcp relay dhcp-server <dhcp-server> counters offer
request (state only)¶
Number of DHCP request messages.
vsr> show state vrf <vrf> dhcp relay dhcp-server <dhcp-server> counters request
decline (state only)¶
Number of DHCP decline messages.
vsr> show state vrf <vrf> dhcp relay dhcp-server <dhcp-server> counters decline
ack (state only)¶
Number of DHCP ack messages.
vsr> show state vrf <vrf> dhcp relay dhcp-server <dhcp-server> counters ack
nack (state only)¶
Number of DHCP nack messages.
vsr> show state vrf <vrf> dhcp relay dhcp-server <dhcp-server> counters nack
release (state only)¶
Number of DHCP release messages.
vsr> show state vrf <vrf> dhcp relay dhcp-server <dhcp-server> counters release
inform (state only)¶
Number of DHCP inform messages.
vsr> show state vrf <vrf> dhcp relay dhcp-server <dhcp-server> counters inform
boot-request (state only)¶
Number of BOOTP BOOTREQUEST messages.
vsr> show state vrf <vrf> dhcp relay dhcp-server <dhcp-server> counters boot-request
boot-reply (state only)¶
Number of BOOTP BOOTREPLY messages.
vsr> show state vrf <vrf> dhcp relay dhcp-server <dhcp-server> counters boot-reply
dhcp-server-leases (state only)¶
State of leases for DHCP server.
starts (state only)¶
Lease start time.
vsr> show state vrf <vrf> dhcp relay dhcp-server <dhcp-server> dhcp-server-leases <dhcp-server-leases> starts
ends (state only)¶
Lease end time.
vsr> show state vrf <vrf> dhcp relay dhcp-server <dhcp-server> dhcp-server-leases <dhcp-server-leases> ends
hw-mac-address (state only)¶
MAC address of the network interface on which the lease will be used.
vsr> show state vrf <vrf> dhcp relay dhcp-server <dhcp-server> dhcp-server-leases <dhcp-server-leases> hw-mac-address
uid (state only)¶
Client identifier used by the client to acquire the lease.
vsr> show state vrf <vrf> dhcp relay dhcp-server <dhcp-server> dhcp-server-leases <dhcp-server-leases> uid
client-hostname (state only)¶
Client host name sent using client-hostname statement.
vsr> show state vrf <vrf> dhcp relay dhcp-server <dhcp-server> dhcp-server-leases <dhcp-server-leases> client-hostname
binding-state (state only)¶
Lease’s binding state.
vsr> show state vrf <vrf> dhcp relay dhcp-server <dhcp-server> dhcp-server-leases <dhcp-server-leases> binding-state
next-binding-state (state only)¶
State the lease will move to when the current state expires.
vsr> show state vrf <vrf> dhcp relay dhcp-server <dhcp-server> dhcp-server-leases <dhcp-server-leases> next-binding-state
option-agent-circuit-id (state only)¶
Circuit ID option sent by the relay agent.
vsr> show state vrf <vrf> dhcp relay dhcp-server <dhcp-server> dhcp-server-leases <dhcp-server-leases> option-agent-circuit-id
option-agent-remote-id (state only)¶
Remote ID option sent by the relay agent.
vsr> show state vrf <vrf> dhcp relay dhcp-server <dhcp-server> dhcp-server-leases <dhcp-server-leases> option-agent-remote-id
vendor-class-identifier (state only)¶
Client-supplied Vendor Class Identifier option.
vsr> show state vrf <vrf> dhcp relay dhcp-server <dhcp-server> dhcp-server-leases <dhcp-server-leases> vendor-class-identifier