Broadband Network Gateway Command Reference for Cisco ASR 9000 Series Routers

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 [block]

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.
block	Dynamically blocks one of the networks in the address pool.

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.
Release 6.2.1	Modified the command to include block option.

Usage Guidelines

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.

Dynamic soft pool migration as well as static IP address subscriber management work only if the identity change feature is enabled using subscriber featurette identity-change command. DHCP validates the IP address with DAPS and accordingly rejects the RENEW request from the client, only if the block command is enabled. For more details, refer DHCP soft pool migration feature in Cisco ASR 9000 Series Aggregation Services Router Broadband Network Gateway Configuration Guide.

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

This example shows how to enable dynamic soft pool migration by blocking one of the networks in the address pool:


RP/0/RSP0/CPU0:router#config
RP/0/RSP0/CPU0:router#pool vrf default ipv4 dhcp_192
RP/0/RSP0/CPU0:router#address-range 192.0.2.1 192.0.2.7 block
RP/0/RSP0/CPU0:router#address-range 192.0.2.11 192.0.2.20

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.
subscriber featurette identity-change	Enables identity change for DHCP Remote-Id parameter, thereby allowing modification of the subscriber service

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}

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

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 [default-router default-router-address ] | 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.

default-router

(Optional) Specifies the default-gateway address for the subnet.

default-router-address

IPv4 address of the default-gateway.

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.
Release 5.1	Support for IPv4 default-router was added.

Usage Guidelines

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 ⁹⁶ 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.

The default-router option is supported only for IPv4 pools. The configured default-gateway address is automatically excluded from allocation to clients, if the address is within the subnet range.

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 default-router 11.11.11.11

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.

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

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

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

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

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.

pool onfly pppoe

To enable dynamic modification of DAPS pool for PPPoE sessions, use the pool onfly pppoe command in Global Configuration mode. To disable the feature, use the no form of this command.

pool onfly pppoe

Syntax Description

This command has no keywords or arguments.

Command Default

By default, dynamic modification of DAPS pool for PPPoE sessions is disabled.

Command Modes

Global Configuration

Command History


Release	Modification
Release 7.4.1	This command was introduced for Cisco IOS XR 64-bit platforms.
Release 6.8.1	This command was introduced for Cisco IOS XR 32-bit platforms.

Usage Guidelines

For the subscriber session to be released after the configuration changes are done, you may have to wait for approximately 5 to 20 minutes, depending on the number of IP addresses allocated from an address pool.

Task ID


Task ID	Operation
tunnel	read, write

Examples

This example shows how to enable dynamic modification of DAPS pool for PPPoE sessions:


Router#configure
Router(config)#pool onfly pppoe
Router(config)#commit

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}

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

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.

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

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

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}

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

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.

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}

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

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 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 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 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 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 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 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.

Bias-Free Language

Results

Chapter: Address Pool Service Commands

Address Pool Service Commands

address-range

Syntax Description

Command Default

Command Modes

Command History

Usage Guidelines

Task ID

Examples

Related Commands

exclude

Syntax Description

Command Default

Command Modes

Command History

Usage Guidelines

Task ID

Examples

Related Commands

network (BNG)

Syntax Description

Command Default

Command Modes

Command History

Usage Guidelines

Task ID

Examples

Related Commands

pool ipv4

Syntax Description

Command Default

Command Modes

Command History

Usage Guidelines

Task ID

Examples

Related Commands

pool ipv6

Syntax Description

Command Default

Command Modes

Command History

Usage Guidelines

Task ID

Examples

Related Commands

pool onfly pppoe

Syntax Description

Command Default

Command Modes

Command History

Usage Guidelines

Task ID

Examples

pool vrf

Syntax Description

Command Default

Command Modes

Command History

Usage Guidelines

Task ID

Examples

Related Commands

prefix-length

Syntax Description

Command Default

Command Modes

Command History

Usage Guidelines

Task ID

Examples

Related Commands

prefix-range

Syntax Description

Command Default

Command Modes