Cisco ASR 9000 Series Aggregation Services Router Broadband Network Gateway Command Reference, Release 5.1.x
BNG DHCP Commands
Downloads: This chapterpdf (PDF - 1.66MB) The complete bookPDF (PDF - 4.65MB) | Feedback

BNG DHCP Commands

Contents

BNG DHCP Commands

This module describes the Cisco IOS XR software commands used to configure the DHCP commands for Broadband Network Gateway (BNG) on the Cisco ASR 9000 Series Router. For details regarding the related configurations, refer to the Cisco ASR 9000 Series Aggregation Services Router Broadband Network Gateway Configuration Guide.

address-pool

To specify the name of an address pool by integrating the DHCPv6 sever with distributed address pool service (DAPS), use the address-pool command in the DHCP IPv6 server profile class configuration mode. To remove the address pool name, use the no form of this command.

address-pool pool_name

no address-pool pool_name

Syntax Description

pool_name

Specifies the name of a address pool.

Command Default

None

Command Modes

DHCP IPv6 server profile class 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.

To enter the DHCP IPv6 server profile configuration, enter profile profile_name server command in the DHCPv6 configuration mode.

To enter the DHCP IPv6 server profile class configuration, enter class class_name command in the DHCPv6 server profile configuration mode.

Task ID

Task ID

Operations

ip-services

read, write

Examples

This is an example of creating a address-pool name using the address-pool command:

RP/0/RSP0/CPU0:router(config)# dhcp ipv6
RP/0/RSP0/CPU0:router(config-dhcpv6)# profile my_profile server
RP/0/RSP0/CPU0:router(config-dhcpv6-server-profile)# class class_dhcp
RP/0/RSP0/CPU0:router(config-dhcpv6-server-profile-class)# address-pool pool_addr

aftr-name

To set the Address Family Transition Router's (AFTR) name for Dual-stack Lite support, use the aftr-name command in DHCPv6 server profile configuration mode. To disable the AFTR-name, use the no form of this command.

aftr-name aftr-name

no aftr-name aftr-name

Syntax Description

aftr-name

Specifies the AFTR fully qualified domain name for the server profile.

Command Default

Dual-stack support is not enabled.

Command Modes

DHCPv6 server profile 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.

Task ID

Task ID Operation

ip-services

read, write

Examples

This example shows how to configure the AFTR Fully Qualified Domain Name (FQDN) for a server profile:

RP/0/RSP0/CPU0:router(config)# dhcp ipv6
RP/0/RSP0/CPU0:router(config-dhcpv6)# profile my_profile server
RP/0/RSP0/CPU0:router(config-dhcpv6-server-profile)# aftr-name aftr-server.example.com

broadcast-flag policy check (BNG)

To configure Dynamic Host Configuration Protocol (DHCP) IPv4 Relay to broadcast only BOOTREPLY packets if the DHCP IPv4 broadacst flag is set in the DHCP IPv4 header, use the broadcast-flag policy check command in DHCP IPv4 relay profile configuration submode or DHCP IPv4 server profile configuration submode. By default, the DHCP IPv4 Relay always broadcasts BOOTREPLY packets. To restore the default, use the no form of this command.

broadcast-flag policy{ check | unicast-always }

no broadcast-flag policy{ check | unicast-always }

Syntax Description

check

Checks the broadcast flag in packets.

unicast-always

Sets the broadcast-flag policy to unicast-always.

Command Default

Relay agent always broadcasts DHCP IPv4 packets to a client.

Command Modes

DHCP IPv4 relay profile configuration

DHCP IPv4 server profile

Command History

Release

Modification

Release 3.7.0

This command was introduced.

Release 4.2.0

This command was supported for BNG.

Release 5.1

The unicast-always keyword 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.

Task ID

Task ID

Operations

ip-services

read, write

Examples

This an example of the broadcast-flag policy check command:

RP/0/RSP0/CPU0:router# config
RP/0/RSP0/CPU0:router(config)# dhcp ipv4
RP/0/RSP0/CPU0:router(config-dhcpv4)# profile client relay
RP/0/RSP0/CPU0:router(config-dhcpv4-relay-profile)# broadcast-flag policy check

This an example of the broadcast-flag policy command:

RP/0/RSP0/CPU0:router# config
RP/0/RSP0/CPU0:router(config)# dhcp ipv4
RP/0/RSP0/CPU0:router(config-dhcpv4)# profile TEST server
RP/0/RSP0/CPU0:router(config-dhcpv4-server-profile)# broadcast-flag policy unicast-always

Related Commands

Command

Description

dhcp ipv4 (BNG)

Enables DHCP for IPv4 and enters DHCP IPv4 configuration mode.

Configures the DHCP relay agent to relay packets to a specific DHCP server.

relay information check (BNG)

Configures a DHCP server to validate the relay agent information option in forwarded BOOTREPLY messages.

relay information option (BNG)

Enables the system to insert a DHCP relay agent information option in forwarded BOOTREQUEST messages to a DHCP server.

relay information option allow-untrusted (BNG)

Configures the DHCP component to not drop BOOTREQUEST messages that have the relay information option set and the giaddr set to zero.

Configures how a relay agent processes BOOTREQUEST messages that already contain a relay information option.

class

To create a proxy profile class and to enter the proxy profile class sub configuration mode, use the class command in an appropriate configuration mode. To disable this feature and exit the profile mode, use the no form of this command.

class class_name { helper-address | match } { address-pool | dns-server | domain-name | prefix-pool }

no class class_name

Syntax Description

class_name

Specifies the class name.

helper-address

Specifies the server address to relay packets.

match

Inserts a match keyword.

address-pool

Specifies the name of the address pool

dns-server

Specifies the name of a dns server.

domain-name

Specifies the name of a domain.

prefix-pool

Specifies the name of the prefix pool.

Command Default

No class is specified.

Command Modes

DHCP IPv4 proxy profile configuration

DHCP IPv6 proxy profile configuration

DHCP IPv6 server profile configuration

Command History

Release Modification

Release 4.2.0

This command was introduced.

Release 4.3.0

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

The class submode is present in both DHCP IPv6 proxy profile configuration and DHCP IPv6 server profile configuration submodes. A class is associated with a match criterion, which is used to determine if the class is applied to a subscriber or not. The class name needs to be unique for the system.


Note


The address-pool, dns-server, domain-name, and prefix-pool keywords appear only in the DHCP IPv6 server profile configuration mode. However, the helper-address keywords appears in both DHCP IPv4 proxy profile configuration and DHCP IPv6 proxy profile configuration modes.


Task ID

Task ID Operation

ip-services

read, write

Examples

This example shows how to create a class in the DHCP IPv4 proxy profile configuration mode:

RP/0/RSP0/CPU0:router(config)# dhcp ipv4
RP/0/RSP0/CPU0:router(config-dhcpv4)# profile dhcp_profile proxy
RP/0/RSP0/CPU0:router(config-dhcpv4-proxy-profile)# class blue
This example shows how to create a class in the DHCP IPv6 proxy profile configuration mode:
RP/0/RSP0/CPU0:router(config)# dhcp ipv6
RP/0/RSP0/CPU0:router(config-dhcpv6)# profile dhcp_profile1 proxy
RP/0/RSP0/CPU0:router(config-dhcpv4-proxy-profile)# class blue
This example shows how to create a class in the DHCP IPv6 server profile configuration mode:
RP/0/RSP0/CPU0:router(config)# dhcp ipv4
RP/0/RSP0/CPU0:router(config-dhcpv6)# profile dhcp_profile2 server
RP/0/RSP0/CPU0:router(config-dhcpv4-server-profile)# class red

Related Commands

Command

Description

class-map type control subscriber

This topic describes the class-map type control subscriber command.  

dhcp ipv4 (BNG)

To enable Dynamic Host Configuration Protocol (DHCP) for IPv4 and to enter DHCP IPv4 configuration mode, use the dhcp ipv4 command in global configuration mode. To disable DHCP for IPv4 and exit the DHCP IPv4 configuration mode, use the no form of this command.

dhcp ipv4

no dhcp ipv4

Syntax Description

This command has no keywords or arguments.

Command Modes

None

Command Modes

Global configuration

Command History

Release

Modification

Release 3.7.2

This command was introduced.

Release 4.2.0

This command was supported for BNG.

Usage Guidelines

Use the dhcp ipv4 command to enter DHCP IPv4 configuration mode.

Task ID

Task ID

Operations

ip-services

read, write

Examples

This example shows how to enable DHCP for IPv4:


RP/0/RSP0/CPU0:router# dhcp ipv4
RP/0/RSP0/CPU0:router(config-dhcpv4)#

dhcp ipv6 (BNG)

To enable Dynamic Host Configuration Protocol (DHCP) for IPv6 and to enter DHCP IPv6 configuration mode, use the dhcp ipv6 command in global configuration mode. To disable the DHCP for IPv6, use the no form of this command.

dhcp ipv6

no dhcp ipv6

Syntax Description

This command has no keywords or arguments.

Command Modes

Global configuration

Command History

Release

Modification

Release 4.3.0

This command was supported for BNG.

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 dhcp ipv6 command to enter DHCP IPv6 configuration mode.

Task ID

Task ID

Operations

ip-services

read, write

Examples

This example shows how to enable DHCP for IPv6:


RP/0/RSP0/CPU0:router(config)# dhcp ipv6
RP/0/RSP0/CPU0:router(config-dhcpv6)#

dhcpv6 address-pool

To specify addresses for DHCPv6 when Radius does not provide IPv6 address, use the dhcpv6 address-pool command in the dynamic template configuration mode. To remove the IPv6 address pool name for DHCPv6, use the no form of this command.

dhcpv6 address-pool pool_name

no dhcpv6 address-pool pool_name

Syntax Description

pool_name

Specifies the name of a IPv6 address pool name for DHCPv6.

Command Default

None

Command Modes

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

To enter the dynamic template configuration mode, enter dynamic-template command in the global configuration mode.

The IPv6 address pool is used for both PPPoE and IPoE subscribers.

Task ID

Task ID

Operations

config-services

read, write

Examples

This is an example of creating an IPv6 address pool for PPPoE subscribers using the dhcpv6 address-pool command:

RP/0/RSP0/CPU0:router(config)# dynamic-template
RP/0/RSP0/CPU0:router(config-dynamic-template)# type ppp my-ipv6-pppoe-tempate
RP/0/RSP0/CPU0:router(config-dynamic-template-type)# dhcpv6 address-pool my-pppoe-addr-pool

This is an example of creating an IPv6 address pool for IPoE subscribers using the dhcpv6 address-pool command:

RP/0/RSP0/CPU0:router(config)# dynamic-template
RP/0/RSP0/CPU0:router(config-dynamic-template)# type ppp my-ipv6-tempate
RP/0/RSP0/CPU0:router(config-dynamic-template-type)# dhcpv6 address-pool my-ipsub-addr-pool

dhcpv6 delegated-prefix-pool

To specify the default pool name for (IA-PD) prefix delegation when no pool name or prefix is provided by the Radius, use the dhcpv6 delegated-prefix-pool command in the dynamic template configuration mode. To remove the delegated prefix pool name, use the no form of this command.

dhcpv6 delegated-prefix-pool pool_name

no dhcpv6 delegated-prefix-pool pool_name

Syntax Description

pool_name

Specifies the name of a delegated prefix pool for DHCPv6.

Command Default

None

Command Modes

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

To enter the dynamic template configuration mode, enter dynamic-template command in the global configuration mode.

Task ID

Task ID

Operations

config-services

read, write

Examples

This is an example of creating a delegated prefix-pool name using the dhcpv6 delegated-prefix-pool command:

RP/0/RSP0/CPU0:router(config)# dynamic-template
RP/0/RSP0/CPU0:router(config-dynamic-template)# type ipsubscriber ipsub1
RP/0/RSP0/CPU0:router(config-dynamic-template-type)# dhcpv6 delegated-prefix-pool myPool

dns-server (BNG)

To specify the Domain Name System (DNS) IPv6 servers available to a Dynamic Host Configuration Protocol (DHCP) for IPv6 client, use the dns-server command in an appropriate configuration mode. To remove the DNS server list, use the no form of this command.

dns-server ipv6-address

no dns-server ipv6-address

Syntax Description

ipv6-address

IPv6 address of a DNS server.

This argument must be in the form documented in RFC 2373, where the address is specified in hexadecimal using 16-bit values between colons.

Command Default

When a DHCP for IPv6 pool is first created, no DNS IPv6 servers are configured.

Command Modes

DHCP IPv6 server profile configuration

DHCP IPv6 server profile class configuration

Command History

Release

Modification

Release 4.3.0

This command was supported in DHCP IPv6 server profile and class configuration mode in BNG.

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.

Multiple Domain Name System (DNS) server addresses can be configured by issuing this command multiple times. New addresses do not overwrite old addresses.

To enter the DHCP IPv6 server profile configuration, enter profile profile_name server command in the DHCPv6 configuration mode.

To enter the DHCP IPv6 server profile class configuration, enter class class_name command in the DHCPv6 server profile configuration mode.

Task ID

Task ID

Operations

ip-services

read, write

Examples

This is an example of setting the DNS address - 2001:db8:1203::1 and 2001:db8:1204::1 - using the dns-server command in the DHCP IPv6 server profile configuration mode:

RP/0/RSP0/CPU0:router(config)# dhcp ipv6
RP/0/RSP0/CPU0:router(config-dhcpv6)# profile my_profile server
RP/0/RSP0/CPU0:router(config-dhcpv6-server-profile)# dns-server 2001:db8:1203::1 and 2001:db8:1204::1

This is an example of setting the DNS address - 2001:db8:1203::1 and 2001:db8:1204::1 - using the dns-server command in the DHCP IPv6 server profile class configuration mode:

RP/0/RSP0/CPU0:router(config)# dhcp ipv6
RP/0/RSP0/CPU0:router(config-dhcpv6)# profile my_profile server
RP/0/RSP0/CPU0:router(config-dhcpv6-server-profile)# class proxy-red
RP/0/RSP0/CPU0:router(config-dhcpv6-server-profile-class)# dns-server 2001:db8:1203::1 and 2001:db8:1204::1

domain-name (DHCP IPv6 pool-BNG)

To configure a domain name for a Dynamic Host Configuration Protocol (DHCP) for IPv6 client, use the domain-name command in an appropriate configuration mode. To remove the domain name, use the no form of this command.

domain-name domain

no domain-name

Syntax Description

domain

Specifies the domain name string to be used by the client.

Command Default

When a DHCP for IPv6 pool is first created, no domain name for clients is configured.

Command Modes

DHCP IPv6 server profile configuration

DHCP IPv6 server profile class configuration

Command History

Release

Modification

Release 4.3.0

This command was supported in DHCP IPv6 server profile and class configuration mode in BNG.

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.

Multiple Domain Name System (DNS) domain names can be configured by issuing the domain-name command multiple times. The new domain name does not overwrite existing domain names.

To enter the DHCP IPv6 server profile configuration, enter profile profile_name server command in the DHCPv6 configuration mode.

To enter the DHCP IPv6 server profile class configuration, enter class class_name command in the DHCPv6 server profile configuration mode.

The domain name is defined in DHCP IPv6 server profile and DHCP IPv6 server profile class configuration. If the same parameters are defined in the class scope, then the values defined in the class scope takes precedence.

Task ID

Task ID

Operations

ip-services

read, write

Examples

This is an example of setting the domain name using the domain-name command in the DHCP IPv6 server profile configuration mode:

RP/0/RSP0/CPU0:router(config)# dhcp ipv6
RP/0/RSP0/CPU0:router(config-dhcpv6)# profile my_profile server
RP/0/RSP0/CPU0:router(config-dhcpv6-server-profile)# domain-name my.domain.com

This is an example of setting the domain name using the domain-name command in the DHCP IPv6 server profile class configuration mode:

RP/0/RSP0/CPU0:router(config)# dhcp ipv6
RP/0/RSP0/CPU0:router(config-dhcpv6)# profile my_profile server
RP/0/RSP0/CPU0:router(config-dhcpv6-server-profile)# class proxy-red
RP/0/RSP0/CPU0:router(config-dhcpv6-server-profile-class)# domain-name my.domain.com

framed-prefix-pool

To specify the default pool name for ipv6 prefixes for assignment only from SLAAC (Stateless Address Auto-Configuration), use the framed-prefix-pool command in the dynamic template configuration mode. To remove the framed prefix pool name, use the no form of this command.

framed-prefix-pool pool_name

no framed-prefix-pool pool_name

Syntax Description

pool_name

Specifies the name of a prefix pool.

Command Default

None

Command Modes

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

To enter the dynamic template configuration mode, enter dynamic-template command in the global configuration mode.

The dynamic template configuration is used when Radius does not return pool name or prefix for the SLAAC.

Task ID

Task ID

Operations

config-services

read, write

Examples

This is an example of creating a framed prefix pool name using the framed-prefix-pool command:

RP/0/RSP0/CPU0:router(config)# dynamic-template
RP/0/RSP0/CPU0:router(config-dynamic-template)# type ipv6
RP/0/RSP0/CPU0:router(config-dynamic-template-type)# framed-prefix-pool my-slaac-pool

helper-address (BNG)

To configure the Dynamic Host Configuration Protocol (DHCP) IPv4 and IPv6 relay agent to relay BOOTREQUEST packets to a specific DHCP server, use the helper-address command in an appropriate configuration mode. Use the no form of this command to clear the address.

helper-address [ vrf vrf-name ] [ address] [ giaddr gateway-address]

no helper-address [ vrf vrf-name ] [ address] [ giaddr gateway-address]

Syntax Description

vrf-name

(Optional) Specifies the name of a particular VRF.

address

IPv4 and Pv6 address in four part, dotted decimal format.

giaddr gateway-address

Specifies the gateway address to use in packets relayed to server.

Command Default

Helper address is not configured.

Command Modes

DHCP IPv6 proxy profile class configuration

Command History

Release

Modification

Release 3.7.2

This command was introduced.

Release 4.2.0

This command was supported for BNG.

Release 4.3.0

The support for IPv6 was added in BNG.

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.

A maximum of upto eight helper addresses can be configured.

Task ID

Task ID

Operations

ip-services

read, write

Examples

This example shows how to set the helper-address for a VRF using the helper-address command in DHCP IPv6 proxy profile class configuration mode:

RP/0/RSP0/CPU0:router# config
RP/0/RSP0/CPU0:router(config)# dhcp ipv6
RP/0/RSP0/CPU0:router(config-dhcpv6)# profile myprofile proxy
RP/0/RSP0/CPU0:router(config-dhcpv4-proxy-profile)# class myclass
RP/0/RSP0/CPU0:router(config-dhcpv4-proxy-profile-class)#  helper-address vrf my-server-vrf 1:1:1::1

Related Commands

Command

Description

dhcp ipv4 (BNG)

Enables Dynamic Host Configuration Protocol (DHCP) for IPv4 and enters DHCP IPv4 configuration mode.

relay information check (BNG)

Configures a DHCP server to validate the relay agent information option in forwarded BOOTREPLY messages.

relay information option (BNG)

Enables the system to insert a DHCP relay agent information option in forwarded BOOTREQUEST messages to a DHCP server.

relay information option allow-untrusted (BNG)

Configures the DHCP component to not drop BOOTREQUEST messages that have the relay information option set and the giaddr set to zero.

relay information policy (BNG)

Configures how a relay agent processes BOOTREQUEST messages that already contain a relay information option.

interface (DHCP-BNG)

To enable Dynamic Host Configuration Protocol (DHCP) for IPv4 or IPv6 on an interface, use the interface command in the appropriate configuration mode. To disable DHCPv4 or DHCPv6 on an interface, use the no form of the command.

interface type interface-path-id { server | relay | | proxy }

no interface type interface-path-id { relay | | proxy | server }

Syntax Description

type

Interface type. For more information, use the question mark (?) online help function.

interface-path-id

Physical interface or virtual interface.

Note   

Use the show interfaces command to see a list of all interfaces currently configured on the router.

For more information about the syntax for the router, use the question mark (?) online help function.

server

Attaches a server profile for the specified interface.

relay

Specifies a destination address.

proxy

Specifies the proxy and assigns option 82 to an interface.

Command Default

None

Command Modes

DHCP IPv6 configuration

Command History

Release

Modification

Release 4.3.0

The support for IPv6 was added in BNG.

Release 5.1

Support for server profile was added.

Task ID

Task ID

Operations

ip-services

read, write

Examples

This is an example of enabling the DHCP interface mode on a Packet over Sonet/SDH (POS) interface using the interface command:

RP/0/RSP0/CPU0:router(config)# dhcp ipv6
RP/0/RSP0/CPU0:router(config-dhcpv6)# interface POS 0/5/0/0 relay

This is an example of enabling the DHCP interface mode on a Packet over Sonet/SDH (POS) interface using the interface command:


RP/0/RSP0/CPU0:router(config)# dhcp ipv4
RP/0/RSP0/CPU0:router(config-dhcpv4)# interface POS 0/5/0/0 server profile TEST


Related Commands

Command

Description

dhcp ipv6 (BNG)

Enables Dynamic Host Configuration Protocol (DHCP) for IPv6 and enters DHCP IPv6 configuration mode.

dhcp ipv4 (BNG)

Enables Dynamic Host Configuration Protocol (DHCP) for IPv4 and enters DHCP IPv4 configuration mode.

show dhcp ipv6 interface

Displays DHCP for IPv6 interface information.

interface subscriber-pppoe profile

To enable the PPPoE subscribers to use a profile for all the PPPoE subscribers, use the interface subscriber-pppoe profile command in the DHCP IPv6 configuration mode. To disable this feature, use the no form of this command.

interface subscriber-pppoe profile profile_name

no interface subscriber-pppoe profile profile_name

Syntax Description

profile_name

Specifies the name of the profile.

Command Default

VRF is disabled.

Command Modes

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

Task ID

Task ID

Operations

ip-services

read, write

Examples

This is an example for enabling PPPoE subscribers to use the "my-def-pppoe-green" profile for all the PPPoE subscribers using the interface subscriber-pppoe profile command:
RP/0/RSP0/CPU0:router(config)# dhcp ipv6
RP/0/RSP0/CPU0:router(config-dhcpv6)#  interface subscriber-pppoe profile my-def-pppoe-green

lease

To set a client lease time on a per profile basis, use the lease command in DHCPv6 server profile configuration mode. To disable the client lease time, use the no form of this command.

lease { { days | hours | minutes } | infinite }

no lease { { days | hours | minutes } | infinite }

Syntax Description

days

Specifies the number of days for the lease time. The value ranges from 1 to 365.

hours

Specifies the number of hours for the lease time. The value ranges from 0 to 23.

minutes

Specifies the number of minutes for the lease time. The value ranges from 0 to 59.

infinite

Specifies an infinite amount of lease.

Command Default

Lawful intercept is not enabled.

Command Modes

DHCPv6 server profile 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.

The lease time is applied to the class only and not to the whole profile. When both profile and class lease times are present, then the class lease time is applied. The default lease time is 1 day, when no lease time configuration exists.

The lease time is specified in seconds or date format.

Task ID

Task ID Operation

ip-services

read, write

Examples

This example shows how to configure lease time for 1 day, 6 hours, and 0 minutes:

RP/0/RSP0/CPU0:router(config)# dhcp ipv6
RP/0/RSP0/CPU0:router(config-dhcpv6)# profile my_profile server
RP/0/RSP0/CPU0:router(config-dhcpv6-server-profile)# lease 1 6 0
This example shows how to configure infinite amount of lease time:
RP/0/RSP0/CPU0:router(config)# dhcp ipv6
RP/0/RSP0/CPU0:router(config-dhcpv6)# profile my_profile server
RP/0/RSP0/CPU0:router(config-dhcpv6-server-profile)# lease infinite

match option

To match the proxy with the configured pattern, use the match option command in the DHCP IPv4 proxy profile class configuration mode. To disable the match option, use the no form of the command.

match option { 124 | 125 | | 60 | 77 } hex hex_string mask bit_mask_string

no match option { 124 | 125 | | 60 | 77 } hex hex_string mask bit_mask_string

Syntax Description

124

Inserts option 124 vendor-identifying vendor class.

125

Inserts option 125 vendor-identifying vendor-specific info.

60

Inserts option 60 vendor class ID.

77

Inserts option 124 user class.

hex

Inserts a hex pattern.

hex_string

Specifies the hex pattern string.

mask

Inserts bit mask pattern.

bit_mask_string

Specifies the bit mask pattern string. The string pattern is between 0 and 4294967295.

Command Default

None

Command Modes

DHCP IPv4 proxy profile class configuration

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.

Task ID

Task ID Operation

ip-services

read, write

Examples

This is an example of configuring the match option command in the DHCP IPv4 proxy profile class configuration mode:

RP/0/RSP0/CPU0:router(config)# dhcp ipv4
RP/0/RSP0/CPU0:router(config-dhcpv4)# profile dhcp_profile proxy
RP/0/RSP0/CPU0:router(config-dhcpv4-proxy-profile)# class blue
RP/0/RSP0/CPU0:router(config-dhcpv4-proxy-profile-class)# match option 124 hex hex_name mask 3445

Related Commands

Command

Description

class

Creates a proxy profile class and enters the proxy profile class sub configuration mode.  

match vrf

To match class based on VRF name, use the match vrf command in the DHCP IPv4 proxy profile class configuration mode. To disable the match vrf, use the no form of the command.

match vrf vrf_name

no match vrf vrf_name

Syntax Description

vrf_name

Specifies the VRF name.

Command Default

None

Command Modes

DHCP IPv4 proxy profile class configuration

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.

Task ID

Task ID Operation

ip-services

read, write

Examples

This is an example of configuring the match vrf command

RP/0/RSP0/CPU0:router(config)# dhcp ipv4
RP/0/RSP0/CPU0:router(config-dhcpv4)# profile dhcp_profile proxy
RP/0/RSP0/CPU0:router(config-dhcpv4-proxy-profile)# class blue
RP/0/RSP0/CPU0:router(config-dhcpv4-proxy-profile-class)# match vrf vrf1

Related Commands

Command

Description

match option

Matches the proxy with the configured pattern.  

prefix-pool

To specify the name of prefix pool by integrating the DHCPv6 sever with distributed address pool service (DAPS), use the prefix-pool command in the DHCP IPv6 server profile class configuration mode. To remove the prefix pool name, use the no form of this command.

prefix-pool pool_name

no prefix-pool pool_name

Syntax Description

pool_name

Specifies the name of a prefix pool.

Command Default

When a DHCP for IPv6 pool is first created, no DNS IPv6 servers are configured.

Command Modes

DHCP IPv6 server profile class 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.

To enter the DHCP IPv6 server profile configuration, enter profile profile_name server command in the DHCPv6 configuration mode.

To enter the DHCP IPv6 server profile class configuration, enter class class_name command in the DHCPv6 server profile configuration mode.

Task ID

Task ID

Operations

ip-services

read, write

Examples

This is an example of creating a prefix-pool name using the prefix-pool command:

RP/0/RSP0/CPU0:router(config)# dhcp ipv6
RP/0/RSP0/CPU0:router(config-dhcpv6)# profile my_profile server
RP/0/RSP0/CPU0:router(config-dhcpv6-server-profile)# class class_dhcp
RP/0/RSP0/CPU0:router(config-dhcpv6-server-profile-class)# prefix-pool pool1

profile (BNG)

To specify a DHCP profile for the Dynamic Host Configuration Protocol (DHCP) IPv4 and IPv6 component and to enter the profile mode, use the profile command in DHCP IPv4 or DHCP IPv6 configuration submode. To disable a profile and exit the profile mode, use the no form of this command.

profile profile_name { proxy | server }

no profile profile_name proxy

Syntax Description

profile_name

Specifies the name of the profile that uniquely identifies the proxy or server.

proxy

Creates a DHCP proxy profile.

server

Creates a DHCP server profile.

Command Default

None

Command Modes

DHCP IPv4 configuration

DHCP IPv6 configuration

Command History

Release

Modification

Release 4.2.0

This command was introduced.

Release 4.3.0

Support was added for IPv6.

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.

Task ID

Task ID

Operations

ip-services

read, write

Examples

This example shows how to enable the dhcpv4 configuration mode and how to create a profile called dhcp_profile in the dhcpv4 configuration submode:

RP/0/RSP0/CPU0:router(config)# dhcp ipv4
RP/0/RSP0/CPU0:router(config-dhcpv4)# profile dhcp_profile proxy
RP/0/RSP0/CPU0:router(config-dhcpv4-proxy-profile)# 
This example shows how to enable the dhcpv6 configuration mode and how to create a profile called dhcp_v6 in the dhcpv6 configuration submode:
RP/0/RSP0/CPU0:router(config)# dhcp ipv6
RP/0/RSP0/CPU0:router(config-dhcpv6)# profile dhcp_v6 proxy
RP/0/RSP0/CPU0:router(config-dhcpv6-proxy-profile)# 

relay information authenticate (BNG)

To specify relay agent information option to the policy plane for authentication purposes, use the relay information authenticate command in the DHCP IPv4 proxy profile configuration mode. To disable the relay option, use the no form of this command.

relay information authenticate { received | inserted }

no relay information authenticate { received | inserted }

Syntax Description

received

Authenticate using received relay agent information option.

inserted

Authenticate using inserted relay agent information option.

Command Default

None

Command Modes

DHCP IPv4 proxy profile configuration

Command History

Release

Modification

Release 4.3.1

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.

Task ID

Task ID

Operations

ip-services

read, write

Examples

This example shows how to specify the received relay agent information option for authentication using the relay information authenticate command in DHCP IPv4 proxy profile configuration mode:
RP/0/RSP0/CPU0:router# config
RP/0/RSP0/CPU0:router(config)# dhcp ipv4
RP/0/RSP0/CPU0:router(config-dhcpv4)# profile myprofile proxy
RP/0/RSP0/CPU0:router(config-dhcpv4-proxy-profile)# relay information authenticate received

Related Commands

Command

Description

dhcp ipv4 (BNG)

Enables Dynamic Host Configuration Protocol (DHCP) for IPv4 and enters DHCP IPv4 configuration mode.

relay information check (BNG)

Configures a DHCP server to validate the relay agent information option in forwarded BOOTREPLY messages.

relay information option (BNG)

Enables the system to insert a DHCP relay agent information option in forwarded BOOTREQUEST messages to a DHCP server.

relay information option allow-untrusted (BNG)

Configures the DHCP component to not drop BOOTREQUEST messages that have the relay information option set and the giaddr set to zero.

relay information policy (BNG)

Configures how a relay agent processes BOOTREQUEST messages that already contain a relay information option.

relay information check (BNG)

To configure a Dynamic Host Configuration Protocol (DHCP) IPv4 Relay to validate the relay agent information option in forwarded BOOTREPLY messages, use the relay information check command in DHCP IPv4 relay profile configuration submode. To disable this feature, use the no form of this command.

relay information check

no relay information check

Syntax Description

This command has no keywords or arguments.

Command Default

DHCP validates the relay agent information option.

Command Modes

DHCP IPv4 relay profile configuration

Command History

Release

Modification

Release 3.7.2

This command was introduced.

Release 4.2.0

This command was supported for BNG.

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.

Task ID

Task ID

Operations

ip-services

read, write

basic-services

read, write

Examples

This example shows how to use the relay information check command:

RP/0/RSP0/CPU0:router#config 
RP/0/RSP0/CPU0:router(config)# dhcp ipv4
RP/0/RSP0/CPU0:router(config-dhcpv4)# profile client relay
RP/0/RSP0/CPU0:router(config-dhcpv4-relay-profile)# relay information check 

Related Commands

Command

Description

dhcp ipv4 (BNG)

Enables DHCP for IPv4 and enters DHCP IPv4 configuration mode.

Configures the DHCP relay agent to relay packets to a specific DHCP Server.

profile (BNG)

Configures a relay profile for the DHCP IPv4 component.

relay information option (BNG)

Enables the system to insert a DHCP relay agent information option in forwarded BOOTREQUEST messages to a DHCP server.

relay information option allow-untrusted (BNG)

Configures the DHCP component to not drop BOOTREQUEST messages that have the relay information option set and the giaddr set to zero.

relay information option (BNG)

To configure Dynamic Host Configuration Protocol (DHCP) IPv4 relay or DHCP snooping Relay to insert relay agent information option in forwarded BOOTREQUEST messages to a DHCP server, use the relay information option command in DHCP IPv4 relay profile relay configuration or DHCP IPv4 profile snoop submode. To disable inserting relay information into forwarded BOOTREQUEST messages, use the no form of this command.

relay information option

no relay information option

Syntax Description

This command has no keywords or arguments.

Command Default

None

Command Modes


            DHCP IPv4
            relay
            profile
            relay
            configuration
        

DHCP IPv4 profile snoop configuration

Command History

Release

Modification

Release 3.7.2

This command was introduced.

Release 4.2.0

This command was supported for BNG.

Usage Guidelines

The relay information option command automatically adds the circuit identifier suboption and the remote ID suboption to the DHCP relay agent information option.

The relay information option command enables a DHCP server to identify the user (for example, cable access router) sending the request and initiate appropriate action based on this information. By default, DHCP does not insert relay information.

If the information option command is enabled, DHCP snooping mode does not set the giaddr field in the DHCP packet.

The upstream DHCP server or DHCP relay interface must be configured to accept this type of packet using the relay information option allow-untrusted configuration. This configuration prevents the server or relay from dropping the DHCP message.

Task ID

Task ID

Operations

ip-services

read, write

basic-services

read, write

Examples

This example shows how to use the relay information option command:

RP/0/RSP0/CPU0:router# config
RP/0/RSP0/CPU0:router(config)# dhcp ipv4
RP/0/RSP0/CPU0:router(config-dhcpv4)# profile client relay
RP/0/RSP0/CPU0:router(config-dhcpv4-relay-profile)# relay information option

Related Commands

Command

Description

dhcp ipv4 (BNG)

Enables DHCP for IPv4 and enters DHCP IPv4 configuration mode.

Configures the DHCP relay agent to relay packets to a specific DHCP Server.

relay information check (BNG)

Configures a DHCP server to validate the relay agent information option in forwarded BOOTREPLY messages.

relay information option allow-untrusted (BNG)

Configures the DHCP component to not drop BOOTREQUEST messages that have the relay information option set and the giaddr set to zero.

relay information option allow-untrusted (BNG)

To configure the Dynamic Host Configuration Protocol (DHCP) IPv4 relay or DHCP snooping Relay not to drop discard BOOTREQUEST packets that have the relay information option set and the giaddr set to zero, use the relay information option allow-untrusted command in DHCP IPv4 relay profile configuration submode or DHCP IPv4 profile snoop configuration submode. To restore the default behavior, which is to discard the BOOTREQUEST packets that have the relay information option and set the giaddr set to zero, use the no form of this command.

relay information option allow-untrusted

no relay information option allow-untrusted

Syntax Description

This command has no keywords or arguments.

Command Default

The packet is dropped if the relay information is set and the giaddr is set to zero.

Command Modes


            DHCP IPv4
            relay
            profile
            relay
            configuration
        

DHCP IPv4 profile snoop configuration

Command History

Release

Modification

Release 3.7.2

This command was introduced.

Release 4.2.0

This command was supported for BNG.

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.

According to RFC 3046, relay agents (and servers) receiving a DHCP packet from an untrusted circuit with giaddr set to zero but with a relay agent information option already present in the packet shall discard the packet and increment an error count. This configuration prevents the server or relay from dropping the DHCP message.

Task ID

Task ID

Operations

ip-services

read, write

basic-services

read, write

Examples

This example shows how to use the relay information option allow-untrusted command:

RP/0/RSP0/CPU0:router# config
RP/0/RSP0/CPU0:router(config)# dhcp ipv4
RP/0/RSP0/CPU0:router(config-dhcpv4)# profile client relay 
RP/0/RSP0/CPU0:router(config-dhcpv4-relay-profile)# relay information option allow-untrusted

Related Commands

Command

Description

dhcp ipv4 (BNG)

Enables DHCP for IPv4 and enters DHCP IPv4 configuration mode.

Configures the DHCP relay agent to relay packets to a specific DHCP Server.

relay information check (BNG)

Configures a DHCP server to validate the relay agent information option in forwarded BOOTREPLY messages.

relay information option (BNG)

Enables the system to insert a DHCP relay agent information option in forwarded BOOTREQUEST messages to a DHCP server.

relay information policy (BNG)

To configure how the Dynamic Host Configuration Protocol (DHCP) IPv4 relay processes BOOTREQUEST packets that already contain a relay information option, use the relay information policy command in DHCP IPv4 relay profile configuration submode. To restore the default relay information policy, use the no form of this command.

relay information policy { drop | keep | encapsulate }

no relay information policy { drop | keep | encapsulate }

Syntax Description

drop

Directs the DHCP IPv4 Relay to discard BOOTREQUEST packets with the existing relay information option.

keep

Directs the DHCP IPv4 Relay not to discard a BOOTREQUEST packet that is received with an existing relay information option and to keep the existing relay information option value.

encapsulate

Encapsulates the DHCP relay agent information option received from a prior relay agent in forwarded BOOTREQUEST messages.

Command Default

The DHCP IPv4 Relay does not discard a BOOTREQUEST packet that has an existing relay information option. The option and the existing relay information option value is replaced.

Command Modes

DHCP IPv4 relay profile configuration

Command History

Release

Modification

Release 3.7.2

This command was introduced.

Release 4.2.0

This command was supported for BNG.

Release 4.3.1

The encapsulate keyword 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.

The encapsulate keyword allows the second relay agent to encapsulate option 82 information in a message received from the first relay agent, if it is also configured to add its own option 82 information. This configuration allows the DHCP server to use option 82 information from both relay agents.

Task ID

Task ID

Operations

ip-services

read, write

basic-services

read, write

Examples

This is sample output from executing the relay information policy command:

RP/0/RSP0/CPU0:router# config
RP/0/RSP0/CPU0:router(config)# dhcp ipv4
RP/0/RSP0/CPU0:router(config-dhcpv4)# profile client relay
RP/0/RSP0/CPU0:router(config-dhcpv4-relay-profile)# relay information policy keep

This example shows how to encapsulate the DHCP relay agent information option:

RP/0/RSP0/CPU0:router# config
RP/0/RSP0/CPU0:router(config)# dhcp ipv4
RP/0/RSP0/CPU0:router(config-dhcpv4)# profile client relay
RP/0/RSP0/CPU0:router(config-dhcpv4-relay-profile)# relay information policy encapsulate

Related Commands

Command

Description

dhcp ipv4 (BNG)

Enables DHCP for IPv4 and enters DHCP IPv4 configuration mode.

helper-address (BNG)

Configures the DHCP relay agent to relay packets to a specific DHCP Server.

relay information check (BNG)

Configures a DHCP server to validate the relay agent information option in forwarded BOOTREPLY messages.

relay information option (BNG)

Enables the system to insert a DHCP relay agent information option in forwarded BOOTREQUEST messages to a DHCP server.

relay information option allow-untrusted (BNG)

Configures the DHCP component to not drop BOOTREQUEST messages that have the relay information option set and the giaddr set to zero.

relay option remote-id

To identify the remote host end of the circuit in the DHCPv6 relay agents, use the relay option remote-id command in the DHCP IPv6 proxy profile configuration mode. To disable the relay option, use the no form of this command.

relay option remote-id remote-id-string

no relay option remote-id remote_id

Syntax Description

remote-id-string

(Optional) Specifies the string value for the remote-id.

Command Default

If the remote-id is not provided during configuration, then the default value is used.

Command Modes

DHCP IPv4 proxy profile 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.

The relay option remote-id remote-id option is from the relay agent/proxy to the server. The option provides additional information to the DHCPv6 server. The server may use the information in the option to select parameters specific to particular users, hosts, or subscriber modems. The remote-id field is opaque to server and the server does not parse the value.

Task ID

Task ID

Operations

ip-services

read, write

Examples

This example shows how to set the remote-id value as "my-remote-id-12345" using the relay option remote-id command in DHCP IPv6 proxy profile configuration mode:
RP/0/RSP0/CPU0:router# config
RP/0/RSP0/CPU0:router(config)# dhcp ipv6
RP/0/RSP0/CPU0:router(config-dhcpv6)# profile myprofile proxy
RP/0/RSP0/CPU0:router(config-dhcpv4-proxy-profile)# relay option remote-id my-remote-id-12345

Related Commands

Command

Description

dhcp ipv4 (BNG)

Enables Dynamic Host Configuration Protocol (DHCP) for IPv4 and enters DHCP IPv4 configuration mode.

relay information check (BNG)

Configures a DHCP server to validate the relay agent information option in forwarded BOOTREPLY messages.

relay information option (BNG)

Enables the system to insert a DHCP relay agent information option in forwarded BOOTREQUEST messages to a DHCP server.

relay information option allow-untrusted (BNG)

Configures the DHCP component to not drop BOOTREQUEST messages that have the relay information option set and the giaddr set to zero.

relay information policy (BNG)

Configures how a relay agent processes BOOTREQUEST messages that already contain a relay information option.

limit lease per-circuit-id

To specify the lease limit each circuit id each interface, use the limit lease per-circuit-id command in the DHCP IPv4 sub configuration mode. To disable the lease per-circuit-id, use the no form of this command.

limit lease per-circuit-id value

no limit lease per-circuit-id value

Syntax Description

value

Specifies the limit up to which the lease value can be extended.

Command Default

None

Command Modes

DHCP IPv4 configuration

Command History

Release Modification

Release 4.2.1

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 dhcp ipv4 command to enter DHCP IPv4 configuration mode.

Task ID

Task ID Operation

ip-services

read, write

Examples

This is an example of configuring the limit lease per-circuit-id command in the DHCP IPv4 sub configuration mode:

RP/0/RSP0/CPU0:router(config)# dhcp ipv4
RP/0/RSP0/CPU0:router(config-dhcpv4)# profile myproxyprofile proxy
RP/0/RSP0/CPU0:router(config-dhcpv4)# limit lease per-circuit-id 1000

Related Commands

Command

Description

dhcp ipv4 (BNG)

Enables the Dynamic Host Configuration Protocol (DHCP) for IPv4.  

limit lease per-remote-id

To specify the lease limit per remote id each interface, use the limit lease per-remote-id command in the DHCP IPv4 sub configuration mode. To disable the lease per-remote-id, use the no form of this command.

limit lease per-remote-id value

no limit lease per-remote-id value

Syntax Description

value

Specifies the limit up to which the lease value can be extended.

Command Default

None

Command Modes

DHCP IPv4 configuration

Command History

Release Modification

Release 4.2.1

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 dhcp ipv4 command to enter DHCP IPv4 configuration mode.

Task ID

Task ID Operation

ip-services

read, write

Examples

This is an example of configuring the limit lease per-remote-id command in the DHCP IPv4 sub configuration mode:

RP/0/RSP0/CPU0:router(config)# dhcp ipv4
RP/0/RSP0/CPU0:router(config-dhcpv4)# profile myproxyprofile proxy
RP/0/RSP0/CPU0:router(config-dhcpv4)# limit lease per-remote-id 1000

Related Commands

Command

Description

dhcp ipv4 (BNG)

Enables the Dynamic Host Configuration Protocol (DHCP) for IPv4.  

limit lease per-interface

To specify the lease limit each interface, use the limit lease per-interface command in the DHCP IPv4 sub configuration mode. To disable the limit lease per-interface, use the no form of this command.

limit lease per-interface value

no limit lease per-interface value

Syntax Description

value

Specifies the limit up to which the lease value can be extended.

Command Default

None

Command Modes

DHCP IPv4 configuration

Command History

Release Modification

Release 4.2.1

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 dhcp ipv4 command to enter DHCP IPv4 configuration mode.

Task ID

Task ID Operation

ip-services

read, write

Examples

This is an example of configuring the limit lease per-interface command in the DHCP IPv4 sub configuration mode:

RP/0/RSP0/CPU0:router(config)# dhcp ipv4
RP/0/RSP0/CPU0:router(config-dhcpv4)# profile myproxyprofile proxy
RP/0/RSP0/CPU0:router(config-dhcpv4)# limit lease per-interface 1000

Related Commands

Command

Description

dhcp ipv4 (BNG)

Enables the Dynamic Host Configuration Protocol (DHCP) for IPv4.  

lease proxy client-lease-time

To specify the lease limit each circuit id each interface, use the lease proxy client-lease-time command in the DHCP IPv4 sub configuration mode. To disable the lease proxy client-lease-time, use the no form of this command.

lease proxy client-lease-time value

no lease proxy client-lease-time value

Syntax Description

value

Specifies the time in seconds for the lease proxy client. The minimum value of lease proxy client-time is 600 seconds.

Command Default

If you set the default (no), then the lease proxy gets disabled.

Command Modes

DHCP IPv4 configuration

Command History

Release Modification

Release 4.2.1

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.

When the binding is created, the client-lease-time is cached on a per-binding basis, thus, the changes to the profile client-lease-time does not cause any impact to any existing bindings. However, changes are effective only for subsequently created bindings.

Task ID

Task ID Operation

ip-services

read, write

Examples

This is an example of configuring the lease proxy client-lease-time command in the DHCP IPv4 sub configuration mode:

RP/0/RSP0/CPU0:router(config)# dhcp ipv4
RP/0/RSP0/CPU0:router(config-dhcpv4)# profile myproxyprofile proxy
RP/0/RSP0/CPU0:router(config-dhcpv4)# lease proxy client-lease-time 600

Related Commands

Command

Description

dhcp ipv4 (BNG)

Enables the Dynamic Host Configuration Protocol (DHCP) for IPv4.  

show dhcp ipv4 proxy binding

To show information concerning DHCP client bindings for proxy, use the show dhcp ipv4 proxy binding command in the EXEC mode.

show dhcp ipv4 proxy binding [ circuit-id circuit_id_name | detail | interface | ipspecifier | location | locationspecifier | mac-address | remote-id | summary ] { location | vrf | vrf_name }

Syntax Description

circuit-id

Displays the DHCP IPv4 proxy client binding based on circuit ID.

circuit_id_name

Displays the name of the circuit ID.

detail

Displays detailed binding information for DHCP proxy.

interface

Specifies the interface based on which the DHCP bindings are filtered.

ipspecifier

Displays the name of the interface.

location

Specifies the node location of the DHCP proxy.

locationspecifier

Displays the name of the location.

mac-address

Displays detailed client binding information based on mac-address.

remote-id

Displays the DHCP IPv4 proxy client binding based on remote ID.

summary

Displays the summary binding information for proxy.

vrf

Displays the VRF information.

vrf_name

Displays the name of the VRF.

|

Displays the output modifiers.

Command Default

Displays brief information about all DHCP proxy client bindings.

Command Modes

EXEC

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 the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Task ID

Task ID

Operations

ip-services

read

Examples

This is the sample output of the show dhcp ipv4 proxy binding command:

RP/0/RSP0/CPU0:router# show dhcp ipv4 proxy binding
The show dhcp ipv4 proxy binding output is as follows:
                                                                     Lease                                                
 MAC Address      IP Address      State    Remaining      Interface            VRF      Sublabel      
--------------            --------------     ---------   ---------        -------------------  ---------  ---------- 
0000.6602.0102    1.1.1.1             BOUND    3495         Gi0/1/0/0            default    0x0         


RP/0/RSP0/CPU0:router# show dhcp ipv4 proxy binding mac-address  0000.6602.0102
MAC Address:      0000.6602.0102
IP Address:       1.1.1.1
Profile:          foo
State:            BOUND
Proxy Lease:                    86400 secs (1d00h)
Proxy Lease Remaining:  85942 secs (23:52:22)
Client Lease:                    600 secs (00:10:00)
Client Lease Remaining: 442 secs (00:07:22)
Client ID:        00-00-66-02-01-02
Interface:        GigabitEthernet0/1/0/0.200
VLAN Id:      200
VRF:              default
Subscriber Label: 0x0

RP/0/RSP0/CPU0:router# show dhcp ipv4 proxy binding circuit-id CCCCCCCCCC
MAC Address:      0000.6602.0102
IP Address:       1.1.1.1
circuit-id:  CCCCCCCCCC
remote-id: RRRRRRRRRR
Profile:          foo
State:            BOUND
Proxy Lease:                    86400 secs (1d00h)
Proxy Lease Remaining:  85942 secs (23:52:22)
Client Lease:                    600 secs (00:10:00)
Client Lease Remaining: 442 secs (00:07:22)
Client ID:        00-00-66-02-01-02
Interface:        GigabitEthernet0/1/0/0.200
VLAN Id:      outer 200, inner 300
VRF:              default
Subscriber Label: 0x0

RP/0/RSP0/CPU0:router# show dhcp ipv4 proxy binding remote-id RRRRRRRRRR
MAC Address:      0000.6602.0102
IP Address:       1.1.1.1
Profile:          foo
circuit-id:  CCCCCCCCCC
remote-id: RRRRRRRRRR
State:            BOUND
Proxy Lease:                    86400 secs (1d00h)
Proxy Lease Remaining:  85942 secs (23:52:22)
Client Lease:                    600 secs (00:10:00)
Client Lease Remaining: 442 secs (00:07:22)
Client ID:        00-00-66-02-01-02
Interface:        GigabitEthernet0/1/0/0
VRF:              default
Subscriber Label: 0x0

RP/0/RSP0/CPU0:router# show dhcp ipv4 proxy binding detail
MAC Address:        ca01.3fcd.0000
VRF:                default
IP Address:         10.10.10.6
Gateway IP Address: 0.0.0.0
Server IP Address:  11.11.11.3
ReceivedCircuit ID: -
InsertedCircuit ID: -
ReceivedRemote ID:  -
InsertedRemote ID:  -
Profile:            proxyProfile
State:              BOUND
Proxy Lease:                    86400 secs (1d00h)
Proxy Lease Remaining:  85942 secs (23:52:22)
Client Lease:                    600 secs (00:10:00)
Client Lease Remaining: 442 secs (00:07:22)
Client ID:          0x00-0x76-0x6C-0x61-0x6E-0x31-0x30-0x30
Interface:          GigabitEthernet0/1/0/0.100
VLAN:               None
Subscriber Label:   0x0

RP/0/RSP0/CPU0:router# show dhcp ipv4 proxy binding interface Gi0/1/0/0
                                                                     Lease                                                
 MAC Address      IP Address      State    Remaining      Interface            VRF      Sublabel      
--------------            --------------     ---------   ---------        -------------------  ---------  ---------- 
0000.6602.0102    1.1.1.1             BOUND    3495         Gi0/1/0/0            default    0x0         

Related Commands

Command

Description

dhcp ipv4 (BNG)

Enables the Dynamic Host Configuration Protocol (DHCP) for IPv4.  

show dhcp ipv6 proxy binding (BNG)

Shows the client bindings for Dynamic Host Configuration Protocol (DHCP) proxy.  

show dhcp ipv4 proxy interface (BNG)

To display the proxy interface information for Dynamic Host Configuration Protocol (DHCP) IPv4, use the show dhcp ipv4 proxy interface command in EXEC mode.

show dhcp ipv4 proxy interface [ interface-type interface-name ] [detail]

Syntax Description

interface-type

Type of the proxy interface.

interface-name

Name of the proxy interface.

detail

Displays the detailed information of proxy interface.

Command Default

None

Command Modes

EXEC

Command History

Release Modification

Release 4.2.0

This command was supported for BNG.

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.

Task ID

Task ID Operation

ip-services

read

Examples

This is a sample output from the show dhcp ipv4 proxy interface command:

RP/0/RSP0/CPU0:router# show dhcp ipv4 proxy interface bundle-Ether 70.16 detail
Sat Jan  5 14:25:53.484 UTC

Interface:          Bundle-Ether70.16
VRF:                default
Mode:               Proxy
Profile Name:       proxy1
Lease Limit:        per circuit id from AAA 2

Lease Count Details:
Circuit id from AAA                                               Count
c2                                                                1

This table describes the significant fields shown in the display.

Table 1 show dhcp ipv4 proxy interface Command Field Descriptions

Field

Description

Lease Limit

Specifies the lease limit value sent from AAA server.

Count

Specifies the number of sessions on the router having the specific Circuit-ID received from the AAA server.

show dhcp ipv4 proxy profile

To display Dynamic Host Configuration Protocol (DHCP) proxy profile information, use the show dhcp ipv4 proxy profile command in the EXEC mode.

show dhcp ipv4 proxy profile { name | profile_name | }

Syntax Description

name

Displays the detailed proxy profile information.

profile_name

Specifies the profile name.

|

Displays the output modifiers.

Command Default

None

Command Modes

EXEC

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.

This command displays the proxy profiles created for DHCP IPv4.

Task ID

Task ID

Operations

ip-services

read

Examples

This is the sample output of the show dhcp ipv4 proxy profile command:

RP/0/RSP0/CPU0:router# show dhcp ipv4 proxy profile

The show dhcp ipv4 proxy profile output is as follows:

Wed Jan 23 17:05:49.760 IST

DHCP IPv4 Proxy Profiles
--------------------------
DHCP_PROF_IPSUB

This table describes the significant fields shown in the display.

Table 2 show dhcp ipv4 proxy profile Field Descriptions

Field

Description

DHCP IPv4 Proxy Profiles

Specifies all the DHCP IPv4 proxy profiles.

show dhcp ipv4 proxy statistics

To display statistics for a specific bridge domain, use the show dhcp ipv4 proxy statistics command in the EXEC mode.

show dhcp ipv4 proxy statistics location |]

Syntax Description

location

Specifies the node information for dhcp ipv4 proxy.

|

Displays the output modifiers.

Command Default

Displays a table of DHCP proxy statistics.

Command Modes

EXEC

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 the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Task ID

Task ID

Operations

ip-services

read

Examples

This is the sample output of the show dhcp ipv4 proxy statistics command:

RP/0/RSP0/CPU0:router# show dhcp ipv4 proxy statistics

The show dhcp ipv4 proxy statistics output is as follows:

Wed Jan 23 17:07:12.386 IST

                  VRF                     |      RX       |      TX       |       DR      |
-------------------------------------------------------------------------------------------
default                                  |            0  |            0  |            0  |
**nVSatellite                            |            0  |            0  |            0  |

This table describes the significant fields shown in the display.

Table 3 show dhcp ipv4 proxy statistics Field Descriptions

Field

Description

VRF

Specifies the VRF in the DHCP proxy. The default is nVSatellite.

show dhcp ipv6 proxy binding (BNG)

To display the client bindings for Dynamic Host Configuration Protocol (DHCP) proxy, use the show dhcp ipv6 proxy binding command in EXEC mode.

show dhcp ipv6 proxy binding { detail | duid | interface | interface-id | location | mac-address | remote-id | summary | vrf }

Syntax Description

detail

Displays detailed bindings for proxy.

duid

Displays client bindings for DUID.

interface

Displays client bindings by Interface.

interface-id

Displays client bindings by Interface ID.

location

Specifies the node location.

mac-address

Displays detailed client binding information.

remote-id

Displays client binding by Remote ID.

summary

Displays summary bindings for proxy.

vrf

Displays client bindings by VRF name.

Command Default

None

Command Modes

EXEC

Command History

Release Modification
Release 4.1.1

This command was introduced.

Release 4.3.0

This command was supported for BNG.

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.

Task ID

Task ID Operation

ip-services

read

Examples

This is a sample output from the show dhcp ipv6 proxy binding command:


RP/0/RSP0/CPU0:router# show dhcp ipv6 proxy binding

Summary:
  Total number of Proxy bindings = 1
Prefix: 2001::/60 (Gi0/0/0/1)
  DUID: 00030001ca004a2d0000
  IAID: 00020001
  lifetime: 2592000
  expiration: Nov 25 2010 16:47

RP/0/RSP0/CPU0:router# show dhcp ipv6 proxy binding summary

Total number of clients: 2

     STATE              |             COUNT            |
                        |     IA-NA     |    IA-PD     |
--------------------------------------------------------
  INIT                  |            0  |           0  |
  SUB VALIDATING        |            0  |           0  |
  ADDR/PREFIX ALLOCATING|            0  |           0  |
  REQUESTING            |            0  |           0  |
  SESSION RESP PENDING  |            2  |           0  |
  ROUTE UPDATING        |            0  |           0  |
  BOUND                 |            0  |           0  |

show dhcp ipv6 proxy interface (BNG)

To display the proxy interface information for Dynamic Host Configuration Protocol (DHCP), use the show dhcp ipv6 proxy interface command in EXEC mode.

show dhcp ipv6 proxy interface { type | interface-path-id } { location | location }

Syntax Description

type

Interface type. For more information, use the question mark (?) online help function.

interface-path-id

Physical interface or virtual interface.

Note   

Use the show interfaces command to see a list of all interfaces currently configured on the router.

For more information about the syntax for the router, use the question mark ( ? ) online help function.

location

Displays the node location by Interface.

location

Displays the fully qualified location specification of an interface.

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 appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Task ID

Task ID Operation

ip-services

read

Examples

This is a sample output from the show dhcp ipv6 proxy interface command:


RP/0/RSP0/CPU0:router# show dhcp ipv6 proxy interface 

Tue Sep  4 19:14:54.056 UTC
Codes: Amb - Ambiguous VLAN, B - Base, R - Relay, P - Proxy,
       SR - Server, S - Snoop, C - Client, INV - Invalid
       CID - Circuit Id, RID - Remote Id, INTF - Interface

Interface              Mode Profile Name                             Amb Lease Limit
------------------------------------------------------------------------------------
BE1.100                P    pxy1                                     No  None
BE1.200                P    pxy1                                     No  None
BE1.250                P    pxy1                                     Yes None
BE1.400                P    pxy1                                     Yes None


show dhcp ipv6 proxy profile

To display the proxy profile information for Dynamic Host Configuration Protocol (DHCP) proxy, use the show dhcp ipv6 proxy profile command in EXEC mode.

show dhcp ipv6 proxy profile name profile_name { location | location }

Syntax Description

name

Displays the detailed proxy profile information for the profile.

profile_name

Specifies the name of the profile.

location

Displays the node location by Interface.

location

Displays the fully qualified location specification of an interface.

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 appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Task ID

Task ID Operation

ip-services

read

Examples

This is a sample output from the show dhcp ipv6 proxy profile command:


RP/0/RSP0/CPU0:router# show dhcp ipv6 proxy profile 

Tue Sep  4 05:00:57.938 UTC

DHCP IPv6 Proxy Profiles
--------------------------
pxy1
pxy_pppoe1
pxy_pppoe2
   

show dhcp ipv6 proxy statistics

To display the statistics for Dynamic Host Configuration Protocol (DHCP) proxy, use the show dhcp ipv6 proxy statistics command in EXEC mode.

show dhcp ipv6 proxy statistics { debug | location | vrf }

Syntax Description

debug

Displays the debug statistics for the proxy.

location

Displays the node location for the proxy.

vrf

Displays the proxy statistics by VRF.

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 appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Task ID

Task ID Operation

ip-services

read

Examples

This is a sample output from the show dhcp ipv6 proxy statistics command:


RP/0/RSP0/CPU0:router# show dhcp ipv6 proxy statistics 

Wed Sep  5 01:10:35.650 UTC

                  VRF                     |      RX       |      TX       |       DR      |
-------------------------------------------------------------------------------------------
 default                                  |           23  |           28  |            0  |
 red                                      |            0  |            0  |            0  |
 blue                                     |            0  |            0  |            0  |
 green                                    |            6  |            0  |            0  |
 orange                                   |            0  |            0  |            0  |
 test_vrf                                 |            0  |            0  |            0  |
 dhcpclient                               |            0  |            0  |            0  |
 dhcpserver                               |            0  |            0  |            0  |

show dhcp ipv6 server binding

To display the client bindings for Dynamic Host Configuration Protocol (DHCP) server, use the show dhcp ipv6 server binding command in EXEC mode.

show dhcp ipv6 server binding { detail | duid | interface | interface-id | location | mac-address | remote-id | summary | vrf }

Syntax Description

detail

Displays detailed bindings for proxy.

duid

Displays client bindings for DUID.

interface

Displays client bindings by Interface.

interface-id

Displays client bindings by Interface ID.

location

Specifies the node location.

mac-address

Displays detailed client binding information.

remote-id

Displays client binding by Remote ID.

summary

Displays summary bindings for proxy.

vrf

Displays client bindings by VRF name.

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 appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Task ID

Task ID Operation

ip-services

read

Examples

This is a sample output from the show dhcp ipv6 server binding command:


RP/0/RSP0/CPU0:router# show dhcp ipv6 server binding location 0/RSP0/CPU0 
Summary:
Total number of clients: 3
  DUID  : 000300010000641e0103
  MAC Address: 0000.641e.0103
  Client Link Local: fe80::200:64ff:fe1e:103
  Sublabel: 0x82f
    IA ID: 0xb100
      STATE: BOUND
      IPv6 Prefix:  2004:4:4:6::/64 (Bundle-Ether2.3)
        lifetime  : 600 secs (00:10:00)
        expiration: 327 secs (00:05:27)
  DUID  : 000300010000641e0104
  MAC Address: 0000.641e.0104
  Client Link Local: fe80::200:64ff:fe1e:104
  Sublabel: 0x870
    IA ID: 0xb101
      STATE: BOUND
      IPv6 Prefix:  2004:4:4:a::/64 (Bundle-Ether2.3)
        lifetime  : 600 secs (00:10:00)
        expiration: 327 secs (00:05:27)
  DUID  : 000300010000641e0105
  MAC Address: 0000.641e.0105
  Client Link Local: fe80::200:64ff:fe1e:105
  Sublabel: 0x8b5
    IA ID: 0xb102
      STATE: BOUND
      IPv6 Prefix:  2004:4:4:b::/64 (Bundle-Ether2.3)
        lifetime  : 600 secs (00:10:00)
        expiration: 397 secs (00:06:37)

RP/0/RSP0/CPU0:router# show dhcp ipv6 server binding summary 
Tue Sep  4 04:58:19.580 UTC

Total number of clients: 3

     STATE              |             COUNT            |
                        |     IA-NA     |    IA-PD     |
--------------------------------------------------------
  INIT                  |            0  |           0  |
  SUB VALIDATING        |            0  |           0  |
  ADDR/PREFIX ALLOCATING|            0  |           0  |
  REQUESTING            |            0  |           0  |
  SESSION RESP PENDING  |            0  |           0  |
  ROUTE UPDATING        |            0  |           0  |
  BOUND                 |            0  |           3  |


RP/0/RSP0/CPU0:router#show dhcp ipv6 server binding detail
Tue Sep  4 04:59:41.765 UTC

Client Link Local:      fe80::200:64ff:fe1e:103
MAC Address:            0000.641e.0103
Profile:                test
Client DUID:            000300010000641e0103
Client Flag:            0x80080811
Subscriber VRF:         abc
Class Name:             -
Access Interface:       Bundle-Ether2.3
Access VRF:             abc
Subscriber Label:       0x82f
VLAN Id:                3
ReceivedRemote ID:      -
ReceivedInterface ID:   -
Prefix Pool Name:       p2
Address Pool Name:      -
  IA ID:                0xb100
    STATE:              BOUND
      IPv6 Prefix:      2004:4:4:6::/64 (Bundle-Ether2.3)
        lifetime:       600 secs (00:10:00)
        expiration:     515 secs (00:08:35)

Client Link Local:      fe80::200:64ff:fe1e:104
MAC Address:            0000.641e.0104
Profile:                test
Client DUID:            000300010000641e0104
Client Flag:            0x80080811
Subscriber VRF:         abc
Class Name:             -
Access Interface:       Bundle-Ether2.3
Access VRF:             abc
Subscriber Label:       0x870
VLAN Id:                3
ReceivedRemote ID:      -
ReceivedInterface ID:   -
Prefix Pool Name:       p2
Address Pool Name:      -
  IA ID:                0xb101
    STATE:              BOUND
      IPv6 Prefix:      2004:4:4:a::/64 (Bundle-Ether2.3)
        lifetime:       600 secs (00:10:00)
        expiration:     515 secs (00:08:35)

Client Link Local:      fe80::200:64ff:fe1e:105
MAC Address:            0000.641e.0105
Profile:                test
Client DUID:            000300010000641e0105
Client Flag:            0x80080811
Subscriber VRF:         abc
Class Name:             -
Access Interface:       Bundle-Ether2.3
Access VRF:             abc
Subscriber Label:       0x8b5
VLAN Id:                3
ReceivedRemote ID:      -
ReceivedInterface ID:   -
Prefix Pool Name:       p2
Address Pool Name:      -
  IA ID:                0xb102
    STATE:              BOUND
      IPv6 Prefix:      2004:4:4:b::/64 (Bundle-Ether2.3)
        lifetime:       600 secs (00:10:00)
        expiration:     585 secs (00:09:45)

show dhcp ipv6 server interface

To display the server interface information for Dynamic Host Configuration Protocol (DHCP), use the show dhcp ipv6 server interface command in EXEC mode.

show dhcp ipv6 server interface { type | interface-path-id } { location | location }

Syntax Description

type

Interface type. For more information, use the question mark (?) online help function.

interface-path-id

Either a physical interface instance or a virtual interface instance as follows:

  • Physical interface instance. Naming notation is rack/slot/module/port and a slash between values is required as part of the notation.
    • rack: Chassis number of the rack.
    • slot: Physical slot number of the modular services card or line card.
    • module: Module number. A physical layer interface module (PLIM) is always 0.
    • port: Physical port number of the interface.
    Note   

    In references to a Management Ethernet interface located on a route processor card, the physical slot number is alphanumeric (RP0 or RP1) and the module is CPU0. Example: interface MgmtEth0/RP1/CPU0/0.

  • Virtual interface instance. Number range varies depending on interface type.

For more information about the syntax for the router, use the question mark (?) online help function.

location

Displays the node location by Interface.

location

Displays the fully qualified location specification of an interface.

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 appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Task ID

Task ID Operation

ip-services

read

Examples

This is a sample output from the show dhcp ipv6 server interface command:


RP/0/RSP0/CPU0:router# show dhcp ipv6 server interface bundle-Ether 2.3


Tue Sep  4 05:02:03.861 UTC

Interface:          Bundle-Ether2.3
VRF:                abc
Mode:               Server
Profile Name:       test
Lease Limit:        None


show dhcp ipv6 server profile

To display the server profile information for Dynamic Host Configuration Protocol (DHCP) server, use the show dhcp ipv6 server profile command in EXEC mode.

show dhcp ipv6 server profile name profile_name { location | location }

Syntax Description

name

Displays the detailed proxy profile information for the profile.

profile_name

Specifies the name of the profile.

location

Displays the node location by Interface.

location

Displays the fully qualified location specification of an interface.

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 appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Task ID

Task ID Operation

ip-services

read

Examples

This is a sample output from the show dhcp ipv6 server profile command:


RP/0/RSP0/CPU0:router# show dhcp ipv6 server profile name test

Tue Sep  4 05:00:57.938 UTC

Profile: test
DNS Addresses:None
Client Lease Time: 0 secs (00:00:00)
Framed Address Pool: p1
Delegated Prefix Pool: p2
Interface References:
Bundle-Ether2.3   

show dhcp ipv6 server statistics

To display the statistics for Dynamic Host Configuration Protocol (DHCP) server, use the show dhcp ipv6 server statistics command in EXEC mode.

show dhcp ipv6 server statistics { debug | location | vrf }

Syntax Description

debug

Displays the debug statistics for the proxy.

location

Displays the node location for the proxy.

vrf

Displays the proxy statistics by VRF.

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 appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Task ID

Task ID Operation

ip-services

read

Examples

This is a sample output from the show dhcp ipv6 server statistics command:


RP/0/RSP0/CPU0:router# show dhcp ipv6 server statistics 

  Tue Sep  4 19:13:47.472 UTC

                  VRF                     |      RX       |      TX       |       DR      |
-------------------------------------------------------------------------------------------
 default                                  |        10003  |        11651  |            3  |
 red                                      |            0  |            0  |            0  |
 blue                                     |            0  |            0  |            0  |
 green                                    |            0  |            0  |            0  |
 orange                                   |            0  |            0  |            0  |
 test_vrf                                 |            0  |            0  |            0  |
 dhcpclient                               |            0  |            0  |            0  |
 dhcpserver                               |            0  |            0  |            0  |