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

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.

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

Deprecated since: 2024-07-26
Obsolete in release: 25q1
Description: Replaced by an interface config with a list of dhcp server.
Replacement: interface

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

vsr running config# vrf <vrf> dhcp relay dhcp-server <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

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

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

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 (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>

<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

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

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.

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>

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