NSX-T DHCP Pool Exhaustion Due to Stale Lease Entries
search cancel

NSX-T DHCP Pool Exhaustion Due to Stale Lease Entries

book

Article ID: 409189

calendar_today

Updated On:

Products

VMware NSX

Issue/Introduction

VMs unable to get IP address from the DHCP server defined on NSX Segment.

On NSX Manager UI Error Similar to Below are seen:

Pool Lease Allocation failed
The addresses in IP Pool <UUID> of DHCP Server <UUID> have been exhausted.
The last DHCP request has failed and future requests will fail.

Environment

VMware NSX

Cause

The DHCP server reported exhaustion because stale lease entries were retained in the lease table. These entries blocked allocation of IPs even though some were not actively in use by VMs.

Resolution

Resolution

  1. Identify the affected DHCP server and pool:

    get dhcp ip-pool
    
get dhcp leases | find <pool-UUID>

  2. Release stale IP-to-MAC bindings using the NSX API:

    curl -X DELETE -v -k -u admin "https://<NSX-MGR>/api/v1/dhcp/servers/<server-UUID>/leases?ip=<IP>&mac=<MAC>"

  3. After cleanup, confirm DHCP pool availability using:

    get dhcp leases all
Powered by Wolken Software