Configuring an IP Local Pools Holdback Timer
The IP Local Pools Holdback Timer feature allows you to configure a delay in the recycle of free IP addresses from the local pool. You can configure a unique IP address list for each pool.
With Cisco IOS Release 12.4(15)T and later releases, you can use the ip local pool command in global configuration mode to configure the list of IP addresses to delay before recycling and set the recycle delay time.
Feature History for IP Local Pools Holdback Timer
|
|
12.4(15)T |
This feature was introduced. |
Prerequisites for the IP Local Pools Holdback Timer
- Establish a working Point-to-Point Protocol over Ethernet (PPPoE) 802.IQ network
- Establish IP local pools
Information About the IP Local Pools Holdback Timer
The IP Local Pools Holdback Timer feature allows you to configure a recycle delay for each free IP address before it returns to a local pool for reassignment to a different user. You can configure a holdback timers with unique values, one for each pool, and track each pool separately.
The IP Local Pools Holdback Timer feature adds a time-stamp field to the pool element data structure that delays the reuse of the released IP address. The time-stamp field sets whenever the state of the pool element returns to POOL_ELEMENT_FREE, and the element returns to the Free Queue.
When there is a request for a specific IP address that is available for assignment, then the current time is compared against the time stamp configured for that IP address. If the time stamp equals or exceeds the configured recycle delay, the IP address is freed for assignment.
If the compared time difference is lower than the configured recycle delay, and if no other free IP addresses are available, the address allocation request is denied.
If there are free IP addresses when a request is made to get the first free IP address from the free queue, the difference between the current time stamp and the time stamp stored for the first IP address is calculated. If the difference equals or exceeds the configured recycle delay, the IP address is allocated to the peer.
If the configured recycle delay in not equal or exceeded, then the request is denied. Because the free queue is a first-in, first-out (FIFO) queue, all the other IP addresses will have a greater recycle delay than the first IP address. When an address assignment request is denied because the IP address recycle delay time has not expired, a count increments for the pool.
An IP address from the pool is marked as an orphan, when the IP address is still in use but the underlying IP pool has been removed or changed. In these cases, there is no pool for the IP address to return to when the session terminates. The IP address frees immediately and no recycle delay is applied.
How to Configure the IP Local Pools Holdback Timer
This section describes the procedures for configuring the IP Local Pools Holdback Timer feature. For complete information on commands, see the Cisco IOS Dial Technologies Command Reference,
Release 12.4.
To configure an IP local pool holdback timer, follow these steps:
SUMMARY STEPS
1. enable
2. configure terminal
3. ip local pool poolname low-ip-address [ high-ip-address ] recycle delay seconds
4. exit
DETAILED STEPS
|
|
|
Step 1 |
enable
Router> enable |
Enables privileged EXEC mode.
- Enter your password if prompted.
|
Step 2 |
configure terminal
Router# configure terminal |
Enters global configuration mode. |
Step 3 |
ip local pool poolname low-ip-address [high-ip-address] recycle delay seconds
Router(config)# ip local pool example 10.1.1.1 10.2.1.1 recycle delay 30 |
Sets the IP local pool recycle delay for the poolname. |
Step 4 |
exit
Router(config)# exit |
Exits the current mode. |
Configurating an IP Local Pools Holdback Timer: Example
The following example shows how to configure an IP local pools holdback timer of 30 seconds for the local pool example_pool for the IP address range 10.1.1.1 through 10.2.1.1:
gateway# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
gateway(config)# ip local pools example_pool 10.1.1.1 10.2.1.1 recycle delay 30
Additional References
The following sections provide references related to the IP Local Pools Holdback Timer feature.
MIBs
|
|
None |
To locate and download MIBs for selected platforms, Cisco IOS releases, and feature sets, use Cisco MIB Locator found at the following URL: http://www.cisco.com/go/mibs |
Technical Assistance
|
|
The Cisco Technical Support website contains thousands of pages of searchable technical content, including links to products, technologies, solutions, technical tips, and tools. Registered Cisco.com users can log in from this page to access even more content. |
http://www.cisco.com/techsupport |
Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and/or its affiliates in the U.S. and other countries. To view a list of Cisco trademarks, go to this URL: www.cisco.com/go/trademarks. Third-party trademarks mentioned are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (1110R)
Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be actual addresses and phone numbers. Any examples, command display output, network topology diagrams, and other figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses or phone numbers in illustrative content is unintentional and coincidental.
© 2001–2009 Cisco Systems, Inc. All rights reserved.