Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

header-navigation
keyboard_arrow_up
close
keyboard_arrow_left
Juniper BNG CUPS User Guide
Table of Contents Expand all
list Table of Contents

Juniper BNG User Plane CLI Operational Commands

date_range 06-Mar-25

This topic provides an overview of clear, request, restart, and show commands, including syntax, option descriptions, and sample output. You use these commands with Juniper BNG User Planes.

restart bbe-cpcdd-dbng

Syntax

content_copy zoom_out_map
restart bbe-cpcdd-dbng

Description

Restarts the captive portal content delivery process for the routing engine.

Options

This command does not have any options.

Required Privilege Level

root

Output Fields

When you enter this command, you receive feedback on the status of your request.

Sample Output

restart bbe-cpcdd-dbng

content_copy zoom_out_map
user@host> restart bbe-cpcdd-dbng
Captive-portal-content-delivery process for RE started, pid 67476

restart bbe-upm-daemon

Syntax

content_copy zoom_out_map
restart bbe-upm-daemon

Description

Restarts the BNG User Plane manager daemon.

Options

This command does not have any options.

Required Privilege Level

root

Output Fields

When you enter this command, you receive feedback on the status of your request.

Sample Output

restart bbe-upm-daemon

content_copy zoom_out_map
user@host> restart bbe-upm-daemon
Control Plane Manager for dBNG started, pid <process-id>

restart gtp-proxy-service

Syntax

content_copy zoom_out_map
restart gtp-proxy-service

Description

Restarts the BNG User Plane's GPRS tunneling protocol (GTP) proxy service.

Options

This command does not have any options.

Required Privilege Level

root

Output Fields

When you enter this command, you receive feedback on the status of your request.

Sample Output

restart gtp-proxy-service

content_copy zoom_out_map
user@host> restart gtp-proxy-service
User Plane GTP Protocol Proxy started, pid 18832

restart pfcp-proxy-service

Syntax

content_copy zoom_out_map
restart pfcp-proxy-service

Description

Restarts the BNG User Plane's Packet Forwarding Control Protocol (PFCP) proxy service.

Options

This command does not have any options.

Required Privilege Level

root

Output Fields

When you enter this command, you receive feedback on the status of your request.

Sample Output

restart pfcp-proxy-service

content_copy zoom_out_map
user@host> restart pfcp-proxy-service
User Plane PFCP Protocol Proxy started, pid 18840

restart subscriber-helper-service

Syntax

content_copy zoom_out_map
restart subscriber-helper-service

Description

Restarts the enhanced BBE helper BNG User Plane process. This command runs on the BNG User Plane.

Options

This command does not have any options.

Required Privilege Level

root

Output Fields

When you enter this command, you receive feedback on the status of your request.

Sample Output

restart subscriber-helper-service

content_copy zoom_out_map
user@host> restart subscriber-helper-service
Enhanced BBE helper user plane process started, pid 18750

restart subscriber-statistics-service

Syntax

content_copy zoom_out_map
restart subscriber-statistics-service

Description

Restarts the statistics service daemon for the BNG CUPS Controller. This command runs on the BNG User Plane.

Options

This command does not have any options.

Required Privilege Level

root

Output Fields

When you enter this command, you receive feedback on the status of your request.

Sample Output

restart subscriber-statistics-service

content_copy zoom_out_map
user@host> restart subscriber-statistics-service
Statistics Services Daemon for dBNG started, pid 18764

restart up-smg-service

Syntax

content_copy zoom_out_map
restart up-smg-service

Description

Restarts the enhanced session management BNG User Plane process. This command runs on the BNG User Plane.

Options

This command does not have any options.

Required Privilege Level

root

Output Fields

When you enter this command, you receive feedback on the status of your request.

Sample Output

restart up-smg-service

content_copy zoom_out_map
user@host> restart up-smg-service
Enhanced Session Management user plane process started, pid 18585

restart upm-service

Syntax

content_copy zoom_out_map
restart upm-service

Description

Restarts the BNG User Plane manager. This command runs on the BNG User Plane.

Options

This command does not have any options.

Required Privilege Level

root

Output Fields

When you enter this command, you receive feedback on the status of your request.

Sample Output

restart upm-service

content_copy zoom_out_map
user@host> restart upm-service
User Plane Manager for dBNG started, pid 18571

show igmp group

Syntax

content_copy zoom_out_map
show igmp group

Description

Display Internet Group Management Protocol (IGMP) group membership information. This command runs on BNG User Planes.

Required Privilege Level

view

Output Fields

Table 1 describes the output fields for the show igmp group command. Output fields are listed in the approximate order in which they appear.

Table 1: show igmp group Output Fields

Field Name

Field Description

Interface

Name of the interface that received the IGMP membership report. A name of local indicates that the local routing device joined the group itself.

Group

Group address.

Group Mode

Mode the SSM group is operating in: Include or Exclude.

Source

Source address.

Source timeout

Time remaining until the group traffic is no longer forwarded. The timer is refreshed when a listener in include mode sends a report. A group in exclude mode or configured as a static group displays a zero timer.

Last reported by

Address of the host that last reported membership in this group.

Timeout

Time remaining until the group membership is removed.

Group timeout

Time remaining until a group in exclude mode moves to include mode. The timer is refreshed when a listener in exclude mode sends a report. A group in include mode or configured as a static group displays a zero timer.

Type

Type of group membership:

  • Dynamic—Host reported the membership.

  • Static—Membership is configured.

Sample Output

show igmp group

content_copy zoom_out_map
user@host> show igmp group
Interface: pp0.3221225481, Groups: 1
    Group: 225.0.0.1
        Group mode: Exclude
        Source: 0.0.0.0
        Last reported by: 100.1.1.2
        Timeout:     232 Type: Dynamic
Interface: demux0.2147483652, Groups: 1
    Group: 225.0.0.1
        Group mode: Exclude
        Source: 0.0.0.0
        Last reported by: Local
        Timeout:       0 Type: ROUTE
Interface: local, Groups: 2
    Group: 224.0.0.2
        Source: 0.0.0.0
        Last reported by: Local
        Timeout:       0 Type: Dynamic
    Group: 224.0.0.22
        Source: 0.0.0.0
        Last reported by: Local
        Timeout:       0 Type: Dynamic

show igmp statistics

Syntax

content_copy zoom_out_map
show igmp statistics 
<continuous>

Description

Display Internet Group Management Protocol (IGMP) statistics.

By default, Junos OS multicast devices collect statistics of received and transmitted IGMP control messages that reflect currently active multicast group subscribers.

Some devices also automatically maintain continuous IGMP statistics globally on the device in addition to the default active subscriber statistics—these are persistent, continuous statistics of received and transmitted IGMP control packets that account for both past and current multicast group subscriptions processed on the device. With continuous statistics, you can see the total count of IGMP control packets the device processed since the last device reboot or clear igmp statistics continuous command. The device collects and displays continuous statistics only for the fields shown in the IGMP packet statistics output section of this command, and does not display the IGMP Global statistics section.

Devices that support continuous statistics maintain this information in a shared database and copy it to the backup Routing Engine at a configurable interval to avoid too much processing overhead on the Routing Engine. These actions preserve statistics counts across the following events or operations (which doesn’t happen for the default active subscriber statistics):

  • Routing daemon restart

  • Graceful Routing Engine switchover (GRES)

  • In-service software upgrade (ISSU)

  • Line card reboot

You can change the default interval (300 seconds) using the cont-stats-collection-interval configuration statement at the [edit routing-options multicast] hierarchy level.

You can display either the default currently active subscriber statistics or continuous subscriber statistics (if supported), but not both at the same time. Include the continuous option to display continuous statistics, otherwise the command displays the statistics only for active subscribers.

Run the clear igmp statistics command to clear the currently active subscriber statistics. On devices that support continuous statistics, run the clear command with the continuous option to clear all continuous statistics. You must run these commands separately to clear both types of statistics because the device maintains and clears the two types of statistics separately.

Note:

The show igmp statistics command runs on BNG User Planes.

Options

none

Display IGMP statistics for all interfaces. These statistics represent currently active subscribers.

brief | detail

(Optional) Display the specified level of output.

continuous

(Optional) Display continuous IGMP statistics that account for both past and current multicast group subscribers instead of the default statistics that only reflect currently active subscribers.

Required Privilege Level

view

Output Fields

Table 2 describes the output fields for the show igmp statistics command. Output fields are listed in the approximate order in which they appear.

Table 2: show igmp statistics Output Fields

Field Name

Field Description

IGMP packet statistics

Heading for IGMP packet statistics for all interfaces or for the specified interface name.

Note:

Shows currently active subscriber statistics in this section by default, or when the command includes the continuous option, shows continuous, persistent statistics that account for all IGMP control packets processed on the device.

IGMP Message type

Summary of IGMP statistics:

  • Membership Query—Number of membership queries sent and received.

  • V1 Membership Report—Number of version 1 membership reports sent and received.

  • DVMRP—Number of DVMRP messages sent or received.

  • PIM V1—Number of PIM version 1 messages sent or received.

  • Cisco Trace—Number of Cisco trace messages sent or received.

  • V2 Membership Report—Number of version 2 membership reports sent or received.

  • Group Leave—Number of group leave messages sent or received.

  • Mtrace Response—Number of Mtrace response messages sent or received.

  • Mtrace Request—Number of Mtrace request messages sent or received.

  • Domain Wide Report—Number of domain-wide reports sent or received.

  • V3 Membership Report—Number of version 3 membership reports sent or received.

  • Other Unknown types—Number of unknown message types received.

  • IGMP v3 unsupported type—Number of messages received with unknown and unsupported IGMP version 3 message types.

  • IGMP v3 source required for SSM—Number of IGMP version 3 messages received that contained no source.

  • IGMP v3 mode not applicable for SSM—Number of IGMP version 3 messages received that did not contain a mode applicable for source-specific multicast (SSM). Beginning with certain releases, this type includes records received for groups in the SSM range of addresses and in which the mode is MODE_IS_EXCLUDE or CHANGE_TO_EXCLUDE_MODE. This includes records with a non-empty source list.

Received

Number of messages received.

Sent

Number of messages sent.

Rx errors

Number of received packets that contained errors.

Max Rx rate (pps)

Maximum number of IGMP packets received during 1 second interval.

IGMP Global Statistics

Summary of IGMP statistics for all interfaces.

Note:

These statistics are not supported or displayed with the continuous option.

  • Bad Length—Number of messages received with length errors so severe that further classification could not occur.

  • Bad Checksum—Number of messages received with a bad IP checksum. No further classification was performed.

  • Bad Receive If—Number of messages received on an interface not enabled for IGMP.

  • Rx non-local—Number of messages received from senders that are not local.

  • Timed out—Number of groups that timed out as a result of not receiving an explicit leave message.

  • Rejected Report—Number of reports dropped because of the IGMP group policy.

  • Total Interfaces—Number of interfaces configured to support IGMP.

Sample Output

show igmp statistics

content_copy zoom_out_map
user@host> show igmp statistics 
IGMP packet statistics for all interfaces
IGMP Message type      Received       Sent  Rx errors
Membership Query              0          2          0
V1 Membership Report          0          0          0
DVMRP                         0          0          0
PIM V1                        0          0          0
Cisco Trace                   0          0          0
V2 Membership Report          0          0          0
Group Leave                   0          0          0
Mtrace Response               0          0          0
Mtrace Request                0          0          0
Domain Wide Report            0          0          0
V3 Membership Report          2          0          0
Other Unknown types                                 0
IGMP v3 unsupported type                            0
IGMP v3 source required for SSM                     0
IGMP v3 mode not applicable for SSM                 0

IGMP Global Statistics
Bad Length                    2
Bad Checksum                  0
Bad Receive If             4878
Rx non-local                  6
Timed out                     6
Rejected Report               0
Total Interfaces              2
Max Rx rate (pps)            58

show igmp statistics continuous

content_copy zoom_out_map
user@host> show igmp statistics continuous 
IGMP packet statistics for all interfaces
IGMP Message type      Received       Sent  Rx errors
Membership Query              0       6932          0
V1 Membership Report          0          0          0
DVMRP                         0          0          0
PIM V1                        0          0          0
Cisco Trace                   0          0          0
V2 Membership Report          0          0          0
Group Leave                   0          0          0
Mtrace Response               0          0          0
Mtrace Request                0          0          0
Domain Wide Report            0          0          0
V3 Membership Report          6          0          0
Other Unknown types                                 0
IGMP v3 unsupported type                            0
IGMP v3 source required for SSM                     0
IGMP v3 mode not applicable for SSM                 0

show mld group

Syntax

content_copy zoom_out_map
show mld group 

Description

Display information about Multicast Listener Discovery (MLD) group membership. This command runs on BNG User Planes.

Required Privilege Level

view

Output Fields

Table 3 describes the output fields for the show mld group command. Output fields are listed in the approximate order in which they appear.

Table 3: show mld group Output Fields

Field Name

Field Description

Interface

Name of the interface that received the MLD membership report; local means that the local router joined the group itself.

Group

Group address.

Source

Source address.

Group Mode

Mode the SSM group is operating in: Include or Exclude.

Last reported by

Address of the host that last reported membership in this group.

Source timeout

Time remaining until the group traffic is no longer forwarded. The timer is refreshed when a listener in include mode sends a report. A group in exclude mode or configured as a static group displays a zero timer.

Timeout

Time remaining until the group membership is removed.

Group timeout

Time remaining until a group in exclude mode moves to include mode. The timer is refreshed when a listener in exclude mode sends a report. A group in include mode or configured as a static group displays a zero timer.

Type

Type of group membership:

  • Dynamic—Host reported the membership.

  • Static—Membership is configured.

Sample Output

show mld group

content_copy zoom_out_map
user@host> show mld group 
Interface: pp0.3221225483, Groups: 2
    Group: ff1e::1
        Group mode: Exclude
        Source: ::
        Last reported by: fe80::e
        Timeout:     243 Type: Dynamic
    Group: ff1e::2
        Group mode: Exclude
        Source: ::
        Last reported by: fe80::e
        Timeout:     249 Type: Dynamic
Interface: demux0.2147483653, Groups: 2
    Group: ff1e::1
        Group mode: Exclude
        Source: ::
        Last reported by: Local
        Timeout:       0 Type: ROUTE
    Group: ff1e::2
        Group mode: Exclude
        Source: ::
        Last reported by: Local
        Timeout:       0 Type: ROUTE
Interface: local, Groups: 4
    Group: ff02::2
        Source: ::
        Last reported by: Local
        Timeout:       0 Type: Dynamic
    Group: ff02::16
        Source: ::
        Last reported by: Local
        Timeout:       0 Type: Dynamic
    Group: ff02::1:2
        Source: ::
        Last reported by: Local
        Timeout:       0 Type: Dynamic
    Group: ff05::1:3
        Source: ::
        Last reported by: Local
        Timeout:       0 Type: Dynamic

show mld statistics

Syntax

content_copy zoom_out_map
show mld statistics 
<continuous>

Description

Display information about Multicast Listener Discovery (MLD) statistics.

By default, Junos OS multicast devices collect statistics of received and transmitted MLD control messages that reflect currently active multicast group subscribers.

Some devices also automatically maintain continuous MLD statistics globally on the device in addition to the default active subscriber statistics—these are persistent, continuous statistics of received and transmitted MLD control packets that account for both past and current multicast group subscriptions processed on the device. With continuous statistics, you can see the total count of MLD control packets the device processed since the last device reboot or clear mld statistics continuous command. The device collects and displays continuous statistics only for the fields shown in the MLD packet statistics... output section of this command, and does not display the MLD Global statistics section.

Devices that support continuous statistics maintain this information in a shared database and copy it to the backup Routing Engine at a configurable interval to avoid too much processing overhead on the Routing Engine. These actions preserve statistics counts across the following events or operations (which doesn’t happen for the default active subscriber statistics):

  • Routing daemon restart

  • Graceful Routing Engine switchover (GRES)

  • In-service software upgrade (ISSU)

  • Line card reboot

You can change the default interval (300 seconds) using the cont-stats-collection-interval configuration statement at the [edit routing-options multicast] hierarchy level.

You can display either the default currently active subscriber statistics or continuous subscriber statistics (if supported), but not both at the same time. Include the continuous option to display continuous statistics, otherwise the command displays the statistics only for currently active subscribers.

Run the clear mld statistics command to clear the currently active subscriber statistics. On devices that support continuous statistics, run the clear command with the continuous option to clear all continuous statistics. You must run these commands separately to clear both types of statistics because the device maintains and clears the two types of statistics separately.

Note:

The show mld statistics command runs on BNG User Planes.

Options

none

Display MLD statistics for all interfaces. These statistics represent currently active subscribers.

continuous

(Optional) Display continuous MLD statistics that account for both past and current multicast group subscribers instead of the default statistics that only reflect currently active subscribers. This option is not available with the interface option for interface-specific statistics.

Required Privilege Level

view

Output Fields

Table 4 describes the output fields for the show mld statistics command. Output fields are listed in the approximate order in which they appear.

Table 4: show mld statistics Output Fields

Field Name

Field Description

MLD Packet Statistics...

Heading for MLD packet statistics for all interfaces or for the specified interface name.

Note:

Shows currently active subscriber statistics in this section by default, or when the command includes the continuous option, shows continuous, persistent statistics that account for all MLD control packets processed on the device.

Received

Number of received packets.

Sent

Number of transmitted packets.

Rx errors

Number of received packets that contained errors.

MLD Message type

Summary of MLD statistics.

  • Listener Query (v1/v2)—Number of membership queries sent and received.

  • Listener Report (v1)—Number of version 1 membership reports sent and received.

  • Listener Done (v1/v2)—Number of Listener Done messages sent and received.

  • Listener Report (v2)—Number of version 2 membership reports sent and received.

  • Other Unknown types—Number of unknown message types received.

  • MLD v2 source required for SSM—Number of MLD version 2 messages received that contained no source.

  • MLD v2 mode not applicable for SSM—Number of MLD version 2 messages received that did not contain a mode applicable for source-specific multicast (SSM).

MLD Global Statistics

Summary of MLD statistics for all interfaces.

Note:

These statistics are not supported or displayed with the continuous option.

  • Bad Length—Number of messages received with length errors so severe that further classification could not occur.

  • Bad Checksum—Number of messages received with an invalid IP checksum. No further classification was performed.

  • Bad Receive If—Number of messages received on an interface not enabled for MLD.

  • Rx non-local—Number of messages received from nonlocal senders.

  • Timed out—Number of groups that timed out as a result of not receiving an explicit leave message.

  • Rejected Report—Number of reports dropped because of the MLD group policy.

  • Total Interfaces—Number of interfaces configured to support IGMP.

Sample Output

show mld statistics

content_copy zoom_out_map
user@host> show mld statistics 
MLD packet statistics for all interfaces
MLD Message type            Received       Sent  Rx errors
Listener Query (v1/v2)             0          3          0
Listener Report (v1)               0          0          0
Listener Done (v1/v2)              0          0          0
Listener Report (v2)               7          0          0
Other Unknown types                                      0
MLD v2 unsupported type                                  0
MLD v2 source required for SSM                           0
MLD v2 mode not applicable for SSM                       0

MLD Global Statistics
Bad Length                    1
Bad Checksum                  0
Bad Receive If               26
Rx non-local                  0
Timed out                     4
Rejected Report               0
Max Rx rate (pps)             4
Total Interfaces              2

show mld statistics continuous

content_copy zoom_out_map
user@host> show mld statistics continuous 
MLD packet statistics for all interfaces
MLD Message type            Received       Sent  Rx errors
Listener Query (v1/v2)             0          5          0
Listener Report (v1)               0          0          0
Listener Done (v1/v2)              0          0          0
Listener Report (v2)               9          0          0
Other Unknown types                                      0
MLD v2 unsupported type                                  0
MLD v2 source required for SSM                           0
MLD v2 mode not applicable for SSM                       0

show system subscriber-management arp

Syntax

content_copy zoom_out_map
show system subscriber-management arp
<address ip-address>
<interface interface-name>

Description

Displays IPv4 to MAC address bindings (Address Resolution Protocol).

Options

none

Displays the entries in the ARP table.

address ip-address

(Optional) Displays information about ARP for the specified IPv4 address.

interface interface-name

(Optional) Displays information about ARP for the specified interface.

Required Privilege Level

view

Output Fields

Table 5 lists the output fields for the show system subscriber-management arp command. Output fields are listed in the approximate order in which they appear.

Table 5: show system subscriber-management arp Output Fields

Field Name

Field Description

MAC Address

Media access control (MAC) address that corresponds to the IP address.

Address

IP address that corresponds to the hostname.

Name

Host name.

interface

Interface name.

Flags

Indicates how mappings between IP and MAC addresses are defined:

  • permanent—Static mapping. The ARP entry never times out.

  • Blank.

Sample Output

show system subscriber-management arp

content_copy zoom_out_map
user@host> show system subscriber-management arp
MAC Address       Address         Name                      Interface               Flags
00:00:11:11:11:11 100.16.0.1      100.16.0.1                demux0.3222274078       permanent
00:00:11:11:11:14 100.16.0.2      100.16.0.2                demux0.3222274079       permanent

show system subscriber-management arp address ip-address

content_copy zoom_out_map
user@host> show system subscriber-management arp address 100.16.0.1
MAC Address       Address         Name                      Interface               Flags
00:00:11:11:11:11 100.16.0.1      100.16.0.1                demux0.3222274078       permanent

show system subscriber-management arp interface interface-name

content_copy zoom_out_map
user@host> show system subscriber-management arp interface demux0.3222274078
MAC Address       Address         Name                      Interface               Flags
00:00:11:11:11:11 100.16.0.1      100.16.0.1                demux0.3222274078       permanent

show system subscriber-management ipv6-neighbors

Syntax

content_copy zoom_out_map
show system subscriber-management ipv6-neighbors
<address ip-address>
<interface interface-name>

Description

Displays IPv6 to MAC address bindings (neighbor cache).

Options

none

Displays the entries in the IPv6 table.

address ip-address

(Optional) Display information about IPv6 for the specified IPv6 address.

interface interface-name

(Optional) Display information about IPv6 for the specified interface.

Required Privilege Level

view

Output Fields

Table 6 lists the output fields for the show system subscriber-management ipv6-neighbors command. Output fields are listed in the approximate order in which they appear.

Table 6: show system subscriber-management ipv6-neighbors Output Fields

Field Name

Field Description

IPv6 Address

The IPv6 address.

Linklayer Address

Link-layer address.

State

State of the link:

  • up

  • down

  • incomplete

  • reachable

  • stale

  • unreachable

Exp

Number of seconds until the entry expires. It will be zero for permanent entries.

Rtr

Whether the neighbor is a routing, device (yes or no).

Secure

Whether this entry was created using the Secure Neighbor Discovery (SEND) protocol.

interface

Interface name.

Sample Output

show system subscriber-management ipv6-neighbors

content_copy zoom_out_map
user@host> show system subscriber-management ipv6-neighbors
IPv6 Address                       Linklayer Address  State       Exp   Rtr  Secure  Interface
1000::e3                           00:00:11:11:11:ea  reachable   0     no   no      demux0.3222274295
1000::1e6                          00:00:11:11:12:ec  reachable   0     no   no      demux0.3222274551

show system subscriber-management ipv6-neighbors address ip-address

content_copy zoom_out_map
user@host> show system subscriber-management ipv6-neighbors address 1000::e3 
IPv6 Address                       Linklayer Address  State       Exp   Rtr  Secure  Interface
1000::e3                           00:00:11:11:11:ea  reachable   0     no   no      demux0.3222274295
1000::1e6                          00:00:11:11:12:ec  reachable   0     no   no      demux0.3222274551

show system subscriber-management ipv6-neighbors interface interface-name

content_copy zoom_out_map
user@host> show system subscriber-management ipv6-neighbors interface demux0.3222274295
IPv6 Address                        Linklayer Address  State       Exp   Rtr  Secure  Interface   
1000::e3                             00:00:11:11:11:ea  reachable   0     no   no      demux0.3222274295

show system subscriber-management routing-instance

Syntax

content_copy zoom_out_map
show system subscriber-management routing-instance
<routing-instance-name>

Description

Displays the state of the routing instances. The state of the routing instance can be either connected or isolated.

Options

routing-instance-name

(Optional) Displays the state of the specified routing instance.

Required Privilege Level

view

Output Fields

Table 7 lists the output fields for the show system subscriber-management routing-instance command. Output fields are listed in the approximate order in which they appear.

Table 7: show system subscriber-management routing-instance Output Fields

Field Name

Field Description

Routing Intance Name

Name of the routing instance.

State

The state of the routing instance. The state can be either connected or isolated.

Sample Output

show system subscriber-management routing-instance

content_copy zoom_out_map
user@host> show system subscriber-management routing-instance
Routing Instance Name              State
default                            connected

show system subscriber-management routing-instance

content_copy zoom_out_map
user@host> show system subscriber-management routing-instance example-1
Routing Instance Name              State
example-1                          connected

show system subscriber-management subscriber-group

Syntax

content_copy zoom_out_map
show system subscriber-management subscriber-group
<subscriber-group-name>

Description

Displays subscriber group information .

Options

subscriber-group-name

(Optional) Displays information for the specified subscriber group.

Required Privilege Level

view

Output Fields

Table 8 lists the output fields for the show system subscriber-management subscriber-group command. Output fields are listed in the approximate order in which they appear.

Table 8: show system subscriber-management subscriber-group Output Fields

Field Name

Field Description

Name

Name of the subscriber group.

ID

ID for the subscriber group.

SGRP Mode

The subscriber group mode. The mode can be either Control Plane or User Plane.

Oper State

The operational state of the subscriber group. The state can be either Active or Backup.

Ports

The number of ports associated with the subscriber group.

Sessions

The number of subscriber sessions for the subscriber group

Backup Mode

The backup mode or the subscriber group. The backup mode can be either Hot or Warm-enhanced.

Vmac

The virtual MAC address for the subscriber group.

Redundancy Services

Grouping of subscriber sessions for full state restoration to become active. List the number of redundancy services.

PFE-Subscriber-State

The PFE subscriber state. The state can be the following:

  • Flow Only

  • RE Only

  • Full Service

  • Activating

  • Deactivating

  • Exceeded Limit

Switchover-%

The percent of the sessions that have been fully restored on switchover.

Sample Output

show system subscriber-management subscriber-group

content_copy zoom_out_map
user@host> show system subscriber-management subscriber-group
Name             ID        SGRP Mode      Oper State   Ports     Sessions
exampl-1         1024      Control Plane  Active       1         2000     

show system subscriber-management subscriber-group subscriber-group-name

content_copy zoom_out_map
user@host> show system subscriber-management subscriber-group SGRP-1
Name:                   SGRP-1 
ID:                     2048 
Mode:                   Control Plane 
Backup Mode:            Warm-enhanced
Oper State:             Backup 
Vmac:                   22:0:0:0:0:22 
Sessions:               4000 
Ports:                  1 
  ae1 
 
Redundancy Services:    4 
ID          Sessions PFE-Subscriber-State Switchover-% 
524322      1000     Flow Only            - 
524323      1000     Flow Only            - 
524324      1000     Flow Only            - 
524325      1000     Flow Only            -  

show system subscriber-management user-plane

Syntax

content_copy zoom_out_map
show system subscriber-management user-plane 
<associations>
<clients>
<control-plane bng-cups-controller-name> <endpoint endpoint-name>
<services> <service service-name>
<routing-instance routing-instance-name>
<upm>

Description

Displays statistics for the specified option. This command runs on the BNG User Plane.

Options

associations

Displays the BNG CUPS Controller that is associated to the BNG User Plane. Lists information about the BNG CUPS Controller association including the control plane instance name, its address, state, the time the association was formed and the number of times the association was updated.

clients

Displays information about each client that interacts with the user plane manager.

control-plane bng-cups-controller-name endpoint endpoint-name

Options:

  • bng-cups-controller-name—Displays information about all endpoints related to the BNG CUPS Controller association.

  • endpoint endpoint-name—Displays details about a specific endpoint related to the BNG CUPS Controller association, along with its statistics.

services

Displays a list of BNG User Plane services.

Option:

  • service service-name—Displays details of the specific service.

upm Displays summary information about the user plan manager.

Required Privilege Level

root

Output Fields

Table 9 lists the output fields for the show system subscriber-management user-plane command.

Table 9: show system subscriber-management user-plane Output Fields

Field Name

Field Description

User-plane name

The name of the BNG User Plane.

Control-plane

The name, IP address, port, and protocol of the BNG CUPS Controller that the BNG User Plane is associated to.

Attached clients

The number of clients attach to the BNG User Plane.

CP Events

The number of associations, disassociations, and association updates that have occurred to the associated BNG CUPS Controller.

CP Name

Name of the BNG CUPS Controller that the BNG User Plane is associated with.

Address

IP address of the BNG CUPS Controller that the BNG User Plane is associated with.

Assoc Time

The time that the BNG User Plane started its association with the BNG CUPS Controller.

Assoc-updates

The number of times the association has been updated.

Client-name

Name of the BNG User Plane client.

Status

The status of the service (either up or down).

Last Heartbeat Time

The time when the client's last heartbeat was recorded.

Services

The services that information is being reported for.

State (associations)

The state of the BNG CUPS Controller that the BNG User Plane is associated to. The state can be the following:

  • configured

  • ready

  • connected

  • disconnecting

  • connected-pause

State (control-plane control-plane-name)

The state of the endpoint CUPS Controller that the BNG User Plane is associated to. The state can be the following:

  • init

  • configured

  • ready

  • connected

  • timed out

  • disconnecting

  • disconnected

  • warminit

  • connected-pause

  • connected-switched

State (services)

The state of the BNG User Plane services. The state can be the following:

  • starting

  • initialized

  • reconciling

  • reconciled

  • ready

  • terminating

  • purging-db

  • fatal-error

State (services service sevice-name)

The state of the endpoint that is managed by the service. The state can be the following:

  • disabled

  • disconnected

  • connected

  • timed-out

  • resyncing

  • synchronized

  • reconciled

  • reconciling

  • connected(backPressureOn)

Endpoints (control-plane)

The list of endpoints related BG CUPS Controller association service.

Endpoints (services)

The number of endpoints managed by the service.

Restarted

The number of times that the service has been restarted.

Last Updated

The last time the service or endpoint state was refreshed by the system.

Healthy-Endpoints

The number of healthy endpoints.

Flapped

The number of times the endpoint has transitioned from a connected state.

Sample Output

show system subscriber-management user-plane associations

content_copy zoom_out_map
user@host show system subscriber-management user-plane associations
CP Name       Address       State             Assoc Time                Assoc-updates
cpi-example    192.0.2.1     Connected         Thu Sep 24 10:44:31 2020  0

show system subscriber-management user-plane control-plane control-plane-name

content_copy zoom_out_map
user@host> show system subscriber-management user-plane control-plane cpi-example
Ip address: 10.216.173.57
Endpoints               Flapped         State                     Last Updated
  Sci                      2          timed out                    0s ago     
  Cpri                     11         disconnected                 0s ago     
  PfcpProxyStatsIpc        1          connected                    0s ago     
  StatsPfcpProxyIpc        0          connected                    0s ago     
  PfcpProxySmgIpc          1          connected                    0s ago     
  SmgPfcpProxyIpc          0          connected                    0s ago  

show system subscriber-management user-plane control-plane control-plane-name endpoint endpoint-name

content_copy zoom_out_map
user@host> show system subscriber-management user-plane control-plane cpi-example endpoint Sci 
Sci
  Status: timed out
  Rx:                          87
    Invalid packets:           1
    HeartbeatReq                 27
    HeartbeatResp                27
    AssociationSetupReq          4
    AssociationUpdateReq         23
    AssociationUpdateRespAck     1
    NodeReportRespAck            2
    SessionEstablishmentReq      3
  Tx:                          253109
    Avg Round Trip Time:       0
    Transmit errors:           0
    Max Retransmissions:       0
    Retransmissions:           0
    HeartbeatReq                 253054
    HeartbeatResp                28
    AssociationSetupRespAck      3
    AssociationUpdateReq         1
    AssociationUpdateRespAck     18
    NodeReportReq                2
    SessionEstablishmentRespAck  3

show system subscriber-management user-plane services

content_copy zoom_out_map
user@host show system subscriber-management user-plane services
Services                           Status        State             Endpoints    Healthy-Endpoints
pfcp-proxy-service                  up           ready               2              2    
up-smg-service                      up           ready               5              4    
subscriber-helper-service           up           ready               0              0    
replication-server-service          up           ready               0              0    
replication-client-service          up           ready               0              0    
upm-service                         up           ready               0              0    
subscriber-statistics-service       up           ready               1              1    
gtp-proxy-service                   up           ready               3              3    

show system subscriber-management user-plane services service service-name

content_copy zoom_out_map
user@host show system subscriber-management user-plane services service pfcp-proxy-service
pfcp-proxy-service   
  Status: up
  State: ready
  Restarted: 1 times
  Last Updated: 27s ago
  Endpoints:Id           Flapped       State            Last Updated
  PfcpProxySmgIpc:1        1         connected           0s ago     
  PfcpProxyStatsIpc:0      1         connected           0s ago 
 

show system subscriber-management user-plane upm

content_copy zoom_out_map
user@host> show system subscriber-management user-plane upm
Start time: Thu Sep 24 10:44:31 2020
User-plane name: vm123
Control-plane:
    Name:            test12
    IP Address:      192.0.2.1
    Port:            8805
    Protocol:        pfcp
Attached clients:    2
CP Events:
    Associations:    1
    Disassociations: 0
    Assoc Updates:   0

show user-plane class-of-service classifier

Syntax

content_copy zoom_out_map
show user-plane class-of-service classifier
<name name>
<type type>

Description

Displays BNG User Plane specific class-of-service (CoS) classifiers information. This command displays the mapping of code point value to forwarding class and loss priority.

Options

none

Display all classifiers.

name name

(Optional) Display named classifier.

type type

(Optional) Displays the classifier of the specified type. The classifier type can be one of the following:

  • dscp—Displays all classifiers of the Differentiated Services code point (DSCP) type.

  • dscp-ipv6—Displays all classifiers of the DSCP for IPv6 type.

  • exp—Displays all classifiers of the MPLS experimental (EXP) type.

  • ieee-802.1—Displays all classifiers of the ieee-802.1 type.

  • ieee-802.1ad—Displays all classifiers of the ieee-802.1ad type.

  • inet-precedence—Displays all classifiers of the inet-precedence type.

  • inet6-precedence—Displays all classifiers of the inet6-precedence type.

Required Privilege Level

view

Output Fields

Table 10 describes the output fields for the show user-plane class-of-service classifier command. Output fields are listed in the approximate order in which they appear.

Table 10: show user-plane class-of-service classifier Output Fields

Field Name

Field Description

Classifier

Name of the classifier.

Code point type

Type of the classifier: exp (not on EX Series switch), dscp, dscp-ipv6 (not on EX Series switch), ieee-802.1, or inet-precedence.

Index

Internal index of the classifier.

Code point

Code point value used for classification

Forwarding class

Classification of a packet affecting the forwarding, scheduling, and marking policies applied as the packet transits the router.

Loss priority

Loss priority value used for classification. For most platforms, the value is high or low. For some platforms, the value is high, medium-high, medium-low, or low.

Sample Output

show user-plane class-of-service classifier

content_copy zoom_out_map
user@host>show user-plane class-of-service classifier
Classifier: dscp-default, Code point type: dscp, Index: 7
  Code point         Forwarding class                    Loss priority
  000001             q0                                  low
  000010             q0                                  low
  000011             q0                                  low
  000100             q0                                  low
  000101             q0                                  low
  000110             q0                                  low
  000111             q0                                  low
  001000             q0                                  low
  001001             q0                                  low
  001010             q2                                  low
  001011             q0                                  low
  001100             q2                                  high
  001101             q0                                  low
  001110             q2                                  high
  001111             q0                                  low
  010000             q0                                  low
  010001             q0                                  low
  010010             q0                                  low
  010011             q0                                  low
  010100             q0                                  low
  010101             q0                                  low
  010110             q0                                  low
  010111             q0                                  low
  011000             q0                                  low
  011001             q0                                  low
  011010             q0                                  low
  011011             q0                                  low
  011100             q0                                  low
  011101             q0                                  low
  011110             q0                                  low
  011111             q0                                  low
  100000             q0                                  low
  100001             q0                                  low
  100010             q0                                  low
  100011             q0                                  low
  100100             q0                                  low
  100101             q0                                  low
  100110             q0                                  low
  100111             q0                                  low
  101000             q0                                  low
  101001             q0                                  low
  101010             q0                                  low
  101011             q0                                  low
  101100             q0                                  low
  101101             q0                                  low
  101110             q1                                  low
  101111             q0                                  low
  110000             q3                                  low
  110001             q0                                  low
  110010             q0                                  low
  110011             q0                                  low
  110100             q0                                  low
  110101             q0                                  low
  110110             q0                                  low
  110111             q0                                  low
  111000             q3                                  low
  111001             q0                                  low
  111010             q0                                  low
  111011             q0                                  low
  111100             q0                                  low
  111101             q0                                  low
  111110             q0                                  low
  111111             q0                                  low

Classifier: dscp-ipv6-default, Code point type: dscp-ipv6, Index: 8
  Code point         Forwarding class                    Loss priority
  000001             q0                                  low
  000010             q0                                  low
  000011             q0                                  low
  000100             q0                                  low
  000101             q0                                  low
  000110             q0                                  low
  000111             q0                                  low
  001000             q0                                  low
  001001             q0                                  low
  001010             q2                                  low
  001011             q0                                  low
  001100             q2                                  high
  001101             q0                                  low
  001110             q2                                  high
  001111             q0                                  low
  010000             q0                                  low
  010001             q0                                  low
  010010             q0                                  low
  010011             q0                                  low
  010100             q0                                  low
  010101             q0                                  low
  010110             q0                                  low
  010111             q0                                  low
  011000             q0                                  low
  011001             q0                                  low
  011010             q0                                  low
  011011             q0                                  low
  011100             q0                                  low
  011101             q0                                  low
  011110             q0                                  low
  011111             q0                                  low
  100000             q0                                  low
  100001             q0                                  low
  100010             q0                                  low
  100011             q0                                  low
  100100             q0                                  low
  100101             q0                                  low
  100110             q0                                  low
  100111             q0                                  low
  101000             q0                                  low
  101001             q0                                  low
  101010             q0                                  low
  101011             q0                                  low
  101100             q0                                  low
  101101             q0                                  low
  101110             q1                                  low
  101111             q0                                  low
  110000             q3                                  low
  110001             q0                                  low
  110010             q0                                  low
  110011             q0                                  low
  110100             q0                                  low
  110101             q0                                  low
  110110             q0                                  low
  110111             q0                                  low
  111000             q3                                  low
  111001             q0                                  low
  111010             q0                                  low
  111011             q0                                  low
  111100             q0                                  low
  111101             q0                                  low
  111110             q0                                  low
  111111             q0                                  low

Classifier: dscp-ipv6-compatibility, Code point type: dscp-ipv6, Index: 9
  Code point         Forwarding class                    Loss priority
  000001             q0                                  low
  000010             q0                                  low
  000011             q0                                  low
  000100             q0                                  low
  000101             q0                                  low
  000110             q0                                  low
  000111             q0                                  low
  001000             q0                                  low
  001001             q0                                  low
  001010             q0                                  low
  001011             q0                                  low
  001100             q0                                  low
  001101             q0                                  low
  001110             q0                                  low
  001111             q0                                  low
  010000             q0                                  low
  010001             q0                                  low
  010010             q0                                  low
  010011             q0                                  low
  010100             q0                                  low
  010101             q0                                  low
  010110             q0                                  low
  010111             q0                                  low
  011000             q0                                  low
  011001             q0                                  low
  011010             q0                                  low
  011011             q0                                  low
  011100             q0                                  low
  011101             q0                                  low
  011110             q0                                  low
  011111             q0                                  low
  100000             q0                                  low
  100001             q0                                  low
  100010             q0                                  low
  100011             q0                                  low
  100100             q0                                  low
  100101             q0                                  low
  100110             q0                                  low
  100111             q0                                  low
  101000             q0                                  low
  101001             q0                                  low
  101010             q0                                  low
  101011             q0                                  low
  101100             q0                                  low
  101101             q0                                  low
  101110             q0                                  low
  101111             q0                                  low
  110000             q3                                  low
  110001             q0                                  low
  110010             q0                                  low
  110011             q0                                  low
  110100             q0                                  low
  110101             q0                                  low
  110110             q0                                  low
  110111             q0                                  low
  111000             q3                                  low
  111001             q0                                  low
  111010             q0                                  low
  111011             q0                                  low
  111100             q0                                  low
  111101             q0                                  low
  111110             q0                                  low
  111111             q0                                  low

Classifier: exp-default, Code point type: exp, Index: 10
  Code point         Forwarding class                    Loss priority
  001                q0                                  high
  010                q1                                  low
  011                q1                                  high
  100                q2                                  low
  101                q2                                  high
  110                q3                                  low
  111                q3                                  high

Classifier: ieee8021p-default, Code point type: ieee-802.1, Index: 11
  Code point         Forwarding class                    Loss priority
  001                q0                                  high
  010                q1                                  low
  011                q1                                  high
  100                q2                                  low
  101                q2                                  high
  110                q3                                  low
  111                q3                                  high

Classifier: ipprec-default, Code point type: inet-precedence, Index: 12
  Code point         Forwarding class                    Loss priority
  001                q2                                  low
  010                q0                                  low
  011                q0                                  low
  100                q0                                  low
  101                q1                                  low
  110                q3                                  low
  111                q3                                  high

Classifier: ipprec-compatibility, Code point type: inet-precedence, Index: 13
  Code point         Forwarding class                    Loss priority
  001                q0                                  high
  010                q0                                  low
  011                q0                                  high
  100                q0                                  low
  101                q0                                  high
  110                q3                                  low
  111                q3                                  high

show user-plane class-of-service classifier name

content_copy zoom_out_map
user@host> show user-plane class-of-service classifier name ipprec-default type inet-precedenc             
Classifier: ipprec-default, Code point type: inet-precedence, Index: 12
  Code point         Forwarding class                    Loss priority
  001                q2                                  low
  010                q0                                  low
  011                q0                                  low
  100                q0                                  low
  101                q1                                  low
  110                q3                                  low
  111                q3                                  high

show user-plane class-of-service interface

Syntax

content_copy zoom_out_map
show user-plane class-of-service interface 
<detail> 
<interface-name>

Description

Displays BNG User Plane specific class-of-service (CoS) information for subscriber logical interfaces. This command displays the subscriber logical interface association for the classifier, rewrite rules, and scheduler map objects.

Note:

This topic lists all possible options and output fields for the show user-plane class-of-service interface command. Options and output fields can vary depending on the platform, software release, and operating system (Junos OS or Junos OS Evolved).

Note:

On routing platforms with dual Routing Engines, running this command on the backup Routing Engine, with or without any of the available options, is not supported and produces the following error message:

error: the class-of-service subsystem is not running

Options

none

Display CoS associations for all physical and logical interfaces.

detail

(Optional) Display QoS and CoS information based on the interface.

If the interfaceinterface-name is a physical interface, the output includes:

  • Brief QoS information about the physical interface

  • Brief QoS information about the logical interface

  • CoS information about the physical interface

  • Brief information about filters or policers of the logical interface

  • Brief CoS information about the logical interface

If the interfaceinterface-name is a logical interface, the output includes:

  • Brief QoS information about the logical interface

  • Information about filters or policers for the logical interface

  • CoS information about the logical interface

interface-name

(Optional) Display class-of-service (CoS) associations for the specified interface.

none

Display CoS associations for all physical and logical interfaces.

Required Privilege Level

view

Output Fields

Table 11 describes the output fields for the show user-plane class-of-service interface command. Output fields are listed in the approximate order in which they appear.

Table 11: show user-plane class-of-service interface Output Fields

Field Name

Field Description

Physical interface

Name of a physical interface.

Index

Index of this interface or the internal index of this object.

(Enhanced subscriber management) Index values for dynamic CoS traffic control profiles and dynamic scheduler maps are larger for enhanced subscriber management than they are for legacy subscriber management.

Dedicated Queues

Status of dedicated queues configured on an interface.

(Enhanced subscriber management) This field is not displayed for enhanced subscriber management.

Maximum usable queues

Number of queues you can configure on the interface.

Maximum usable queues

Maximum number of queues you can use.

Total non-default queues created

Number of queues created in addition to the default queues.

(Enhanced subscriber management) This field is not displayed for enhanced subscriber management.

Rewrite Input IEEE Code-point

IEEE 802.1p code point (priority) rewrite value. Incoming traffic from the Fibre Channel (FC) SAN is classified into the forwarding class specified in the native FC interface (NP_Port) fixed classifier and uses the priority specified as the IEEE 802.1p rewrite value.

Shaping rate

Maximum transmission rate on the physical interface. You can configure the shaping rate on the physical interface, or on the logical interface, but not on both. Therefore, the Shaping rate field is displayed for either the physical interface or the logical interface.

Scheduler map

Name of the output scheduler map associated with this interface.

(Enhanced subscriber management) The name of the dynamic scheduler map object is associated with a generated UID (for example, SMAP-1_UID1002) instead of with a subscriber interface.

Scheduler map forwarding class sets

Name of the output fabric scheduler map associated with a QFabric system Interconnect device interface.

Input shaping rate

Maximum transmission rate on the input interface.

Input scheduler map

Name of the input scheduler map associated with this interface.

Chassis scheduler map

Name of the scheduler map associated with the packet forwarding component queues.

Rewrite

Name and type of the rewrite rules associated with this interface.

Traffic-control-profile

Name of the associated traffic control profile.

(Enhanced subscriber management) The name of the dynamic traffic control profile object is associated with a generated UID (for example, TC_PROF_100_199_SERIES_UID1006) instead of with a subscriber interface.

Classifier

Name and type of classifiers associated with this interface.

Forwarding-class-map

Name of the forwarding map associated with this interface.

Congestion-notification

Congestion notification state, enabled or disabled.

Dedicated Buffer Profile

Name of the dedicated buffer profile associated with the interface.

Monitoring Profile Name

Name of the monitoring profile defined to monitor the peak queue length for virtual output queues (VOQs) for the interface.

Logical interface

Name of a logical interface.

Object

Category of an object: Classifier, Fragmentation-map (for LSQ interfaces only), Scheduler-map, Rewrite, Translation Table, or traffic-class-map.

Name

Name of an object.

Type

Type of an object: dscp, dscp-ipv6, exp, ieee-802.1, ip, inet-precedence, or ieee-802.1ad.

Link-level type

Encapsulation on the physical interface.

MTU

MTU size on the physical interface.

Speed

Speed at which the interface is running.

Loopback

Whether loopback is enabled and the type of loopback.

Source filtering

Whether source filtering is enabled or disabled.

Flow control

Whether flow control is enabled or disabled.

Auto-negotiation

Whether autonegotiation is enabled or disabled.

Remote-fault

Remote fault status.

  • Online—Autonegotiation is manually configured as online.

  • Offline—Autonegotiation is manually configured as offline.

Device flags

The Device flags field provides information about the physical device and displays one or more of the following values:

  • Down—Device has been administratively disabled.

  • Hear-Own-Xmit—Device receives its own transmissions.

  • Link-Layer-Down—The link-layer protocol has failed to connect with the remote endpoint.

  • Loopback—Device is in physical loopback.

  • Loop-Detected—The link layer has received frames that it sent, thereby detecting a physical loopback.

  • No-Carrier—On media that support carrier recognition, no carrier is currently detected.

  • No-Multicast—Device does not support multicast traffic.

  • Present—Device is physically present and recognized.

  • Promiscuous—Device is in promiscuous mode and recognizes frames addressed to all physical addresses on the media.

  • Quench—Transmission on the device is quenched because the output buffer is overflowing.

  • Recv-All-Multicasts—Device is in multicast promiscuous mode and therefore provides no multicast filtering.

  • Running—Device is active and enabled.

Interface flags

The Interface flags field provides information about the physical interface and displays one or more of the following values:

  • Admin-Test—Interface is in test mode and some sanity checking, such as loop detection, is disabled.

  • Disabled—Interface is administratively disabled.

  • Down—A hardware failure has occurred.

  • Hardware-Down—Interface is nonfunctional or incorrectly connected.

  • Link-Layer-Down—Interface keepalives have indicated that the link is incomplete.

  • No-Multicast—Interface does not support multicast traffic.

  • No-receive No-transmit—Passive monitor mode is configured on the interface.

  • Point-To-Point—Interface is point-to-point.

  • Pop all MPLS labels from packets of depth—MPLS labels are removed as packets arrive on an interface that has the pop-all-labels statement configured. The depth value can be one of the following:

    • 1—Takes effect for incoming packets with one label only.

    • 2—Takes effect for incoming packets with two labels only.

    • [ 1 2 ]—Takes effect for incoming packets with either one or two labels.

  • Promiscuous—Interface is in promiscuous mode and recognizes frames addressed to all physical addresses.

  • Recv-All-Multicasts—Interface is in multicast promiscuous mode and provides no multicast filtering.

  • SNMP-Traps—SNMP trap notifications are enabled.

  • Up—Interface is enabled and operational.

Flags

The Logical interface flags field provides information about the logical interface and displays one or more of the following values:

  • ACFC Encapsulation—Address control field Compression (ACFC) encapsulation is enabled (negotiated successfully with a peer).

  • Device-down—Device has been administratively disabled.

  • Disabled—Interface is administratively disabled.

  • Down—A hardware failure has occurred.

  • Clear-DF-Bit—GRE tunnel or IPsec tunnel is configured to clear the Don't Fragment (DF) bit.

  • Hardware-Down—Interface protocol initialization failed to complete successfully.

  • PFC—Protocol field compression is enabled for the PPP session.

  • Point-To-Point—Interface is point-to-point.

  • SNMP-Traps—SNMP trap notifications are enabled.

  • Up—Interface is enabled and operational.

Encapsulation

Encapsulation on the logical interface.

Admin

Administrative state of the interface (Up or Down)

Link

Status of physical link (Up or Down).

Proto

Protocol configured on the interface.

Input Filter

Names of any firewall filters to be evaluated when packets are received on the interface, including any filters attached through activation of dynamic service.

Output Filter

Names of any firewall filters to be evaluated when packets are transmitted on the interface, including any filters attached through activation of dynamic service.

Link flags

Provides information about the physical link and displays one or more of the following values:

  • ACFC—Address control field compression is configured. The Point-to-Point Protocol (PPP) session negotiates the ACFC option.

  • Give-Up—Link protocol does not continue connection attempts after repeated failures.

  • Loose-LCP—PPP does not use the Link Control Protocol (LCP) to indicate whether the link protocol is operational.

  • Loose-LMI—Frame Relay does not use the Local Management Interface (LMI) to indicate whether the link protocol is operational.

  • Loose-NCP—PPP does not use the Network Control Protocol (NCP) to indicate whether the device is operational.

  • Keepalives—Link protocol keepalives are enabled.

  • No-Keepalives—Link protocol keepalives are disabled.

  • PFC—Protocol field compression is configured. The PPP session negotiates the PFC option.

Hold-times

Current interface hold-time up and hold-time down, in milliseconds.

CoS queues

Number of CoS queues configured.

Last flapped

Date, time, and how long ago the interface went from down to up. The format is Last flapped: year-month-day hour:minute:second:timezone (hour:minute:second ago). For example, Last flapped: 2002-04-26 10:52:40 PDT (04:33:20 ago).

Statistics last cleared

Number and rate of bytes and packets received and transmitted on the physical interface.

  • Input bytes—Number of bytes received on the interface.

  • Output bytes—Number of bytes transmitted on the interface.

  • Input packets—Number of packets received on the interface.

  • Output packets—Number of packets transmitted on the interface.

Exclude Overhead Bytes

Exclude the counting of overhead bytes from aggregate queue statistics.

  • Disabled—Default configuration. Includes the counting of overhead bytes in aggregate queue statistics.

  • Enabled—Excludes the counting of overhead bytes from aggregate queue statistics for just the physical interface.

  • Enabled for hierarchy—Excludes the counting of overhead bytes from aggregate queue statistics for the physical interface as well as all child interfaces, including logical interfaces and interface sets.

IPv6 transit statistics

Number of IPv6 transit bytes and packets received and transmitted on the logical interface if IPv6 statistics tracking is enabled.

Input errors

Input errors on the interface. The labels are explained in the following list:

  • Errors—Sum of the incoming frame terminations and FCS errors.

  • Drops—Number of packets dropped by the input queue of the I/O Manager ASIC. If the interface is saturated, this number increments once for every packet that is dropped by the ASIC's RED mechanism.

  • Framing errors—Number of packets received with an invalid frame checksum (FCS).

  • Runts—Number of frames received that are smaller than the runt threshold.

  • Giants—Number of frames received that are larger than the giant threshold.

  • Bucket Drops—Drops resulting from the traffic load exceeding the interface transmit or receive leaky bucket configuration.

  • Policed discards—Number of frames that the incoming packet match code discarded because they were not recognized or not of interest. Usually, this field reports protocols that Junos OS does not handle.

  • L3 incompletes—Number of incoming packets discarded because they failed Layer 3 (usually IPv4) sanity checks of the header. For example, a frame with less than 20 bytes of available IP header is discarded. Layer 3 incomplete errors can be ignored by configuring the ignore-l3-incompletes statement.

  • L2 channel errors—Number of times the software did not find a valid logical interface for an incoming frame.

  • L2 mismatch timeouts—Number of malformed or short packets that caused the incoming packet handler to discard the frame as unreadable.

  • HS link CRC errors—Number of errors on the high-speed links between the ASICs responsible for handling the router interfaces.

  • HS link FIFO overflows—Number of FIFO overflows on the high-speed links between the ASICs responsible for handling the router interfaces.

Output errors

Output errors on the interface. The labels are explained in the following list:

  • Carrier transitions—Number of times the interface has gone from down to up. This number does not normally increment quickly, increasing only when the cable is unplugged, the far-end system is powered down and up, or another problem occurs. If the number of carrier transitions increments quickly (perhaps once every 10 seconds), the cable, the far-end system, or the PIC is malfunctioning.

  • Errors—Sum of the outgoing frame terminations and FCS errors.

  • Drops—Number of packets dropped by the output queue of the I/O Manager ASIC. If the interface is saturated, this number increments once for every packet that is dropped by the ASIC's RED mechanism.

  • Aged packets—Number of packets that remained in shared packet SDRAM so long that the system automatically purged them. The value in this field should never increment. If it does, it is most likely a software bug or possibly malfunctioning hardware.

  • HS link FIFO underflows—Number of FIFO underflows on the high-speed links between the ASICs responsible for handling the router interfaces.

  • MTU errors—Number of packets whose size exceeds the MTU of the interface.

Egress queues

Total number of egress Maximum usable queues on the specified interface.

Queue counters

CoS queue number and its associated user-configured forwarding class name.

  • Queued packets—Number of queued packets.

  • Transmitted packets—Number of transmitted packets.

  • Dropped packets—Number of packets dropped by the ASIC's RED mechanism.

SONET alarms

SONET defects

SONET media-specific alarms and defects that prevent the interface from passing packets. When a defect persists for a certain period, it is promoted to an alarm. Based on the router configuration, an alarm can ring the red or yellow alarm bell on the router or light the red or yellow alarm LED on the craft interface. See these fields for possible alarms and defects: SONET PHY, SONET section, SONET line, and SONET path.

SONET PHY

Counts of specific SONET errors with detailed information.

  • Seconds—Number of seconds the defect has been active.

  • Count—Number of times that the defect has gone from inactive to active.

  • State—State of the error. A state other than OK indicates a problem.

The SONET PHY field has the following subfields:

  • PLL Lock—Phase-locked loop

  • PHY Light—Loss of optical signal

SONET section

Counts of specific SONET errors with detailed information.

  • Seconds—Number of seconds the defect has been active.

  • Count—Number of times that the defect has gone from inactive to active.

  • State—State of the error. A state other than OK indicates a problem.

The SONET section field has the following subfields:

  • BIP-B1—Bit interleaved parity for SONET section overhead

  • SEF—Severely errored framing

  • LOS—Loss of signal

  • LOF—Loss of frame

  • ES-S—Errored seconds (section)

  • SES-S—Severely errored seconds (section)

  • SEFS-S—Severely errored framing seconds (section)

SONET line

Active alarms and defects, plus counts of specific SONET errors with detailed information.

  • Seconds—Number of seconds the defect has been active.

  • Count—Number of times that the defect has gone from inactive to active.

  • State—State of the error. A state other than OK indicates a problem.

The SONET line field has the following subfields:

  • BIP-B2—Bit interleaved parity for SONET line overhead

  • REI-L—Remote error indication (near-end line)

  • RDI-L—Remote defect indication (near-end line)

  • AIS-L—Alarm indication signal (near-end line)

  • BERR-SF—Bit error rate fault (signal failure)

  • BERR-SD—Bit error rate defect (signal degradation)

  • ES-L—Errored seconds (near-end line)

  • SES-L—Severely errored seconds (near-end line)

  • UAS-L—Unavailable seconds (near-end line)

  • ES-LFE—Errored seconds (far-end line)

  • SES-LFE—Severely errored seconds (far-end line)

  • UAS-LFE—Unavailable seconds (far-end line)

SONET path

Active alarms and defects, plus counts of specific SONET errors with detailed information.

  • Seconds—Number of seconds the defect has been active.

  • Count—Number of times that the defect has gone from inactive to active.

  • State—State of the error. A state other than OK indicates a problem.

The SONET path field has the following subfields:

  • BIP-B3—Bit interleaved parity for SONET section overhead

  • REI-P—Remote error indication

  • LOP-P—Loss of pointer (path)

  • AIS-P—Path alarm indication signal

  • RDI-P—Path remote defect indication

  • UNEQ-P—Path unequipped

  • PLM-P—Path payload (signal) label mismatch

  • ES-P—Errored seconds (near-end STS path)

  • SES-P—Severely errored seconds (near-end STS path)

  • UAS-P—Unavailable seconds (near-end STS path)

  • ES-PFE—Errored seconds (far-end STS path)

  • SES-PFE—Severely errored seconds (far-end STS path)

  • UAS-PFE—Unavailable seconds (far-end STS path)

Received SONET overhead

Transmitted SONET overhead

Values of the received and transmitted SONET overhead:

  • C2—Signal label. Allocated to identify the construction and content of the STS-level SPE and for PDI-P.

  • F1—Section user channel byte. This byte is set aside for the purposes of users.

  • K1 and K2—These bytes are allocated for APS signaling for the protection of the multiplex section.

  • J0—Section trace. This byte is defined for STS-1 number 1 of an STS-N signal. Used to transmit a 1-byte fixed-length string or a 16-byte message so that a receiving terminal in a section can verify its continued connection to the intended transmitter.

  • S1—Synchronization status. The S1 byte is located in the first STS-1 number of an STS-N signal.

  • Z3 and Z4—Allocated for future use.

Received path trace

Transmitted path trace

SONET/SDH interfaces allow path trace bytes to be sent inband across the SONET/SDH link. Juniper Networks and other router manufacturers use these bytes to help diagnose misconfigurations and network errors by setting the transmitted path trace message so that it contains the system hostname and name of the physical interface. The received path trace value is the message received from the router at the other end of the fiber. The transmitted path trace value is the message that this router transmits.

HDLC configuration

Information about the HDLC configuration.

  • Policing bucket—Configured state of the receiving policer.

  • Shaping bucket—Configured state of the transmitting shaper.

  • Giant threshold—Giant threshold programmed into the hardware.

  • Runt threshold—Runt threshold programmed into the hardware.

Packet Forwarding Engine configuration

Information about the configuration of the Packet Forwarding Engine:

  • Destination slot—FPC slot number.

  • PLP byte—Packet Level Protocol byte.

CoS information

Information about the CoS queue for the physical interface.

  • CoS transmit queue—Queue number and its associated user-configured forwarding class name.

  • Bandwidth %—Percentage of bandwidth allocated to the queue.

  • Bandwidth bps—Bandwidth allocated to the queue (in bps).

  • Buffer %—Percentage of buffer space allocated to the queue.

  • Buffer usec—Amount of buffer space allocated to the queue, in microseconds. This value is nonzero only if the buffer size is configured in terms of time.

  • Priority—Queue priority: low or high.

  • Limit—Displayed if rate limiting is configured for the queue. Possible values are none and exact. If exact is configured, the queue transmits only up to the configured bandwidth, even if excess bandwidth is available. If none is configured, the queue transmits beyond the configured bandwidth if bandwidth is available.

Forwarding classes

Total number of forwarding classes supported on the specified interface.

Egress queues

Total number of egress Maximum usable queues on the specified interface.

Queue

Queue number.

Forwarding classes

Forwarding class name.

Queued Packets

Number of packets queued to this queue.

Queued Bytes

Number of bytes queued to this queue. The byte counts vary by PIC type.

Transmitted Packets

Number of packets transmitted by this queue. When fragmentation occurs on the egress interface, the first set of packet counters shows the postfragmentation values. The second set of packet counters (displayed under the Packet Forwarding Engine Chassis Queues field) shows the prefragmentation values.

Transmitted Bytes

Number of bytes transmitted by this queue. The byte counts vary by PIC type.

Tail-dropped packets

Number of packets dropped because of tail drop.

RED-dropped packets

Number of packets dropped because of random early detection (RED).

  • (M Series and T Series routers only) On M320 and M120 routers and the T Series routers, the total number of dropped packets is displayed. On all other M Series routers, the output classifies dropped packets into the following categories:

    • Low, non-TCP—Number of low-loss priority non-TCP packets dropped because of RED.

    • Low, TCP—Number of low-loss priority TCP packets dropped because of RED.

    • High, non-TCP—Number of high-loss priority non-TCP packets dropped because of RED.

    • High, TCP—Number of high-loss priority TCP packets dropped because of RED.

  • (MX Series routers with enhanced DPCs, and T Series routers with enhanced FPCs only) The output classifies dropped packets into the following categories:

    • Low—Number of low-loss priority packets dropped because of RED.

    • Medium-low—Number of medium-low loss priority packets dropped because of RED.

    • Medium-high—Number of medium-high loss priority packets dropped because of RED.

    • High—Number of high-loss priority packets dropped because of RED.

RED-dropped bytes

Number of bytes dropped because of RED. The byte counts vary by PIC type.

  • (M Series and T Series routers only) On M320 and M120 routers and the T Series routers, only the total number of dropped bytes is displayed. On all other M Series routers, the output classifies dropped bytes into the following categories:

    • Low, non-TCP—Number of low-loss priority non-TCP bytes dropped because of RED.

    • Low, TCP—Number of low-loss priority TCP bytes dropped because of RED.

    • High, non-TCP—Number of high-loss priority non-TCP bytes dropped because of RED.

    • High, TCP—Number of high-loss priority TCP bytes dropped because of RED.

Transmit rate

Configured transmit rate of the scheduler. The rate is a percentage of the total interface bandwidth.

Rate Limit

Rate limiting configuration of the queue. Possible values are :

  • None—No rate limit.

  • exact—Queue transmits at the configured rate.

Buffer size

Delay buffer size in the queue.

Priority

Scheduling priority configured as low or high.

Excess Priority

Priority of the excess bandwidth traffic on a scheduler: low, medium-low, medium-high, high, or none.

Drop profiles

Display the assignment of drop profiles.

  • Loss priority—Packet loss priority for drop profile assignment.

  • Protocol—Transport protocol for drop profile assignment.

  • Index—Index of the indicated object. Objects that have indexes in this output include schedulers and drop profiles.

  • Name—Name of the drop profile.

  • Type—Type of the drop profile: discrete or interpolated.

  • Fill Level—Percentage fullness of a queue.

  • Drop probability—Drop probability at this fill level.

Excess Priority

Priority of the excess bandwidth traffic on a scheduler.

Drop profiles

Display the assignment of drop profiles.

  • Loss priority—Packet loss priority for drop profile assignment.

  • Protocol—Transport protocol for drop profile assignment.

  • Index—Index of the indicated object. Objects that have indexes in this output include schedulers and drop profiles.

  • Name—Name of the drop profile.

  • Type—Type of the drop profile: discrete or interpolated.

  • Fill Level—Percentage fullness of a queue.

  • Drop probability—Drop probability at this fill level.

Adjustment information

Display the assignment of shaping-rate adjustments on a scheduler node or queue.

  • Adjusting application—Application that is performing the shaping-rate adjustment.

    • The adjusting application can appear as ancp LS-0, which is the Junos OS Access Node Control Profile process (ancpd) that performs shaping-rate adjustments on schedule nodes.

    • The adjusting application can appear as DHCP, which adjusts the shaping-rate and overhead-accounting class-of-service attributes based on DSL Forum VSA conveyed in DHCP option 82, suboption 9 (Vendor Specific Information). The shaping rate is based on the actual-data-rate-downstream attribute. The overhead accounting value is based on the access-loop-encapsulation attribute and specifies whether the access loop uses Ethernet (frame mode) or ATM (cell mode).

    • The adjusting application can also appear as pppoe, which adjusts the shaping-rate and overhead-accounting class-of-service attributes on dynamic subscriber interfaces in a broadband access network based on access line parameters in Point-to-Point Protocol over Ethernet (PPPoE) Tags [TR-101]. The shaping rate is based on the actual-data-rate-downstream attribute. The overhead accounting value is based on the access-loop-encapsulation attribute and specifies whether the access loop uses Ethernet (frame mode) or ATM (cell mode).

  • Adjustment type—Type of adjustment: absolute or delta.

  • Configured shaping rate—Shaping rate configured for the scheduler node or queue.

  • Adjustment value—Value of adjusted shaping rate.

  • Adjustment target—Level of shaping-rate adjustment performed: node or queue.

  • Adjustment overhead-accounting mode—Configured shaping mode: frame or cell.

  • Adjustment overhead bytes—Number of bytes that the ANCP agent adds to or subtracts from the actual downstream frame overhead before reporting the adjusted values to CoS.

  • Adjustment target—Level of shaping-rate adjustment performed: node or queue.

  • Adjustment multicast index

Sample Output

show user-plane class-of-service interface

content_copy zoom_out_map
user@host> show user-plane class-of-service interface
  Logical interface: demux0.3222274073, Index: 3222274073
Object                  Name                   Type                    Index
Classifier              dscp-ipv6-compatibility dscp-ipv6                  9
Classifier              ipprec-compatibility   ip                         13

  Logical interface: pp0.3222274074, Index: 3222274074
Object                  Name                   Type                    Index
Traffic-control-profile cp::tcp1_UID1129       Output              4295491731
Scheduler-map           cp::smap_UID1128       Output              4294967355
Classifier              ipprec-compatibility   ip                         13

show user-plane class-of-service interface interface-name

content_copy zoom_out_map
user@host> show user-plane class-of-service interface pp0.3222274074
  Logical interface: pp0.3222274074, Index: 3222274074
Object                  Name                   Type                    Index
Traffic-control-profile cp::tcp1_UID1129       Output              4295491731
Scheduler-map           cp::smap_UID1128       Output              4294967355
Classifier              ipprec-compatibility   ip                         13

show class-of-service interface detail

content_copy zoom_out_map
user@host> show user-plane class-of-service interface pp0.3222274074 detail
  Logical interface: pp0.3222274074, Index: 3222274074
Object                  Name                   Type                    Index
Traffic-control-profile cp::tcp1_UID1129       Output              4295491731
Scheduler-map           cp::smap_UID1128       Output              4294967355
Classifier              ipprec-compatibility   ip                         13

show user-plane class-of-service rewrite-rule

Syntax

content_copy zoom_out_map
show user-plane class-of-service rewrite-rule
<name name> 
<type type>

Description

Displays BNG User plane specific class-of-service (CoS) rewrite rules information. This command displays the mapping of forwarding classes and loss priority to code point values.

Options

none

Display all rewrite rules.

name name

(Optional) Display the specified rewrite rule.

type type

(Optional) Display the rewrite rule of the specified type. The rewrite rule type can be one of the following:

  • dscp—For IPv4 traffic.

  • dscp-ipv6—For IPv6 traffic.

  • exp—For MPLS traffic.

  • ieee-802.1—For Layer 2 traffic.

  • ieee-802.1ad—For Layer 2 traffic.

  • inet-precedence—For IPv4 traffic.

  • inet6-precedence—For IPv6 traffic.

Required Privilege Level

view

Output Fields

Table 12 describes the output fields for the show user-plane class-of-service rewrite-rule command. Output fields are listed in the approximate order in which they appear.

Table 12: show user-plane class-of-service rewrite-rule Output Fields

Field Name

Field Description

Rewrite rule

Name of the rewrite rule.

Code point type

Type of rewrite rule: dscp, dscp-ipv6, exp, frame-relay-de, or inet-precedence.

Forwarding class

Classification of a packet affecting the forwarding, scheduling, and marking policies applied as the packet transits the router or switch.

Index

Internal index for this particular rewrite rule.

Loss priority

Loss priority for rewriting.

Code point

Code point value to rewrite.

Sample Output

show user-plane class-of-service rewrite-rule

content_copy zoom_out_map
user@host> show user-plane class-of-service rewrite-rule     
Rewrite rule: cp::dscp-default, Code point type: dscp, Index: 138
  Forwarding class                    Loss priority       Code point
  q0                                  low                 000000
  q0                                  high                000000
  q1                                  low                 101110
  q1                                  high                101110
  q2                                  low                 000000
  q2                                  high                000000
  q3                                  low                 000000
  q3                                  high                000000

Rewrite rule: cp::dscp-ipv6-default, Code point type: dscp-ipv6, Index: 139
  Forwarding class                    Loss priority       Code point
  q0                                  low                 000000
  q0                                  high                000000
  q1                                  low                 101110
  q1                                  high                101110
  q2                                  low                 000000
  q2                                  high                000000
  q3                                  low                 000000
  q3                                  high                000000

Rewrite rule: cp::exp-default, Code point type: exp, Index: 140
  Forwarding class                    Loss priority       Code point
  q0                                  low                 000
  q0                                  high                000
  q1                                  low                 011
  q1                                  high                011
  q2                                  low                 000
  q2                                  high                000
  q3                                  low                 000
  q3                                  high                000

Rewrite rule: cp::ieee8021p-default, Code point type: ieee-802.1, Index: 141
  Forwarding class                    Loss priority       Code point
  q0                                  low                 000
  q0                                  high                000
  q1                                  low                 011
  q1                                  high                011
  q2                                  low                 000
  q2                                  high                000
  q3                                  low                 000
  q3                                  high                000

Rewrite rule: cp::ipprec-default, Code point type: inet-precedence, Index: 142
  Forwarding class                    Loss priority       Code point
  q0                                  low                 000
  q0                                  high                000
  q1                                  low                 101
  q1                                  high                101
  q2                                  low                 000
  q2                                  high                000
  q3                                  low                 000
  q3                                  high                000

show user-plane class-of-service rewrite-rule name

content_copy zoom_out_map
user@host> show user-plane class-of-service rewrite-rule name cp::ipprec-default type inet-precedence  
Rewrite rule: cp::ipprec-default, Code point type: inet-precedence, Index: 142
  Forwarding class                    Loss priority       Code point
  q0                                  low                 000
  q0                                  high                000
  q1                                  low                 101
  q1                                  high                101
  q2                                  low                 000
  q2                                  high                000
  q3                                  low                 000
  q3                                  high                000

show user-plane class-of-service scheduler-map

Syntax

content_copy zoom_out_map
show user-plane class-of-service scheduler-map
<scheduler-name>

Description

Displays BNG User plane specific class-of-service (CoS) scheduler map information. This command displays the mapping of schedulers to forwarding classes and a summary of scheduler parameters for each entry.

Options

none

Display all schedular maps.

scheduler-name

Name of the scheduler for which you want to view information. Displays a summary of scheduler parameters for each forwarding class to which the named scheduler is assigned.

Required Privilege Level

view

Output Fields

Table 13 describes the output fields for the show user-plane class-of-service scheduler-map command. Output fields are listed in the approximate order in which they appear.

Table 13: show user-plane class-of-service scheduler-map Output Fields

Field Name

Field Description

Scheduler map

Name of the scheduler map.

(Enhanced subscriber management for MX Series routers) The name of the dynamic scheduler map object is associated with a generated UID (for example, SMAP-1_UID1002) instead of with a subscriber interface.

Index

Index of the indicated object. Objects having indexes in this output include scheduler maps, schedulers, and drop profiles.

Index values for dynamic CoS traffic control profiles are larger for enhanced subscriber management than they are for legacy subscriber management.

Scheduler

Name of the scheduler.

Forwarding class

Classification of a packet affecting the forwarding, scheduling, and marking policies applied as the packet transits the router.

Transmit rate

Configured transmit rate of the scheduler (in bps). The rate is a percentage of the total interface bandwidth, or the keyword remainder, which indicates that the scheduler receives the remaining bandwidth of the interface.

Rate Limit

Rate limiting configuration of the queue. Possible values are none, meaning no rate limiting, and exact, meaning the queue only transmits at the configured rate.

Maximum buffer delay

Amount of transmit delay (in milliseconds) or the buffer size of the queue. The buffer size is shown as a percentage of the total interface buffer allocation, or by the keyword remainder to indicate that the buffer is sized according to what remains after other scheduler buffer allocations.

Priority

Scheduling priority: low or high.

Excess priority

Priority of excess bandwidth: low, medium-low, medium-high, high, or none.

Adjust minimum

Minimum shaping rate for an adjusted queue, in bps.

Adjust percent

Bandwidth adjustment applied to a queue, in percent.

Drop profiles

Table displaying the assignment of drop profiles by name and index to a given loss priority and protocol pair.

Loss priority

Packet loss priority for drop profile assignment.

Protocol

Transport protocol for drop profile assignment.

Name

Name of the drop profile.

Sample Output

show user-plane class-of-service scheduler-map

content_copy zoom_out_map
user@host> show user-plane class-of-service scheduler-map             
Scheduler map: cp::smap_UID1128, Index: 4294967355

  Scheduler: cp::s1_UID1120, Forwarding class: q0, Index: 4295491712
    Transmit rate: remainder, Rate Limit: none, Buffer size: remainder, Buffer Limit: none, Priority: low
    Excess Priority: unspecified
    Drop profiles:
      Loss priority   Protocol    Index    Name
      Low             non-TCP       128
      Low             TCP           128
      High            non-TCP       128
      High            TCP           128

  Scheduler: cp::s2_UID1121, Forwarding class: q1, Index: 4295491714
    Transmit rate: remainder, Rate Limit: none, Buffer size: remainder, Buffer Limit: none, Priority: strict-high
    Excess Priority: unspecified
    Shaping rate: 10000000 bps
    Drop profiles:
      Loss priority   Protocol    Index    Name
      Low             non-TCP       128
      Low             TCP           128
      High            non-TCP       128
      High            TCP           128

  Scheduler: cp::s3_UID1122, Forwarding class: q2, Index: 4295491715
    Transmit rate: remainder, Rate Limit: none, Buffer size: remainder, Buffer Limit: none, Priority: low
    Excess Priority: unspecified
    Shaping rate: 10000000 bps
    Drop profiles:
      Loss priority   Protocol    Index    Name
      Low             non-TCP       128
      Low             TCP           128
      High            non-TCP       128
      High            TCP           128

  Scheduler: cp::s4_UID1123, Forwarding class: q3, Index: 4295491716
    Transmit rate: remainder, Rate Limit: none, Buffer size: remainder, Buffer Limit: none, Priority: high
    Excess Priority: unspecified
    Shaping rate: 10000000 bps
    Drop profiles:
      Loss priority   Protocol    Index    Name
      Low             non-TCP       128
      Low             TCP           128
      High            non-TCP       128
      High            TCP           128

  Scheduler: cp::s5_UID1124, Forwarding class: q4, Index: 4295491717
    Transmit rate: remainder, Rate Limit: none, Buffer size: remainder, Buffer Limit: none, Priority: low
    Excess Priority: unspecified
    Drop profiles:
      Loss priority   Protocol    Index    Name
      Low             non-TCP       128
      Low             TCP           128
      High            non-TCP       128
      High            TCP           128

  Scheduler: cp::s6_UID1125, Forwarding class: q5, Index: 4295491718
    Transmit rate: remainder, Rate Limit: none, Buffer size: remainder, Buffer Limit: none, Priority: low
    Excess Priority: unspecified
    Drop profiles:
      Loss priority   Protocol    Index    Name
      Low             non-TCP       128
      Low             TCP           128
      High            non-TCP       128
      High            TCP           128

  Scheduler: cp::s7_UID1126, Forwarding class: q6, Index: 4295491719
    Transmit rate: remainder, Rate Limit: none, Buffer size: remainder, Buffer Limit: none, Priority: low
    Excess Priority: unspecified
    Drop profiles:
      Loss priority   Protocol    Index    Name
      Low             non-TCP       128
      Low             TCP           128
      High            non-TCP       128
      High            TCP           128

  Scheduler: cp::s8_UID1127, Forwarding class: q7, Index: 4295491720
    Transmit rate: remainder, Rate Limit: none, Buffer size: remainder, Buffer Limit: none, Priority: low
    Excess Priority: unspecified
    Drop profiles:
      Loss priority   Protocol    Index    Name
      Low             non-TCP       128
      Low             TCP           128
      High            non-TCP       128
      High            TCP           128
  

show user-plane class-of-service traffic-control-profile

Syntax

content_copy zoom_out_map
show user-plane class-of-service traffic-control-profile
<profile-name>

Description

Displays BNG User plane specific class-of-service (CoS) traffic control profile information. This command displays information on traffic shaping and scheduling profiles.

Options

none

Displays all traffic control profiles.

profile-name

Name of the traffic control profile for which you want to view information.

Required Privilege Level

view

Output Fields

Table 14 describes the output fields for the show class-of-service traffic-control-profile command. Output fields are listed in the approximate order in which they appear.

Table 14: show user-plane class-of-service traffic-control-profile Output Fields

Field Name

Field Description

Traffic control profile

Name of the traffic control profile.

You can configure objects of the same type with the same name on the user plane and the control plane. The display designates between the control plane and the user plane by adding cp or up to the name. Also, the dynamically generated UID is displayed.

Index

Index number of the traffic control profile.

Shaping rate

Configured shaping rate, in bps.

Note:

(MX Series routers with ATM Multi-Rate CE MIC) Configured peak rate, in cps.

Scheduler map

Name of the associated scheduler map.

(Enhanced subscriber management for MX Series routers) The name of the dynamic scheduler map object is associated with a generated UID (for example, SMAP-1_UID1002) instead of with a subscriber interface.

User-plane

The associated BNG User Plane.

Sample Output

show user-plane class-of-service traffic-control-profile

content_copy zoom_out_map
user@host> show user-plane class-of-service traffic-control-profile
Traffic control profile: cp::tcp1_UID1129, Index: 4295491731
  Shaping rate: 50000000
  Scheduler map: cp::smap_UID1128

show user-plane <user-plane-name> class-of-service traffic-control-profile profile-name

content_copy zoom_out_map
user@host> show user-plane test-123 class-of-service traffic-control-profile cp::tcp1_UID1129
Traffic control profile: cp::tcp1_UID1129, Index: 4295491731
  Shaping rate: 50000000
  Scheduler map: cp::smap_UID1128

show user-plane class-of-service traffic-control-profile static-only

show user-plane firewall filter

Syntax

content_copy zoom_out_map
show firewall
<counter> counter-name
<filter filter-name>
<log>
<prefix-action-stats>
<terse>

Description

Displays statistics about configured firewall filters on the BNG User Plane.

Options

none

Displays statistics about configured firewall filters.

counter counter-name

(Optional) Name of a filter counter.

filter filter-name

(Optional) Displays firewall filter information for the specified configured filter.

log

(Optional) Displays log entries for firewall filters.

prefix-action-stats

(Optional) Display prefix action statistics for firewall filters.

terse

(Optional) Displays firewall filter names only.

Required Privilege Level

view

Output Fields

Table 15 lists the output fields for the show user-plane firewall filter command. Output fields are listed in the approximate order in which they appear.

Table 15: show user-plane firewall filter Output Fields

Field Name

Field Description

Filter

Name of a filter that has been configured with the filter at the [edit firewall] hierarchy level.

When an interface-specific filter is displayed, the name of the filter is followed by the full interface name and by either -i for an input filter or -o for an output filter.

When dynamic filters are displayed, the name of the filter is followed by the full interface name and by either -in for an input filter or -out for an output filter. When a logical system–specific filter is displayed, the name of the filter is prefixed with two underscore (__) characters and the name of the logical system (for example, __ls1/filter1).

Counters

Display filter counter information:

  • Name—Name of a filter counter that has been configured with the counter firewall filter action.

  • Bytes—Number of bytes that match the filter term under which the counter action is specified.

  • Packets—Number of packets that matched the filter term under which the counter action is specified.

Policers

Display policer information:

  • Name—Name of policer.

  • Bytes—Number of bytes that match the filter term under which the policer action is specified. This is only the number out-of-specification (out-of-spec) byte counts, not all the bytes in all packets policed by the policer.

  • Packets—Number of packets that matched the filter term under which the policer action is specified. This is only the number of out-of-specification (out-of-spec) packet counts, not all packets policed by the policer.

Sample Output

show user-plane firewall

content_copy zoom_out_map
user@host> show user-plane firewall
Filter: in-filter-2-et-0/0/0.99-i
Counters:
Name                                                     Bytes              Packets
count-2-et-0/0/0.99-I                                        0                    0
Policers:
Name                                                     Bytes              Packets
upstream-policer-term-1-et-0/0/0.99-i                        0                    0

Filter: in-filter_UID1075-pp0.3221225500-in
Counters:
Name                                                     Bytes              Packets
P0-Aggregate-count-pp0.3221225500-in               25669737936             46757264
P1-Aggregate-count-pp0.3221225500-in               50120712891             91294559
P2-Aggregate-count-pp0.3221225500-in               50120448273             91294077
final-count-pp0.3221225500-in                      50120511408             91294192

Filter: out-filter_UID1077-pp0.3221225500-out
Counters:
Name                                                     Bytes              Packets
out-filter-count-pp0.3221225500-out                          0                    0
                                                             0                    0

show user-plane firewall filter

content_copy zoom_out_map
user@host> show user-plane firewall filter in-filter_UID1075-pp0.3221225500-in
Filter: in-filter_UID1075-pp0.3221225500-in
Counters:
Name                                                     Bytes              Packets
P0-Aggregate-count-pp0.3221225500-in               25675095078             46767022
P1-Aggregate-count-pp0.3221225500-in               50131401372             91314028
P2-Aggregate-count-pp0.3221225500-in               50131463958             91314142
final-count-pp0.3221225500-in                      

show user-plane firewall filter filter-name counter

content_copy zoom_out_map
user@host> show user-plane firewall filter in-filter_UID1075-pp0.3221225500-in counter P0-Aggregate-count-pp0.3221225500-in
Filter: in-filter_UID1075-pp0.3221225500-in
Counters:
Name                                                   Bytes              Packets
P0-Aggregate-count-pp0.3221225500-in             25688770119             46791931

show user-plane firewall terse

content_copy zoom_out_map
user@host> show user-plane firewall terse

Filter: in-filter-2-et-0/0/0.99-i

Filter: in-filter_UID1075-pp0.3221225500-in

Filter: out-filter_UID1077-pp0.3221225500-out

show user-plane firewall templates-in-use

Syntax

content_copy zoom_out_map
show user-plane firewall templates-in-use up-name user-plane-name

Description

Display the names of configured filter templates that are currently in use by dynamic subscribers and the number of times each template is referenced.

Options

user-plane-name Display the configured filter templates for the specified BNG User Plane.

Required Privilege Level

view

Output Fields

Table 16 lists the output fields for the show user-plane firewall templates-in-use command. Output fields are listed in the approximate order in which they appear.

Table 16: show user-plane firewall templates-in-use Output Fields

Field Name

Field Description

Filter Template

Name of a filter that has been configured using the filter statement at either the [edit firewall] or [edit dynamic-profiles profile-name firewall] hierarchy and is being used as a template for dynamic subscriber filtering.

User Plane

BNG User Plane name.

Reference Count

Number of times the filter has been referenced by subscribers accessing the network.

Sample Output

show user-plane firewall templates-in-use up-name up-example-1

content_copy zoom_out_map
user@host> show user-plane firewall templates-in-use up-name up-example-1
                         Dynamic Subscribers Reference Counts
Filter Template                 User Plane         Reference Count
----------------                ----------         ----------------
static-filter                   up-example-1       2                  
dynamic-filter_UID1080          up-example-1       2 

show user-plane interfaces logical

Syntax

content_copy zoom_out_map
show user-plane interfaces logical physical-interface-name
<breif | detail | terse>
<forwarding class forwarding-class-name>
<queue physical-interface-name | forwarding class forwarding-class-name>

Description

Lists interface statistics for the specified BNG User Plane subscriber interfaces.

Options

detail | extensive | terse

(Optional) Displays the specified level of output.

logical physical-interface-name Displays interface statistics for the specified BNG User Plane subscriber's interface name.
forwarding class forwarding-class-name (Optional) Forwarding class name for this queue. Shows detailed statistics for the queue associated with the specified forwarding class.

Required Privilege Level

view

Output Fields

Table 17 lists the output fields for the show user-plane interfaces logical command. Output fields are listed in the approximate order in which they appear.

Table 17: show user-plane interfaces logical Output Fields

Field Name

Field Description

Logical interface

Name of the logical interface.

Flags

Information about the interface. Possible values are described in the “Interface Flags” section under Common Output Fields Description

State

State of the logical interface (up or down).

Session ID

Session ID.

Session AC Name

Name of the access concentrator.

Underlying interface

Interface on which PPPoE is running.

Ignor End-Of List tag

Disables the End-of-List tag to continue processing of other tags after the End-of-List tag in a PPPoE Active Discovery Offer (PADO) packet.

Sample Output

show user-plane interfaces logical physical-interface-name brief

content_copy zoom_out_map
user@host> show user-plane interfaces logical pp0.3222274049 brief
Logical Interface pp0.3222274049
 Flags: Up Point-To-Point PPPOE
 PPPoE:
   State: SessionUp, Session ID: 1,
   Session AC name: cpi-ssen, Remote MAC address: 00:12:01:00:00:01,
   Underlying interface: demux0.3222274048 (Index 537395211)
   Ignore End-Of-List tag: Disable
       100.0.0.1 --> 0.0.0.0

show user-plane interfaces logical physical-interface-name terse

content_copy zoom_out_map
user@host> show user-plane interfaces logical pp0.3222274049 terse
Logical Interface pp0.3222274049
    Flags: Up Point-To-Point PPPOE
    PPPoE:
      State: SessionUp, Session ID: 1,
      Session AC name: cpi-ssen, Remote MAC address: 00:12:01:00:00:01,
      Underlying interface: demux0.3222274048 (Index 537395211)
      Ignore End-Of-List tag: Disable
           100.0.0.1 --> 0.0.0.0

show user-plane interfaces logical physical-interface-name detail

content_copy zoom_out_map
user@host> show user-plane interfaces logical pp0.3222274049 detail
Logical Interface pp0.3222274049 (Index 537395213) (SNMP ifIndex 200524301) (Generation 3)
    Flags: Up Point-To-Point PPPOE
    PPPoE:
      State: SessionUp, Session ID: 1,
      Session AC name: cpi-ssen, Remote MAC address: 00:12:01:00:00:01,
      Underlying interface: demux0.3222274048 (Index 537395211)
      Ignore End-Of-List tag: Disable
  Egress: 8 supported, 8 in use
  Queue counters:       Queued packets  Transmitted packets      Dropped packets
    0                                0                    0                    0
    1                                0                    0                    0
    2                                0                    0                    0
    3                                0                    0                    0
    4                                0                    0                    0
    5                                0                    0                    0
    6                                0                    0                    0
    7                                0                    0                    0
    Traffic statistics:
     Input  bytes  :                   40
     Output bytes  :                   36
     Input  packets:                    1
     Output packets:                    2
    Local traffic statistics:
     Input  bytes  :                    0
     Output bytes  :                    0
     Input  packets:                    0
     Output packets:                    0
    Transit traffic statistics:
     Input  bytes  :                   40                    0 bps
     Output bytes  :                   36                    0 bps
     Input  packets:                    1                    0 bps
     Output packets:                    2                    0 bps
    Protocol inet, MTU: 1470
    Max nh cache: 0, New hold nh limit: 0, Curr nh cnt: 0, Curr new hold cnt: 0, NH drop cnt: 0
    Route table: 0
      Flags: Unnumbered
      Donor interface: lo0.0 (Index 322)
      Addresses, Flags: Is-Primary
      Destination: Unspecified, Local: 100.0.0.1, Broadcast: Unspecified, Generation: 3

show user-plane interfaces queue

Syntax

content_copy zoom_out_map
show user-plane interfaces queue physical-interface-name
<forwarding class forwarding-class-name>

Description

Lists queue information for the specified BNG User Plane subscriber's interface name.

Options

none

Show detailed queue statistics for all physical interfaces.

forwarding class forwarding-class-name (Optional) Forwarding class name for this queue. Shows detailed statistics for the queue associated with the specified forwarding class.

Required Privilege Level

root

Output Fields

Table 18 lists the output fields for the show user-plane interfaces queue command. Output fields are listed in the approximate order in which they appear.

Table 18: show user-plane interfaces queue Output Fields

Field Name

Field Description

Queue

Queue number.

Forwarding classes

Forwarding class name.

Queued Packets

Number of packets queued to this queue.

For rate-limited interfaces hosted on MICs or MPCs only, this statistic does not include traffic dropped due to rate limiting. For more information, see Additional Information.

Queued Bytes

Number of bytes queued to this queue. The byte counts vary by interface hardware. For more information, see Byte Count by Interface Hardware.

For rate-limited interfaces hosted on MICs or MPCs only, this statistic does not include traffic dropped due to rate limiting. For more information, see Additional Information.

Transmitted Packets

Number of packets transmitted by this queue. When fragmentation occurs on the egress interface, the first set of packet counters shows the postfragmentation values. The second set of packet counters (displayed under the Packet Forwarding Engine Chassis Queues field) shows the prefragmentation values.

Transmitted Bytes

Number of bytes transmitted by this queue. The byte counts vary by interface hardware. .

Note:

On MX Series routers, this number can be inaccurate when you issue the command for a physical interface repeatedly and in quick succession, because the statistics for the child nodes are collected infrequently. Wait ten seconds between successive iterations to avoid this situation.

Note:

For Layer 2 statistics, see Additional Information

Tail-dropped packets

Number of packets dropped because of tail drop.

RL-dropped packets

Number of packets dropped due to rate limiting.

For rate-limited interfaces hosted on MICs, MPCs, and Enhanced Queuing DPCs only, this statistic is not included in the queued traffic statistics. For more information, see Additional Information.

RL-dropped bytes

Number of bytes dropped due to rate limiting.

For rate-limited interfaces hosted on MICs, MPCs, and Enhanced Queuing DPCs only, this statistic is not included in the queued traffic statistics. For more information, see Additional Information.

RED-dropped packets

Number of packets dropped because of random early detection (RED).

  • The output classifies dropped packets into the following categories:

    • Low—Number of low-loss priority packets dropped because of RED.

    • Medium-low—Number of medium-low loss priority packets dropped because of RED.

    • Medium-high—Number of medium-high loss priority packets dropped because of RED.

    • High—Number of high-loss priority packets dropped because of RED.

RED-dropped bytes

Number of bytes dropped because of RED. The byte counts vary by interface hardware. For more information, see .

  • The output classifies dropped bytes into the following categories:

    • Low, non-TCP—Number of low-loss priority non-TCP bytes dropped because of RED.

    • Low, TCP—Number of low-loss priority TCP bytes dropped because of RED.

    • High, non-TCP—Number of high-loss priority non-TCP bytes dropped because of RED.

    • High, TCP—Number of high-loss priority TCP bytes dropped because of RED.

ECN-CE packets

The number of packets that experienced congestion, either on a specific queue or on another device prior to being received.

ECN-CE bytes

The number of bytes that experienced congestion, either on a specific queue or on another device prior to being received.

Queue Buffer Usage:

  • Reserved buffer—The size of the memory buffer that is allocated for storing packets

  • Current—The amount of buffer memory that is currently in use on this queue.

Queue-depth bytes

Displays the amount of queue buffer that is in occupation at this instance. This is an indicator of the amount of data that is present in a queue at that point in time. The amount of data present is in the units of bytes.

Peak

Diplays the peak buffer occupancy for the queue while buffer-monitor-enable is enabled at the [edit chassis fpc slot-number traffic-manager] hierarchy level.

Last-packet enqueued

If packet-timestamp is enabled for an FPC, shows the day, date, time, and year in the format day-of-the-week month day-date hh:mm:ss yyyy when a packet was enqueued in the CoS queue. When the timestamp is aggregated across all active Packet Forwarding Engines, the latest timestamp for each CoS queue is reported.

Sample Output

show user-plane interfaces queue physical-interface-name

content_copy zoom_out_map
user@host> show user-plane interfaces queue pp0.3222274049 
Egress: 8 supported, 8 in use
Queue: 0, Forwarding classes: q0
  Queued:
    Packets              :                     0                     0 pps
    Bytes                :                     0                     0 bps
  Transmitted:
    Packets              :                     0                     0 pps
    Bytes                :                     0                     0 bps
    Tail-dropped packets :                     0                     0 pps
    RL-dropped packets   :                     0                     0 pps
    RL-dropped bytes     :                     0                     0 bps
    RED-dropped packets  :                     0                     0 pps
     Low                 :                     0                     0 pps
     Medium-low          :                     0                     0 pps
     Medium-high         :                     0                     0 pps
     High                :                     0                     0 pps
    RED-dropped bytes    :                     0                     0 bps
     Low                 :                     0                     0 bps
     Medium-low          :                     0                     0 bps
     Medium-high         :                     0                     0 bps
     High                :                     0                     0 bps
Queue: 1, Forwarding classes: q1
  Queued:
    Packets              :                     0                     0 pps
    Bytes                :                     0                     0 bps
  Transmitted:
    Packets              :                     0                     0 pps
    Bytes                :                     0                     0 bps
    Tail-dropped packets :                     0                     0 pps
    RL-dropped packets   :                     0                     0 pps
    RL-dropped bytes     :                     0                     0 bps
    RED-dropped packets  :                     0                     0 pps
     Low                 :                     0                     0 pps
     Medium-low          :                     0                     0 pps
     Medium-high         :                     0                     0 pps
     High                :                     0                     0 pps
    RED-dropped bytes    :                     0                     0 bps
     Low                 :                     0                     0 bps
     Medium-low          :                     0                     0 bps
     Medium-high         :                     0                     0 bps
     High                :                     0                     0 bps
Queue: 2, Forwarding classes: q2
  Queued:
    Packets              :                     0                     0 pps
    Bytes                :                     0                     0 bps
  Transmitted:
    Packets              :                     0                     0 pps
    Bytes                :                     0                     0 bps
    Tail-dropped packets :                     0                     0 pps
    RL-dropped packets   :                     0                     0 pps
    RL-dropped bytes     :                     0                     0 bps
    RED-dropped packets  :                     0                     0 pps
     Low                 :                     0                     0 pps
     Medium-low          :                     0                     0 pps
     Medium-high         :                     0                     0 pps
     High                :                     0                     0 pps
    RED-dropped bytes    :                     0                     0 bps
     Low                 :                     0                     0 bps
     Medium-low          :                     0                     0 bps
     Medium-high         :                     0                     0 bps
     High                :                     0                     0 bps
Queue: 3, Forwarding classes: q3        
  Queued:                               
    Packets              :                     0                     0 pps
    Bytes                :                     0                     0 bps
  Transmitted:                          
    Packets              :                     0                     0 pps
    Bytes                :                     0                     0 bps
    Tail-dropped packets :                     0                     0 pps
    RL-dropped packets   :                     0                     0 pps
    RL-dropped bytes     :                     0                     0 bps
    RED-dropped packets  :                     0                     0 pps
     Low                 :                     0                     0 pps
     Medium-low          :                     0                     0 pps
     Medium-high         :                     0                     0 pps
     High                :                     0                     0 pps
    RED-dropped bytes    :                     0                     0 bps
     Low                 :                     0                     0 bps
     Medium-low          :                     0                     0 bps
     Medium-high         :                     0                     0 bps
     High                :                     0                     0 bps
Queue: 4, Forwarding classes: q4        
  Queued:                               
    Packets              :                     0                     0 pps
    Bytes                :                     0                     0 bps
  Transmitted:                          
    Packets              :                     0                     0 pps
    Bytes                :                     0                     0 bps
    Tail-dropped packets :                     0                     0 pps
    RL-dropped packets   :                     0                     0 pps
    RL-dropped bytes     :                     0                     0 bps
    RED-dropped packets  :                     0                     0 pps
     Low                 :                     0                     0 pps
     Medium-low          :                     0                     0 pps
     Medium-high         :                     0                     0 pps
     High                :                     0                     0 pps
    RED-dropped bytes    :                     0                     0 bps
     Low                 :                     0                     0 bps
     Medium-low          :                     0                     0 bps
     Medium-high         :                     0                     0 bps
     High                :                     0                     0 bps
Queue: 5, Forwarding classes: q5        
  Queued:                               
    Packets              :                     0                     0 pps
    Bytes                :                     0                     0 bps
  Transmitted:                          
    Packets              :                     0                     0 pps
    Bytes                :                     0                     0 bps
    Tail-dropped packets :                     0                     0 pps
    RL-dropped packets   :                     0                     0 pps
    RL-dropped bytes     :                     0                     0 bps
    RED-dropped packets  :                     0                     0 pps
     Low                 :                     0                     0 pps
     Medium-low          :                     0                     0 pps
     Medium-high         :                     0                     0 pps
     High                :                     0                     0 pps
    RED-dropped bytes    :                     0                     0 bps
     Low                 :                     0                     0 bps
     Medium-low          :                     0                     0 bps
     Medium-high         :                     0                     0 bps
     High                :                     0                     0 bps
Queue: 6, Forwarding classes: q6        
  Queued:                               
    Packets              :                     0                     0 pps
    Bytes                :                     0                     0 bps
  Transmitted:                          
    Packets              :                     0                     0 pps
    Bytes                :                     0                     0 bps
    Tail-dropped packets :                     0                     0 pps
    RL-dropped packets   :                     0                     0 pps
    RL-dropped bytes     :                     0                     0 bps
    RED-dropped packets  :                     0                     0 pps
     Low                 :                     0                     0 pps
     Medium-low          :                     0                     0 pps
     Medium-high         :                     0                     0 pps
     High                :                     0                     0 pps
    RED-dropped bytes    :                     0                     0 bps
     Low                 :                     0                     0 bps
     Medium-low          :                     0                     0 bps
     Medium-high         :                     0                     0 bps
     High                :                     0                     0 bps
Queue: 7, Forwarding classes: q7        
  Queued:                               
    Packets              :                     0                     0 pps
    Bytes                :                     0                     0 bps
  Transmitted:                          
    Packets              :                     0                     0 pps
    Bytes                :                     0                     0 bps
    Tail-dropped packets :                     0                     0 pps
    RL-dropped packets   :                     0                     0 pps
    RL-dropped bytes     :                     0                     0 bps
    RED-dropped packets  :                     0                     0 pps
     Low                 :                     0                     0 pps
     Medium-low          :                     0                     0 pps
     Medium-high         :                     0                     0 pps
     High                :                     0                     0 pps
    RED-dropped bytes    :                     0                     0 bps
     Low                 :                     0                     0 bps
     Medium-low          :                     0                     0 bps
     Medium-high         :                     0                     0 bps
     High                :                     0                     0 bps

show user-plane subscribers

Syntax

content_copy zoom_out_map
show user-plane subscribers 
<accounting-statistics>
<address ip-address>
<client-type client-type>
<count>
<detail | extensive | terse>
<id subscriber-id>
<interface interface-name>
<license-usage>
<mac-address mac-address>
<physical-interface physical-interface-name>
<routing-instance routing-instance-name>
<stacked-vlan-id stacked-vlan-id>
<subscriber-state subscriber-state>
<Summary>
<vlan-id vlan-id>

Description

Displays information for the BNG User Plane subscribers.

Options

None

Displays information by interface, IP address or VLAN ID, and LS:RI.

accounting-statistics

Displays subscriber accounting statistics. If you do not configure the statement, the CLI displays a value of 0 for the accounting statistics.

address ip-address

(Optional) Display subscribers whose IP address matches the specified address. You must specify the IPv4 or IPv6 address prefix without a netmask (for example, 192.0.2.0). If you specify the IP address as a prefix with a netmask (for example, 192.0.2.0/32), the router displays a message that the IP address is invalid and rejects the command.

client-type client-type

(Optional) Display subscribers whose client type matches one of the following client types:

  • dhcp—Dynamic Host Configuration Protocol (DHCP) clients only.

  • dotlx—802.1X clients only.

  • essm—Extensible Subscribers Services Manager (ESSM) clients only.

  • fixed-wireless-access—Fixed wireless access clients only.

  • fwauth—FwAuth (authenticated across a firewall) clients only.

  • l2tp—Layer 2 Tunneling Protocol (L2TP) clients only.

  • mlppp—Multilink Point-to-Point Protocol (MLPPP) clients only.

  • ppp—Point-to-Point Protocol (PPP) clients only.

  • pppoe—Point-to-Point Protocol over Ethernet (PPPoE) clients only.

  • static—Static clients only.

  • vlan—VLAN clients only.

  • vlan-oob—VLAN out-of-band (triggered by by Access Node Control Protocol or ANCP) clients only.

  • vpls-pw—Virtual private LAN service (VPLS) pseudowire clients only.

  • xauth—Extended Authentication (XAuth) clients only.

count

(Optional) Displays the count of total subscribers and active subscribers for any specified option.

detail | extensive | terse

(Optional) Displays the specified level of output.

id subscriber-id

(Optional) Displays a subscriber of a session with an ID matching the specific subscriber ID.

interface interface-name

(Optional) Displays subscribers with an interface that matches the specified interface.

license-usage

(Optional) Displays the license usage for the last 48 hours.

mac-address mac-address

(Optional) Displays subscribers with a MAC address that matches the specified MAC address.

physical-interface physical-interface-name

(Optional) Displays subscribers whose physical interface matches the specified physical interface.

routing-instance routing-instance-name

(Optional) Displays subscribers with a routing instance that matches the specified routing instance.

stacked-vlan-id stacked-vlan-id

(Optional) Displays subscribers with a stacked VLAN ID that matches the specified stacked VLAN ID.

subscriber-state subscriber-state

(Optional) Display subscribers whose subscriber state matches the specified subscriber state (ACTIVE, CONFIGURED, INIT, TERMINATED, or TERMINATING).

summary

(Optional) Displays summary information for subscribers.

vlan-id vlan-id

(Optional) Displays subscribers that have a VLAN ID that matches the specified VLAN ID, regardless of whether the subscriber uses a single-tagged or double-tagged VLAN. For subscribers using a double-tagged VLAN, this option displays subscribers where the inner VLAN tag matches the specified VLAN ID. To display only subscribers where the specified value matches only double-tagged VLANs, use the stacked-vlan-id stacked-vlan-id option to match the outer VLAN tag.

Required Privilege Level

view

Output Fields

Table 19 lists the output fields for the show user-plane subscribers command. Output fields are listed in the approximate order in which they appear.

Table 19: show user-plane subscribers Output Fields

Field Name

Field Description

Interface

Interface associated with the subscriber. The router or switch displays subscribers with interfaces that match or begin with the specified interface.

The asterisk (*) character indicates a continuation of addresses for the same session.

IP Address/VLAN ID

Subscriber IP address or VLAN ID associated with the subscriber in the form tpid.vlan-id.

No IP address or VLAN ID is assigned to a Layer 2 Tunneling Protocol (L2TP) tunnel-switched session. For these subscriber sessions the value is Tunnel-switched.

LS:RI

Logical system and routing instance associated with the subscriber.

Type

Subscriber client type (DHCP, L2TP, PPP, PPPoE, and VLAN).

IP Address

Subscriber IPv4 address.

Logical System

Logical system associated with the subscriber.

Routing Instance

Routing instance associated with the subscriber.

Interface

Name of the enhanced subscriber management logical interface, in the form demux0.nnnn (for example, demux0.3221225472), to which access-internal and framed subscriber routes are mapped.

Interface Type

Whether the subscriber interface is Static or Dynamic.

Underlying Interface

Name of the underlying interface for the subscriber session.

MAC Address

MAC address associated with the subscriber.

State

Current state of the subscriber session (Init, Configured, Active, Terminating, Tunneled).

PFE Flow ID

Forwarding flow identifier.

VLAN ID

VLAN ID associated with the subscriber in the form tpid.vlan-id.

Session ID

ID number for a subscriber session.

Service Sessions

Number of service sessions (that is, a service that is activated using RADIUS CoA) associated with the subscribers.

Service Session ID

ID number for a subscriber service session.

Service Session Name

Service session profile name.

IPv4 Input Filter Name

Name assigned to the IPv4 input filter (client or service session).

IPv4 Output Filter Name

Name assigned to the IPv4 output filter (client or service session).

Service Activation Time

Time at which the first family in this service became active.

Accounting Interval Service

How often statistics are collected for the accounting profile.

Dynamic Configuration

Values for variables that are passed into the dynamic profile from RADIUS.

Subscribers by State

Number of subscribers summarized by state. The summary information includes the following:

  • Init—Number of subscribers currently in the initialization state.

  • Configured—Number of configured subscribers.

  • Active—Number of active subscribers.

  • Terminating—Number of subscribers in the process of being terminated.

  • Terminated—Number of terminated subscribers.

  • Total—Total number of subscribers for all states.

Subscribers by Client Type

Number of subscribers, summarized by client type. Client types can include DHCP, L2TP, PPP, PPPoE, and VLAN. Also displays the total number of subscribers for all client types.

Subscribers by LS:RI

Number of subscribers, summarized by logical system:routing instance (LS:RI) combination. Also displays the total number of subscribers for all LS:RI combinations.

Sample Output

show user-plane subscribers

content_copy zoom_out_map
user@host> show user-plane subscribers             
Interface             IP Address/VLAN ID                                 LS:RI
demux0.3222276148      0x8100.210 0x8100.209                        default:default      
demux0.3222276149      0x8100.210 0x8100.210                        default:default      
demux0.3222276150      0x8100.210 0x8100.211                        default:default      
demux0.3222276151      0x8100.210 0x8100.212                        default:default      
demux0.3222276152      0x8100.210 0x8100.213                        default:default      
demux0.3222276153      0x8100.210 0x8100.214                        default:default      
demux0.3222276154      0x8100.210 0x8100.215                        default:default      
demux0.3222276155      0x8100.210 0x8100.216                        default:default      
demux0.3222276156      0x8100.210 0x8100.217                        default:default      
demux0.3222276157      0x8100.210 0x8100.218                        default:default      
demux0.3222276158     192.168.10.254                                default:default      
demux0.3222276159     192.168.10.252                                default:default      
demux0.3222276160     192.168.10.253                                default:default      
demux0.3222276161     192.168.10.248                                default:default      
demux0.3222276162     192.168.10.249                                default:default      
demux0.3222276163     192.168.10.250                                default:default  
    

show user-plane subscribers count

content_copy zoom_out_map
user@host> show user-plane subscribers count              
Total Subscribers: 1, Active Subscribers: 1

show user-plane subscribers detail

content_copy zoom_out_map
user@host> show user-plane subscribers detail 
Type: PPPoE
IP Address: 192.0.2.1
Logical System: default
Routing Instance: default
Interface: pp0.3221749760
Interface type: Dynamic
Underlying Interface: ge-0/3/5.1
MAC Address: 0:00:5E:00:53:10
State: Active
Session ID: 5
PFE Flow ID: 537395210
VLAN Id: 1

show user-plane subscribers detail (DHCP)

content_copy zoom_out_map
user@host> show user-plane subscribers detail 
Type: DHCP
IP Address: 192.0.2.1
Logical System: default
Routing Instance: default
Interface: demux0.3221749761
Interface type: Dynamic
Underlying Interface: ge-0/3/5.2
MAC Address: 0:00:5E:00:53:10
State: Active
Session ID: 6
PFE Flow ID: 537395212
VLAN Id: 10

Type: DHCP
IPv6 Address: 2001:db8::3/128
Logical System: default
Routing Instance: default
Interface: demux0.3221749762
Interface type: Dynamic
Underlying Interface: ge-0/3/5.2
MAC Address: 0:00:5E:00:53:15
State: Active
Session ID: 7
PFE Flow ID: 537395213
VLAN Id: 10

show user-plane subscribers extensive

content_copy zoom_out_map
user@host> show user-plane subscribers extensive
Type: DHCP 
IP Address: 192.0.2.1
Logical System: default 
Routing Instance: default 
Interface: demux0.3221225473 
Interface type: Dynamic 
Underlying Interface: ge-0/0/4.0 
MAC Address: 2001:db8::10:94:00:00:07 
State: Active 
Session ID: 2 
PFE Flow ID: 28 
VLAN Id: 99 
Service Sessions: 1 
Service Session ID: 197               
Service Session Name: ngstats-serv-2 
State: Active 
Family: inet 
Service session type: Service-Profile 
IPv4 Input Filter Name: fin_UID1002-demux0.3221225557-in 
IPv4 Output Filter Name: fout_UID1003-demux0.3221225557-out 
Service Activation time: 2020-06-12 13:30:40 PDT 
Accounting interval service: 600 
Dynamic configuration:  
fin: fin_UID1002 
fout: fout_UID1003 
port: 0121 

show user-plane subscribers id

content_copy zoom_out_map
user@host> show user-plane subscribers id 2
Interface             IP Address/VLAN ID       SessionId     LS:RI 
demux0.3221225473     192.0.2.1                   2       default:default

show user-plane subscribers interface

content_copy zoom_out_map
user@host> show user-plane subscribers interface demux0.3221225473
Interface             IP Address/VLAN ID       SessionId     LS:RI 
demux0.3221225473     192.0.2.1                   2       default:default

show user-plane subscribers routing-instance

content_copy zoom_out_map
user@host> show user-plane subscribers routing-instance default
Interface             IP Address/VLAN ID       SessionId     LS:RI 
demux0.3221225473     192.0.2.1                   2       default:default

show user-plane subscribers vlan-id

content_copy zoom_out_map
user@host> show user-plane subscribers vlan-id 99
Interface             IP Address/VLAN ID        SessionId         LS:RI 
demux0.3221225473         192.0.2.1                 2         default:default

show user-plane subscribers summary

content_copy zoom_out_map
user@host> show user-plane subscribers summary

Subscribers by State 
   Active: 732 
   Total: 732 
Subscribers by Client Type 
   DHCP: 722
   VLAN: 10 
   Total: 732 

show user-plane subscribers stacked-vlan-id

content_copy zoom_out_map
user@host> show user-plane subscribers stacked-vlan-id 150
Interface             IP Address/VLAN ID            SessionId             LS:RI 
demux0.3221225481     0x8100.150 0x8100.150            2                default:defaul

show user-plane subscribers terse

content_copy zoom_out_map
user@host> show user-plane subscribers terse 
Interface             IP Address/VLAN ID           SessionId               LS:RI 
demux0.3221225473     192.0.2.1                         2            default:default 
footer-navigation