Technical Documentation

show subscribers

Syntax

show subscribers <address address><client-type client-type><interface interface><logical-system logical-system><mac-address mac-address><profile-name profile-name><routing-instance routing-instance><stacked-vlan-id stacked-vlan-id><subscriber-state subscriber-state><vlan-id vlan-id><count | detail | extensive |summary (all | logical-system logical-system | routing-instance routing-instance) | terse>

Release Information

Command introduced in Junos OS Release 9.3.

Command introduced in Junos OS Release 9.3 for EX Series switches.

client-type, mac-address, subscriber-state, extensive, and summary options introduced in Junos OS Release 10.2.

count option usage with other options introduced in Junos OS Release 10.2

Description

Display information for active subscribers.

Options

address: (Optional) Display subscribers whose IP address matches the specified address.
client-type: (Optional) Display subscribers whose client type matches the specified client type (DHCP, L2TP, PPP, PPPOE, or VLAN).
count: (Optional) Display the count of total subscribers and active subscribers for any specified option. You can use the count option alone or with the address, client-type, interface, logical-system, mac-address, profile-name, routing-instance, stacked-vlan-id, subscriber-state, and vlan-id options.
interface: (Optional) Display subscribers whose interface matches the specified interface.
logical system: (Optional) Display subscribers whose logical system matches the specified logical system.
mac-address: (Optional) Display subscribers whose MAC address matches the specified MAC address.
profile name: (Optional) Display subscribers whose dynamic profile matches the specified profile name.
routing instance: (Optional) Display subscribers whose routing instance matches the specified routing instance.
subscriber-state: (Optional) Display subscribers whose subscriber state matches the specified subscriber state (ACTIVE, CONFIGURED, INIT, TERMINATED, or TERMINATING).
vlan-id: (Optional) Display subscribers whose VLAN ID matches the specified VLAN ID.
stacked-vlan-id: (Optional) Display subscribers whose stacked VLAN ID matches the specified stacked VLAN ID.
detail | terse | extensive: (Optional) Display the specified level of output.
summary: (Optional) Display summary output.

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
show subscribers detail (IPv4)
show subscribers detail (IPv6)
show subscribers logical-system
show subscribers count
show subscribers routing-instance inst1 count
show subscribers vlan-id
show subscribers vlan-id detail
show subscribers stacked-vlan-id detail
show subscribers stacked-vlan-id vlan-id detail (Combined Output)
show subscribers stacked-vlan-id vlan-id interface detail (Combined Output for a Specific Interface)
show subscribers client-type dhcp detail
show subscribers extensive
show subscribers summary
show subscribers summary all
show subscribers 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
User Name	Name of subscriber.
Type	Subscriber client type (DHCP, VLAN, PPP, PPPOE, or L2TP).
IP Address	Subscriber IPv4 address.
IP Netmask	Subscriber IP netmask.
IPv6 Address	Subscriber IPv6 address.
IPv6 Prefix	Subscriber IPv6 prefix.
IPv6 Prefix Length	Length of the subscriber IPv6 prefix.
Logical System	Logical system associated with the subscriber.
Routing Instance	Routing instance associated with the subscriber.
Interface	Interface associated with the subscriber. The router displays subscribers whose interface matches or begins with the specified interface.
Interface Type	Whether the subscriber interface is static or dynamic.
Dynamic Profile Name	Dynamic profile used for the subscriber.
MAC Address	MAC address associated with the subscriber.
State	Current state of the subscriber session (Init, Configured, Active, Terminating, Terminated).
VLAN Id	VLAN ID associated with the subscriber in the form tpid.vlan-id.
Stacked VLAN Id	Stacked VLAN ID associated with the subscriber in the form tpid.vlan-id.
RADIUS Accounting ID	RADIUS accounting ID associated with the subscriber.
Agent Circuit ID	Option 82 agent circuit ID associated with the subscriber.
Agent Remote ID	Option 82 agent remote ID associated with the subscriber.
DHCP Relay IP Address	IP address used by the DHCP relay agent.
Login Time	Date and time at which the subscriber logged in.
Session ID	ID number for a subscriber service session.
Service Sessions	Number of service sessions (that is, a service activated using RADIUS CoA) associated with the subscribers.
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).
IPv6 Input Filter Name	Name assigned to the IPv6 input filter (client or service session).
IPv6 Output Filter Name	Name assigned to the IPv6 output filter (client or service session).
IFL Input Filter Name	Name assigned to the logical interface input filter (client or service session).
IFL Output Filter Name	Name assigned to the logical interface output filter (client or service session).
Subscribers by State	Number of subscribers summarized by state. The summary information includes the following: Init—Number of subscriber currently in the initialization state. Configured—Number of configured subscribers. Active—Number of active subscribers. Terminating—Number of subscribers currently terminating. Terminated—Number of terminated subscribers. Summary information includes subscriber counts per state and the total number of subscribers.
Subscribers by Client Type	Number of subscribers summarized by client type. Client types can include DHCP, VLAN, PPP, PPPOE, and L2TP. Summary information includes subscriber counts per client type and the total number of subscribers.
Subscribers by LS:RI	Number of subscribers summarized by logical system:routing instance (LS:RI) combination. Summary information includes subscriber counts per LS:RI and the total number of subscribers.

Sample Output

show subscribers

user@host> show subscribers

Interface       				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

show subscribers detail (IPv4)

user@host> show subscribers detail

Type: DHCP
IP Address: 100.20.9.7
IP Netmask: 255.255.0.0
Logical System: default
Routing Instance: default
Interface: demux0.1073744127
Interface type: Dynamic
Dynamic Profile Name: dhcp-demux-prof
MAC Address: 00:10:95:00:00:98
State: Active
Radius Accounting ID: jnpr :2304
Login Time: 2009-08-25 14:43:52 PDT
Service Sessions: 2

show subscribers detail (IPv6)

user@host> show subscribers detail

Type: DHCP
IPv6 Address: 1080:0:0:0:8:800:200C:417A
Ipv6 Prefix: fec0:1:1:1::/128
Logical System: default1
Routing Instance: default
Interface: demux0.1073744127
Interface type: Dynamic
Dynamic Profile Name: dhcp-demux-prof
MAC Address: 00:10:95:00:00:98
State: Active
Radius Accounting ID: jnpr :2304
Login Time: 2009-08-25 14:43:52 PDT
Service Sessions: 2

show subscribers logical-system

user@host> show subscribers logical-system test1
terse

Interface       				IP Address/VLAN ID   User Name         LS:RI
demux0.1073741825   		101.0.0.3            RETAILER1-CLIENT  test1:retailer1
demux0.1073741826   		102.0.0.3            RETAILER2-CLIENT  test1:retailer2

show subscribers count

user@host> show subscribers count

Total Subscribers: 188, Active Subscribers: 188

show subscribers routing-instance inst1 count

user@host> show subscribers routing-instance
inst1 count

Total Subscribers: 188, Active Subscribers: 183

show subscribers vlan-id

user@host> show subscribers vlan-id 100

Interface           IP Address                              User Name
ge-1/0/0.1073741824
ge-1/2/0.1073741825

show subscribers vlan-id detail

user@host> show subscribers vlan-id 100 detail

Type: VLAN
Interface: ge-1/0/0.1073741824
Interface type: Dynamic
Dynamic Profile Name: vlan-prof-tpid
State: Active
VLAN Id: 100
Login Time: 2009-03-11 06:48:54 PDT

Type: VLAN
Interface: ge-1/2/0.1073741825
Interface type: Dynamic
Dynamic Profile Name: vlan-prof-tpid
State: Active
VLAN Id: 100
Login Time: 2009-03-11 06:48:54 PDT

show subscribers stacked-vlan-id detail

user@host> show subscribers stacked-vlan-id
101 detail

Type: VLAN
Interface: ge-1/2/0.1073741824
Interface type: Dynamic
Dynamic Profile Name: svlan-prof
State: Active
Stacked VLAN Id: 0x8100.101
VLAN Id: 0x8100.100
Login Time: 2009-03-27 11:57:19 PDT

show subscribers stacked-vlan-id vlan-id detail (Combined Output)

user@host> show subscribers stacked-vlan-id
101 vlan-id 100 detail

Type: VLAN
Interface: ge-1/2/0.1073741824
Interface type: Dynamic
Dynamic Profile Name: svlan-prof
State: Active
Stacked VLAN Id: 0x8100.101
VLAN Id: 0x8100.100
Login Time: 2009-03-27 11:57:19 PDT

show subscribers stacked-vlan-id vlan-id interface detail (Combined Output for a Specific Interface)

user@host> show subscribers stacked-vlan-id
101 vlan-id 100 interface ge-1/2/0.* detail

Type: VLAN
Interface: ge-1/2/0.1073741824
Interface type: Dynamic
Dynamic Profile Name: svlan-prof
State: Active
Stacked VLAN Id: 0x8100.101
VLAN Id: 0x8100.100
Login Time: 2009-03-27 11:57:19 PDT

show subscribers client-type dhcp detail

user@host> show subscribers client-type dhcp
detail

Type: DHCP
IP Address: 100.20.9.7
IP Netmask: 255.255.0.0
Logical System: default
Routing Instance: default
Interface: demux0.1073744127
Interface type: Dynamic
Dynamic Profile Name: dhcp-demux-prof
MAC Address: 00:10:95:00:00:98
State: Active
Radius Accounting ID: jnpr :2304
Login Time: 2009-08-25 14:43:52 PDT

Type: DHCP
IP Address: 100.20.10.7
IP Netmask: 255.255.0.0
Logical System: default
Routing Instance: default
Interface: demux0.1073744383
Interface type: Dynamic
Dynamic Profile Name: dhcp-demux-prof
MAC Address: 00:10:94:00:01:f3
State: Active
Radius Accounting ID: jnpr :2560
Login Time: 2009-08-25 14:43:56 PDT

show subscribers extensive

user@host> show subscribers extensive

Type: DHCP
       IPv6 Prefix: 2001::40:0:0:0/74
       IPv6 Prefix Length: 64
       Logical System: default
           Routing Instance: default
           Interface: demux0.1073741825
           Interface type: Dynamic
           Dynamic Profile Name: dhcp-demux-prof
           State: Active
           Radius Accounting ID: jnpr :2
           Agent Circuit ID: abc
           Remote Circuit ID: xyz
           Login Time: 2010-03-31 14:27:19 PDT
           Service Sessions: 1
           IPv6 Input Filter Name: demux0-inet6-in
              Session ID: 213
              Service Session Name: service-profile
              IPv6 Input Filter Name: dfwd1-demux.1073741825-in

show subscribers summary

user@host> show subscribers summary

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

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