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

Subscriber Commands

Subscriber Commands

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

subscriber session limit

To configure a limit for subscriber sessions, use the subscriber session limit command in global configuration mode. To remove the session limit for subscribers, use the no form of this command.

subscriber session limit session_limit

no subscriber session limit session_limit

Syntax Description

session_limit

Limit for subscriber sessions.

The range is from 1 to 200000.

Command Default

None

Command Modes

Global configuration

Command History

Release Modification
Release 5.1.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.

This command does not limit the number of un-authenticated sessions on the router, until the overall session count reaches session_limit. If a new session comes up after router reached the session_limit, then the long-lived un-authenticated subscriber session is deleted. The new session can be an authenticated or un-authenticated session.

Task ID

Task ID Operation

config-services

read, write

Examples

This example shows how to configure a limit for subscriber sessions:

RP/0/RSP0/CPU0:router# configure
RP/0/RSP0/CPU0:router(config)# subscriber session limit 100000

Related Commands

Command

Description

show subscriber session

Displays the subscriber management session information.  

show subscriber database

To display the configuration details of subscriber database, use the show subscriber database command in the EXEC mode.

show subscriber database { association | configuration | connection | interface | statistics summary }

Syntax Description

association

Displays the association between subscriber sessions and dynamic templates.

configuration

Displays the configuration database information.

connection

Displays subscriber client connection identifiers.

interface

Displays the mapping between subscriber labels and interface handles.

statistics

Displays the show subscriber database statistics information.

summary

Displays the show subscriber database summary counts.

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

network

read

Examples

The sample output of the show subscriber database command is:

RP/0/RSP0/CPU0:router# show subscriber database association

Mon Jun 14 16:24:50.432 EDT
Object Name: TEMPL1
  Object Type: IP-SUBSCRIBER-TEMPLATE
  Feature Name: IPV4
    Attribute Name: ipv4/unnumbered
                    reference count : 1
                    sysDb pathname  : /cfg/gl/dynamic-templates/ipsubscriber/TEMPL1/ipv4/unnumbered
                    datatype        : string
                    length          : 10
                    value           : Loopback0

Object Name: TEMPL2
  Object Type: IP-SUBSCRIBER-TEMPLATE
  Feature Name: IPV4
    Attribute Name: ipv4/mtu 
                    reference count : 1
                    sysDb pathname  : /cfg/gl/dynamic-templates/ipsubscriber/ss/ipv4/mtu
                    datatype        : uint32
                    length          : 4
                    value           : 1500
  Feature Name: QoS
    Attribute Name: qos/service_policy_in/qos_policy
                    reference count : 1
                    sysDb pathname  : /cfg/gl/dynamic-templates/ipsubscriber/ss/qos/service_policy_in/:qos_policy
                    datatype        : packed
                    length          : 20
                    value           : packed
                                          AB CD 43 21 02 00 04 00 
  00 00 00 03 00 00 03 00 
                                      00 06 00 00
  Feature Name: 'RSI'
    Attribute Name: rsi/vrf
                    reference count : 1
                    sysDb pathname  : /cfg/gl/dynamic-templates/ipsubscriber/ss/rsi/vrf
                    datatype        : 3
                    length          : 5
                    value           : blue

RP/0/RSP0/CPU0:router# show subscriber database connection

Tue Jun 15 11:00:19.650 EDT

Client Connection Identifier:  0x0
=====================================
    ref_count        = 3
    req_count        = 0
    bpi_reg_count    = 0
    spi_reconciled   = TRUE
    bpi_reconciled   = FALSE
    client_restarted = FALSE
    client_name      = template-mgr
    timer_running    = FALSE

    spi_cb_info:  N/A


    Persistent Information:
        in_use                    = TRUE
        forced_full_resync        = FALSE
        client_flags              = TMPL_PROD
        state                     = SUBDB_CLIENT_FULL
        instance_no               = 0
        num_bpi_regs              = 0
        num_send_drop_bpi_msg     = 0
        num_send_drop_spi_msg     = 0
        num_recv_drop_bpi_msg     = 0
        num_recv_drop_spi_msg     = 0
        num_sent_bpi_msg          = 0
        num_sent_spi_msg          = 0
        num_recv_bpi_msg          = 0
        num_recv_spi_msg          = 0
        num_sent_pulse            = 0

    SPI AIPC Information:
        conn_present              = 0
        tx_attempt_count          = 0
        tx_count                  = 0
        rx_count                  = 0
        notify_connect_count      = 0
        notify_queue_high_count   = 0
        notify_queue_low_count    = 0
        notify_queue_full_count   = 0
        notify_data_waiting_count = 0
        notify_error_count        = 0
        notify_close_count        = 0
        notify_sendstatus_count   = 0
        notify_open_count         = 0
        pulse_data_waiting_count  = 0
        queue_full                = 0
        queue_full_drop           = 0
       outstanding_buffers       = 0
        overflow_queue_size       = 0
        cumulative_overflow_msgs  = 0
        hwm_overflow_msgs         = 0
    BPI AIPC Information:
        conn_present              = 1
        tx_attempt_count          = 0
        tx_count                  = 0
        rx_count                  = 1
        notify_connect_count      = 0
        notify_queue_high_count   = 0
        notify_queue_low_count    = 0
        notify_data_waiting_count = 1
        notify_error_count        = 0
        notify_close_count        = 0
        notify_sendstatus_count   = 0
        notify_open_count         = 1
        queue_full                = 0
        queue_full_drop           = 0
        outstanding_buffers       = 0
        overflow_queue_size       = 0
        cumulative_overflow_msgs  = 0
        hwm_overflow_msgs         = 0
    Feature Information (number of entries = 3):
    ---------------------------------------------------
     ***Feature Name***     = RSI
        Connection ID       = 0x1
        Session type        = SUBDB_SESSION_LABEL_TYPE_IP_SUB_INBAND
        Activate Required   = FALSE
        Config Set ID       = 1
        Registration Handle = 0x1
        whichevent[0]       = SUBDB_CB_EVENT_NONE
        whichevent[1]       = SUBDB_CB_EVENT_ALL
        Feature State       = SUBDB_FEATURE_REGISTERED

     ***Feature Name***     = RSI
        Connection ID       = 0x1
        Session type        = SUBDB_SESSION_LABEL_TYPE_PPPOE_SUB
        Activate Required   = FALSE
        Config Set ID       = 1
        Registration Handle = 0x2
        whichevent[0]       = SUBDB_CB_EVENT_NONE
        whichevent[1]       = SUBDB_CB_EVENT_ALL
        Feature State       = SUBDB_FEATURE_REGISTERED

     ***Feature Name***     = RSI
        Connection ID       = 0x1
        Session type        = SUBDB_SESSION_LABEL_TYPE_IP_SUB_DHCP
        Activate Required   = FALSE
        Config Set ID       = 1
        Registration Handle = 0x3
        whichevent[0]       = SUBDB_CB_EVENT_NONE
        whichevent[1]       = SUBDB_CB_EVENT_ALL
        Feature State       = SUBDB_FEATURE_REGISTERED

Client Connection Identifier:  0x2
=====================================
    ref_count        = 2
    req_count        = 0
    bpi_reg_count    = 0
    spi_reconciled   = TRUE
    bpi_reconciled   = TRUE
    client_restarted = FALSE
    client_name      = iedge SVM
    timer_running    = FALSE

    spi_cb_info:
        SUBDB_SPI_CB_PROD_ALL_DONE          = SUBDB_CB_EVENT_NONE
        SUBDB_SPI_CB_SESSION_PROD_DONE      = SUBDB_CB_EVENT_ALL
        SUBDB_SPI_CB_SESSION_ACTIVATED      = SUBDB_CB_EVENT_NONE
        SUBDB_SPI_CB_SESSION_CREATED        = SUBDB_CB_EVENT_NONE
        SUBDB_SPI_CB_SESSION_DESTROYED      = SUBDB_CB_EVENT_NONE
        SUBDB_SPI_CB_SESSION_ASSOCIATED     = SUBDB_CB_EVENT_ALL
        SUBDB_SPI_CB_SESSION_UNASSOCIATED   = SUBDB_CB_EVENT_ALL
        SUBDB_SPI_CB_SESSION_CONFIG_CHANGED = SUBDB_CB_EVENT_ALL
        SUBDB_SPI_CB_TEMPLATE_INSTALLED     = SUBDB_CB_EVENT_ALL
        SUBDB_SPI_CB_TEMPLATE_UNINSTALLED   = SUBDB_CB_EVENT_ALL
        SUBDB_SPI_CB_OBJECT_AGEOUT          = SUBDB_CB_EVENT_ALL


    Persistent Information:
        in_use                    = TRUE
        forced_full_resync        = FALSE
        client_flags              = TMPL_PROD, SESS_PROD
        state                     = SUBDB_CLIENT_FULL
        instance_no               = 1
        num_bpi_regs              = 0
        num_send_drop_bpi_msg     = 0
        num_send_drop_spi_msg     = 0
        num_recv_drop_bpi_msg     = 0
        num_recv_drop_spi_msg     = 0
        num_sent_bpi_msg          = 0
        num_sent_spi_msg          = 0
        num_recv_bpi_msg          = 0
        num_recv_spi_msg          = 1
        num_sent_pulse            = 0

    SPI AIPC Information:
        conn_present              = 1
        tx_attempt_count          = 0
        tx_count                  = 0
        rx_count                  = 2
        notify_connect_count      = 0
        notify_queue_high_count   = 0
        notify_queue_low_count    = 0
        notify_queue_full_count   = 0
        notify_data_waiting_count = 2
        notify_error_count        = 0
        notify_close_count        = 0
        notify_sendstatus_count   = 0
        notify_open_count         = 1
        pulse_data_waiting_count  = 0
        queue_full                = 0
        queue_full_drop           = 0
        outstanding_buffers       = 0
        overflow_queue_size       = 0
        cumulative_overflow_msgs  = 0
        hwm_overflow_msgs         = 0
    BPI AIPC Information:
        conn_present              = 0
        tx_attempt_count          = 0
        tx_count                  = 0
        rx_count                  = 0
        notify_connect_count      = 0
        notify_queue_high_count   = 0
        notify_queue_low_count    = 0
        notify_data_waiting_count = 0
        notify_error_count        = 0
        notify_close_count        = 0
        notify_sendstatus_count   = 0
        notify_open_count         = 0
        queue_full                = 0
        queue_full_drop           = 0
        outstanding_buffers       = 0
        overflow_queue_size       = 0
        cumulative_overflow_msgs  = 0
        hwm_overflow_msgs         = 0
    Feature Information (number of entries = 0):
    ---------------------------------------------------

RP/0/RSP0/CPU0:router# show subscriber database interface
Tue Jun 15 09:05:53.769 EDT
Interface	Ifhandle		Session ID:
Gi0/2/0/0.ip1	0x1000040		0x4000000
Gi0/2/0/0.ip2	0x1000060		0x4000082

RP/0/RSP0/CPU0:router# show subscriber database statistics

Tue Jun 15 09:05:53.769 EDT
3 wrapping entries (2048 possible, 0 filtered, 3 total)
Jun 15 06:49:40.123 subdb/common 0/0/CPU0 t4004322208 Process client ID '2' with connection event 'RESTARTED'
Jun 15 06:49:40.125 subdb/common 0/0/CPU0 t4153857728 Process SPI END RECONCILE msg for client '2 [ring index '0']
Jun 15 06:49:40.125 subdb/common 0/0/CPU0 t4004322208 Process client ID '2' with connection event 'RECONCILED'

show subscriber feature accounting

To display the feature accounting information of the subscriber, use the show subscriber feature accounting command in the EXEC mode.

show subscriber feature accounting ma { statistics debug [ location location ] | subscriber-label subscriber-id | summary [ location location ] | trace { all | error | event } }

Syntax Description

ma

Displays the subscriber accounting feature management agent information.

statistics

Displays the accounting feature statistics.

debug

Displays the debug statistics.

location

Specifies the location of the node.

location

Fully qualified location name.

subscriber-label

Specifies the unique subscriber ID.

subscriber-id

ID of the subscriber, in hexadecimal.

summary

Displays the summary data.

trace

Displays the accounting feature ltrace data.

all

Displays trace of all errors and events.

error

Displays trace of errors.

event

Displays trace of events.

Command Default

None

Command Modes

EXEC

Command History

Release Modification

Release 4.2.0

This command was introduced.

Release 5.1

The show command output was extended to display session Idle Timeout feature information.

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 subscriber feature accounting command in the EXEC mode:

RP/0/RSP0/CPU0:router# show subscriber feature accounting ma subscriber-label 0x40
Subscriber Label: 0x40         Interface: Gi0/0/0/0.pppoe1

  Feature:  Session Accounting      Method-list: default

  Feature:  Session Idle Timeout
    Timeout value:         200 seconds
    Threshold value:       3 minutes per packet
    Timeout direction:     both

This table describes the significant fields displayed in the show subscriber feature accounting command output :
Field Description
Timeout value Specifies the timeout value configured for that particular subscriber session.
Threshold value Specifies the threshold value configured for that particular subscriber session, to decide on the duration of the session inactivity.
Timeout direction: both Specifies that both the ingress and egress traffic is considered for the determination of the idle time for that particular subscriber session.

Related Commands

Command

Description

show subscriber database

Displays the configuration details of subscriber database.  

show subscriber manager statistics

Displays the subscriber management internal manager information.  

show subscriber running-config

Displays the subscriber running configuration derived from dynamic template.  

show subscriber session

Displays the subscriber management session information.  

show subscriber manager sadb

To display the database information of the subscriber management feature attribute, use the show subscriber manager sadb command in the EXEC mode.

show subscriber manager sadb [ location location ]

Syntax Description

location

Specifies the location of the node.

location

Fully qualified location name.

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 subscriber manager sadb command:

RP/0/RSP0/CPU0:routershow subscriber manager sadb
Mon Apr  8 10:02:24.274 IST

Sublabel: 0x00000095 Node_ID: 00000000 Signature: 0xabcdef12 Version: 1 Rev: 9
Length: 168

Attribute list: 135469872
1:  outer-vlan-id   len=  4  10(a)
2:  port-type       len=  4  Virtual IP over VLAN
3:  static-session  len=  1  true
4:  parent-if-handle len=  4  1664(680)
5:  string-session-id len=  8  00000049
6:  interface       len=  8  0/0/1/10
7:  username        len=  6  BNG:10
8:  if-handle       len=  4  1664(680)
9:  vrf-id          len=  4  0(0)
10:  ipv4-session-state len=  1  true

Related Commands

Command

Description

show subscriber session

Displays the subscriber management session information.  

ipsubscriber interface

Enables interface based static session in BNG.  

show subscriber manager statistics

To display the subscriber management internal manager information, use the show subscriber manager statistics command in the EXEC mode.

show subscriber manager statistics { AAA COA | HA | PPSM | PRE | SVM | debug | performance | summary }

Syntax Description

AAA

Displays the Authentication, Authorization, Accounting Coordinator statistics.

HA

Displays the High Availability statistics.

PPSM

Displays the Policy Plane Session Manager statistics.

PRE

Displays the Policy Rule Engine statistics.

SVM

Displays the Service Manager statistics.

debug

Displays the debug statistics.

performance

Displays the performance statistics.

summary

Displays the summary statistics.

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

network

read

Examples

This is the sample output of the show subscriber manager statistics command in the EXEC mode:

RP/0/RSP0/CPU0:router# show subscriber manager statistics summary total

The show subscriber manager statistics output is as follows:

Wed Jan 23 09:57:41.855 GMT

[ IEDGE SUMMARY STATISTICS ]

 Location: 0/0/CPU0

IEDGE SUMMARY
=============
Control Policy errors
  Subscriber control policy not applied on interface = 0
  No class match in Start Request                    = 0

Attribute format warnings
  NAS Port                                           = 0
  NAS Port id                                        = 0
  Destination station id                             = 0
  Calling station id                                 = 0
  User Name                                          = 0

User Profile Statistics
  User Profile Install                               = 0
  User Profile Install errors                        = 0
  User Profile Removes                               = 0
  User Profile Errors                                = 0

Session Disconnect Flow Control
  Inflight                                           = 0
  Queued                                             = 0

 Location: 0/1/CPU0

IEDGE SUMMARY
=============
Control Policy errors
  Subscriber control policy not applied on interface = 0
  No class match in Start Request                    = 0

Attribute format warnings
  NAS Port                                           = 72
  NAS Port id                                        = 0
  Destination station id                             = 72
  Calling station id                                 = 72
  User Name                                          = 0

User Profile Statistics
  User Profile Install                               = 0
  User Profile Install errors                        = 0
  User Profile Removes                               = 0
  User Profile Errors                                = 0

Session Disconnect Flow Control
  Inflight                                           = 0
  Queued                                             = 0

This table describes the significant fields shown in the display.

Table 1 show subscriber manager statistics Field Descriptions

Field

Description

Control Policy errors

Specifies the errors in the control policy.

Attribute format warnings

Specifies the attribute format warnings.

User Profile Statistics

Specifies the user profile statistics.

Session Disconnect Flow Control

Specifies the session disconnect flow control.

show subscriber running-config

To display the subscriber running configuration derived from dynamic template, use the show subscriber running-config command in EXEC.

show subscriber running-config { location | subscriber-label }

Syntax Description

location

Displays subscriber database running configuration information for all sessions at specified location.

subscriber-label

Allows to enter a hex value subscriber-value that ranges between 0X0-0xffffffff.

|

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

network

read

Examples

This is a sample output of the show subscriber running-config command:

RP/0/RSP0/CPU0:router# show subscriber running-config

Tue Jun 15 09:05:53.769 EDT
Session ID: 0x4000000
dynamic-template
 type ipsubscriber TEMPL1
  ipv4 unnumbered Loopback0
 !
!
dynamic-template
 type ipsubscriber TEMPL2
  service-policy input qos_policy
  vrf blue
  ipv4 mtu 1500
 !
!
Session ID: 0x4000082
dynamic-template
 type ipsubscriber TEMPL1
  ipv4 unnumbered Loopback0
 !
!
dynamic-template
 type ipsubscriber TEMPL2
  service-policy input qos_policy
  vrf blue
  ipv4 mtu 1500
 !
!


show subscriber session

To display the subscriber management session information, use the show subscriber session command in the EXEC mode.

show subscriber session { all [ detail | summary | username ] [ location node-id ] | debug | filter | subscriber-label session-id }

Syntax Description

all

Displays all subscriber sessions.

debug

Displays unique subscriber session selected for debugging.

filter

Displays the search results of the subscriber session database based on the filter criteria.

subscriber-label

Displays the unique ID of the subscriber session.

session-id

Hex value of subscriber session ID. The range is from 0 to ffffffff.

Command Default

None

Command Modes

EXEC

Command History

Release Modification

Release 4.2.0

This command was introduced.

Release 4.3.1

Added example output for show subscriber session all detail command to display service accounting feature information.

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.

For interface-based static sessions in the BNG, the value of Type field in the show ipsubscriber session command output is displayed as IP: Static.

Task ID

Task ID Operation

network

read

config-services

read

Examples

These are some of the options for the show subscriber session command in the EXEC mode:

RP/0/RSP0/CPU0:router# show subscriber session all
RP/0/RSP0/CPU0:router# show subscriber session all summary location 0/1/CPU0
RP/0/RSP0/CPU0:router# show subscriber session filter vrf vrf1 location 0/1/CPU0
RP/0/RSP0/CPU0:router# show subscriber session subscriber-label 40

This is the sample output of the show subscriber session all command:

Wed Jan 23 10:20:58.344 GMT
Codes: IN - Initialize, CN - Connecting, CD - Connected, AC - Activated,
       ID - Idle, DN - Disconnecting, ED - End

Type         Interface                State     Subscriber IP Addr / Prefix
                                                LNS Address (Vrf)
--------------------------------------------------------------------------------
PPPoE:PTA    Gi0/1/0/0.pppoe1         AC        100.0.0.1 (default)
PPPoE:PTA    Gi0/1/0/0.pppoe2         AC        100.0.0.1 (default)
PPPoE:PTA    Gi0/1/0/0.pppoe3         AC        100.0.0.1 (default)
PPPoE:PTA    Gi0/1/0/0.1.pppoe1       AC        100.0.0.1 (default)
PPPoE:PTA    Gi0/1/0/0.1.pppoe2       AC        100.0.0.1 (default)
PPPoE:PTA    Gi0/1/0/0.1.pppoe3       AC        100.0.0.1 (default)
PPPoE:PTA    Gi0/1/0/0.2.pppoe1       AC        100.0.0.1 (default)
PPPoE:PTA    Gi0/1/0/0.2.pppoe2       AC        100.0.0.1 (default)
PPPoE:PTA    Gi0/1/0/0.2.pppoe3       AC        100.0.0.1 (default)
PPPoE:PTA    Gi0/1/0/0.3.pppoe1       AC        100.0.0.1 (default)
PPPoE:PTA    Gi0/1/0/0.3.pppoe2       AC        100.0.0.1 (default)
PPPoE:PTA    Gi0/1/0/0.3.pppoe3       AC        100.0.0.1 (default)
PPPoE:PTA    Gi0/1/0/0.pppoe4         AC        100.0.0.1 (default)
PPPoE:PTA    Gi0/1/0/0.pppoe5         AC        100.0.0.1 (default)
PPPoE:PTA    Gi0/1/0/0.pppoe6         AC        100.0.0.1 (default)
PPPoE:PTA    Gi0/1/0/0.1.pppoe4       AC        100.0.0.1 (default)
PPPoE:PTA    Gi0/1/0/0.1.pppoe5       AC        100.0.0.1 (default)
PPPoE:PTA    Gi0/1/0/0.1.pppoe6       AC        100.0.0.1 (default)
PPPoE:PTA    Gi0/1/0/0.2.pppoe4       AC        100.0.0.1 (default)
PPPoE:PTA    Gi0/1/0/0.2.pppoe5       AC        100.0.0.1 (default)
PPPoE:PTA    Gi0/1/0/0.2.pppoe6       AC        100.0.0.1 (default)
PPPoE:PTA    Gi0/1/0/0.3.pppoe4       AC        100.0.0.1 (default)
PPPoE:PTA    Gi0/1/0/0.3.pppoe5       AC        100.0.0.1 (default)
PPPoE:PTA    Gi0/1/0/0.3.pppoe6       AC        100.0.0.1 (default)
PPPoE:PTA    Gi0/1/0/0.pppoe7         AC        100.0.0.1 (default)
PPPoE:PTA    Gi0/1/0/0.pppoe8         AC        100.0.0.1 (default)
PPPoE:PTA    Gi0/1/0/0.pppoe9         AC        100.0.0.1 (default)
PPPoE:PTA    Gi0/1/0/0.1.pppoe7       AC        100.0.0.1 (default)
PPPoE:PTA    Gi0/1/0/0.1.pppoe8       AC        100.0.0.1 (default)
PPPoE:PTA    Gi0/1/0/0.1.pppoe9       AC        100.0.0.1 (default)
PPPoE:PTA    Gi0/1/0/0.2.pppoe7       AC        100.0.0.1 (default)
PPPoE:PTA    Gi0/1/0/0.2.pppoe8       AC        100.0.0.1 (default)
PPPoE:PTA    Gi0/1/0/0.2.pppoe9       AC        100.0.0.1 (default)
PPPoE:PTA    Gi0/1/0/0.3.pppoe7       AC        100.0.0.1 (default)
PPPoE:PTA    Gi0/1/0/0.3.pppoe8       AC        100.0.0.1 (default)
PPPoE:PTA    Gi0/1/0/0.3.pppoe9       AC        100.0.0.1 (default)
PPPoE:PTA    Gi0/1/0/0.pppoe10        AC        100.0.0.1 (default)
PPPoE:PTA    Gi0/1/0/0.pppoe11        AC        100.0.0.1 (default)
PPPoE:PTA    Gi0/1/0/0.pppoe12        AC        100.0.0.1 (default)
PPPoE:PTA    Gi0/1/0/0.1.pppoe10      AC        100.0.0.1 (default)
PPPoE:PTA    Gi0/1/0/0.1.pppoe11      AC        100.0.0.1 (default)
PPPoE:PTA    Gi0/1/0/0.1.pppoe12      AC        100.0.0.1 (default)
PPPoE:PTA    Gi0/1/0/0.2.pppoe10      AC        100.0.0.1 (default)
PPPoE:PTA    Gi0/1/0/0.2.pppoe11      AC        100.0.0.1 (default)
PPPoE:PTA    Gi0/1/0/0.2.pppoe12      AC        100.0.0.1 (default)
PPPoE:PTA    Gi0/1/0/0.3.pppoe10      AC        100.0.0.1 (default)
PPPoE:PTA    Gi0/1/0/0.3.pppoe11      AC        100.0.0.1 (default)
PPPoE:PTA    Gi0/1/0/0.3.pppoe12      AC        100.0.0.1 (default)
PPPoE:PTA    Gi0/1/0/0.pppoe13        AC        100.0.0.1 (default)
PPPoE:PTA    Gi0/1/0/0.pppoe14        AC        100.0.0.1 (default)
PPPoE:PTA    Gi0/1/0/0.pppoe15        AC        100.0.0.1 (default)
PPPoE:PTA    Gi0/1/0/0.1.pppoe13      AC        100.0.0.1 (default)
PPPoE:PTA    Gi0/1/0/0.1.pppoe14      AC        100.0.0.1 (default)
PPPoE:PTA    Gi0/1/0/0.1.pppoe15      AC        100.0.0.1 (default)
PPPoE:PTA    Gi0/1/0/0.2.pppoe13      AC        100.0.0.1 (default)
PPPoE:PTA    Gi0/1/0/0.2.pppoe14      AC        100.0.0.1 (default)
PPPoE:PTA    Gi0/1/0/0.2.pppoe15      AC        100.0.0.1 (default)
PPPoE:PTA    Gi0/1/0/0.3.pppoe13      AC        100.0.0.1 (default)
PPPoE:PTA    Gi0/1/0/0.3.pppoe14      AC        100.0.0.1 (default)
PPPoE:PTA    Gi0/1/0/0.3.pppoe15      AC        100.0.0.1 (default)
PPPoE:PTA    Gi0/1/0/0.pppoe16        AC        100.0.0.1 (default)
PPPoE:PTA    Gi0/1/0/0.pppoe17        AC        100.0.0.1 (default)
PPPoE:PTA    Gi0/1/0/0.pppoe18        AC        100.0.0.1 (default)
PPPoE:PTA    Gi0/1/0/0.1.pppoe16      AC        100.0.0.1 (default)
PPPoE:PTA    Gi0/1/0/0.1.pppoe17      AC        100.0.0.1 (default)
PPPoE:PTA    Gi0/1/0/0.1.pppoe18      AC        100.0.0.1 (default)
PPPoE:PTA    Gi0/1/0/0.2.pppoe16      AC        100.0.0.1 (default)
PPPoE:PTA    Gi0/1/0/0.2.pppoe17      AC        100.0.0.1 (default)
PPPoE:PTA    Gi0/1/0/0.2.pppoe18      AC        100.0.0.1 (default)
PPPoE:PTA    Gi0/1/0/0.3.pppoe16      AC        100.0.0.1 (default)
PPPoE:PTA    Gi0/1/0/0.3.pppoe17      AC        100.0.0.1 (default)
PPPoE:PTA    Gi0/1/0/0.3.pppoe18      AC        100.0.0.1 (default)

This table describes the significant fields shown in the display.

Table 2 show subscriber session Field Descriptions

Field

Description

Type

Specifies the subscriber session type.

Interface

Specifies the interface type.

State

Specifies the states of the subscriber session such as initiate, connecting, connected, activated, disconnected, idle, end.

Subscriber IP Addr / Prefix LNS Address (Vrf)

Specifies the IP address of the subscriber interface.

This example shows the detailed information about all the subscriber sessions including service accounting information.

RP/0/RSP0/CPU0:router# show subscriber session all detail

Interface:                Bundle-Ether12.125.ip643
Circuit ID:               Unknown
Remote ID:                00066c9ced63ef20
Type:                     IP: DHCP-trigger
IPv6 State:               Up, Fri Feb  8 16:42:57 2013
IPv6 Address:             2001:2::b246, VRF: default
Delegated IPv6 Prefix:    3000:2:0:8546::/64, VRF: default
IPv6 Interface ID:        0004007d000c (30 30 30 34 30 30 37 64 30 30 30 63)
Mac Address:              0010.6401.0102
Account-Session Id:       00008ad2
Nas-Port:                 Unknown
User name:                0010.6401.0102
Outer VLAN ID:            125
Subscriber Label:         0x00000046
Created:                  Fri Feb  8 16:42:57 2013
State:                    Activated
Authentication:           unauthenticated
Access-interface:         Bundle-Ether12.125
Policy Executed:
policy-map type control subscriber BNG-Test
  event Session-Start match-first [at Fri Feb  8 16:42:57 2013]
    class type control subscriber PPPoE do-until-failure [Failed]
    class type control subscriber IPoE-DS do-until-failure [Succeeded]
      1 activate dynamic-template IPoE [Succeeded]
      10 authorize aaa list default [Succeeded]
      15 activate dynamic-template test-svc1 [Succeeded]
      16 activate dynamic-template test-svc2 [Succeeded]
Session Accounting:
  Acct-Session-Id:          00008ad2
  Method-list:              default
  Accounting started:       Fri Feb  8 16:43:27 2013
  Interim accounting:       Off
Service Accounting:         AcctTurbo1G
  Acct-Session-Id:          00008ad3
  Method-list:              default
  Accounting started:       Fri Feb  8 16:43:27 2013
  Interim accounting:       On, interval 2 mins
    Last successful update: Never
    Next update in:         00:01:48 (dhms)
Service Accounting:         test-svc3
  Acct-Session-Id:          00008ad4
  Method-list:              default
  Accounting started:       Fri Feb  8 16:43:27 2013
  Interim accounting:       On, interval 2 mins
    Last successful update: Never
    Next update in:         00:01:48 (dhms)
Service Accounting:         svcAcct
  Acct-Session-Id:          00008ad5
  Method-list:              default
  Accounting started:       Fri Feb  8 16:43:27 2013
  Interim accounting:       Off
Service Accounting:         test-svc1
  Acct-Session-Id:          00008ad6
  Method-list:              default
  Accounting started:       Fri Feb  8 16:43:27 2013
  Interim accounting:       On, interval 2 mins
    Last successful update: Never
    Next update in:         00:01:48 (dhms)
Service Accounting:         test-svc2
  Acct-Session-Id:          00008ad7
  Method-list:              default
  Accounting started:       Fri Feb  8 16:43:27 2013
  Interim accounting:       On, interval 2 mins
    Last successful update: Never
    Next update in:         00:01:48 (dhms)
Last COA request received: unavailable

This sample output of show subscriber session all command, displays the active IPv4 or IPv6 client sessions for a dual-stack configuration.

RP/0/RSP0/CPU0:router# show subscriber session all

Tue Jan 29   12:49:25.237 UTC

Codes: IN -   Initialize, CN - Connecting, CD - Connected, AC - Activated,

       ID - Idle, DN - Disconnecting, ED -   End

Type         Interface               State     Subscriber IP Addr / Prefix

                                                 LNS Address (Vrf)                            

--------------------------------------------------------------------------------

IP:DHCP     BE1.10.ip22             AC       10.10.10.10 (default)

                                                 2001::2 (default)               

This sample output of show subscriber session all detail command, displays the detailed information of the active IPv4 or IPv6 client sessions for a dual-stack configuration.

RP/0/RSP0/CPU0:router# show subscriber session all detail

Tue Jan 29   12:49:27.752 UTC

Interface:               Bundle-Ether1.10.ip22

Circuit ID:               Unknown

Remote ID:               Unknown

Type:                     IP: DHCP-trigger

IPv4 State:               Up, Tue Jan 29 12:46:32 2013

IPv4   Address:             10.10.10.10, VRF:   default

IPv6 State:               Up, Tue Jan 29 12:46:42 2013

IPv6   Address:            2001::2, VRF: default

IPv6 Interface   ID:       ..d..... (02 00 64 ff fe 01   01 02)

Mac   Address:             0000.6401.0102

Account-Session   Id:       0000001c

Nas-Port:                 Unknown

User name:               0000.6401.0102

Outer VLAN ID:           10

Subscriber   Label:         0x00000055

Created:                 Tue Jan 29 12:46:32 2013

State:                   Activated

Authentication:           unauthenticated

Access-interface:         Bundle-Ether1.10

Policy Executed:

policy-map type   control subscriber pm-src-mac

event Session-Start match-all [at Tue Jan   29 12:46:32 2013]

   class type control subscriber   dual_stack_class_map do-all [Succeeded]

     1 activate dynamic-template   Dual_stack_IPoE [Succeeded]

     2 authorize aaa list default   [Succeeded]

Session   Accounting:      

Acct-Session-Id:         0000001c

Method-list:             default

Accounting started:       Tue Jan 29 12:46:32 2013

Interim accounting:       On, interval 1 mins

   Last successful update: Tue Jan 29   12:48:34 2013

   Next update in:         00:00:06 (dhms)

Last COA request   received: unavailable

clear subscriber session

To clear the subscriber sessions in BNG, use the clear subscriber session command in EXEC mode.

clear subscriber session { all | debug { subscriber-label } | identifier { access-interface interface-type interface-instance | interface interface-type interface-instance } } [ location node-id]

Syntax Description

all

Clears all subscriber sessions.

debug subscriber-label

Clears debug tracking of unique subscriber session.

identifier

Clears the subscriber session information based on the identifier(s) you select.

access-interface

Clears the subscriber session based on the access interface name.

interface-type

Specifies the interface type whose subscriber sessions you want to delete.

interface-instance

Specifies either a physical interface instance or a virtual interface instance that you want to delete.

The details of the interface instance are 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.
location

Clears the subscriber session information of a specific location.

node-id

Specifies the node whose subscriber sessions you want to delete. The node-id argument is entered in the rack/slot/module notation.

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

execute

Examples

This example shows how to clear all the subscriber sessions in a particular node location:

RP/0/RSP0/CPU0:router# clear subscriber session all location 0/RSP0/CPU0

Related Commands

Command

Description

show subscriber session

Displays the subscriber management session information.