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

BNG DHCP Commands

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.

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

no broadcast-flag policy{ check}

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

Command History

Release

Modification

Release 3.7.0

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

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

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)#

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 IPv4 profile relay 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 DHCP IPv4 profile relay configuration mode:

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)# helper-address vrf v1 10.10.10.1

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

RP/0/RSP0/CPU0:router# config
RP/0/RSP0/CPU0:router(config)# dhcp ipv4
RP/0/RSP0/CPU0:router(config-dhcpv4)# profile client proxy
RP/0/RSP0/CPU0:router(config-dhcpv4-relay-profile)# helper-address vrf v1 10.10.10.1 giaddr 10.10.10.10

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 on an interface, use the interface command in the appropriate configuration mode. To disable DHCPv4 on an interface, use the no form of the command.

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

no interface type interface-path-id { relay | 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.

relay

Specifies a destination address.

Command Default

None

Command Modes

DHCP IPv4 configuration

Command History

Release

Modification

Release 4.3.0

The support for IPv6 was added in BNG.

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 ipv4
RP/0/RSP0/CPU0:router(config-dhcpv4)# interface POS 0/5/0/0 relay

Related Commands

Command

Description

dhcp ipv4 (BNG)

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

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.  

profile (BNG)

To specify a DHCP profile for the Dynamic Host Configuration Protocol (DHCP) IPv4 component and to enter the profile mode, use the profile command in DHCP IPv4 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

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

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)# 

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.

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.

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.

profile (DHCP)

Configures a relay profile for the DHCP IPv4 component.

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.

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

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.

profile (DHCP)

Configures a relay profile for the DHCP IPv4 component.

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.

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

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 }

no relay information policy { drop | keep }

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.

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.

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

Related Commands

Command

Description

dhcp ipv4 (BNG)

Enables DHCP for IPv4 and enters DHCP IPv4 configuration mode.

Configures how a relay agent processes BOOTREQUEST messages that already contain a nonzero giaddr attribute.

helper-address (BNG)

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

profile (DHCP)

Configures a relay profile for the DHCP IPv4 component.

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.

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