request dhcp relay bulk-leasequery
Syntax
request dhcp relay bulk-leasequery <all-configured-ip> <client-id | ipv4-address | mac-address> <relay-id relay-id> <remote-id remote-id> <server-address server-address | server-group group-name> <logical-system logical-system-name> <routing-instance routing-instance-name>
Description
Initiate a bulk leasequery operation to update the binding information for multiple subscribers by requesting that the DHCPv4 relay agent send the bulk leasequery message to the configured DHCPv4 servers. The DHCP bulk leasequery feature must be configured on the DHCPv4 relay agent. If you do not specify a server-address or server-group, then the query is sent to all DHCPv4 servers known to the relay agent.
Options
By default, the bulk leasequery operation uses the relay ID of the DHCPv4 relay agent if you do not explicitly specify any of the following options: client-id, ipv4-address, mac-address, relay-id, or remote-id.
| all-configured-ip | Update binding information for all IP addresses configured in the local server. The information is returned regardless of whether the IP addresses are part of a currently active binding and regardless of remote Id or relay ID. This enables the relay agent to update its database with all address changes that occurred after some point in time. |
| client-id | Update binding information for clients identified by the specified DHCPv4 client option (option 61). |
| ipv4-address | Update binding information for the most recent client that was assigned that IP address. |
| logical-system logical-system-name | Specify an optional logical system for the DHCP server being queried. The default logical system is used by default. |
| mac-address | Update binding information for the most recent client that has that MAC address. |
| relay-id relay-id | Update binding information for all currently active leases assigned to the client that has the specified Relay Agent Identifier suboption (suboption 12) of the DHCP relay agent information option (option 82). Suboption 12 uniquely identifies a relay agent within an administrative domain, which consists of all DHCP servers and relay agents that communicate with each other. |
| remote-id remote-id | Update binding information for all currently active leases assigned to clients that use that Agent Remote ID (suboption 2) of the DHCP relay agent information option (option 82). |
| routing-instance routing-instance-name | Specify an optional routing instance for the DHCP server being queried. The default routing instance is used by default. |
| server-address server-address | Specify the address of a DHCP local server to query. |
| server-group group-name | Specify the name of a group of DHCP local servers to query. |
Required Privilege Level
view
Output Fields
When you enter this command, DHCP relay agent initiates the bulk leasequery operation.
Sample Output
request dhcp relay bulk-leasequery
user@host> request dhcp relay bulk-leasequery 4/1224 server-address 192.168.10.10
Release Information
Command introduced in Junos OS Release 16.1.
all-configured-ip, relay-id, and remote-id options added in Junos OS Release 19.1R1.