DHCPv4 Status

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.

Since:

The last time the local pool state changed.

Peer State:

The state of the failover pool from the perspective of the peer, if known.

Since:

The last time the peer pool state changed.

See also

Troubleshooting High Availability DHCP Failover

DHCPv4 Leases

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.

Tip

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.

Hostname:

The hostname (if any) that the client sent as part of its DHCP request.

Description:

The description for a host with a DHCP static mapping.

Start/End:

The beginning and end times of the DHCP lease.

Note

For static mappings the page prints n/a as static mapping leases do not have a start or end time, and they do not expire.

Online:

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:

Static:

This lease entry is from a static DHCP mapping entry.

Active:

A current lease from an active client.

Expired:

A lease which has expired because a client did not renew it before its expiration time.

Actions

Add static mapping

To create a static mapping from a dynamic lease, click fa-plus-square-regular 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 fa-pencil icon which takes the user to the page to edit that specific entry.

Wake on LAN Integration

Clicking the fa-power-off icon to the right of the lease sends a Wake on LAN (WOL) packet to that host.

Click fa-plus-square to create a WOL entry for the MAC address.

See also

Wake on LAN

Delete a lease

While viewing the leases, an expired or inactive lease may be manually deleted by clicking fa-trash-can 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 fa-trash-can 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.