Configuring Local Address Servers
The local address server allocates IP addresses from a pool of addresses stored locally on the router. You can optionally configure shared local address pools to obtain addresses from a DHCP local address pool that is in the same virtual router. Addresses are provided automatically to client sessions requiring an IP address from a virtual router that is configured to use a local address pool.
A local address server is defined in the context of a virtual router. You create a local address server when you configure the first local pool. Local address servers exist as long as the virtual router exists or until you remove them by deleting all configured pools.
Figure 1 illustrates the local address pool hierarchy. Multiple local address server instances, one per virtual router. can exist. Each local address server can have one or more local address pools. Each pool can contain a number of IP addresses that are available for allocation and used by clients, such as PPP sessions.
![]()
Local Address Pool Ranges
As shown in Figure 1, each local address pool is named and contains ranges of sequentially ordered IP addresses. These addresses are allocated when the AAA server makes a request for an IP address.
If a local address pool range is exhausted, the next range of addresses is used. If all pool ranges are exhausted, you can configure a new range to extend or supplement the existing range of addresses, or you can create a new pool. The newly created pool range is then used for future address allocation. If addresses allocated from the first pool range are released, then subsequent requests for addresses are taken from the first pool range.
Addresses are assigned sequentially from a range within a pool. If a range has no addresses available, the next range within that pool is used. If a pool has no addresses available, the next configured pool is used, unless a specific pool is indicated.
Local Address Pool Aliases
An alias is an alternate name for an existing local address pool. It comprises an alias name and a pool name.
When the AAA server requests an IP address from a specific local address pool, the local address server first verifies whether an alias exists for the requested pool. If an alias exists, the IP address is allocated from the pool specified by the alias. If no alias exists, the IP address is allocated from the pool originally specified in the request.
The use of aliases simplifies management of subscribers. For example, you can use an alias to migrate subscribers from one local address pool to another. Instead of having to modify countless subscriber records on the AAA server, you create an alias to make the configuration change.
Shared Local Address Pools
Typically, the local address server allocates IP addresses from a pool of addresses that is stored locally on the router. However, shared local address pools enable a local address server to hand out addresses that are allocated from DHCP local server address pools within the same virtual router. The addresses are configured and managed within DHCP. Therefore, thresholds are not configured on the shared pool, but are instead managed by the referenced DHCP local server pool.
A shared local address pool references one DHCP address pool. The shared local address pool can then obtain addresses from the referenced DHCP address pool and from any DHCP address pools that are linked to the referenced DHCP address pool.
Figure 2 illustrates a shared local address pool environment that includes four linked DHCP address pools. In the figure, both Shared_LAS_Pool_A and Shared_LAS_Pool_B reference DHCP_Pool_1, and can therefore obtain addresses from all four DHCP address pools. Shared_LAS_Pool_C references DHCP_Pool_3 and can get addresses from DHCP_Pool_3 and DHCP_Pool_4.
![]()
When the local address server requests an address from a shared address pool, the address is returned from the referenced DHCP pool or a subsequent linked pool. If no address is available, DHCP notifies the local address server and the search is ended.
Keep the following guidelines in mind when using shared local address pools:
- The DHCP attributes do not apply to shared local address pools; for example, the lease time for shared local address pools is infinite.
- When you delete the referenced DHCP address pool, DHCP notifies the local address server and logs out all subscribers that are using addresses from the deleted pool.
- When you delete a shared local address pool, the local address server logs out the subscribers that are using addresses from the deleted pool, then notifies DHCP and releases the addresses.
- If the chain of linked DHCP address pools is broken, no action is taken and the existing subscribers retain their address. However, the DHCP local address pools that are no longer part of the chain are now unable to provide any new addresses.
Example
This following commands create the shared address pools in Figure 2:
host1(config)#ip local shared-pool Shared_LAS_Pool_A DHCP_Pool_1host1(config)#ip local shared-pool Shared_LAS_Pool_B DHCP_Pool_1host1(config)#ip local shared-pool Shared_LAS_Pool_C DHCP_Pool_3SNMP Thresholds
An address pool has SNMP thresholds associated with it that enable the local address server to signal SNMP traps when certain conditions exist. These thresholds include high utilization threshold and abated utilization threshold. If a pool's outstanding addresses exceed the high utilization threshold and the SNMP trap signaling is enabled, SNMP is notified. Likewise, when a pool's utilization drops below the abated threshold utilization threshold, SNMP is notified.
Configuring a Local Address Server
You can create, modify, and delete address pools. You can display address pool information or status with the show ip local pool command. The following are examples of tasks you can configure:
host1(config)#ip address-pool localMap an address pool name to a range of local addresses. You can also use this command to add additional ranges to a pool. host1(config)#ip local pool addrpool_10 192.168.56.10 192.168.56.15Map an address pool name to a domain name. host1(config)#aaa domain-map westford.comhost1(config-domain-map)#address-pool-name poolADelete an address pool. host1(config)#no ip local pool addrpool_10
NOTE: If a pool or range is deleted and addresses are outstanding, the AAA server logs out the clients using the addresses.
Create a shared local address pool. host1(config)#ip local shared-pool Shared_LAS_Pool_A DHCP_Pool_1Delete a shared local address pool. host1(config)#no ip local shared-pool Shared_LAS_Pool_CSet SNMP variables by specifying an existing pool name and values. host1(config)#ip local pool addrpool_10 warning 90 80address-pool-name
- Use to specify the name of the local address pool from which the router allocates addresses for the domain that you are configuring.
- If the authentication server does not return an address, the router allocates an address from this pool. The authentication server may override this pool name using RADIUS attributes such as Framed-Pool.
- Example
host1(config)#aaa domain-map westford.comhost1(config-domain-map)#address-pool-name poolAUse the no version to remove the address pool name. ip address-pool
- Use to specify the addressing scheme: dhcp, local, or none.
- The addressing scheme none returns a special indicator to AAA that enables the remote PPP client to assign its own address.
- Example
host1(config)#ip address-pool dhcpUse the no version to specify the default, local. ip local alias
- Use to create an alias for an existing local address pool. The IP address is allocated from the pool specified by the alias rather than from the pool specified in the IP address request.
- An alias name may contain up to 16 characters.
- You can configure a maximum of 32 aliases per virtual router.
- A local address pool can have multiple aliases.
- You can set the name of the alias to match the name of a local address pool; however, the two names used in the alias cannot be the same.
- You can modify an existing alias with a different local address pool name.
- When a local address pool is deleted, all aliases with the matching pool name are also deleted.
- Example
host1(config)#ip local alias groupB pool-name addrpool_10Use the no version to remove the alias name. ip local pool
- Use to map an address pool name to a range of local addresses.
- You can create a pool with no address ranges configured for it.
- A name may contain up to 16 characters.
- Example
host1(config)#ip local pool addrpool_10 192.168.56.10 192.168.56.15Use the no version to remove the local pool (all ranges), or the specified range. ip local pool snmpTrap
host 1(config)#ip local pool addr_test snmpTrapUse the no version to disable SNMP pool utilization traps. ip local pool warning
host1(config)#ip local pool addr_test warning 90 80Use the no version to reset the attributes to their default values; high threshold 85, abated threshold 75. ip local shared-pool
- Use to create a local shared address pool and to specify the DHCP address pool that provides the addresses.
- You can reference a DHCP address pool that has not yet been configured.
- Example
host1(config)#ip local shared-pool sharedPool11 dhcpPool6Use the no version to delete a specific local shared address pool.