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 (deprecated)¶
Attention
interfaceConfiguration 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 (deprecated) (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
interface (deprecated)¶
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 (deprecated)¶
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 (deprecated)¶
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 (deprecated)¶
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 (deprecated)¶
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 (deprecated)¶
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
interface¶
Interface configuration on which to listen to DHCPv4 queries.
vsr running config# vrf <vrf> dhcp relay interface <interface>
|
An interface name. |
enabled¶
Enable or disable DHCP relay for this interface.
vsr running config# vrf <vrf> dhcp relay interface <interface>
vsr running interface <interface># enabled true|false
- Default value
true
dhcp-server (mandatory)¶
IP address of DHCP server to which DHCP queries should be relayed.
vsr running config# vrf <vrf> dhcp relay interface <interface>
vsr running interface <interface># dhcp-server DHCP-SERVER
|
An IPv4 address. |
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 interface <interface>
vsr running interface <interface># 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 interface <interface>
vsr running interface <interface># 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 interface <interface>
vsr running interface <interface># 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 interface <interface>
vsr running interface <interface># max-size <64-1400>
agent-information¶
DHCP relay agent information configuration.
vsr running config# vrf <vrf> dhcp relay interface <interface> agent-information
enabled¶
Enable DHCP relay agent information. By default, only the circuit-id containing the interface name is inserted.
vsr running config# vrf <vrf> dhcp relay interface <interface> agent-information
vsr running agent-information# enabled true|false
- Default value
true
circuit-id¶
Custom Agent Circuit ID DHCP Option 82.1 to append when relaying the DHCP packets to the DHCP servers. It identifies the interface towards the DHCP client.
vsr running config# vrf <vrf> dhcp relay interface <interface> agent-information
vsr running agent-information# circuit-id <string>
link-selection¶
Link Selection DHCP Option 82.5 to append when relaying the DHCP packets to the DHCP servers. It provides the DHCP servers with the IP address of the interface.
vsr running config# vrf <vrf> dhcp relay interface <interface> agent-information
vsr running agent-information# link-selection LINK-SELECTION
|
Description |
|---|---|
|
Set the Link-Selection to the IP address of this interface. The giaddr (relay agent Gateway IP address) and the Link-Selection will have the same value. |
|
An IPv4 address. |
remote-id¶
Agent Remote ID DHCP Option 82.2 to append when relaying the DHCP packets to the DHCP servers. It identifies the remote end device.
vsr running config# vrf <vrf> dhcp relay interface <interface> agent-information remote-id
global¶
Custom Agent Remote ID DCHP Option 82.2 value to append when relaying DHCP packets to the DHCP servers. Because this value applies globally to all remote devices behind the interface, it does not comply with RFC3046. However, it does ensure compatibility with certain DHCP implementations.
vsr running config# vrf <vrf> dhcp relay interface <interface> agent-information remote-id
vsr running remote-id# global <string>
counters (state only)¶
Statistics for DHCP relay.
discover (state only)¶
Number of DHCP discover messages.
vsr> show state vrf <vrf> dhcp relay interface <interface> counters discover
offer (state only)¶
Number of DHCP offer messages.
vsr> show state vrf <vrf> dhcp relay interface <interface> counters offer
request (state only)¶
Number of DHCP request messages.
vsr> show state vrf <vrf> dhcp relay interface <interface> counters request
decline (state only)¶
Number of DHCP decline messages.
vsr> show state vrf <vrf> dhcp relay interface <interface> counters decline
ack (state only)¶
Number of DHCP ack messages.
vsr> show state vrf <vrf> dhcp relay interface <interface> counters ack
nack (state only)¶
Number of DHCP nack messages.
vsr> show state vrf <vrf> dhcp relay interface <interface> counters nack
release (state only)¶
Number of DHCP release messages.
vsr> show state vrf <vrf> dhcp relay interface <interface> counters release
inform (state only)¶
Number of DHCP inform messages.
vsr> show state vrf <vrf> dhcp relay interface <interface> counters inform
boot-request (state only)¶
Number of BOOTP BOOTREQUEST messages.
vsr> show state vrf <vrf> dhcp relay interface <interface> counters boot-request
boot-reply (state only)¶
Number of BOOTP BOOTREPLY messages.
vsr> show state vrf <vrf> dhcp relay interface <interface> 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 interface <interface> dhcp-server-leases <dhcp-server-leases> starts
ends (state only)¶
Lease end time.
vsr> show state vrf <vrf> dhcp relay interface <interface> 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 interface <interface> 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 interface <interface> 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 interface <interface> dhcp-server-leases <dhcp-server-leases> client-hostname
binding-state (state only)¶
Lease’s binding state.
vsr> show state vrf <vrf> dhcp relay interface <interface> 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 interface <interface> 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 interface <interface> 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 interface <interface> 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 interface <interface> dhcp-server-leases <dhcp-server-leases> vendor-class-identifier