Cisco ASR 9000 Series Aggregation Services Router Broadband Network Gateway Command Reference, Release 4.3.x
Address Pool Service Commands
Downloads: This chapterpdf (PDF - 1.42MB) The complete bookPDF (PDF - 4.57MB) | Feedback

Address Pool Service Commands

Address Pool Service Commands

This chapter describes the Cisco IOS XR software Address Pool Service commands for Broadband Network Gateway (BNG). For details regarding related configurations, refer to the Cisco ASR 9000 Series Aggregation Services Router Broadband Network Gateway Configuration Guide.

address-range

To specify address range for allocation, use the address-range command in Pool IPv4 or IPv6 configuration submode. To remove the address range, use the no form of this command.

address-range first_range last_range

no address-range first_range last_range

Syntax Description

first_range

Specifies the first address in range from which the IP addresses can be assigned to clients.

last_range

Specifies the last address in range until which the IP addresses can be assigned to clients.

Command Default

None

Command Modes

Pool IPv4 configuration

Pool IPv6 configuration

Command History

Release Modification

Release 4.2.0

This command was introduced.

Release 4.3.0

Support for IPv6 was added.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

You should only specify the addresses that are assignable to clients in a particular subnet. The interface and broadcast addresses should not be included in the address-range configuration.

Use the pool ipv4 command to enter IPv4 pool configuration submode and pool ipv6 command to enter IPv6 pool configuration submode.

Multiple address-ranges are allowed within a pool.

Task ID

Task ID Operation

ip-services

read, write

Examples

This is an example of configuring the address-range command for IPv4 in the global configuration mode:

RP/0/RSP0/CPU0:router# configure
RP/0/RSP0/CPU0:router(config)# pool vrf vrf1 ipv4 pool2
RP/0/RSP0/CPU0:router(config-pool-ipv4)# address-range 11.11.11.11 14.14.14.14

This is an example of configuring the address-range command for IPv6 in the global configuration mode:

RP/0/RSP0/CPU0:router# configure
RP/0/RSP0/CPU0:router(config)# pool vrf vrf1 ipv6 pool3
RP/0/RSP0/CPU0:router(config-pool-ipv6)# address-range 2001::1 2001::100

Related Commands

Command

Description

pool ipv4

Enables distributed address pool service on ipv4.

pool vrf

Enables distributed address pool service on vrf.

exclude

Specifies a range of IP addresses that distributed address pool service should not assign to clients.

exclude

To specify a range of IPv4 or Pv6 addresses that distributed address pool service (DAPS) must not assign to clients, use the exclude command in Pool IPv4 or IPv6 configuration submode. To remove the excluded IP addresses, use the no form of this command.

exclude { first_address | last_address }

no exclude { first_address | last_address }

Syntax Description

first_address

Specifies the first address in the range that needs to be excluded for IPv4 and specifies the first address or prefix in the range for IPv6.

last_address

Specifies the last address in the range that needs to be excluded and specifies the last address or prefix in the range for IPv6.

Command Default

None

Command Modes

Pool IPv4 configuration

Pool IPv6 configuration

Command History

Release Modification

Release 4.2.0

This command was introduced.

Release 4.3.0

Support for IPv6 was added.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Use the pool ipv4 command to enter IPv4 pool configuration submode and pool ipv6 command to enter IPv6 pool configuration submode.

The low IP address cannot overlap with the IP address of a reserved address command. Multiple exclude commands are allowed within a pool. To exclude a single address, <highIpAddress> can be omitted.


Note


The exclude command can be configured along with the network, address-range, and the prefix-range commands.


Task ID

Task ID Operation

ip-services

read, write

Examples

This is an example to configure the exclude command for IPv4:

RP/0/RSP0/CPU0:router# configure
RP/0/RSP0/CPU0:router(config)# pool vrf vrf1 ipv4 pool2
RP/0/RSP0/CPU0:router(config-pool-ipv4)# exclude 10.10.10.1 10.10.10.10 

This is an example to configure the exclude command for IPv6:

RP/0/RSP0/CPU0:router# configure
RP/0/RSP0/CPU0:router(config)# pool vrf vrf1 ipv6 pool3
RP/0/RSP0/CPU0:router(config-pool-ipv6)# exclude 2001::1 

Related Commands

Command

Description

pool ipv4

Enables distributed address pool service on IPv4.

pool vrf

Enables distributed address pool service on vrf.

network (BNG)

Specifies a set of addresses or prefixes inside a subnet.

network (BNG)

To specify a set of addresses or prefixes inside a subnet, use the network command in Pool IPv4 or IPv6 configuration submode. To remove the addresses or prefixes, use the no form of this command.

network { IPv4_subnet/length | IPv6_subnet/length }

no network { IPv4_subnet/length | IPv6_subnet/length }

Syntax Description

IPv4_subnet

Specifies the decimal representation of the IPv4 subnet mask.

IPv6_subnet

Specifies the hexadecimal value for the IPv6 subnet mask.

length
Specifies the length of the prefix.
Note   

The prefix length must be a maximum of 16 bit more than the subnet mask.

Command Default

None

Command Modes

Pool IPv4 configuration

Pool IPv6 configuration

Command History

Release Modification

Release 4.2.0

This command was introduced.

Release 4.3.0

Support for IPv6 was added.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Use the pool ipv4 command to enter IPv4 pool configuration submode and pool ipv6 command to enter IPv6 pool configuration submode.

The prefix-length command must be configured whenever the network command is used. The prefix-length must be configured to 128 to signify singleton addresses and a smaller value to signify IPv6 prefixes. The number of addresses or prefixes that can be allocated by DAPS can become huge when this command is used. The prefix-length command should be configured to a number that limits the number of addresses or prefixes for each pool to 64K.

The prefix is written as the first address of a network, followed by a slash character (/) , and ends with the bit-length of the prefix. For example, 192.168.1.0/24 is the prefix of the IPv4 network starting at the given address, having 24 bits allocated for the network prefix, and the remaining 8 bits reserved for host addressing. The IPv6 address specification 2001:db8::/32 is a large network with 2 96 addresses, having a 32-bit routing prefix. In IPv4 the routing prefix is also specified in the form of the subnet mask, which is expressed in quad-dotted decimal representation like an address. For example, 255.255.255.0 is the network mask for the 192.168.1.0/24 prefix.

Task ID

Task ID Operation

ip-services

read, write

Examples

This is an example of configuring the network command for IPv4:

RP/0/RSP0/CPU0:router# configure
RP/0/RSP0/CPU0:router(config)# pool vrf vrf1 ipv4 pool2
RP/0/RSP0/CPU0:router(config-pool-ipv4)# network 11.11.11.0/24

This is an example of configuring the network command for IPv6:

RP/0/RSP0/CPU0:router# configure
RP/0/RSP0/CPU0:router(config)# pool vrf vrf1 ipv6 pool3
RP/0/RSP0/CPU0:router(config-pool-ipv6)# network 10:1:1::/50 

Related Commands

Command

Description

pool ipv4

Enables distributed address pool service on ipv4.

pool vrf

Enables distributed address pool service on vrf.

prefix-length

Specifies the length of the prefix that is assigned to the client.

prefix-length

To specify the length of the prefix that is assigned to the client, use the prefix-length command in IPv6 configuration submode. To remove the length of the prefix, use the no form of this command.

prefix-length prefix_length

no prefix-length prefix_length

Syntax Description

prefix_length

Specifies the length of the prefix.

Command Default

None

Command Modes

Pool IPv6 configuration

Command History

Release Modification

Release 4.3.0

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Use the pool ipv6 command to enter ipv6 pool configuration submode.

The prefix-length command under the pool ensures all the prefixes (described in the prefix-range section) in the pool have the same length. The prefix-length command must be configured when the network and the prefix-length commands are used.

Task ID

Task ID Operation

ip-services

read, write

Examples

This is an example of configuring the prefix-length command in the IPv6 configuration submode:

RP/0/RSP0/CPU0:router# configure
RP/0/RSP0/CPU0:router(config)# pool vrf vrf1 ipv6 pool3
RP/0/RSP0/CPU0:router(config-pool-ipv6)# prefix-length 50

Related Commands

Command

Description

pool ipv4

Enables distributed address pool service on ipv4.

pool vrf

Enables distributed address pool service on vrf.

network (BNG)

Specifies a set of addresses or prefixes inside a subnet.

prefix-range

To specify a range of IPv6 address prefixes, use the prefix-range command in IPv6 configuration submode. To remove the range of prefixes, use the no form of this command.

prefix-range { first_ipv6_range | last_ipv6_range }

no prefix-range { first_ipv6_range | last_ipv6_range }

Syntax Description

first_ipv6_range

Specifies the first IPv6 in the prefix range.

last_ipv6_range

Specifies the last IPv6 in the prefix range.

Command Default

None

Command Modes

Pool IPv6 configuration

Command History

Release Modification

Release 4.3.0

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Use the pool ipv6 command to enter IPv6 pool configuration submode.

Multiple prefix-ranges are allowed within a pool. The length of the prefix in any pool is the same for all prefix's and this is imposed by the prefix-length command. The prefix-length has to be mandatorily configured whenever prefix-range is configured.

Task ID

Task ID Operation

ip-services

read, write

Examples

This is an example of configuring the prefix-range command in IPv6 configuration submode:

RP/0/RSP0/CPU0:router# configure
RP/0/RSP0/CPU0:router(config)# pool vrf vrf1 ipv6 pool3
RP/0/RSP0/CPU0:router(config-pool-ipv6)# prefix-range 1001:1:1:1:: 1001:1:1:10:: 

Related Commands

Command

Description

pool ipv4

Enables distributed address pool service on ipv4.

pool vrf

Enables distributed address pool service on vrf.

prefix-length

Specifies the length of the prefix that is assigned to the client.

pool vrf

To enable distributed address pool service on a vrf and to enter the corresponding configuration submode, use the pool vrf command in the global configuration mode. To disable this feature, use the no form of this command.

pool vrf { vrf_name | all } { ipv4 | pool_name | ipv6 | pool_name }

no pool vrf { vrf_name | all } { ipv4 | pool_name | ipv6 | pool_name }

Syntax Description

vrf_name

Specifies the name of the vrf.

ipv4

Specifies IPv4 pool name. Each pool must have a unique name across all VRFs.

ipv6

Specifies IPv6 pool name. Each pool must have a unique name across all VRFs.

pool_name

Specifies the name of the pool for IPv4 or IPv6.

all

Specifies the global pool.

Command Default

None

Command Modes

Global configuration mode

Command History

Release Modification

Release 4.2.0

This command was introduced.

Release 4.3.0

Support for IPv6 was added.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Use the pool ipv4 command to enter IPv4 pool configuration submode and pool ipv6 command to enter IPv6 pool configuration submode.


Note


Each pool must have a unique name across all VRFs. For example, pool1 can not be created in both vrf1 and vrf2.


Some pools can be associated with all the VRFs and these pools are configured with the all keyword.

Task ID

Task ID Operation

ip-services

read, write

Examples

This is an example of configuring the pool vrf command for IPv4 in the global configuration mode:

RP/0/RSP0/CPU0:router# configure
RP/0/RSP0/CPU0:router(config)# pool vrf vrf1 ipv4 pool2
RP/0/RSP0/CPU0:router(config-pool-ipv4)# 

This is an example of configuring the pool vrf command for IPv6 in the global configuration mode:

RP/0/RSP0/CPU0:router# configure
RP/0/RSP0/CPU0:router(config)# pool vrf vrf1 ipv6 pool3
RP/0/RSP0/CPU0:router(config-pool-ipv6)# 

Related Commands

Command

Description

pool ipv4

Enables distributed address pool service on IPv4.

pool ipv6

Enables distributed address pool service on IPv6.

pool ipv4

To enable distributed address pool service on IPv4 and to enter the pool IPv4 configuration submode, use the pool ipv4 command in the global configuration mode. To disable this feature, use the no form of this command.

pool ipv4 pool_name

no pool ipv4 pool_name

Syntax Description

pool_name

Specifies the name of the IPv4 pool.

Command Default

None

Command Modes

Global configuration mode

Command History

Release Modification

Release 4.2.0

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Use the pool ipv4 command to enter IPv4 pool configuration submode.

Task ID

Task ID Operation

ip-services

read, write

Examples

This is an example of configuring the pool ipv4 command in the global configuration mode:

RP/0/RSP0/CPU0:router# configure
RP/0/RSP0/CPU0:router(config)# pool ipv4 pool1
RP/0/RSP0/CPU0:router(config-pool-ipv4)# address-range 10.10.10.1 10.10.10.254

Related Commands

Command

Description

pool vrf

Enables distributed address pool service on vrf.

exclude

Specifies a range of IP addresses that distributed address pool service should not assign to clients.

address-range

Specifies a range of IP addresses.

pool ipv6

To enable distributed address pool service on IPv6 and to enter the IPv6 pool configuration submode, use the pool ipv6 command in the global configuration mode. To disable this feature, use the no form of this command.

pool ipv6 pool_name

no pool ipv6 pool_name

Syntax Description

pool_name

Specifies the IPv6 pool name.

Command Default

None

Command Modes

Global configuration mode

Command History

Release Modification

Release 4.3.0

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Use the pool ipv6 command to enter IPv6 pool configuration submode.

Task ID

Task ID Operation

ip-services

read, write

Examples

This is an example of configuring the pool ipv6 command in the global configuration mode:

RP/0/RSP0/CPU0:router# configure
RP/0/RSP0/CPU0:router(config)# pool ipv6 p6 prefix-length 45
RP/0/RSP0/CPU0:router(config-pool-ipv6)# 

Related Commands

Command

Description

pool vrf

Enables distributed address pool service on vrf.

utilization-mark

To specify a utilization threshold, use the utilization-mark command in Pool IPv4 or IPv6 configuration submode. To remove the utilization threshold, use the no form of this command.

utilization-mark { high | high_value | low | low_value }

no utilization-mark { high | high_value | low | low_value }

Syntax Description

high

Specifies the high mark in the threshold value.

high_value

Specifies the numerical value as percentage, for the low mark in the threshold.

low

Specifies the low mark in the threshold value.

low_value

Specifies the numerical value as percentage, for the low mark in the threshold.

Command Default

None

Command Modes

Pool IPv4 configuration

Pool IPv6 configuration

Command History

Release Modification

Release 4.2.0

This command was introduced.

Release 4.3.0

Support for IPv6 was added.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Use the pool ipv4 command to enter IPv4 pool configuration submode and pool ipv6 command to enter IPv6 pool configuration submode.

When the utilization threshold is reached, a LOG_WARNING message is logged with syslog facility. The high and low values are entered as percentages between 0 and 100. The utilization is defined as the # allocated addresses or # total addresses.

Task ID

Task ID Operation

ip-services

read, write

Examples

This is an example of configuring the utilization-mark command in Pool IPv4 configuration submode:

RP/0/RSP0/CPU0:router# configure
RP/0/RSP0/CPU0:router(config)# pool vrf vrf1 ipv4 pool2
RP/0/RSP0/CPU0:router(config-pool-ipv4)# utilization-mark high 90 low 10

This is an example of configuring the utilization-mark command in Pool IPv6 configuration submode:

RP/0/RSP0/CPU0:router# configure
RP/0/RSP0/CPU0:router(config)# pool vrf vrf1 ipv6 pool3
RP/0/RSP0/CPU0:router(config-pool-ipv6)# utilization-mark high 70 low 40

Related Commands

Command

Description

pool ipv4

Enables distributed address pool service on ipv4.

pool vrf

Enables distributed address pool service on vrf.

exclude

Specifies a range of IP addresses that distributed address pool service should not assign to clients.

show pool ipv4 name

To display the status of an IPv4 pool, use the show pool ipv4 name command in the EXEC mode.

show pool ipv4 name pool_name { location | verbose | }

Syntax Description

pool_name

Specifies the name of the IPv4 pool.

location

Specifies the location of the IPv4 pool.

verbose

Displays all allocations for the pools.

|

Specifies the output modifiers.

Command Default

None

Command Modes

EXEC

Command History

Release Modification

Release 4.2.0

This command was introduced.

Release 4.3.0

Support for IPv6 was added.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Use thepool ipv4 command to enter Pool IPv4 configuration submode.

Task ID

Task ID Operation

ip-services

read

Examples

This is the sample output of the show pool ipv4 name command:

RP/0/RSP0/CPU0:router# show pool ipv4 name POOL1

              Pool POOL1 Allocations
---------------------------------------------------
VRF: default
Pool Id: 30
Pool Scope: VRF Specific Pool
Prefix Length: 32

Used:           100
Excl:             0
Free:          7900
Total:         8000

Utilization:    1%

Range List: 
----------- 
Range Start        :  12.0.0.2 
Range End          :  12.0.31.65 
Used Addresses     :  100 
Excluded Addresses :  0 
Free Addresses     :  7900  

RP/0/RSP0/CPU0:router# show pool ipv4 name POOL1 verbose 

              Pool POOL1 Allocations
---------------------------------------------------
VRF: default
Pool Id: 30
Pool Scope: VRF Specific Pool
Prefix Length: 32

Used:           100
Excl:             0
Free:          7900
Total:         8000

Utilization:    1%

Range List: 
----------- 
Range Start        :  12.0.0.2 
Range End          :  12.0.31.65 
Used Addresses     :  100 
Excluded Addresses :  0 
Free Addresses     :  7900 
 
In-Use Address List:
   12.0.0.2  PPP
   12.0.0.3  PPP
   12.0.0.4  PPP
   12.0.0.5  PPP
   12.0.0.6  PPP
   12.0.0.7  PPP
   12.0.0.8  PPP
   12.0.0.9  PPP
   12.0.0.10  PPP
   12.0.0.11  PPP
   12.0.0.12  PPP
   12.0.0.13  PPP
   12.0.0.14  PPP
   12.0.0.15  PPP
   12.0.0.16  PPP
   12.0.0.17  PPP
   12.0.0.18  PPP
   12.0.0.19  PPP
   12.0.0.20  PPP
   12.0.0.21  PPP
   12.0.0.22  PPP
   12.0.0.23  PPP
   12.0.0.24  PPP
   12.0.0.25  PPP
   12.0.0.26  PPP
   12.0.0.27  PPP
   12.0.0.28  PPP
   12.0.0.29  PPP
   12.0.0.30  PPP
   12.0.0.31  PPP
   12.0.0.32  PPP
   12.0.0.33  PPP
   12.0.0.34  PPP
   12.0.0.35  PPP
   12.0.0.36  PPP
   12.0.0.37  PPP
   12.0.0.38  PPP
   12.0.0.39  PPP
   12.0.0.40  PPP
   12.0.0.41  PPP
   12.0.0.42  PPP
   12.0.0.43  PPP
   12.0.0.44  PPP
   12.0.0.45  PPP
   12.0.0.46  PPP
   12.0.0.47  PPP
   12.0.0.48  PPP
   12.0.0.49  PPP
   12.0.0.50  PPP
   12.0.0.51  PPP
   12.0.0.52  PPP
   12.0.0.53  PPP
   12.0.0.54  PPP
   12.0.0.55  PPP
   12.0.0.56  PPP
   12.0.0.57  PPP
   12.0.0.58  PPP
   12.0.0.59  PPP
   12.0.0.60  PPP
   12.0.0.61  PPP
   12.0.0.62  PPP
   12.0.0.63  PPP
   12.0.0.64  PPP
   12.0.0.65  PPP
   12.0.0.66  PPP
   12.0.0.67  PPP
   12.0.0.68  PPP
   12.0.0.69  PPP
   12.0.0.70  PPP
   12.0.0.71  PPP
   12.0.0.72  PPP
   12.0.0.73  PPP
   12.0.0.74  PPP
   12.0.0.75  PPP
   12.0.0.76  PPP
   12.0.0.77  PPP
   12.0.0.78  PPP
   12.0.0.79  PPP
   12.0.0.80  PPP
   12.0.0.81  PPP
   12.0.0.82  PPP
   12.0.0.83  PPP
   12.0.0.84  PPP
   12.0.0.85  PPP
   12.0.0.86  PPP
   12.0.0.87  PPP
   12.0.0.88  PPP
   12.0.0.89  PPP
   12.0.0.90  PPP
   12.0.0.91  PPP
   12.0.0.92  PPP
   12.0.0.93  PPP
   12.0.0.94  PPP
   12.0.0.95  PPP
   12.0.0.96  PPP
   12.0.0.97  PPP
   12.0.0.98  PPP
   12.0.0.99  PPP
   12.0.0.100  PPP
   12.0.0.101  PPP

This table describes the significant fields shown in the display.

Table 1 show pool ipv4 name Field Descriptions

Field

Description

VRF

Specifies the VRF the pool is associated with.

Pool ID

The unique pool ID of a specific pool.

Pool Scope

Pool scope belongs to the VRF specific pool.

Prefix Length

Length of the prefix specified.

Related Commands

Command

Description

pool vrf

Enables distributed address pool service on vrf.

pool ipv4

Enables distributed address pool service on ipv4.

exclude

Specifies a range of IP addresses that distributed address pool service should not assign to clients.

address-range

Specifies a range of IP addresses.

show pool ipv6 name

To show the status of an IPv6 pool, use the show pool ipv6 name command in the EXEC mode.

show pool ipv6 name pool_name { location | verbose | }

Syntax Description

pool_name

Specifies the name of the IPv6 pool.

location

Specifies the location of the IPv6 pool.

verbose

Displays all allocations for the pools.

|

Specifies the output modifiers.

Command Default

None

Command Modes

EXEC

Command History

Release Modification

Release 4.3.0

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Use thepool ipv6 command to enter Pool IPv6 configuration submode.

Task ID

Task ID Operation

ip-services

read

Examples

This is the sample output for the show pool ipv6 name command:

RP/0/RSP0/CPU0:router# show pool ipv4 name POOL_A6_i_1
                Pool POOL_A6_i_1 Allocations
---------------------------------------------------
VRF: vrf1
Pool Id: 1
Pool Scope: VRF Specific Pool
Prefix Length: 128

Used:         15797
Excl:             0
Free:           203
Total:        16000

Utilization:    98%

Range List:
-----------
Range Start        :  19::2
Range End          :  19::3e81
Used Addresses     :  15797
Excluded Addresses :  0
Free Addresses     :  203

RP/0/RSP0/CPU0:router# show pool ipv6 name POOL_A6_i_1 verbose

              Pool POOL_A6_i_1 Allocations
---------------------------------------------------
VRF: vrf1
Pool Id: 1
Pool Scope: VRF Specific Pool
Prefix Length: 128

Used:         15797
Excl:             0
Free:           203
Total:        16000

Utilization:    98%

Range List:
-----------
Range Start        :  19::2
Range End          :  19::3e81
Used Addresses     :  15797
Excluded Addresses :  0
Free Addresses     :  203

In-Use Address List:
   19::2  DHCPV6
   19::3  DHCPV6
   19::4  DHCPV6
   19::5  DHCPV6
   19::6  DHCPV6
   19::7  DHCPV6
   19::8  DHCPV6
   19::9  DHCPV6
   19::a  DHCPV6
   19::b  DHCPV6
   19::c  DHCPV6
   19::d  DHCPV6
   19::e  DHCPV6
   19::f  DHCPV6
   19::10  DHCPV6
   19::11  DHCPV6
   19::12  DHCPV6
   19::13  DHCPV6
   19::14  DHCPV6
   19::15  DHCPV6
   19::16  DHCPV6
   19::17  DHCPV6
   19::18  DHCPV6
   19::19  DHCPV6
   19::1a  DHCPV6
   19::1b  DHCPV6
   19::1c  DHCPV6
   19::1d  DHCPV6
   19::1e  DHCPV6
   19::1f  DHCPV6
   19::20  DHCPV6
   19::21  DHCPV6
   19::22  DHCPV6
   19::23  DHCPV6
   19::24  DHCPV6
   19::25  DHCPV6
   19::26  DHCPV6
   19::27  DHCPV6
   19::28  DHCPV6
   19::29  DHCPV6
   19::2a  DHCPV6
   19::2b  DHCPV6
   19::2c  DHCPV6
   19::2d  DHCPV6
   19::2e  DHCPV6
   19::2f  DHCPV6
   19::30  DHCPV6
   19::31  DHCPV6
   19::32  DHCPV6
   19::33  DHCPV6
   19::34  DHCPV6
   19::35  DHCPV6
   19::36  DHCPV6
   19::37  DHCPV6
   19::38  DHCPV6
   19::39  DHCPV6
   19::3a  DHCPV6
   19::3b  DHCPV6
   19::3c  DHCPV6
   19::3d  DHCPV6
   19::3e  DHCPV6
   19::3f  DHCPV6
   19::40  DHCPV6
   19::41  DHCPV6
   19::42  DHCPV6
   19::43  DHCPV6
   19::44  DHCPV6
   19::45  DHCPV6
   19::46  DHCPV6
   19::47  DHCPV6
   19::48  DHCPV6
   19::49  DHCPV6
   19::4a  DHCPV6
   19::4b  DHCPV6
   19::4c  DHCPV6
   19::4d  DHCPV6
   19::4e  DHCPV6
   19::4f  DHCPV6
   19::50  DHCPV6
   19::51  DHCPV6
   19::52  DHCPV6
   19::53  DHCPV6
   19::54  DHCPV6
   19::55  DHCPV6
   19::56  DHCPV6
   19::57  DHCPV6
   19::58  DHCPV6
   19::59  DHCPV6
   19::5a  DHCPV6
   19::5b  DHCPV6
   19::5c  DHCPV6
   19::5d  DHCPV6
   19::5e  DHCPV6
   19::5f  DHCPV6
   19::60  DHCPV6
   19::61  DHCPV6
   19::62  DHCPV6
   19::63  DHCPV6
   19::64  DHCPV6
   19::65  DHCPV6
   19::66  DHCPV6
   19::67  DHCPV6
   19::68  DHCPV6
   19::69  DHCPV6
   19::6a  DHCPV6
   19::6b  DHCPV6
   19::6c  DHCPV6
   19::6d  DHCPV6
   19::6e  DHCPV6
   19::6f  DHCPV6
   19::70  DHCPV6
   19::71  DHCPV6
   19::72  DHCPV6
   19::73  DHCPV6
   19::74  DHCPV6
   19::75  DHCPV6
   19::76  DHCPV6
   19::77  DHCPV6
   19::78  DHCPV6
   19::79  DHCPV6
   19::7a  DHCPV6
   19::7b  DHCPV6
   19::7c  DHCPV6
   19::7d  DHCPV6
   19::7e  DHCPV6
   19::7f  DHCPV6
   19::80  DHCPV6
   19::81  DHCPV6
   19::82  DHCPV6
   19::83  DHCPV6
   19::84  DHCPV6
   19::85  DHCPV6
   19::86  DHCPV6
   19::87  DHCPV6
   19::88  DHCPV6
   19::89  DHCPV6
   19::8a  DHCPV6
   19::8b  DHCPV6
   19::8c  DHCPV6
   19::8d  DHCPV6
   19::8e  DHCPV6
   19::8f  DHCPV6
   19::90  DHCPV6
   19::91  DHCPV6
   19::92  DHCPV6
   19::93  DHCPV6
   19::94  DHCPV6
   19::95  DHCPV6
   19::96  DHCPV6
   19::97  DHCPV6
   19::98  DHCPV6
   19::99  DHCPV6
   19::9a  DHCPV6
   19::9b  DHCPV6
   19::9c  DHCPV6
   19::9d  DHCPV6
   19::9e  DHCPV6
   19::9f  DHCPV6
   19::a0  DHCPV6
   19::a1  DHCPV6
   19::a2  DHCPV6
   19::a3  DHCPV6
   19::a4  DHCPV6
   19::a5  DHCPV6
   19::a6  DHCPV6
   19::a7  DHCPV6
   19::a8  DHCPV6
   19::a9  DHCPV6
   19::aa  DHCPV6
   19::ab  DHCPV6
   19::ac  DHCPV6
   19::ad  DHCPV6
   19::ae  DHCPV6
   19::af  DHCPV6
   19::b0  DHCPV6
   19::b1  DHCPV6
   19::b2  DHCPV6
   19::b3  DHCPV6
   19::b4  DHCPV6
   19::b5  DHCPV6
   19::b6  DHCPV6
   19::b7  DHCPV6
   19::b8  DHCPV6
   19::b9  DHCPV6
   19::ba  DHCPV6
   19::bb  DHCPV6
   19::bc  DHCPV6
   19::bd  DHCPV6
   19::be  DHCPV6
   19::bf  DHCPV6
   19::c0  DHCPV6
   19::c1  DHCPV6
   19::c2  DHCPV6
   19::c3  DHCPV6
   19::c4  DHCPV6
   19::c5  DHCPV6
   19::c6  DHCPV6
   19::c7  DHCPV6
   19::c8  DHCPV6
   19::c9  DHCPV6
   19::ca  DHCPV6
   19::cb  DHCPV6
   19::cc  DHCPV6
   19::cd  DHCPV6
   19::ce  DHCPV6
   19::cf  DHCPV6
   19::d0  DHCPV6
   19::d1  DHCPV6
   19::d2  DHCPV6
   19::d3  DHCPV6
   19::d4  DHCPV6
   19::d5  DHCPV6
   19::d6  DHCPV6
   19::d7  DHCPV6
   19::d8  DHCPV6
   19::d9  DHCPV6
   19::da  DHCPV6
   19::db  DHCPV6
   19::dc  DHCPV6
   19::dd  DHCPV6
   19::de  DHCPV6
   19::df  DHCPV6
   19::e0  DHCPV6
   19::e1  DHCPV6
   19::e2  DHCPV6
   19::e3  DHCPV6
   19::e4  DHCPV6
   19::e5  DHCPV6
   19::e6  DHCPV6
   19::e7  DHCPV6
   19::e8  DHCPV6
   19::e9  DHCPV6
   19::ea  DHCPV6
   19::eb  DHCPV6
   19::ec  DHCPV6
   19::ed  DHCPV6
   19::ee  DHCPV6
   19::ef  DHCPV6
   19::f0  DHCPV6
   19::f1  DHCPV6
   19::f2  DHCPV6
   19::f3  DHCPV6
   19::f4  DHCPV6
   19::f5  DHCPV6
   19::f6  DHCPV6
   19::f7  DHCPV6
   19::f8  DHCPV6
   19::f9  DHCPV6
   19::fa  DHCPV6
   19::fb  DHCPV6
   19::fc  DHCPV6
   19::fd  DHCPV6
   19::fe  DHCPV6
   19::ff  DHCPV6
   19::100  DHCPV6
   19::101  DHCPV6
   19::102  DHCPV6
   19::103  DHCPV6
   19::104  DHCPV6
   19::105  DHCPV6
   19::106  DHCPV6
   19::107  DHCPV6
   19::108  DHCPV6
   19::109  DHCPV6
   19::10a  DHCPV6
   19::10b  DHCPV6
   19::10c  DHCPV6
   19::10d  DHCPV6
   19::10e  DHCPV6
   19::10f  DHCPV6
   19::110  DHCPV6
   19::111  DHCPV6
   19::112  DHCPV6
   19::113  DHCPV6
   19::114  DHCPV6
   19::115  DHCPV6
   19::116  DHCPV6
   19::117  DHCPV6
   19::118  DHCPV6
   19::119  DHCPV6
   19::11a  DHCPV6
   19::11b  DHCPV6
   19::11c  DHCPV6
   19::11d  DHCPV6
   19::11e  DHCPV6

This table describes the significant fields shown in the display.

Table 2 show pool ipv6 name Field Descriptions

Field

Description

VRF

Specifies the VRF the pool is associated with.

Pool ID

The unique pool ID of a specific pool.

Pool Scope

Pool scope belongs to the VRF specific pool.

Prefix Length

Length of the prefix specified.

Related Commands

Command

Description

pool vrf

Enables distributed address pool service on vrf.

pool ipv6

Enables distributed address pool service on ipv6.

exclude

Specifies a range of IP addresses that distributed address pool service should not assign to clients.

address-range

Specifies a range of IP addresses.

show pool vrf

To show the status of VRF pool, use the show pool vrf command in the EXEC mode.

show pool vrf vrf_name{ ipv4| ipv6}

Syntax Description

vrf_name

Specifies the vrf name.

all

Displays all vrfs.

ipv4

Specifies the IPv4 pool.

ipv6

Specifies the IPv6 pool.

|

Specifies the output modifiers.

Command Default

None

Command Modes

EXEC

Command History

Release Modification

Release 4.2.0

This command was introduced.

Release 4.3.0

Support for IPv6 was added.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Use the pool ipv4 command to enter IPv4 pool configuration submode and pool ipv6 command to enter IPv6 pool configuration submode.

Task ID

Task ID Operation

ip-services

read

Examples

This is the sample output of the show pool vrf command for IPv4:

RP/0/RSP0/CPU0:router# show pool vrf vrf1 ipv4

                   Allocation Summary
---------------------------------------------------

Used: 0
Excl: 0
Free: 254
Total: 254
Utilization: 0%


 Pool Name    Pool ID      VRF      Used    Excl    Free   Total
-----------  ---------  ---------  ------  ------  ------ -------
     test1      4        vrf2           0      0    254    254

This is the sample output of the show pool vrf command for IPv6:

RP/0/RSP0/CPU0:router# show pool vrf vrf1 ipv6


                 Allocation Summary
---------------------------------------------------

Used: 2
Excl: 0
Free: 31999
Total: 32001
Utilization: 0%


 Pool Name    Pool ID      VRF      Used    Excl    Free   Total
-----------  ---------  ---------  ------  ------  ------ -------
POOL_A6_i_1      1        vrf1           1      0  15999  16000
POOL_P6_i_2      2        vrf1           1      0  15999  16000
      test      0        vrf1           0      0      1      1

This table describes the significant fields shown in the display.

Table 3 show pool ipv4 name Field Descriptions

Field

Description

VRF

Specifies the VRF the pool is associated with.

Pool ID

The unique pool ID of a specific pool.

Pool Name

The name of the IPv6 pool.

Related Commands

Command

Description

pool vrf

Enables distributed address pool service on vrf.

pool ipv4

Enables distributed address pool service on ipv4.

exclude

Specifies a range of IP addresses that distributed address pool service should not assign to clients.

address-range

Specifies a range of IP addresses.