show subscribers summary
Syntax
show subscribers summary <all> <detail | extensive | terse> <count> <physical-interface physical-interface-name> <logical-system logical-system pic | port | routing-instance routing-instance | slot> <sub-system (agf | bng)>
Description
Display summary information for subscribers.
Options
| none |
Display summary information by state and client type for all subscribers. |
| all |
(Optional) Display summary information by state, client type, and logical system and routing instance (LS:RI). |
| detail | extensive | terse |
(Not supported on MX Series routers) (Optional) Display the specified level of output. |
| count |
(Not supported on MX Series routers) (Optional) Display the count of total subscribers and active subscribers for any specified option. |
| logical-system logical-system |
(Optional) Display subscribers whose logical system matches the specified logical system. |
| physical-interface physical-interface-name |
(M120, M320, and MX Series routers only) (Optional) Display the count of subscribers whose physical interface matches the specified physical interface, by subscriber state, client type, and LS:RI. |
| pic |
(M120, M320, and MX Series routers only) (Optional) Display the count of subscribers by PIC number and the total number of subscribers. |
| port |
(M120, M320, and MX Series routers only) (Optional) Display the count of subscribers by port number and the total number of subscribers. |
| routing-instance routing-instance |
(Optional) Display subscribers whose routing instance matches the specified routing instance. |
| slot |
(M120, M320, and MX Series routers only) (Optional) Display the count of subscribers by Flexible PIC Concentrator (FPC) slot number and the total number of subscribers. |
| sub-system (agf | bng) | (Optional) Display a count of subscribers using either
the
Access Gateway Function
(AGF)
or
broadband
network gateway
(BNG)
services. Note:
The subsystem option is only available when both the AGF and BNG subscribers are logged into the router at the same time. |
Because of display limitation, the logical system and routing instance output values are truncated when necessary.
Starting from Junos OS 20.4R1 release, you need a license to use the Extensible Subscribers Services Manager (ESSM) feature.
Required Privilege Level
view
Output Fields
Table 1 lists the
output fields for the show subscribers summary command. Output fields
are listed in the approximate order in which they appear.
|
Field Name |
Field Description |
Level of Output |
|---|---|---|
|
|
Number of subscribers summarized by state. The summary includes the following information:
|
|
|
|
Number of subscribers summarized by client type. Client types can include DHCP, GRE, L2TP, PPP, PPPoE, STATIC-INTERFACE, VLAN, and VLAN-OOB. This field also displays the total number of subscribers for all client types (Total). |
|
|
|
Number of subscribers summarized by logical system:routing instance (LS:RI) combination. This field also displays the total number of subscribers for all the LS:RI combinations (Total). |
|
|
|
Number of subscribers summarized by connection type,
|
|
|
|
Number of subscribers on the subsystem—AGF or BNG as well as the total number of subscriber. |
All levels |
|
|
Interface associated with the subscriber. The router or the switch displays subscribers whose interface matches or begins with the specified interface. The asterisk (*) indicates a continuation of addresses for the same session. For aggregated Ethernet interfaces, the output of the For pseudowire IFDs, this field displays both the pseudowire and the associated logical tunnel (LT) and the redundant logical tunnel (RLT) anchor interface. For example: ps0: lt-2/1/0 ps1: rlt0: lt-4/0/0 |
All levels |
|
|
Count of subscribers displayed for each PIC, port, or slot when those
options are specified with the Multiple pseudowire interfaces can share a given logical tunnel or redundant logical tunnel anchor interface. Starting in Junos OS Release 18.1R1, the field displays subscribers per individual pseudowire interface. In earlier releases, the field displays the same number of subscribers for all the pseudowire interfaces that share the same tunnel interface as their anchor point. |
|
|
|
Total number of subscribers for all physical interfaces, all PICs, all ports, or all LS:RI slots. |
|
|
|
Subscriber IP address or VLAN ID associated with the subscriber in the form tpid.vlan-id |
|
|
|
Name of the subscriber. |
|
|
|
Logical system and routing instance associated with the subscriber. |
|
Sample Output
- show subscribers summary
- show subscribers summary all
- show subscribers summary physical-interface
- show subscribers summary physical-interface pic
- show subscribers summary physical-interface port
- show subscribers summary physical-interface slot
- show subscribers summary pic
- show subscribers summary pic (Aggregated Ethernet Interfaces)
- show subscribers summary port
- show subscribers summary port (Pseudowire Interfaces)
- show subscribers summary port extensive
- show subscribers summary slot
- show subscribers summary terse
- show subscribers summary (agf)
- show subscribers summary sub-system agf
show subscribers summary
user@host> show subscribers summary Subscribers by State Active: 52194 Total: 52194 Subscribers by Client Type DHCP: 10000 VLAN: 15997 VLAN-OOB: 3600 PPPoE: 15998 ESSM: 6599 Total: 52194
show subscribers summary all
user@host> show subscribers summary all Subscribers by State Init 3 Configured 2 Active 183 Terminating 2 Terminated 1 TOTAL 191 Subscribers by Client Type DHCP 107 PPP 76 VLAN 8 TOTAL 191 Subscribers by LS:RI default:default 1 default:ri1 28 default:ri2 16 ls1:default 22 ls1:riA 38 ls1:riB 44 logsysX:routinstY 42 TOTAL 191
show subscribers summary physical-interface
user@host> show subscribers summary physical-interface ge-1/0/0 Subscribers by State Active: 3998 Total: 3998 Subscribers by Client Type DHCP: 3998 Total: 3998 Subscribers by LS:RI default:default: 3998 Total: 3998
show subscribers summary physical-interface pic
user@host> show subscribers summary physical-interface ge-0/2/0 pic Subscribers by State Active: 4825 Total: 4825 Subscribers by Client Type DHCP: 4825 Total: 4825 Subscribers by LS:RI default:default: 4825 Total: 4825
show subscribers summary physical-interface port
user@host> show subscribers summary physical-interface ge-0/3/0 port Subscribers by State Active: 4825 Total: 4825 Subscribers by Client Type DHCP: 4825 Total: 4825 Subscribers by LS:RI default:default: 4825 Total: 4825
show subscribers summary physical-interface slot
user@host> show subscribers summary physical-interface ge-2/0/0 slot Subscribers by State Active: 4825 Total: 4825 Subscribers by Client Type DHCP: 4825 Total: 4825 Subscribers by LS:RI default:default: 4825 Total: 4825
show subscribers summary pic
user@host> show subscribers summary pic Interface Count ge-1/0 1000 ge-1/3 1000 Total Subscribers: 2000
show subscribers summary pic (Aggregated Ethernet Interfaces)
user@host> show subscribers summary pic Interface Count ae0: ge-1/0 801 ae0: ge-1/3 801 Total Subscribers: 801
show subscribers summary port
user@host> show subscribers summary port Interface Count ge-5/0/1 201 ge-5/0/2 301 Total Subscribers: 502
show subscribers summary port (Pseudowire Interfaces)
user@host> show subscribers summary port ps0: lt-2/1/0 10 ps1: lt-2/1/0 20 Total Subscribers: 30
show subscribers summary port extensive
user@host>show subscribers summary port extensive Interface: xe-3/0/3 Port Count: 100 Detail: Subscribers by Client Type PPPoE: 1 ESSM: 99 Subscribers by Connection Type Terminated: 1 Interface: xe-3/1/3 Port Count: 3100 Detail: Subscribers by Client Type PPPoE: 1600 ESSM: 1100 VLAN-OOB: 400 Subscribers by Connection Type Tunneled: 500 Terminated: 1100 Cross-connected: 400 Total Subscribers: 26197
show subscribers summary slot
user@host> show subscribers summary slot Interface Count ge-1 2000 Total Subscribers: 2000
show subscribers summary terse
user@host> show subscribers summary terse Interface IP Address/VLAN ID User Name LS:RI ge-1/3/0.1073741824 100 default:default demux0.1073741824 203.0.113.10 WHOLESALER-CLIENT default:default demux0.1073741825 203.0.113.13 RETAILER1-CLIENT test1:retailer1 demux0.1073741826 203.0.113.213 RETAILER2-CLIENT test1:retailer2
show subscribers summary (agf)
user@host> show subscribers summary Subscribers by Sub-System AGF: 3000 BNG: 0 Total: 3000 Subscribers by State Active: 4000 Total: 4000 Subscribers by Client Type VLAN: 1000 PPPoE: 3000 Total: 4000
show subscribers summary sub-system agf
user@host> show subscribers summary sub-system agf
AGF Subscribers by State
Init: 3
Active: 12
Total: 15
AGF Subscribers by Client Type
DHCP: 2
PPPOE: 5
PPPOE-5G 5
TOTAL 12
Release Information
Command introduced in Junos OS Release 10.2.
sub-system added in Junos OS Release 22.3R1.