Juniper BNG CUPS CLI Operational Commands
This topic provides an overview of show commands, including syntax, option
descriptions, and sample output.
show firewall
Syntax
show firewall <filter filter-name> <filter regex regular-expression> <terse> <user-plane user-plane-name>
Description
When running the show firewall command on the BNG CUPS
Controller, the output displays only the filter names and the associated BNG
User Plane. No counters or other information appears. To see the counters or the
log or syslog output, you must run the show firewall command on
the appropriate BNG User Plane.
Options
| filter filter-name |
(Optional) Name of a configured filter. |
| filter regex regular-expression |
(Optional) Regular expression that matches the names of a subset of filters. |
| terse |
(Optional) Display firewall filter names and BNG User Plane names. |
| user-plane user-plane-name | Displays the firewall filters for the listed BNG User Plane. |
Required Privilege Level
view
Output Fields
Table 1 lists the output fields for the show
firewall command. Output fields are listed in the approximate order
in which they appear.
|
Field Name |
Field Description |
|---|---|
|
|
Name of a filter that has been configured with the
|
| User Plane | BNG User Plane name |
Sample Output
show firewall terse
user@host> show firewall terse Filter: finid_UID4003-demux0.3221229982-in User Plane: up-example-2 Filter: dfwda-demux0.3221229982-in User Plane: up-example-2 Filter: finid_UID4003-demux0.3221225473-in User Plane: up-example-1 Filter: dfwda-demux0.3221225473-in User Plane: up-example-1
show firewall terse (user-plane)
user@host> show firewall terse user-plane up-exampl-1 Filter: finid_UID4003-demux0.3221225473-in User Plane: up-example-1 Filter: dfwda-demux0.3221225473-in User Plane: up-example-1
show firewall templates-in-use
- Syntax
- Description
- Options
- Required Privilege Level
- Output Fields
- Sample Output
- show firewall templates-in-use user-plane
Syntax
show firewall templates-in-use <user-plane> 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 user-plane-name |
(Optional) Displays the configured filter templates for a specific BNG User Plane. |
Required Privilege Level
root
Output Fields
Table 2 lists the output fields for the show firewall
templates-in-use command. Output fields are listed in the
approximate order in which they appear.
|
Field Name |
Field Description |
|---|---|
|
|
Name of a filter that has been configured using the
|
|
|
BNG User Plane name |
|
|
Number of times the filter has been referenced by subscribers accessing the network |
Sample Output
show firewall templates-in-use
user@host> show firewall templates-in-use
Dynamic Subscribers Reference Counts
Filter Template User Plane Reference Count
---------------- ---------- ----------------
dfwda 10
finid_UID4003 up-example-2 7
finid_UID1000 up-example-1 3
show firewall templates-in-use user-plane
regress@octans> show firewall templates-in-use user-plane bos42
Dynamic Subscribers Reference Counts
Filter Template User Plane Reference Count
---------------- ---------- ----------------
dfwda up-example-1 3
finid_UID1000 up-example-1 3show igmp group
Syntax
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 3 describes the
output fields for the show igmp group command. Output fields
are listed in the approximate order in which they appear.
|
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:
|
Sample Output
show igmp group
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
Release Information
Statement introduced in Juniper BNG CUPS Release 22.4R1.
show igmp interface
Syntax
show igmp interface user-plane user-plane-name
Description
Displays information about Internet Group Management Protocol (IGMP)-enabled interfaces on BNG User Planes.
Options
| none |
When you run this command on the BNG CUPS Controller, the output displays standard information about all IGMP-enabled interfaces on all BNG User Planes associated to the BNG CUPS Controller. When you run this command on a BNG User Plane, the output displays standard information about all IGMP-enabled interfaces on the BNG User Plane. |
| user-plane user-plane-name |
(Optional) Displays information about the IGMP-enabled interfaces on the specified BNG User Plane. |
Required Privilege Level
view
Output Fields
Table 4 describes
the output fields for the show igmp interface command. Output
fields are listed in the approximate order in which they appear.
|
Field Name |
Field Description |
|---|---|
|
Interface |
Name of the interface. |
|
Querier |
Address of the routing device that has been elected to send membership queries. |
|
State |
State of the interface: Up or Down. |
|
Timeout |
How long until the IGMP querier is declared to be unreachable, in seconds. |
|
Version |
IGMP version being used on the interface: 1 , 2 , or 3. |
|
Groups |
Number of groups on the interface. |
|
Group threshold |
Configured threshold at which a warning message is generated. This threshold is based on a percentage of groups received on the interface. If the number of groups received reaches the configured threshold, the device generates a warning message. |
|
Group log-interval |
Time (in seconds) between consecutive log messages. |
|
Immediate Leave |
State of the immediate leave option:
|
|
Promiscuous Mode |
State of the promiscuous mode option:
|
|
Distributed |
State of IGMP, which, by default, takes place on the Routing Engine for MX Series routers but can be distributed to the Packet Forwarding Engine to provide faster processing of join and leave events.
|
|
Passive |
State of the passive mode option:
The
|
| User plane | The BNG User Plane to which the interface belongs. |
|
Configured Parameters |
Information configured by the user:
|
|
Derived Parameters |
Derived information:
|
Sample Output
show igmp interface
user@host> show igmp interface
Interface: pp0.3221225481
Querier: 128.220.14.35
State: Up Timeout: 1000 Version: 3 Groups: 1
Group threshold: 0
Group log-interval: 10000
Immediate leave: Off
Promiscuous mode: On
Passive: Off
User plane: up1
Interface: demux0.2147483652
Querier: 0.0.0.0
State: Up Timeout: None Version: 3 Groups: 1
Immediate leave: On
Promiscuous mode: On
Passive: Off
User plane: up1
Configured Parameters:
IGMP Query Interval: 125.0
IGMP Query Response Interval: 10.0
IGMP Last Member Query Interval: 1.0
IGMP Robustness Count: 2
Derived Parameters:
IGMP Membership Timeout: 260.0
IGMP Other Querier Present Timeout: 255.0Release Information
Statement introduced in Juniper BNG CUPS Release 22.4R1.
show igmp statistics
Syntax
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.
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 5 describes
the output fields for the show igmp statistics command. Output
fields are listed in the approximate order in which they appear.
|
Field Name |
Field Description |
|---|---|
|
|
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
|
|
|
Summary of IGMP statistics:
|
|
|
Number of messages received. |
|
|
Number of messages sent. |
|
|
Number of received packets that contained errors. |
|
|
Maximum number of IGMP packets received during 1 second interval. |
|
|
Summary of IGMP statistics for all interfaces. Note:
These statistics are not supported or displayed with the
|
Sample Output
show igmp statistics
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
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
Release Information
Statement introduced in Juniper BNG CUPS Release 22.4R1.
show mld group
Syntax
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 6 describes the output
fields for the show mld group command. Output fields are listed
in the approximate order in which they appear.
|
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:
|
Sample Output
show mld group
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
Release Information
Statement introduced in Juniper BNG CUPS Release 22.4R1.
show mld interface
Syntax
show mld interface user-plane user-plane-name
Description
Displays information about multipoint Listener Discovery (MLD)-enabled interfaces.
Options
| none |
When you run this command on the BNG CUPS Controller, the output displays standard information about all MLD-enabled interfaces on all BNG User Planes associated to the BNG CUPS Controller. When you run this command on a BNG User Plane, the output displays standard information about all MLD-enabled interfaces on the BNG User Plane. |
| user-plane user-plane-name |
(Optional) Displays information about the MLD-enabled interfaces on the specified BNG User Plane. |
Required Privilege Level
view
Output Fields
Table 7 describes the
output fields for the show mld interface command. Output fields
are listed in the approximate order in which they appear.
|
Field Name |
Field Description |
|---|---|
|
|
Name of the interface. |
|
Querier |
Address of the router that has been elected to send membership queries. |
|
State |
State of the interface: Up or Down. |
|
Timeout |
How long until the MLD querier is declared to be unreachable, in seconds. |
|
Version |
MLD version being used on the interface: 1 or 2. |
|
Groups |
Number of groups on the interface. |
|
Passive |
State of the passive mode option:
The
|
|
Group threshold |
Configured threshold at which a warning message is generated. This threshold is based on a percentage of groups received on the interface. If the number of groups received reaches the configured threshold, the device generates a warning message. |
|
Group log-interval |
Time (in seconds) between consecutive log messages. |
|
Immediate Leave |
State of the immediate leave option:
|
|
Distributed |
State of MLD, which, by default, takes place on the Routing Engine for MX Series routers but can be distributed to the Packet Forwarding Engine to provide faster processing of join and leave events.
|
|
Promiscuous Mode |
State of the promiscuous mode option:
|
| User plane | The BNG User Plane to which the interface belongs. |
|
Configured Parameters |
Information configured by the user.
|
|
Derived Parameters |
Derived information.
|
Sample Output
show mld interface
user@host> show mld interface
Interface: pp0.3221225483
Querier: fe80::5668:adff:fec0:2ec4
State: Up Timeout: 1000 Version: 2 Groups: 2
Group threshold: 0
Group log-interval: 10000
Immediate leave: On
Promiscuous mode: Off
Passive: Off
User plane: up1
Interface: demux0.2147483653
Querier: fe80::5668:adff:fec0:2ec4
State: Up Timeout: None Version: 2 Groups: 2
Immediate leave: On
Promiscuous mode: Off
Passive: Off
User plane: up1
Configured Parameters:
MLD Query Interval: 125.0
MLD Query Response Interval: 10.0
MLD Last Member Query Interval: 1.0
MLD Robustness Count: 2
Derived Parameters:
MLD Membership Timeout: 260.0
MLD Other Querier Present Timeout: 255.0 Release Information
Statement introduced in Juniper BNG CUPS Release 22.4R1.
show mld statistics
Syntax
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.
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 |
Required Privilege Level
view
Output Fields
Table 8 describes
the output fields for the show mld statistics command. Output
fields are listed in the approximate order in which they appear.
|
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
|
|
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.
|
|
MLD Global Statistics |
Summary of MLD statistics for all interfaces. Note:
These statistics are not supported or displayed with the
|
Sample Output
show mld statistics
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
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
Release Information
Statement introduced in Juniper BNG CUPS Release 22.4R1.
show network-access address-assignment address-pool-manager status
Syntax
show network-access address-assignment address-pool-manager status
Description
Displays the status of Juniper Address Pool Manager (APM).
Required Privilege Level
root
Output Fields
Table 9 lists the
output fields for the show network-access address-assignment
address-pool-manager status command. Output fields are listed in
alphabetical order.
|
Field Name |
Field Description |
|---|---|
| Address Pool Manager | IP address for APM |
| Status | Connection status of APM |
| Pool Count | Number of pools |
| Connect Timestamp | Time at which APM first connected to BNG CUPS Controller |
| Security | Connection status: secured or not secured |
Sample Output
show network-access address-assignment address-pool-manager status
user@host> show network-access address-assignment address-pool-manager status Address Pool Manager: 192.0.2.1 Status: Connected Connect Timestamp: 2021-12-23 14:22:08 Security: unsecured
show network-access address-assignment domain
Syntax
show network-access address-assignment domain <name> domain-name | domain-profile <routing-instance> routing-instance-name
Description
Displays the state of each pool domain (dynamic linked address pool) connected to APM and a count of the transmitted alarms for a specified routing instance.
Options
name domain-name |
domain-profile |
(Optional) Displays information depending on which of the following
variables are entered:
|
routing-instance
routing-instance-name |
(Optional) Designate the routing instance to use. If left empty, the default routing instance is used. |
Required Privilege Level
root
Output Fields
Table 10 lists the
output fields for the show network-access address-assignment domain
command. Output fields are listed in alphabetical order.
|
Field Name |
Field Description |
|---|---|
| Domain Name | Name of the pool domain. |
| Head | Name of the domain’s pool head. |
| Pool Count | Number of pools. |
| Addresses | Total number of addresses in the pool domain. |
| Free | Number of addresses in the pool domain that are available for allocation. |
| Apportion | The number of apportion alarms. The alarm occurs when the number of free addresses falls below the apportion threshold. |
| Reclaim | The number of reclaim alarms. The alarm occurs when the number of free addresses for the pool domain on the BNG CUPS Controller rises above the reclaim threshold. |
| Abatement | The number of abatement alarms. An the
alarm occurs when either of the following conditions changes,
causing APM to disregard the original alarm:
|
| Pool Drain | The number of pool drain alarms. The alarm occurs when a pool is completely drained. |
| Pool Name | Name of the pool. |
| Prefix | Subnetwork allocated to the address pool. |
| Used |
The number of addresses being used. |
| State | State of the pool domain. |
Sample Output
- show network-access address-assignment domain
- show network-access address-assignment domain name (using domain profile)
- show network-access address-assignment domain name
show network-access address-assignment domain
user@host> show network-access address-assignment domain Domain Name Head Pool Count Addresses Free Apportion Reclaim Abatement PoolDrain 1232-default 1232-default 3 507 120 1 0 0 0 test-default test-default 2 1535 279 1 0 0 0
show network-access address-assignment domain name (using domain profile)
user@host> show network-access address-assignment domain name test1234 routing-instance default56 Domain Name Head Pool Count Addresses Free Apportion Reclaim Abatement PoolDrain test1234-default56 test1234-default56 1 1024 98 1 1 0 1
show network-access address-assignment domain name
user@host show network-access address-assignment domain name test1234-default56 routing-instance default56 Pool Name Prefix Addresses Used State test1234-default56 192.0.2.1/24 255 253 Active test1234-default56-000 192.0.2.8/24 254 0 Active -
show network-access address-assignment domain-state
Syntax
show network-access address-assignment domain-state <routing-instance> routing-instance-name
Description
Displays the alarm state (outstanding alarms) for each pool domain.
Options
routing-instance
routing-instance-name |
(Optional) Designate the routing instance to use. If left empty, the default routing instance is used. |
Required Privilege Level
root
Output Fields
Table 11 lists the
output fields for the show network-access address-assignment
domain-state command. Output fields are listed in alphabetical
order.
|
Field Name |
Field Description |
|---|---|
| Domain Name | Name of the pool domain. |
| Alarm | Name of the alarm.
|
| Age | How long an alarm has been outstanding. |
| Logins | Whether logins are enabled. |
| State | State of the pool domain. |
Sample Output
- show network-access address-assignment domain
- show network-access address-assignment domain name (using domain profile)
- show network-access address-assignment domain name
show network-access address-assignment domain
user@host> show network-access address-assignment domain Domain Name Head Pool Count Addresses Free Apportion Reclaim Abatement PoolDrain 1232-default 1232-default 3 507 120 1 0 0 0 test-default test-default 2 1535 279 1 0 0 0
show network-access address-assignment domain name (using domain profile)
user@host> show network-access address-assignment domain name test1234 routing-instance default56 Domain Name Head Pool Count Addresses Free Apportion Reclaim Abatement PoolDrain test1234-default56 test1234-default56 1 1024 98 1 1 0 1
show network-access address-assignment domain name
user@host show network-access address-assignment domain name test1234-default56 routing-instance default56 Pool Name Prefix Addresses Used State test1234-default56 192.0.2.1/24 255 253 Active test1234-default56-000 192.0.2.8/24 254 0 Active -
show system subscriber-management control-plane
Syntax
show system subscriber-management control-plane <associations> <bbe-instances> <cpm> <services> <user-plane>
Description
Displays statistics for the specified option. This command runs on the BNG CUPS Controller.
Options
associations |
(Optional) Displays information about the BNG User Planes that are associated to the BNG CUPS Controller. |
bbe-instances |
(Optional) Displays the dynamically created instances of the BBE Infrastructure daemon. There is one for each BNG User Plane. |
cpm |
(Optional) Displays information about the control plane manager process. |
services |
(Optional) Displays the health of services and the endpoints they manage. See show system subscriber-management control-plane services. |
user-plane |
(Optional) Displays information about the associated BNG User Plane. |
Required Privilege Level
root
Output Fields
Table 12 lists the
output fields for the show system subscriber-management
control-plane command.
|
Field Name |
Field Description |
|---|---|
| Transport | The IP address, protocol, and port number of the BNG CUPS Controller. |
| Attached clients | The number of clients attached to the BNG CUPS Controller. |
| UP Events | The number of associations, disassociations, and association updates that have occurred with all associated BNG User Planes. |
| BBE Instance Events: | The number of times that the BBE instance was created, deleted, or restarted. |
| UP Name | Name of the BNG User Plane that the BNG CUPS Controller is associated with. |
| ID | ID of the BNG User Planes that the BNG CUPS Controller is associated with. |
| Address | BNG User Plane IP address. |
| Assoc Time | The amount of time that the BNG CUPS Controller is associated to the listed BNG User Plane. |
| Assoc-updates | The number of times that an association has been updated. |
| Client-name | The name of the BNG CUPS Controller that is associated to the BNG User Plane. |
| Status | Displays whether the BNG CUPS Controller is attached to or detached from the client. |
| State | Displays either the health of the service or the status of the BNG User Plane's connection. |
| Last Heartbeat Time | The time when the client's last heartbeat was recorded. |
| PID | The process identifier number. |
| UP-Id | The BNG User Plane's ID number. |
| CPRi Ports | The CPRi ports used by the BBE instance. |
| UPTIME | How long the the BBE instance is up. |
| Flapped | How many times the service went from down to up. |
Sample Output
- show system subscriber-management control-plane cpm
- show system subscriber-management control-plane associations
- show system subscriber-management control-plane bbe-instances
- show system subscriber-management control-plane user-plane
- show system subscriber-management control-plane user-plane endpoint (specific endpoint of a BNG User Plane)
show system subscriber-management control-plane cpm
user@host> show system subscriber-management control-plane cpm
Start time: Thu Mar 10 22:23:02 2022
State: Assoc-Ready
Transport:
IPv4 Address: 192.0.2.1
Protocol: pfcp
Port: 8805
Attached clients: 14
UP Events:
Associations: 5
Disassociations: 0
Assoc Updates: 0
BBE Instance Events:
Created: 0
Deleted: 0
Restarted: 0
Endpoints:
Endpoint Flapped State Last Updated
ScacheClient 0 Disconnected 7s ago
ScacheServer 3 Reconciled 19s ago
Apm 0 Connected 7s ago
show system subscriber-management control-plane associations
user@host> show system subscriber-management control-plane associations UP Name ID Address State Assoc Time Assoc-updates vm123 2 192.0.2.1 Connected Sep 24 17:44:31 2020 0 vm456 1 192.0.2.8 Connected Sep 28 13:21:48 2020 0
show system subscriber-management control-plane bbe-instances
user@host show system subscriber-management control-plane bbe-instances Instance ID PID UP-Id UPTIME CPRi Ports 1 544 1 0:08:07:41 50163,50164,50165 2 556 2 0:08:07:41 50166,50167,50168 3 565 3 0:08:07:41 50169,50170,50171 4 569 4 0:08:07:40 50172,50173,50174 5 576 5 0:08:07:40 50175,50176,50177
show system subscriber-management control-plane user-plane
user@host show system subscriber-management control-plane user-plane UP-example-1 Id: 1 Ip address:192.0.2.1 State: Healthy Endpoints Flapped State Last Updated Sci-Stats 0 Connected 18s ago PppSmdIpc 2 Connected 27s ago L2tpSmdIpc 2 Connected 27s ago SmdPppIpc 0 Connected 21s ago SmdL2tpIpc 0 Connected 21s ago DhcpSmdIpc 2 Connected 29s ago SmdDhcpIpc 0 Connected 21s ago Sci-Session 2 Connected 18s ago Cpri-Low 2 Connected 21s ago Cpri-Med 2 Connected 21s ago Cpri-High 2 Connected 21s ago RepClientSS 2 Synchronized 25s ago RepServerSS 2 Synchronized 25s ago Sci-Node 2 Connected 25s
show system subscriber-management control-plane user-plane endpoint (specific endpoint of a BNG User Plane)
user@host show system subscriber-management control-plane user-plane UP-example-1 endpoint Dhcpsmdlpc
DhcpSmdIpc
Status: Connected
Ipcconn stats:
Send total: 226372
Send clean: 226372
Send pending: 0
Send partial: 0
Send terminal: 0
Send pending serviced: 0
Send stored: 0
Send stored failed: 0
Send failed total: 0
Egress Q dequeues: 0
Egress Q enqueues: 0
Egress Q size: 0
Egress Q avg time: 0
Recv total: 205565
Recv serviced: 12250
Recv service disables: 0
Recv service enables: 0
show system subscriber-management control-plane services
Syntax
show system subscriber-management control-plane services <services> all | service-name
Description
Displays the health of services and the endpoints they manage. Using the information in this command, you can determine the overall health of the BNG CUPS Controller and the BNG User Planes. This command runs on the BNG CUPS Controller.
Services are also referred to as endpoint clients.
Options
services all | service-name |
Specify one of the following:
|
Required Privilege Level
root
Output Fields
Table 13 lists the
output fields for the show system subscriber-management control-plane
services command.
|
Field Name |
Field Description |
|---|---|
|
Services |
The service for which information is being reported. |
|
Status |
Whether the service is up or down. |
|
State |
Operational state of the service. All services should be in
the |
|
Endpoints |
The total number of connections the endpoint's service hosts. |
|
Healthy Endpoints |
The total number of healthy endpoints. |
|
Restarted |
Number of times the service has been restarted. |
|
Last cupm msg rx |
Last message received from the control plane manager or the user plane manager. |
|
Last cupm msg tx |
Last message sent to the control plane manager or the user plane manager. |
|
Last updated |
When the information was last collected. |
|
Flapped |
How many times the service went from down to up. |
Sample Output
- show system subscriber-management control-plane services
- show system subscriber-management control-plane services service
- show system subscriber-management control-plane services service
show system subscriber-management control-plane services
user@host> show system subscriber-management control-plane services Services Status State Endpoints Healthy-Endpoints ppp-service Up Ready 2 2 cp-smg-service Up Ready 0 0 replication-serverd-process Up Ready 3 3 replication-clientd-process Up Ready 3 2 cp-smg-service2 Up Ready 7 7 cp-smg-service1 Up Ready 7 7 bbe-cpm-daemon Up Ready 2 2 general-authentication-service Up Ready 0 0 l2tp-universal-edge Up Starting 2 2 dhcp-service Up Ready 2 2 bbe-upsf-service Up Ready 0 0 bbe-stats-svcsd Up Ready 2 2
show system subscriber-management control-plane services service
user@host> show system subscriber-management control-plane services service all ppp-service Status: Up State: Ready Restarted: 0 times Last cupm msg rx: reconcile Last cupm msg tx: keepalive (1s ago) Last Updated: 0s ago Endpoints: Id Flapped State Last Updated PppSmdIpc: 2 1 Connected 19s ago PppSmdIpc: 1 2 Connected 14s ago cp-smg-service Status: Up State: Ready Restarted: 0 times Last cupm msg rx: reconcile Last cupm msg tx: keepalive (1s ago) Last Updated: 29s ago replication-serverd-process Status: Up State: Ready Restarted: 0 times Last cupm msg rx: reconcile Last cupm msg tx: keepalive (1s ago) Last Updated: 30s ago Endpoints: Id Flapped State Last Updated RepServerSS: 2 1 Synchronized 4s ago RepServerSS: 1 2 Synchronized 4s ago ScacheServer:0 3 Reconciled 9s ago replication-clientd-process Status: Up State: Ready Restarted: 0 times Last cupm msg rx: reconcile Last cupm msg tx: keepalive (1s ago) Last Updated: 30s ago Endpoints: Id Flapped State Last Updated RepClientSS: 2 1 Synchronized 4s ago RepClientSS: 1 2 Synchronized 4s ago ScacheClient: 0 0 Disconnected 9s ago cp-smg-service2 Status: Up State: Ready Restarted: 1 times Last cupm msg rx: reconcile Last cupm msg tx: keepalive (2s ago) Last Updated: 18s ago Endpoints: Id Flapped State Last Updated SmdDhcpIpc: 2 0 Connected 17s ago SmdPppIpc: 2 0 Connected 17s ago Sci-Session:2 1 Connected 14s ago SmdL2tpIpc: 2 0 Connected 17s ago Cpri-Low: 2 1 Connected 17s ago Cpri-Med: 2 1 Connected 17s ago Cpri-High: 2 1 Connected 17s ago cp-smg-service1 Status: Up State: Ready Restarted: 2 times Last cupm msg rx: reconcile Last cupm msg tx: keepalive (0s ago) Last Updated: 14s ago Endpoints: Id Flapped State Last Updated SmdPppIpc: 1 0 Connected 14s ago SmdL2tpIpc: 1 0 Connected 14s ago SmdDhcpIpc: 1 0 Connected 14s ago Sci-Session:1 2 Connected 11s ago Cpri-Low: 1 2 Connected 14s ago Cpri-Med: 1 2 Connected 14s ago Cpri-High: 1 2 Connected 14s ago bbe-cpm-daemon Status: Up State: Ready Restarted: 0 times Last Updated: 29s ago Endpoints: Id Flapped State Last Updated Sci-Node: 2 1 Connected 4s ago Sci-Node: 1 2 Connected 4s ago general-authentication-service Status: Up State: Ready Restarted: 3 times Last Updated: 16s ago l2tp-universal-edge Status: Up State: Starting Restarted: 0 times Last cupm msg rx: reconcile Last cupm msg tx: keepalive (1s ago) Last Updated: 30s ago Endpoints: Id Flapped State Last Updated L2tpSmdIpc: 2 1 Connected 23s ago L2tpSmdIpc: 1 2 Connected 14s ago dhcp-service Status: Up State: Ready Restarted: 0 times Last cupm msg rx: reconcile Last cupm msg tx: keepalive (0s ago) Last Updated: 30s ago Endpoints: Id Flapped State Last Updated DhcpSmdIpc: 2 1 Connected 19s ago DhcpSmdIpc: 1 2 Connected 16s ago bbe-upsf-service Status: Up State: Ready Restarted: 0 times Last cupm msg rx: reconcile Last cupm msg tx: keepalive (1s ago) Last Updated: 29s ago bbe-stats-svcsd Status: Up State: Ready Restarted: 0 times Last cupm msg rx: reconcile Last cupm msg tx: keepalive (2s ago) Last Updated: 28s ago Endpoints: Id Flapped State Last Updated Sci-Stats: 1 0 Connected 11s ago Sci-Stats: 2 0 Connected 14s ago
show system subscriber-management control-plane services service
user@host> show system subscriber-management control-plane services service service dhcp-service dhcp-service Status: Up State: Ready Restarted: 0 times Last cupm msg rx: reconcile Last cupm msg tx: keepalive (2s ago) Last Updated: 20s ago Endpoints:Id Flapped State Last Updated DhcpSmdIpc:5 0 Connected 15s ago DhcpSmdIpc:4 0 Connected 16s ago DhcpSmdIpc:3 0 Connected 17s ago DhcpSmdIpc:2 0 Connected 18s ago DhcpSmdIpc:1 0 Connected 18s ago
show system subscriber-management load-balancing group
Syntax
show system subscriber-management load-balancing group group-name
Description
Displays information for the load-balancing groups.
Options
| Empty |
If you do not enter a load-balancing group name, all load-balancing groups are listed. |
group group-name |
(Optional) Displays information about the listed load-balancing group. |
Required Privilege Level
root
Output Fields
Table 15 lists the output fields for the show system
subscriber-management load-balancing group command.
|
Field Name |
Field Description |
|---|---|
|
Group Name |
The name of the load-balancing group. |
|
UP Name |
The name of the BNG User Plane with which the load-balancing group is associated. |
|
Logical-Port |
BNG User Plane logical port. |
|
Usage |
The logical port's current load, represented as a percentage. |
|
Computed weight |
Current computed weight. |
|
Max weight |
Configured maximum weight. |
Sample Output
show system subscriber-management load-balancing group
user@host> show system subscriber-management load-balancing group mygroup Group Name UP Name Logical-Port Usage Computed weight Max weight mygroup UP-example-1 UP-example-1:ps0.30 80 0 0
show system subscriber-management user-plane
Syntax
show system subscriber-management user-plane <associations> <clients> <control-plane> <services> <upm>
Description
Displays statistics for the specified option. This command runs on the BNG User Plane.
Options
associations |
(Optional) Displays the BNG CUPS Controller that is associated to the BNG User Plane. |
clients |
(Optional) Displays information about each client that interacts with the user plane manager. |
control-plane |
(Optional) Displays information about the associated BNG CUPS Controller. |
services |
(Optional) Displays information about the BNG User Plane services. |
upm |
(Optional) Displays summary information about the user plan manager. |
Required Privilege Level
root
Output Fields
Table 15 lists the output fields for the show system
subscriber-management user-plane command.
|
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 with which the BNG User Plane is associated. |
|
Attached clients |
The number of clients attached 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 with which the BNG User Plane is associated. |
|
Address |
IP address of the BNG CUPS Controller that the BNG User Plane is associated with. |
|
Assoc Time |
The time at which 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 |
|
|
Last Heartbeat Time |
The time when the client's last heartbeat was recorded. |
|
Services |
The service for which information is being reported. |
|
State |
Health state of the BNG User Plane. If the state is not
|
|
Endpoints |
The total number of endpoints associated with the service. |
|
Healthy Endpoints |
The number of healthy endpoints. |
Sample Output
- show system subscriber-management user-plane upm
- show system subscriber-management user-plane associations
- show system subscriber-management user-plane clients
- show system subscriber-management user-plane services
show system subscriber-management user-plane upm
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 system subscriber-management user-plane associations
user@host> show system subscriber-management user-plane associations CP Name Address State Assoc Time Assoc-updates cp-example 192.0.2.1 Connected Thu Sep 24 10:44:31 2020 0
show system subscriber-management user-plane clients
user@host show system subscriber-management user-plane clients Client-name Status Last Heartbeat Time ep_bbePfcpUpEndpointClient attached Tue Sep 29 11:29:12 2020 ep_bbePfcpCpEndpointClient attached Tue Sep 29 11:29:12 2020 testCupmClient detached --
show system subscriber-management user-plane services
user@host show system subscriber-management user-plane services Services Status State Endpoints Healthy-Endpoints up-smg-service Up Ready 4 4 bbe-helperd Up Ready 0 0 replication-serverd-process Up Ready 1 1 replication-clientd-process Up Ready 1 1 bbe-upm-daemon Up Ready 1 1 bbe-stats-svcsd Up Ready 1 1
show system subscriber-management user-plane control-plane endpoints
Syntax
show system subscriber-management user-plane control-plane control-plane-name endpoint all | endpoint-name
Description
Displays the status of endpoints for BNG User Planes. You use this command to track the health of the BNG User Planes by using the health of all endpoints for the BNG User Planes. This command runs on the BNG User Plane.
Options
| None |
Lists the state and flapped count for all endpoints. |
|
control-plane
control-plane-name |
The BNG CUPS Controller with which the BNG User Planes are associated. |
|
endpoint |
Specify one of the following: |
|
Required Privilege Level
root
Output Fields
Table 16 lists the
output fields for the show system subscriber-management user-plane
control-plane endpoint command.
|
Field Name |
Field Description |
|---|---|
|
UP id |
The BNG User Plane's ID number. |
|
Ip Address |
The BNG CUPS Controller's IP address. |
|
Endpoints |
The endpoints associated with the BNG User Plane. |
|
Flapped |
How many times the service went from down to up. |
|
State |
The state of the service, either connected or disconnected. |
|
Status |
Indicates if the BNG CUPS Controller and BNG User Plane are connected. |
|
Security |
Indicates if security is enabled. |
|
Last updated |
The time since the information was last collected. |
|
Heartbeat failure |
Number of heartbeat failures. |
|
Invalid packets |
Number of invalid Packet Forwarding Control Protocol messages received. |
|
HeartbeatResp |
Number of Packet Forwarding Control Protocol heartbeat response messages received. |
| AssociationSetupRespAck | Number of successful Packet Forwarding Control Protocol association setup response messages received. |
|
Transmit errors |
Number of Packet Forwarding Control Protocol messages that failed to send. |
|
Max Retranmissions |
The total number of Packet Forwarding Control Protocol request messages that were retransmitted the maximum number of times. |
|
Retranmissions |
Number of retransmitted Packet Forwarding Control Protocol messages. |
|
HeartbeatReq |
Number of Packet Forwarding Control Protocol heartbeat request messages sent. |
|
AssociationSetupReq |
Number of Packet Forwarding Control Protocol association setup request messages sent. |
| Pkts count | Number of packets received. |
| Pkts dropped | Number of received packet that were dropped. |
| Pkts client rx | Number of received client packets, such as dhcp, dhcpv6,or ppp. |
| Pkts terminated locally | Number of received packets that terminated locally, such as echo packets for heartbeat keepalive. |
| Pkts aggr rx | Total of both client packets plus locally terminated packets received. |
| Client packets up to cp | Number of client packets sent from the BNG User Plane to the BNG CUPS Controller, such as dhcp, dhcpv6, or ppp. |
| Aggr packets up to cp | Total of both locally injected packets plus client packets sent from the BNG User Plane to the BNG CUPS Controller. |
| Aggr packets up to cp fail | Total of both locally injected packets plus client packets that failed when sent from the BNG User Plane to the BNG CUPS Controller. |
| Pkts injected locally to cp | Number of locally injected packets sent from the BNG User Plane to the BNG CUPS Controller, such as echo packets for heartbeat keepalives. |
| Pkts fwd to kernel | Number of packets forwarded to the Packet Forwarding Engine. |
| Pkts fwd to kernel fail | Number of failed packets forwarded to the Packet Forwarding Engine. |
| Last local seq num tx | The last local echo packet sequence number sent. |
| Last local seq num rx | The last local echo packet sequence number received. |
| Last remote seq num rx | The last remote echo packet sequence number received. |
| Total local echo pkts rx | The total number of local echo packets transmitted. |
| Total remote echo pkts rx | The total number of remote echo packets received. |
| Num of echo pkts lost | Number of missing or lost echo packets. |
| Chain Length | Number of nodes in a statesync chain. |
| Unique Id | Unique identifier assigned to each unique object in the statesync chain. |
| Sequence No. | Sequence number assigned to each statesync node. |
Sample Output
- show system subscriber-management user-plane control-plane endpoint (all)
- show system subscriber-management user-plane control-plane endpoint
- show system subscriber-management user-plane control-plane
show system subscriber-management user-plane control-plane endpoint (all)
user@host> show system subscriber-management user-plane control-plane cp-example-1 endpoint all
Sci-Node
Status: Connected
Heartbeat failure: 0
Rx: 38
Invalid packets: 0
HeartbeatResp 36
AssociationSetupRespAck 2
Tx: 41
Transmit errors: 0
Max Retranmissions: 0
Retranmissions: 0
HeartbeatReq 39
AssociationSetupReq 2
Sci-Stats
Status: Connected
Hearbeat failure: 0
Rx: 37
Invalid packets: 0
HeartbeatResp 36
AssociationSetupRespAck 1
Tx: 37
Transmit errors: 0
Max Retranmissions: 0
Retranmissions: 0
HeartbeatReq 36
AssociationSetupReq 1
Sci-Session
Status: Connected
Hearbeat failure: 0
Rx: 73
Invalid packets: 0
HeartbeatResp 71
AssociationSetupRespAck 1
NodeReportRespAck 1
Tx: 73
Transmit errors: 0
Max Retranmissions: 0
Retranmissions: 0
HeartbeatReq 71
AssociationSetupReq 1
NodeReportReq 1
Cpri-High
Status: Connected
Pkts count: 10
Pkts dropped: 0
Pkts client rx: 0
Pkts terminated locally: 4228
Pkts aggr rx: 4228
Client packets up to cp: 0
Aggr packets up to cp: 4237
Aggr packets up to cp fail: 0
Pkts injected locally to cp: 4237
Pkts fwd to kernel: 0
Pkts fwd to kernel fail: 0
Last local seq num tx: 2108
Last local seq num rx: 2108
Last remote seq num rx: 1853
Total local echo pkts rx: 2099
Total remote echo pkts rx: 2129
Num of echo pkts lost: 0
Cpri-Med
Status: Connected
Pkts count: 0
Pkts dropped: 0
Pkts client rx: 0
Pkts terminated locally: 4228
Pkts aggr rx: 4228
Client packets up to cp: 0
Aggr packets up to cp: 12059
Aggr packets up to cp fail: 0
Pkts injected locally to cp: 4237
Pkts fwd to kernel: 0
Pkts fwd to kernel fail: 0
Last local seq num tx: 2108
Last local seq num rx: 2108
Last remote seq num rx: 1853
Total local echo pkts rx: 2099
Total remote echo pkts rx: 2129
Num of echo pkts lost: 0
Cpri-Low
Status: Connected
Pkts count: 10
Pkts dropped: 0
Pkts client rx: 30
Pkts terminated locally: 4230
Pkts aggr rx: 4260
Client packets up to cp: 0
Aggr packets up to cp: 4247
Aggr packets up to cp fail: 0
Pkts injected locally to cp: 4237
Pkts fwd to kernel: 30
Pkts fwd to kernel fail: 0
Last local seq num tx: 2108
Last local seq num rx: 2108
Last remote seq num rx: 1853
Total local echo pkts rx: 2099
Total remote echo pkts rx: 2129
Num of echo pkts lost: 0
RepClientSS
Status: Synchronized
Chain Length: 0
Unique Id: 145
Sequence No.: 569
RepServerSS
Status: Synchronized
Chain Length: 231
Unique Id: 150
Sequence No.: 595'
show system subscriber-management user-plane control-plane endpoint
user@host> show system subscriber-management user-plane control-plane cp-exampl-1 endpoint Cpri-High Cpri-High Status: Connected Pkts count: 0 Pkts dropped: 0 Pkts client rx: 0 Pkts terminated locally: 1320 Pkts aggr rx: 1320 Client packets up to cp: 0 Aggr packets up to cp: 1320 Aggr packets up to cp fail: 0 Pkts injected locally to cp: 1320 Pkts fwd to kernel: 0 Pkts fwd to kernel fail: 0 Last local seq num tx: 660 Last local seq num rx: 660 Last remote seq num rx: 663 Total local echo pkts rx: 660 Total remote echo pkts rx: 660 Num of echo pkts lost: 0
show system subscriber-management user-plane control-plane
user@host> show system subscriber-management user-plane control-plane cp-exampl-1 Ip address: 192.0.2.1 Endpoints Flapped State Last Updated Sci-Session 0 Connected 19s ago Sci-Stats 0 Connected 19s ago RepServerSS 0 Synchronized 19s ago RepClientSS 0 Synchronized 19s ago Cpri-Low 0 Connected 19s ago Cpri-Med 0 Connected 19s ago Cpri-High 0 Connected 19s ago Sci-Node 0 Connected 6s ago
show system subscriber-management placement-cluster
Syntax
show subscriber-management placement-cluster cluster cluster-name service-group service-group-name
Description
Shows the BNG User Plane's steering cluster information for all clusters or specific clusters.
Options
cluster cluster-name |
(Optional) Displays the BNG User Plane steering for the specified cluster. If a cluster name is not specified, then all clusters are displayed. |
service-group
service-group-name |
(Optional) Displays the service group. If a service group name is not specified, then all service groups are displayed. |
Required Privilege Level
root
Output Fields
Table 17 lists the
output fields for the show subscriber-management
placement-cluster command. Output fields are listed in alphabetical
order.
|
Field Name |
Field Description |
|---|---|
| Cluster |
The name of the cluster that services the access node where the subscriber's services are terminated |
| Service-group |
The name of the service group |
| UP Name |
The name of the BNG User Plane |
| UP Id |
The BNG User Plane identifier |
Sample Output
- show system subscriber-management placement-cluster cluster (All)
- show system subscriber-management placement-cluster cluster
- show system subscriber-management placement-cluster service-group
show system subscriber-management placement-cluster cluster (All)
user@host> show system subscriber-management placement-cluster cluster Custer Name Cluster-1 Cluster-2
show system subscriber-management placement-cluster cluster
user@host> show system subscriber-management placement-cluster cluster cluster-1 UP Name UP Id Service-group up-example-1 1 premium up-example-1 1 gaming up-example-2 2 internet
show system subscriber-management placement-cluster service-group
user@host> show system subscriber-management placement-cluster service-group Service-group Cluster UP premium custer-1 up-example-1 gaming cluster-1 up-example-1 internet cluster-2 up-example-2
show system subscriber-management placement-cluster service-group
user@host> show system subscriber-management placement-cluster service-group premium Cluser Name UP Name UP ID cluster-1 up-example-1 1
show user-plane subscribers
Syntax
show user-plane subscribers <all> <count> <detail | extensive | terse> <id session-id> <interface interface> <mac-address mac-address> <physical-address physical-address-name> <pic> <port> <routing-instance routing-instance> <slot> <stacked-vlan-id stacked-vlan-id> <Summary> <vlan-id vlan-id>
Description
Displays information for BNG User Plane subscribers.
Options
| None |
Displays information by interface, IP address or VLAN ID, and LS:RI. |
| all |
(Optional) Displays summary information by state, client type, and LS:RI. |
detail | extensive | terse |
(Optional) Displays the specified level of output. |
count |
(Optional) Displays the count of total subscribers and active subscribers for any specified option. |
id session-id |
(Optional) Displays subscriber of a session with an ID matching the specific subscriber ID. |
interface |
(Optional) Displays subscribers with an interface that matches the specified interface. |
mac-address |
(Optional) Displays subscribers with a MAC address that matches the specified MAC address. |
physical-address-name |
(Optional) Displays subscribers with a physical address that matches the specified physical address. |
pic |
(Optional) Displays a count of subscribers by PIC number and total number of subscribers. |
port |
(Optional) Displays a count of subscribers by port number and total number of subscribers. |
routing-instance |
(Optional) Displays subscribers with a routing instance that matches the specified routing instance. |
| slot |
(Optional) Displays a count of subscribers by Flexible PIC Concentrator (FPC) slot number and total number of subscribers. |
stacked-vlan-id |
(Optional) Displays subscribers with a stacked VLAN ID that matches the specified stacked VLAN ID. |
summary |
(Optional) Displays summary information for subscribers. |
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
|
Required Privilege Level
view
Output Fields
Table 18 lists the output fields for the show user-plane
subscribers command. Output fields are listed in the approximate
order in which they appear.
|
Field Name |
Field Description |
|---|---|
|
|
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. |
|
|
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
|
|
|
Logical system and routing instance associated with the subscriber. |
|
|
Subscriber client type (DHCP, L2TP, PPP, PPPoE, and VLAN). |
|
|
Subscriber IPv4 address. |
|
|
Logical system associated with the subscriber. |
|
|
Routing instance associated with the subscriber. |
|
|
Name of the enhanced subscriber management logical interface,
in the form |
|
|
Whether the subscriber interface is |
|
|
Name of the underlying interface for the subscriber session. |
|
|
MAC address associated with the subscriber. |
|
|
Current state of the subscriber session
( |
|
|
Forwarding flow identifier. |
|
|
VLAN ID associated with the subscriber in the form tpid.vlan-id. |
|
|
ID number for a subscriber session. |
|
|
Number of service sessions (that is, a service that is activated using RADIUS CoA) associated with the subscribers. |
|
|
ID number for a subscriber service session. |
|
|
Service session profile name. |
|
|
Name assigned to the IPv4 input filter (client or service session). |
|
|
Name assigned to the IPv4 output filter (client or service session). |
|
|
Time at which the first family in this service became active. |
|
|
How often statistics are collected for the accounting profile. |
|
|
Values for variables that are passed into the dynamic profile from RADIUS. |
|
|
Number of subscribers summarized by state. The summary information includes the following:
|
|
|
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. |
|
|
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
- show user-plane subscribers (DHCP)
- show user-plane subscribers count
- show user-plane subscribers detail
- show user-plane subscribers detail (DHCP)
- show user-plane subscribers extensive
- show user-plane subscribers id
- show user-plane subscribers interface
- show user-plane subscribers routing-instance
- show user-plane subscribers vlan-id
- show user-plane subscribers summary
- show user-plane subscribers summary slot
- show user-plane subscribers stacked-vlan-id
- show user-plane subscribers terse
show user-plane subscribers
user@host> show user-plane subscribers Interface IP Address/VLAN ID LS:RI pp0.3221749760 192.0.2.1 default:default
show user-plane subscribers (DHCP)
user@host> show user-plane subscribers Interface IP Address/VLAN ID LS:RI demux0.3221749761 192.0.2.1 default:default demux0.3221749762 2001:db8::3/128 default:default
show user-plane subscribers count
user@host> show user-plane subscribers count Total Subscribers: 1, Active Subscribers: 1
show user-plane subscribers detail
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)
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
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
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
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
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
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
user@host> show user-plane subscribers summary Subscribers by State Active: 2 Total: 2 Subscribers by Client Type DHCP: 2 Total: 2
show user-plane subscribers summary slot
user@host> show user-plane subscribers summary slot all Subscribers by State Active: 1 Total: 1 Subscribers by Client Type DHCP: 1 Total: 1 Subscribers by LS:RI default:default: 1 Total: 1
show user-plane subscribers stacked-vlan-id
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
user@host> show user-plane subscribers terse Interface IP Address/VLAN ID SessionId LS:RI demux0.3221225473 192.0.2.1 2 default:default
request network-access aaa address-assignment domain-profile
Syntax
request network-access aaa address-assignment domain-profile ri-name routing-instance-name profile-name profile-name [enable-login | disable-login]
Description
Enable or disable logins for existing domains created from the domain profile and to control the creation of new domains from the domain profile.
Options
ri-name routing-instance-name |
Specify the routing instance name. |
profile-name profile-name |
Specify the name of the profile. |
[enable-login | disable-login] |
Specify the desired action. |
Required Privilege Level
root
Output Fields
When you enter this command, you receive feedback only if an error occurs.
request network-access aaa address-assignment user-plane
Syntax
request network-access aaa address-assignment user-plane user-plane-name [enable-login | disable-login]
Description
Enable or disable logins for subscribers originating from the specified BNG User Plane. When you use this command, you effectively enable or disable logins for existing domains associated with the BNG User Plane. You also control the creation of new domains for the BNG User Plane.
Options
user-plane user-plane-name |
Specify the BNG User Plane name. |
[enable-login | disable-login] |
Specify the desired action. |
Required Privilege Level
root
Output Fields
When you enter this command, you receive feedback only if an error occurs.
restart bbe-cpm-daemon
Syntax
restart bbe-cpm-daemon
Description
Restarts the Control 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. This command runs on the BNG CUPS Controller.
Sample Output
restart bbe-cpm-daemon
user@host> restart bbe-cpm-daemon Control Plane Manager for dBNG started, pid <process-id>
restart bbe-stats-daemon
Syntax
restart bbe-stats-daemon
Description
Restarts the Enhanced Session Management Statistics 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. This command runs on the BNG CUPS Controller.
Sample Output
restart bbe-stats-daemon
user@host> restart bbe-stats-daemon Control Plane Manager for dBNG started, pid <process-id>
restart bbe-stats-svcsd
Syntax
restart bbe-stats-svcsd
Description
Restarts the Statistics Services 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. This command runs on the BNG User Planes.
Sample Output
restart bbe-stats-svcsd
user@host> restart bbe-stats-svcsd Control Plane Manager for dBNG started, pid <process-id>
restart bbe-upm-daemon
Syntax
restart bbe-upm-daemon
Description
Restarts the User Plane Manager daemon. This command runs on the BNG CUPS Controller.
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
user@host> restart bbe-upm-daemon Control Plane Manager for dBNG started, pid <process-id>
restart bbe-upsf-daemon
Syntax
restart bbe-upsf-daemon
Description
Restarts the User Plane Selection Function daemon. This command runs on the BNG CUPS Controller.
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-upsf-daemon
user@host> restart bbe-upsf-daemon Control Plane Manager for dBNG started, pid <process-id>
restart cp-smg-server
Syntax
restart cp-smg-server
Description
Restarts the Enhanced Session Management BNG CUPS Controller process. This command runs on the BNG CUPS Controller.
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 cp-smg-server
user@host> restart cp-smg-server Control Plane Manager for dBNG started, pid <process-id>
restart replication-client-process
Syntax
restart replication-client-process
Description
Restarts the Replication Client Process. A BNG User Plane hosts the Replication Client Process daemon and the Replication Server Process daemon. These daemons replicate the state between the BNG CUPS Controller and the BNG User Plane and the routing engines. This command runs on the BNG CUPS Controller.
Avoid using this command unless Juniper Networks Technical Assistance Center (JTAC) directs you to use it.
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 replication-client-process
user@host> restart replication-client-process Control Plane Manager for dBNG started, pid <process-id>
restart replication-server-process
Syntax
restart replication-server-process
Description
Restarts the Replication Server Process. A BNG User Plane hosts the Replication Client Process daemon and the Replication Server Process daemon. These daemons replicate the state between the BNG CUPS Controller and the BNG User Plane and the routing engines. This command runs on the BNG CUPS Controller.
Avoid using this command unless Juniper Networks Technical Assistance Center (JTAC) directs you to use it.
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 replication-server-process
user@host> restart replication-server-process Control Plane Manager for dBNG started, pid <process-id>
restart up-helper-service
Syntax
restart up-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 up-helper-service
user@host> restart up-helper-service Control Plane Manager for dBNG started, pid <process-id>
restart up-smg-server
Syntax
restart up-smg-server
Description
Restarts the Enhanced Session Management BNG User Plane process. This command runs on the BNG CUPS Controller.
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-server
user@host> restart up-smg-server Control Plane Manager for dBNG started, pid <process-id>