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

IPoE Commands

IPoE Commands

This module describes the Cisco IOS XR software commands used to configure the IPoE 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.

initiator dhcp

To enable DHCP as first-sign-of-life protocol for IPv4 subscriber, use the initiator dhcp command in the appropriate configuration submode. To disable this feature, use the no form of this command.

initiator dhcp

no initiator dhcp

Syntax Description

This command has no keywords or arguments.

Command Default

None

Command Modes

IP subscriber IPv4 L2-connected 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

network

read, write

Examples

This is an example of configuring the initiator dhcp command in the Interface configuration mode:

RP/0/RSP0/CPU0:router# configure
RP/0/RSP0/CPU0:router(config)# interface Bundle-Ether 56
RP/0/RSP0/CPU0:router(config-if)# ipsubscriber ipv4 l2-connected
RP/0/RSP0/CPU0:router(config-if-ipsub-ipv4-l2conn)# initiator dhcp

Related Commands

Command

Description

show ipsubscriber summary

Displays the ipsubscriber information.

initiator unclassified-source

To enable unclassified packets as first-sign-of-life for IPv4 subscriber, use the initiator unclassified-source command in the appropriate configuration submode. To disable this feature, use the no form of this command.

initiator unclassified-source

no initiator unclassified-source

Syntax Description

This command has no keywords or arguments.

Command Default

None

Command Modes

IP subscriber IPv4 L2-connected 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.


Note


Because packet-triggered L2 sessions are not supported for IPv6, this command is not supported for IPv6.


Task ID

Task ID Operation

network

read, write

Examples

This is an example of configuring the initiator unclassified-source command in the IP subscriber IPv4 L2-connected configuration mode:

RP/0/RSP0/CPU0:router# configure
RP/0/RSP0/CPU0:router(config)# interface Bundle-Ether 56
RP/0/RSP0/CPU0:router(config-if)# ipsubscriber ipv4 l2-connected
RP/0/RSP0/CPU0:router(config-if-ipsub-ipv4-l2conn)# initiator unclassified-source

Related Commands

Command

Description

show ipsubscriber summary

Displays the ipsubscriber information.

ipsubscriber l2-connected

To enable l2-connected IP subscriber for IPv4, use the ipsubscriber l2-connected command in the interface configuration mode. To disable this feature, use the no form of this command.

ipsubscriber { ipv4 } l2-connected initiator { dhcp | unclassified-source }

no ipsubscriber { ipv4 } l2-connected initiator { dhcp | unclassified-source }

Syntax Description

ipv4

Specifies IPv4 address prefixes.

initiator

Configures the IP subscriber initiator.

dhcp

Configures DHCP as first-sign-of-life protocol for IPv4 subscriber.

unclassified-source

Configures unclassified packets as first-sign-of-life for IPv4 subscriber.

Command Default

None

Command Modes

Interface configuration mode

Command History

Release Modification

Release 4.2.0

This command was introduced.

Usage Guidelines

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


Note


Packet-triggered L2 session (initiator unclassified-source) is not supported for IPv6.


Task ID

Task ID Operation

network

read, write

Examples

This is an example of configuring the ipsubscriber l2-connected command in the interface configuration mode for IPv4:

RP/0/RSP0/CPU0:router# configure
RP/0/RSP0/CPU0:router(config)# interface Bundle-Ether 56
RP/0/RSP0/CPU0:router(config-if)# ipsubscriber ipv4 l2-connected initiator dhcp

Related Commands

Command

Description

show ipsubscriber summary

Displays the ipsubscriber information.

show ipsubscriber access-interface

To display the access interface information for IP subscriber, use the show ipsubscriber access-interface command in the EXEC mode.

show ipsubscriber access-interface { type | interface-path-id | brief | 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.

brief

Displays the brief summary of IP Subscriber access interface status and configuration.

location

Specifies the IP subscriber location.

location

Specifies the fully qualified location specification.

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.

Task ID

Task ID Operation

network

read

Examples

This is the sample output of the show ipsubscriber access-interface command:

RP/0/RSP0/CPU0:router# show ipsubscriber access-interface

Interface: GigabitEthernet0/0/0/0 (ifhandle 0x20000040)
  State: UP
  Type: Plain
  Created Jan 18 00:01:32 (age 00:58:28)
  Initiator DHCP enabled
    Session count 0
    FSOL packets 0, bytes 0
    FSOL dropped packets 0, bytes 0
  Initiator Packet-Trigger enabled
    Session count 0
    FSOL packets 0, bytes 0
    FSOL dropped packets 0, bytes 0
  Initiator DHCPv6 disabled
    Session count 0
    FSOL packets 0, bytes 0
    FSOL dropped packets 0, bytes 0
  Initiator Packet-Trigger-IPv6 enabled
    Session count 0
    FSOL packets 0, bytes 0
    FSOL dropped packets 0, bytes 0

RP/0/RSP0/CPU0:router# show ipsubscriber access-interface brief

Codes: UP - Up, DOWN - Down, DELETED - Deleted State, UNKNOWN - Unknown State,
       PKT - Packet Trigger Initiation, DHCP - DHCP Initiation
       PKTv6 - Packet Trigger Initiation for IPv6, DHCPv6 - DHCPv6 Initiation

Interface              Proto                 DHCP        Pkt Trigger DHCPv6      PktTrigIPv6 State
---------------------- --------------------- ----------- ----------- ----------- ----------- ---------
Gi0/0/0/0              DHCP,PKT,DHCPv6,PKTv6           0           2           0           0        UP
BE1.1                  DHCP,PKT                        0           0           0           0        UP


This table describes the significant fields shown in the display.

Table 1 show ipsubscriber access-interface Field Descriptions

Field

Description

Interface

Specifies the access interface type.

Proto

Specifies the prototype, for instance, DHCP, DHCPv6, PKTv6.

DHCP

Specifies the DHCP initiation.

Pkt Trigger

Specifies the packet trigger Initiation.

DHCPv6

Specifies the packet trigger Initiation for IPv6.

PktTrigIPv6

Specifies the DHCPv6 initiation.

State

Specifies the various states of the access interface, for example, up, down, deleted, and unknown state.

Related Commands

Command

Description

ipsubscriber l2-connected

Displays the subscriber management session information.

show ipsubscriber interface

To display the interface information for the IP subscriber interfaces, use the show ipsubscriber interface command in the EXEC mode.

show ipsubscriber interface { type interface-path-id | access-interface | address-family | brief | location node-id | subscriber-ip | subscriber-label | | subscriber-mac | vrf }

Syntax Description

type

Interface type. For more information on interface types available for this command, 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.

access-interface

Specifies the access or parent interface.

address-family

Specifies the address-family in which the IP subscriber interface operates.

brief

Displays the brief summary of IP Subscriber access interface status and configuration.

location

Specifies the IP subscriber location.

node-id

Specifies the fully qualified location specification.

subscriber-ip

Specifies the subscriber IPv4 address.

subscriber-label

Specifies the subscriber label.

subscriber-mac

Specifies the subscriber MAC address.

vrf

Specifies the VRF in which the IP subscriber interface operates.

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.

Task ID

Task ID Operation

network

read

Examples

This is the sample output of the show ipsubscriber interface command:

RP/0/RSP0/CPU0:router# show ipsubscriber interface

Interface: GigabitEthernet0/1/0/0.11.ip1
      Type: L2-connected
      Ifhandle: 0x201000c0
      Access Interface: GigabitEthernet0/1/0/0.11 (0x20100080)
      Subscriber MAC: 0100.0000.0000	
      Subscriber IP: 11.10.10.9         <------- this line will not be shown if empty
      Subscriber IPv6 Prefix: FE80::10  <------- this line will not be shown if empty
      Subscriber Label: 0x8000000
      IPv4: Initiator: Packet-Trigger   <-- this line will not be shown if not enabled
      IPv6: Initiator: DHCPv6           <-- this line will not be shown if not enabled
      Created: May 11 16:33:08 (age 00:03:08)
      VRF: vpn1 (0x60000002), IPv4 Table: default (0xe0000002), IPv6 Table: default (0xe0000002)
      IPv4: State: Up(9) (old: Adjacency added(8))
            Last state change: May 11 16:33:08 (00:03:08 in current state)
      IPv6: State: Up(9) (old: Adjacency added(8))
            Last state change: May 11 16:33:08 (00:03:08 in current state)

RP/0/RSP0/CPU0:router# show ipsubscriber interface brief

Codes: INV - Invalid, INIT - Initialized, STRTD - Session Creation Started,
       CPEXCTG - Control-Policy Executing, CPEXCTD - Control-Policy Executed,
       FTAPPLD - Session Features Applied, VRFCFGD - VRF Configured,
       ADJADDG - Adding Adjacency, ADJADDD - Adjacency Added, UP - Up,
       DOWN - Down, DISCG - Disconnecting, DISCD - Disconnected, ERR - Error,
       UNKWN - Unknown State, PKT - Packet Trigger Initiation,
       PKTv6 - Packet Trigger Initiation for IPv6,
       DHCP - DHCP Initiation, DHCPv6 - DHCPv6 Initiation

Interface              Proto Subscriber IP      MAC Address        Sublabel   VRF        State
---------------------- ------ ------------------ ------------------ ---------- ---------- ----------
Gi0/0/0/0.ip1          DHCP   1.10.10.9          0100.0000.0000     0x40       default    UP
                       DHCPv6                    0100.0000.0000     0x40       default    UP
Gi0/0/0/0.ip2          PKT    2.20.20.9          0200.0000.0000     0x20       default    UP
                       PKTv6                     0200.0000.0000     0x20       default    UP
Gi0/0/0/0.ip3          DHCPv6 5.40.20.9          0200.2200.0000     0x21       default    UP
Gi0/0/0/0.ip4          PKTv6  7.91.20.9          0200.2210.0000     0x31       default    UP

This table describes the significant fields shown in the display.

Table 2 show ipsubscriber interface Field Descriptions

Field

Description

Interface

Specifies the access interface type.

Proto

Specifies the prototype, for instance, DHCP, DHCPv6, PKTv6.

Subscriber IP

Specifies the IP address of the subscriber interface.

MAC Address

Specifies the MAC address for each interface type.

Sublabel

Specifies the sub label type for each interface.

VRF

Specifies the default VRF type.

State

Specifies the various states of the access interface, for example, up, down, deleted, and unknown state.

Related Commands

Command

Description

ipsubscriber l2-connected

Displays the subscriber management session information.

show ipsubscriber summary

To display the summary information for the IP subscriber interfaces, use the show ipsubscriber summary command in the EXEC mode.

show ipsubscriber summary location location

Syntax Description

location

Specifies the IP subscriber location.

location

Specifies the fully qualified location specification.

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.

Task ID

Task ID Operation

network

read

Examples

This is the sample output of the show ipsubscriber summary command:

RP/0/RSP0/CPU0:router# show ipsubscriber summary
IPSUB Summary for all nodes

Interface Counts:
                                    DHCP  Pkt Trigger
                              ---------- ------------
                     Invalid:          0            0
                 Initialized:          0            0
    Session creation started:          0            0
    Control-policy executing:          0            0
     Control-policy executed:          0            0
    Session features applied:          0            0
              VRF configured:          0            0
            Adding adjacency:          0            0
             Adjacency added:          0            0
                          Up:          0            0
                        Down:          0            0
               Disconnecting:          0            0
                Disconnected:          0            0
               Unknown state:          0            0
                       Error:          0            0
                              ---------- ------------
                       Total:          0            0

                                  DHCPv6 PktTrig-IPv6
                              ---------- ------------
                     Invalid:          0            0
                 Initialized:          0            0
    Session creation started:          0            0
    Control-policy executing:          0            0
     Control-policy executed:          0            0
    Session features applied:          0            0
              VRF configured:          0            0
            Adding adjacency:          0            0
             Adjacency added:          0            0
                          Up:          0            0
                        Down:          0            0
               Disconnecting:          0            0
                Disconnected:          0            0
               Unknown state:          0            0
                       Error:          0            0
                              ---------- ------------
                       Total:          0            0

Routes Per VRF (0 VRFs):
                                   Count
                              ----------

Access Interface Counts (1 interfaces):

                                    DHCP  Pkt Trigger
                              ---------- ------------
                FSOL Packets:          0            0
                  FSOL Bytes:          0            0

                                  DHCPv6 PktTrig-IPv6
                              ---------- ------------
                FSOL Packets:          0            0
                  FSOL Bytes:          0            0


This table describes the significant fields shown in the display.

Table 3 show ipsubscriber summary Field Descriptions

Field

Description

Invalid

Specifies the number of invalid packets for DHCP and Packet Trigger.

Initialized

Specifies the number of packets that were initialized for DHCP and Packet Trigger.

Session creation started

Specifies the total number of session initiation that was created.

Control-policy executing

Specifies the control policies that are executing for DHCP and Packet Trigger.

Control-policy executed

Specifies the control policies that were executed for DHCP and Packet Trigger.

Session features applied

Specifies the number of session features that were applied for DHCP and Packet Trigger.

VRF configured

Specifies the VRFs configured.

Up

Specifies the number of packets that are in the UP state.

Down

Specifies the number of packets that are in the DOWN state.

Disconnecting

Specifies the number of packets that are disconnecting.

Disconnected

Specifies the number of packets that are disconnected.

Unknown State

Specifies the packets that are in the unknown state.

Error

Specifies the number of packets that are errored out.

Related Commands

Command

Description

ipsubscriber l2-connected

Displays the subscriber management session information.