show ip dhcp
binding
database
option-82
relay statistics
reserved
statistics
vlan
Description
This command displays the DHCP server binding, database setting, relay, pool statistics, and device reservations.
Parameter | Description |
binding | Show DHCP server bindings. |
database | Show DHCP server settings. |
option-82 | Show DHCP option-82 configurations. |
relay statistics | Show DHCP relay statistics. |
reserved | Show DHCP server device reservations. |
statistics | Show DHCP pool statistics. |
vlan | Show DHCP vlan information. |
Examples
The following example displays DHCP statistics for two configured networks:
(host) [mynode] #show ip dhcp statistics
DHCPv4 enabled; DHCPv6 enabled
DHCP Pools
----------
Network Name Type Active Configured leases Active leases Free leases Expired leases Abandoned leases
------------ ---- ------ ----------------- ------------- ----------- -------------- ----------------
2-2-2-nw v4 Yes 242 0 242 0 0
3-2-2-nw v4 Yes 254 0 254 0 0
test v4 Yes 254 0 254 0 0
2011 v6 No 5 - - - -
2012 v6 No 5 - - - -
Current leases 750
Total leases 512
Starting from ArubaOS 8.2.0.0, if the DHCP lease limit is configured to exceed the user limit, a warning is displayed in the command output.
host) (config) #show ip dhcp statistics
DHCPv4 disabled; DHCPv6 disabled
DHCP Pools
----------
Network Name Type Active Configured leases Active leases Free leases Expired leases
------------ ---- ------ ----------------- ------------- ----------- --------------
Abandoned leases
---------- ------
Current leases 0
Total leases 2048
WARNING: DHCP lease limit increased beyond user limit. Some of the controller's services may be impacted
NOTE: To make a DHCPv6 pool active, ensure that the pool name is added in vlan interface.
The output of this command includes the following parameters:
Parameter | Description |
Network Name | Range of addresses that the DHCP server may assign to clients. |
Type | Indicates the IP version of the DHCP server. It can be v4 or v6. |
Active | Indicates if the DHCP server is active or not. |
Configured leases | Number of leases configured on the DHCP server. |
Active leases | Number of active DHCP leases. |
Free leases | Number of available DHCP leases. |
Expired leases | Number of leases that have expired because they have extended past their valid lease period. |
Abandoned leases | Number of abandoned leases. Abandoned leases will not be reassigned unless there are no free leases available. |
The following example displays information about DHCP server device reservations:
(host) [mynode] (config) #show ip dhcp reserved
DHCP Server Device Reservation Information ------------------------------------------
Hardware Address Reserved IP Address Hostname Lease Status
---------------- ------------------- -------- -------------
00:1A:1E:C0:80:28 10.3.129.253 DISCONNECTED
00:0B:86:42:35:80 10.3.129.99 DISCONNECTED
00:1A:1E:C0:1C:60 10.3.129.254 print CONNECTED
The output of this command includes the following parameters:
Parameter | Description |
Hardware Address | Indicates the MAC address of the client device. |
Reserved IP Address | Indicates the IP addresses manually reserved from a DHCP pool. |
Hostname | Indicates the hostname of the client device. |
Lease Status | Indicates whether the client received the IP address or not. This parameter displays one of the following values: Connected Disconnected NOTE: The Lease Status displays Connected after a successful DHCP negotiation, when the client receives an IP address from the reserved list. The Lease Status displays Disconnected when the IP address is not assigned to the client. |
Related Commands
Command | Description |
ip dhcp pool | This command configures a DHCP pool on Mobility Conductor. |
ipv6 dhcp pool | This command configures a DHCPv6 pool on Mobility Conductor. |
ip dhcp increase-lease-limit | This command increases the DHCP scope on a controller—7005, 7008, or 7010 controllers—to twice the user limit. |
ip dhcp reserved | This command configures DHCP server device reservations. |
Command History
Release | Modification |
ArubaOS 8.8.0.0 | The reserved parameter was introduced. |
ArubaOS 8.0.0.0 | Command introduced. |
Command Information
Platforms | License | Command Mode |
All platforms | Base operating system. | Enable or Config mode on Mobility Conductor. |