The current contents of the DHCPv4 lease database and related information are viewable at Status > DHCP leases.
The page contains multiple sections with information about leases.
Pool Status (HA/Failover)¶
The Pool Status section of the page is only present if the firewall is configured for DHCPv4 failover as a part of a high availability cluster.
This section of the page includes information on DHCP failover pools, including:
- Failover Group
The name of the failover group for a given pool, which includes the interface name.
- My State
The state of the failover pool from the perspective of this firewall.
The last time the local pool state changed.
- Peer State
The state of the failover pool from the perspective of the peer, if known.
The last time the peer pool state changed.
This section of the page lists client leases and their properties, including:
- IP Address
IP address assigned to the client by DHCP, or static mapping address.
- MAC Address
The client MAC address.
Installing the NMAP package activates a feature which allows the page to also display the manufacturer associated with the MAC address, if it is known. Note that this is not effective in some cases, such as for virtual machines which use randomly generated MAC addresses or for wireless clients which utilize privacy features that alter their MAC addresses.
- Client ID
The client ID (if any) that the client sent as part of its DHCP request.
The hostname (if any) that the client sent as part of its DHCP request.
The description for a host with a DHCP static mapping.
The beginning and end times of the DHCP lease.
For static mappings the page prints
n/aas static mapping leases do not have a start or end time, and they do not expire.
Whether or not the machine is currently “online” as indicated by the contents of the ARP table.
If a system shows online, then it has recently tried to communicate to or through this firewall.
A host marked as offline may be powered on and working but it has not attempted communication to or through the firewall recently.
- Lease Type
The type of DHCP lease assigned to this client, which can be one of:
This lease entry is from a static DHCP mapping entry.
A current lease from an active client.
A lease which has expired because a client did not renew it before its expiration time.
The search box filters the contents of the Leases table based on keyword matching.
Enter a search string or UNIX regular expression into the box and click Search to filter the list to only matching records.
By default the search looks at text from all fields in the lease record, but this can be limited to specific fields using the drop-down list.
Add static mapping¶
To create a static mapping from a dynamic lease, click the to the right of the lease. This pre-fills the MAC address of that host into the Edit static mapping screen.
Edit static mapping¶
Entries for existing static mappings have the icon which takes the user to the page to edit that specific entry.
Wake on LAN Integration¶
Clicking the icon to the right of the lease sends a Wake on LAN (WOL) packet to that host.
Click to create a WOL entry for the MAC address.
Delete a lease¶
While viewing the leases, an expired or inactive lease may be manually deleted by clicking at the end of its line. This option is not available for active or static leases, only for offline or expired leases.
Pool Usage Summary¶
The Leases In Use section summarizes pool usage, giving a count of leases used in each pool configured in the DHCPv4 server.
View inactive leases¶
By default the page lists active and static leases. Clicking Show all configured leases makes the page display all leases, including inactive and expired leases.
To reduce the view back to normal, click Show active and static leases only.
Clear DHCP Leases¶
The Clear all DHCP leases button stops the DHCP daemon, removes the entire lease database, and then starts the daemon again.
This does not remove static DHCP leases, only dynamic leases.