show subscribers summary
Syntax
Release Information
Command introduced in Junos OS Release 10.2.
Description
Display summary information for subscribers.
Options
detail | extensive | terse | — | (Optional) Display the specified level of output. |
count | — | (Optional) Display the count of total subscribers and active subscribers for any specified option. |
logical-system | — | (Optional) Display subscribers whose logical system matches the specified logical system. |
physical-interface-name | — | (M120, M320, and MX Series routers only) (Optional) Display a 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 a count of subscribers by PIC number and the total number of subscribers. |
port | — | (M120, M320, and MX Series routers only) (Optional) Display a count of subscribers by port number and the total number of subscribers. |
routing-instance | — | (Optional) Display subscribers whose routing instance matches the specified routing instance. |
slot | — | (M120, M320, and MX Series routers only) (Optional) Display a count of subscribers by FPC slot number and the total number of subscribers. |
 | Note: Due to display limitations, logical system and routing instance output values are truncated when necessary. |
Required Privilege Level
view
List of Sample Output
show subscribers summaryshow 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 slot
show subscribers summary terse
Output Fields
Table 1 lists the output fields for the show subscribers command. Output fields are listed in the approximate order in which they appear.
Table 1: show subscribers Output Fields
Field Name | Field Description |
|---|---|
Subscribers by State | Number of subscribers summarized by state. The summary information includes the following:
|
Subscribers by Client Type | Number of subscribers summarized by client type. Client types can include DHCP, L2TP, PPP, PPPOE, STATIC-INTERFACE, and VLAN. Also displays the total number of subscribers for all client types (Total). |
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 (Total). |
Interface | Interface associated with the subscriber. The router or switch displays subscribers whose interface matches or begins with the specified interface. The * character indicates a continuation of addresses for the same session. For aggregated Ethernet interfaces, the output of the summary (pic | port | slot) options prefixes the interface name with ae0:. |
Count | Count of subscribers displayed for each PIC, port, or slot when those options are specified with the summary option. For an aggregated Ethernet configuration, the total subscriber count does not equal the sum of the individual PIC, port, or slot counts, because each subscriber can be in more than one aggregated Ethernet link. |
Total Subscribers | Total number of subscribers for all physical interfaces, all PICS, all ports, or all LS:RI slots. |
IP Address/VLAN ID | Subscriber IP address or VLAN ID associated with the subscriber in the form tpid.vlan-id |
User Name | Name of subscriber. |
LS:RI | Logical system and routing instance associated with the subscriber. |
Sample Output
show subscribers summary
user@host> show subscribers summarySubscribers 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
show subscribers summary all
user@host> show subscribers summary allSubscribers 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/0Subscribers 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 picSubscribers 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 portSubscribers 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 slotSubscribers 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 picInterface Count ge-1/0 1000 ge-1/3 1000 Total Subscribers: 2000
show subscribers summary pic (Aggregated Ethernet Interfaces)
user@host> show subscribers summary picInterface Count ae0: ge-1/0 801 ae0: ge-1/3 801 Total Subscribers: 801
show subscribers summary port
user@host> show subscribers summary portInterface Count ge-1 2000 Total Subscribers: 2000
show subscribers summary slot
user@host> show subscribers summary slotInterface Count ge-1 2000 Total Subscribers: 2000
show subscribers summary terse
user@host> show subscribers summary terseInterface IP Address/VLAN ID User Name LS:RI ge-1/3/0.1073741824 100 default:default demux0.1073741824 100.0.0.10 WHOLESALER-CLIENT default:default demux0.1073741825 101.0.0.3 RETAILER1-CLIENT test1:retailer1 demux0.1073741826 102.0.0.3 RETAILER2-CLIENT test1:retailer2
