Guest

Cisco IOS Software Releases 12.1 Special and Early Deployments

IP Overlapping Address Pools

Table Of Contents

IP Overlapping Address Pools

Contents

Restrictions for IP Overlapping Address Pools

Information About IP Overlapping Address Pools

Benefits

How IP Address Groups Work

How to Configure IP Overlapping Address Pools

Configuring and Verifying a Local Pool Group

Configuration Examples for Configuring IP Overlapping Address Pools

Define Local Address Pooling as the Global Default Mechanism Example

Configure Multiple Ranges of IP Addresses into One Pool Example

Additional References

Related Documents

Standards

MIBs

RFCs

Technical Assistance

Command Reference

ip local pool

show ip local pool

Glossary


IP Overlapping Address Pools


The IP Overlapping Address Pools feature improves flexibility in assigning IP addresses dynamically. This feature allows you to configure overlapping IP address pool groups to create different address spaces and concurrently use the same IP addresses in different address spaces.

Feature Specifications for the IP Overlapping Address Pools Feature

Feature History
 
Release
Modification

12.1(5)DC

This feature was introduced.

12.2(13)T

This feature was integrated into Cisco IOS Release 12.2(13)T.

Supported Platforms

Cisco 6400 node route processor 1 (NRP-1), Cisco 6400 node route processor 25v (NRP-25v), Cisco 74001 6400-NRP-1

1 The Cisco 6400 NRP-25v must be a DC-powered 6400.


Finding Support Information for Platforms and Cisco IOS Software Images

Use Cisco Feature Navigator to find information about platform support and Cisco IOS software image support. Access Cisco Feature Navigator at http://www.cisco.com/go/fn. You must have an account on Cisco.com. If you do not have an account or have forgotten your username or password, click Cancel at the login dialog box and follow the instructions that appear.

Availability of Cisco IOS Software Images

Platform support for particular Cisco IOS software releases is dependent on the availability of the software images for those platforms. Software images for some platforms may be deferred, delayed, or changed without prior notice. For updated information about platform support and availability of software images for each Cisco IOS software release, refer to the online release notes or, if supported, Cisco Feature Navigator.

Contents

Restrictions for IP Overlapping Address Pools

Information About IP Overlapping Address Pools

How to Configure IP Overlapping Address Pools

Configuration Examples for Configuring IP Overlapping Address Pools

Additional References

Command Reference

Glossary

Restrictions for IP Overlapping Address Pools

The Cisco IOS software checks for duplicate addresses on a per-group basis. The check for duplicate addresses means that you can configure pools in multiple groups that could have possible duplicate addresses. The IP Overlapping Address Pools feature should be used only in cases where overlapping IP address pools make sense, such as Multiprotocol Label Switching (MPLS) Virtual Private Network (VPN) environments where multiple IP address spaces are supported.

Information About IP Overlapping Address Pools

To configure the IP Overlapping Address Pools feature, you should understand the following concepts:

Benefits

How IP Address Groups Work

Benefits

The IP Overlapping Address Pools gives greater flexibility in assigning IP addresses dynamically. It allows you to configure overlapping IP address pool groups to create different address spaces and concurrently use the same IP addresses in different address spaces.

How IP Address Groups Work

Existing configurations are not affected by the new pool feature. The "group" concept is an extension of the existing ip local pool command. Processing of pools that are not specified as a member of a group is unchanged from the existing implementation.

How to Configure IP Overlapping Address Pools

This section contains the following procedure:

Configuring and Verifying a Local Pool Group

Configuring and Verifying a Local Pool Group

This section contains the steps necessary to configure a local pool group and verify that it exists.

SUMMARY STEPS

1. enable

2. configure terminal

3. ip local pool {default | poolname} {low-ip-address [high-ip-address] [group group-name] [cache-size size]}

4. show ip local pool [poolname | [group group-name]]

DETAILED STEPS

 
Command or Action
Purpose

Step 1 

enable

Example:

Router> enable

Enables privileged EXEC mode.

Enter your password if prompted.

Step 2 

configure terminal

Example:

Router# configure terminal

Enters global configuration mode.

Step 3 

ip local pool {default | poolname} {low-ip-address [high-ip-address] [group group-name] [cache-size size]}

Example:

Router(config)# ip local pool testpool 10.2.2.1 10.2.2.10 group testgroup cache-size 10000

Configures a group of local IP address pools, gives this group a name, and specifies a cache size.

Step 4 

show ip local pool [poolname | [group group-name]]

Example:

Router(config)# show ip local pool group testgroup testpool

Displays statistics for any defined IP address pools.

Configuration Examples for Configuring IP Overlapping Address Pools

Define Local Address Pooling as the Global Default Mechanism Example

Configure Multiple Ranges of IP Addresses into One Pool Example

Define Local Address Pooling as the Global Default Mechanism Example

The following example shows how to configure local pooling as the global default mechanism:

ip address-pool local
ip local pool default 192.169.15.15 192.68.15.16

Configure Multiple Ranges of IP Addresses into One Pool Example

The following example shows how to configure two ranges of IP addresses for one IP address pool:

ip local pool default 192.169.10.10 192.169.10.20

ip local pool default 192.169.50.25 192.169.50.50

Additional References

For additional information related to IP Overlapping Address Pools, refer to the following references:

Related Documents

Standards

MIBs

RFCs

Technical Assistance

Related Documents

Related Topic
Document Title

Ip address pooling

"Configuring Media-Independent PPP and Multilink PPP" chapter of the Cisco IOS Dial Technologies Configuration Guide, Release 12.2.

Assigning IP addresses using Local IP address pooling

"Configuring Protocol Translation and Virtual Asynchronous Devices" chapter of the Cisco IOS Terminal Services Configuration Guide, Release 12.2.

System Management

"System Management" chapter of the Cisco IOS Configuration Fundamentals Configuration Guide, Release 12.2.


Standards

Standards1
Title

None

1 Not all supported standards are listed.


MIBs

MIBs1
MIBs Link

None

To obtain lists of supported MIBs by platform and Cisco IOS release, and to download MIB modules, go to the Cisco MIB website on Cisco.com at the following URL:

http://www.cisco.com/public/sw-center/netmgmt/cmtk/mibs.shtml

1 Not all supported MIBs are listed.


To locate and download MIBs for selected platforms, Cisco IOS releases, and feature sets, use Cisco MIB Locator found at the following URL:

http://tools.cisco.com/ITDIT/MIBS/servlet/index

If Cisco  MIB Locator does not support the MIB information that you need, you can also obtain a list of supported MIBs and download MIBs from the Cisco  MIBs page at the following URL:

http://www.cisco.com/public/sw-center/netmgmt/cmtk/mibs.shtml

To access Cisco MIB Locator, you must have an account on Cisco.com. If you have forgotten or lost your account information, send a blank e-mail to cco-locksmith@cisco.com. An automatic check will verify that your e-mail address is registered with Cisco.com. If the check is successful, account details with a new random password will be e-mailed to you. Qualified users can establish an account on Cisco.com by following the directions found at this URL:

http://www.cisco.com/register

RFCs

RFCs
Title

None


Technical Assistance

Description
Link

Technical Assistance Center (TAC) home page, containing 30,000 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/public/support/tac/home.shtml


Command Reference

This section documents modified commands. All other commands used with this feature are documented in the Cisco IOS Release 12.2 T command reference publications.

ip local pool

show ip local pool

ip local pool

To configure a local pool of IP addresses to be used when a remote peer connects to a point-to-point interface, use the ip local pool command in global configuration mode. To remove a range of addresses from a pool (the longer of the no forms of this command), or to delete an address pool (the shorter of the no forms of this command), use one of the no forms of this command.

ip local pool {default | poolname} [low-ip-address [high-ip-address]] [group group-name] [cache-size size]

no ip local pool poolname low-ip-address [high-ip-address]

no ip local pool {default | poolname}

Syntax Description

default

Creates a default local IP address pool that is used if no other pool is named.

poolname

Name of the local IP address pool.

low-IP-address [high-IP-address]

First and, optionally, last address in an IP address range.

group group-name

(Optional) Creates a pool group.

cache-size size

(Optional) Sets the number of IP address entries on the free list that the system checks before assigning a new IP address. Returned IP addresses are placed at the end of the free list. Before assigning a new IP address to a user, the system checks the number of entries from the end of the list (as defined by the cache-size size option) to determine that there are no returned IP addresses for that user. The range for the cache size is 0 to 100. The default cache size is 20.


Defaults

No address pools are configured. Any pool created without the optional group keyword is a member of the base system group.

Command Modes

Global configuration

Command History

Release
Modification

11.0

This command was introduced.

11.3 AA

This command was enhanced to allow address ranges to be added and removed.

12.1(5)DC

This command was enhanced to allow pool groups to be created.

12.2(13)T

This command was integrated into Cisco IOS Release 12.2(13)T and support was added for the Cisco 6400 node route processor 25v (NRP-25v) and Cisco 7400 platforms.


Usage Guidelines

Use the ip local pool command to create one or more local address pools from which IP addresses are assigned when a peer connects. You may also add another range of IP addresses to an existing pool. To use a named IP address pool on an interface, use the peer default ip address pool interface configuration command. A pool name can also be assigned to a specific user using authentication, authorization, and accounting (AAA) RADIUS and TACACS functions.

If no named local IP address pool is created, a default address pool is used on all point-to-point interfaces after the ip address-pool local global configuration command is issued. If no explicit IP address pool is assigned, but pool use is requested by use of the ip address-pool local command, the special pool named "default" is used.

The optional group keyword and associated group name allows the association of an IP address pool with a named group. Any IP address pool created without the group keyword automatically becomes a member of a base system group.

An IP address pool name can be associated with only one group. Subsequent use of the same pool name, within a pool group, is treated as an extension of that pool, and any attempt to associate an existing local IP address pool name with a different pool group is rejected. Therefore, each use of a pool name is an implicit selection of the associated pool group.


Note To reduce the chances of inadvertent generation of duplicate addresses, the system allows creation of the special pool named "default" only in the base system group, that is, no group name can be specified with the pool name "default."


All IP address pools within a pool group are checked to prevent overlapping addresses; however, no checks are made between any group pool member and a pool not in a group. The specification of a named pool within a pool group allows the existence of overlapping IP addresses with pools in other groups, and with pools in the base system group, but not among pools within a group. Otherwise, processing of the IP address pools is not altered by their membership in a group. In particular, these pool names can be specified in peer commands and returned in RADIUS and AAA functions with no special processing.

IP address pools can be associated with Virtual Private Networks (VPNs). This association permits flexible IP address pool specifications that are compatible with a VPN and a VPN routing and forwarding instance (VRF).

The IP address pools can also be used with the translate commands for one-step vty-async connections and in certain AAA or TACACS+ authorization functions. Refer to the chapter "Configuring Protocol Translation and Virtual Asynchronous Devices" in the Cisco IOS Terminal Services Configuration Guide and the "System Management" part of the Cisco IOS Configuration Fundamentals Configuration Guide for more information.

IP address pools are displayed with the show ip local pool EXEC command.

Examples

The following example creates a local IP address pool named "pool2," which contains all IP addresses in the range 172.16.23.0 to 172.16.23.255:

ip local pool pool2 172.16.23.0 172.16.23.255

The following example configures a pool of 1024 IP addresses:

no ip local pool default
ip local pool default 10.1.1.0 10.1.4.255

Note Although not required, it is good practice to precede local pool definitions with a no form of the command to remove any existing pool, because the specification of an existing pool name is taken as a request to extend that pool with the new IP addresses. If the intention is to extend the pool, the no form of the command is not applicable.


The following example configures multiple ranges of IP addresses into one pool:

ip local pool default 10.1.1.0 10.1.9.255
ip local pool default 10.2.1.0 10.2.9.255

The following examples show how to configure two pool groups and IP address pools in the base system group:

ip local pool p1_g1 10.1.1.1 10.1.1.50 group grp1
ip local pool p2_g1 10.1.1.100 10.1.1.110 group grp1
ip local pool p1_g2 10.1.1.1 10.1.1.40 group grp2
ip local pool lp1 10.1.1.1 10.1.1.10
ip local pool p3_g1 10.1.2.1 10.1.2.30 group grp1
ip local pool p2_g2 10.1.1.50 10.1.1.70 group grp2
ip local pool lp2 10.1.2.1 10.1.2.10 

In the example:

Group grp1 consists of pools p1_g1, p2_g1, and p3_g1.

Group grp2 consists of pools p1_g2 and p2_g2.

Pools lp1 and lp2 are not associated with a group and are therefore members of the base system group.

Note that IP address 10.1.1.1 overlaps groups grp1, grp2, and the base system group. Also note that there is no overlap within any group including the base system group, which is unnamed.

The following examples show configurations of IP address pools and groups for use by a VPN and VRF:

ip local pool p1_vpn1 10.1.1.1 10.1.1.50 group vpn1
ip local pool p2_vpn1 10.1.1.100 10.1.1.110 group vpn1
ip local pool p1_vpn2 10.1.1.1 10.1.1.40 group vpn2
ip local pool lp1 10.1.1.1 10.1.1.10
ip local pool p3_vpn1 10.1.2.1 10.1.2.30 group vpn1
ip local pool p2_vpn2 10.1.1.50 10.1.1.70 group vpn2
ip local pool lp2 10.1.2.1 10.1.2.10

The examples show configuration of two pool groups, including pools in the base system group, as follows:

Group vpn1 consists of pools p1_vpn1, p2_vpn1, and p3_vpn1.

Group vpn2 consists of pools p1_vpn2 and p2_vpn2.

Pools lp1 and lp2 are not associated with a group and are therefore members of the base system group.

Note that IP address 10.1.1.1 overlaps groups vpn1, vpn2, and the base system group. Also note that there is no overlap within any group including the base system group, which is unnamed.

The VPN needs a configuration that selects the proper group by selecting the proper pool based on remote user data. Thus, each user in a given VPN can select an address space using the pool and associated group appropriate for that VPN. Duplicate addresses in other VPNs (other group names) are not a concern, because the address space of a VPN is specific to that VPN.

In the example, a user in group vpn1 is associated with some combination of the pools p1_vpn1, p2_vpn1, and p3_vpn1, and is allocated addresses from that address space. Addresses are returned to the same pool from which they were allocated.

Related Commands

Command
Description

debug ip peer

Displays additional output when IP address pool groups are defined.

ip address-pool

Enables an address pooling mechanism used to supply IP addresses to dial in asynchronous, synchronous, or ISDN point-to-point interfaces.

peer default ip address

Specifies an IP address, an address from a specific IP address pool, or an address from the DHCP mechanism to be returned to a remote peer connecting to this interface.

show ip local pool

Displays statistics for any defined IP address pools.

translate lat

Translates a LAT connection request automatically to another outgoing protocol connection type.

translate tcp

Translates a TCP connection request automatically to another outgoing protocol connection type.


show ip local pool

To display statistics for any defined IP address pools, use the show ip local pool command in privileged EXEC mode.

show ip local pool [poolname | [group group-name]]

Syntax Description

poolname

(Optional) Named IP address pool.

group

(Optional) Displays statistics of all pools in the base system group.

group [group-name]

(Optional) Displays statistics of all pools in the named group.


Command Modes

Privileged EXEC

Command History

Release
Modification

11.1

This command was introduced.

12.1(5)DC

This command was enhanced to allow pool group statistics to be displayed.

12.2(13)T

This command was integrated into Cisco IOS Release 12.2(13)T and support was added for the Cisco 6400 node route processor 25v (NRP-25v) Cisco 7400 platforms.


Usage Guidelines

If you omit the poolname argument, the command displays a generic list of all defined address pools and the IP addresses that belong to them. If you specify the poolname argument, the command displays detailed information about that pool.

When you supply the group keyword without the associated group name, the command displays all pools in the base system group. When you supply the group keyword with the associated group name, the command displays all pools in that group.

Examples

The following is sample output from the show ip local pool command when pool groups have not been created:

Router# show ip local pool

Scope    Begin           End             Free InUse
Dialin   172.30.228.11   172.30.228.26   16   0  
Available addresses:
   172.30.228.12                             
   172.30.228.13                             
   172.30.228.14                             
   172.30.228.15                             
   172.30.228.16                             
   172.30.228.17                             
   172.30.228.18                             
   172.30.228.19                             
   172.30.228.20                             
   172.30.228.21                             
   172.30.228.22                             
   172.30.228.23                             
   172.30.228.24                             
   172.30.228.25                             
   172.30.228.26                             
   172.30.228.11        Async5               

Inuse addresses:
     None

The following is sample output from the show ip local pool command when pool groups have been created:

Router# show ip local pool

 Pool                     Begin           End             Free  In use
 ** pool <p1> is in group <g1>
 p1                       10.1.1.1        10.1.1.10         10       0
                          10.1.1.21       10.1.1.30         10       0
 ** pool <p2> is in group <g2>
 p2                       10.1.1.1        10.1.1.10         10       0
 lcl1                     10.2.2.1        10.2.2.10         10       0
                          10.2.2.21       10.2.2.30         10       0
                          10.2.2.41       10.2.2.50         10       0
 ** pool <mypool> is in group <mygroup>
 mypool                   172.18.184.223  172.18.184.224     2       0
                          172.18.184.218  172.18.184.222     5       0
 ** pool <ccc> is in group <grp-c>
 ccc                      172.18.184.218  172.18.184.220     3       0
 ** pool <bbb> is in group <grp-b>
 bbb                      172.18.184.218  172.18.184.220     3       0
 ** pool <ddd> is in group <grp-d>
 ddd                      172.18.184.218  172.18.184.220     3       0
 ** pool <pp1> is in group <grp-pp>
 pp1                      172.18.184.218  172.18.184.220     2       1

The following is sample output from the show ip local pool command for the pool group named mygroup:

Router# show ip local pool mygroup

 Pool                     Begin           End             Free  In use
 ** pool <mypool> is in group <mygroup>
 mypool                   172.18.184.223  172.18.184.224     2       0
                          172.18.184.218  172.18.184.222     5       0

The following sample output from the show ip local pool group command shows the base system group (lcl1):

Router# show ip local pool group

 Pool                     Begin            End              Free  In use
 lcl1                     10.2.2.1         10.2.2.10          10       0
                          10.2.2.21        10.2.2.30          10       0
                          10.2.2.41        10.2.2.50          10       0

Table 1 describes the significant fields shown in the displays.

Table 1 show ip local pool Field Descriptions 

Field
Description

Scope

The type of access.

Begin

The first IP address in the defined range of addresses in this pool.

End

The last IP address in the defined range of addresses in this pool.

Free

The number of addresses available.

InUse

The number of addresses in use.

Pool

Pool and group names and associations, if created.


Related Commands

Command
Description

ip address-pool

Enables an address pooling mechanism used to supply IP addresses to dial asynchronous, synchronous, or ISDN point-to-point interfaces.

ip local pool

Configures a local pool of IP addresses to be used when a remote peer connects to a point-to-point interface.


Glossary

IPCP—IP Control Protocol. Protocol that establishes and configures IP over PPP.

MPLS—Multiprotocol Label Switching. Switching method that forwards IP traffic using a label. This label instructs the routers and the switches in the network where to forward the packets based on preestablished IP routing information.

NAT—Network Address Translation. Mechanism for reducing the need for globally unique IP addresses. NAT allows an organization with addresses that are not globally unique to connect to the Internet by translating those addresses into globally routable address space. Also known as Network Address Translator.

VPDN—virtual private dialup network. Also known as virtual private dial network. A VPDN is a network that extends remote access to a private network using a shared infrastructure. VPDNs use Layer 2 tunnel technologies (L2F, L2TP, and PPTP) to extend the Layer 2 and higher parts of the network connection from a remote user across an ISP network to a private network. VPDNs are a cost-effective method of establishing a long distance, point-to-point connection between remote dial users and a private network. See also VPN.

VPN—Virtual Private Network. Enables IP traffic to travel securely over a public TCP/IP network by encrypting all traffic from one network to another. A VPN uses "tunneling" to encrypt all information at the IP level.

VRF—A VPN routing and forwarding instance. A VRF consists of an IP routing table, a derived forwarding table, a set of interfaces that use the forwarding table, and a set of rules and routing protocols that determine what goes into the forwarding table. In general, a VRF includes the routing information that defines a customer VPN site that is attached to a PE router.


Note Refer to the Internetworking Terms and Acronyms for terms not included in this glossary.