Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

show dhcp relay active-leasequery

Syntax

Description

Display information about DHCPv4 active leasequery peer relay agents.

Options

details

(Optional) Display the topology discovery translation table for the specified peer. You must also specify the peer ip-address option.

summary

(Optional) Display summary information for all active leasequery peers. The summary option produces the same output as not specifying any option. You can also specify the logical-system logical-system-name option or the routing-instance routing-instance-name option with the summary option. You cannot specify any other option with the summary option.

interface interface-name

(Optional) Display active leasequery statistics for a specific access interface. You must also specify the statistics option.

logical-system logical-system-name

(Optional) Perform this operation on the specified logical system. If you do not specify a logical system name, statistics are displayed for the default logical system.

peer ip-address

(Optional) Display information about active leasequery peer relay agents. You must also specify either the details option or the statistics option.

routing-instance routing-instance-name

(Optional) Perform this operation on the specified routing instance. If you do not specify a routing instance name, statistics are displayed for the default routing instance.

statistics

(Optional) Display active leasequery statistics for a specific active leasequery peer relay agent or a specific access interface. You must also specify either the peer ip-address option or the interface interface-name option.

Required Privilege Level

view

Output Fields

Table 1 lists the output fields for the show dhcp relay active-leasequery command. Output fields are listed in the approximate order in which they appear.

Table 1: show dhcp relay active-leasequery Output Fields

Field Name

Field Description

peer

IP address of topology discovery peer relay agent.

Connected Peers

Number of access interfaces that have completed the topology discovery process and are associated with the peer. Each interface is in the Connected state.

Connecting Peers

Number of access interfaces that are configured with topology discovery but have not completed the topology discovery process. Consequently these interfaces are not yet associated with any peer. Each interface is in the Connecting state. When topology discovery completes and the interface is associated with a peer, the state moves to Connected.

Local Circuit ID

The local access interface for the specified peer.

Remote Circuit ID

The remote access interface on another peer relay agent that corresponds to the specified peer’s local access interface.

Local Interface Address

IP address of the local access interface.

State

State of the topology discovery process.

  • Done—Topology discovery has completed for the specified peer.

Redundancy State

M:N redundancy state associated with the peer or interface.

  • Backup—The specified peer or interface is currently in backup mode. This means that the BNG hosting the relay agent is the current backup BNG for the group.

  • Master—The specified peer or interface is currently in primary mode. This means that the BNG hosting the relay agent is the current primary BNG for the group.

  • Unknown—The redundancy state of the peer or interface is unknown.

xid

Randomly generated, temporary transaction ID for the topology discovery query sent for the local access interface.

Remote ALQ Status

State of the active leasequery process.

  • Done—The active leasequery process has completed. Subscriber state and binding information has been synchronized for subscriber groups that use the local access interface.

  • Queued—The active leasequery is queued. Subscriber state and binding information are not yet synchronized/

  • Unknown—Active leasequery process state is unknown.

Interface

Name of the specified address for which statistics are displayed.

Topology-Discover Configured

Indicates whether topology discovery has been configured on the specified peer or interface, Yes or No.

Bindings Sent

Number of DHCP bindings sent based on active leasequery for the specified interface or peer.

For the interface, it’s the count of all bindings sent over the interface.

For the peer, it’s the count of all bindings sent over all interfaces that belong to the peer.

Bindings Received

Number of DHCP bindings received based on active leasequery for the specified interface or peer.

For the interface, it’s the count of all bindings received over the interface.

For the peer, it’s the count of all bindings received over all interfaces that belong to the peer.

Bindings Installed Successfully

Number of DHCP bindings successfully installed based on active leasequery for the specified interface or peer.

For the interface, it’s the count of all bindings successfully installed over the interface.

For the peer, it’s the count of all bindings successfully installed over all interfaces that belong to the peer.

Bindings Failed to Install

Number of DHCP bindings that failed to install based on active leasequery for the specified interface or peer.

For the interface, it’s the count of all bindings that failed over the interface.

For the peer, it’s the count of all bindings that failed over all interfaces that belong to the peer.

Last Synchronization Time

Time stamp for the last time synchronization for subscribers occurred for the specified interface or peer.

ALQ Transmit Buffer count

The maximum TCP received and transmitted bytes buffer for the jdhcpd process. The value is nonconfigurable and is always 65,535 (ffff).

Max Leasequery Transmit Rate

The transmit rate of bulk leasequery replies per second. It is the maximum number of bulk leasequery replies per one-second interval. The value is nonconfigurable and is always 60. For example, if 600 leases are synchronized to the peer, it takes 10 seconds to complete.

Local Interface Count

Number of local access interfaces for the specified peer or interface.

For the interface, the value is always 1.

Remote Interface Count

Number of remote access interfaces for the specified peer or interface.

For the interface, the value is always 1.

Sample Output

show dhcp relay active-leasequery (Summary)

show dhcp relay active-leasequery (IPv4 Peer Details)

show dhcp relay active-leasequery (IPv6 Peer Details)

show dhcp relay active-leasequery (Peer Details Pseudowire Interfaces)

show dhcp relay active-leasequery (Peer Statistics)

show dhcp relay active-leasequery (Interface Statistics)

Release Information

Command introduced in Junos OS Release 19.2R1.