show subscribers
Syntax
show subscribers <detail | extensive | terse> <address address> <accounting-statistics id session-id> <agent-circuit-identifier agent-circuit-identifier> <agent-remote-identifier agent-remote-identifier> <aggregation-interface-set-name interface-set-name> <client-type client-type> <count> <interface interface <accounting-statistics>> <logical-system logical-system> <mac-address mac-address> <physical-interface physical-interface-name> <profile-name profile-name> <routing-instance routing-instance> <stacked-vlan-id stacked-vlan-id> <subscriber-state subscriber-state> <user-name user-name> <vci vci-identifier> <vpi vpi-identifier> <vlan-id vlan-id>
Description
Display information for active subscribers.
Options
detail | extensive | terse | (Optional) Display the specified level of output. |
address | (Optional) Display subscribers whose IP address matches the specified address. You must specify the IPv4 or IPv6 address prefix without a netmask (for example, 192.0.2.0). If you specify the IP address as a prefix with a netmask (for example, 192.0.2.0/32), the router displays a message that the IP address is invalid, and rejects the command. |
accounting-statistics id session-id |
(Optional) Display accurate subscriber accounting statistics
for a subscriber session with the specified ID. Requires
the |
agent-circuit-identifier | (Optional) Display all dynamic subscriber sessions whose ACI value matches the specified string. You can specify either the complete ACI string or a substring. To specify a substring, you must enter characters that form the beginning of the string, followed by an asterisk (*) as a wildcard to substitute for the remainder of the string. The wildcard can be used only at the end of the specified substring; for example: user@host1> show subscribers agent-circuit-identifier substring* |
agent-remote-identifier | (Optional) Display all dynamic subscriber sessions whose ARI value matches the specified string. You must specify the complete ACI string; you cannot specify a wildcard. |
aggregation-interface-set-name interface-set-name | (Optional) Display summary information for the specified aggregation node interface set, including interface, VLAN ID, username and LS:RI. |
client-type | (Optional) Display subscribers whose client type matches one of the following client types:
|
count | (Optional) Display the count of total subscribers and active subscribers for any specified option. You can use the |
id session-id | (Optional) Display a specific subscriber session whose session ID matches the specified subscriber ID. You can display subscriber IDs by using the |
interface | (Optional) Display subscribers whose interface matches the specified interface. |
interface accounting-statistics | (Optional) Display subscriber accounting statistics for the specified interface. Requires the |
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. |
physical-interface-name | (Optional) Display subscribers whose physical interface matches the specified physical interface. |
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. |
stacked-vlan-id | (Optional) Display subscribers whose stacked VLAN ID matches the specified stacked VLAN ID. |
subscriber-state | (Optional) Display subscribers whose subscriber state matches the specified subscriber state (ACTIVE, CONFIGURED, INIT, TERMINATED, or TERMINATING). |
user-name | (Optional) Display subscribers whose username matches the specified subscriber name. |
vci-identifier | (Optional) Display active ATM subscribers whose ATM virtual circuit identifier (VCI) matches the specified VCI identifier. The range of values is 0 through 255. |
vpi-identifier | (Optional) Display active ATM subscribers whose ATM virtual path identifier (VPI) matches the specified VPI identifier. The range of values is 0 through 65,535. |
vlan-id | (Optional) Display subscribers whose VLAN ID 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 |
Because of display limitations, logical system and routing instance output values are truncated when necessary.
Required Privilege Level
view
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.
Field Name |
Field Description |
---|---|
|
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. |
|
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 an L2TP tunnel-switched session. For these subscriber sessions the value is |
|
Name of subscriber. |
|
Logical system and routing instance associated with the subscriber. |
|
Subscriber client type (DHCP, FWA, GRE, L2TP, PPP, PPPoE, STATIC-INTERFACE, VLAN). |
|
Subscriber IPv4 address. |
|
Subscriber IP netmask. This field displays 255.255.255.255 by default. For tunneled or terminated PPP subscribers only, this field displays the actual value of Framed-IP-Netmask when the SDB_FRAMED_PROTOCOL attribute in the session database is equal to AUTHD_FRAMED_PROTOCOL_PPP. This occurs in the use case where the LNS generates access-internal routes when it receives Framed-IP-Netmask from RADIUS during authorization. When it receives Framed-Pool from RADIUS, the pool mask is ignored and the default /32 mask is used. |
|
IP address of primary DNS server. This field is displayed with the |
|
IP address of secondary DNS server. This field is displayed with the |
|
IPv6 address of primary DNS server. This field is displayed with the |
|
IPv6 address of secondary DNS server. This field is displayed with the |
|
IP addresses for the DNS server, displayed in order of configuration. This field is displayed with the |
|
IPv6 addresses for the DNS server, displayed in order of configuration. This field is displayed with the |
|
IP address of primary WINS server. |
|
IP address of secondary WINS server. |
|
Subscriber IPv6 address, or multiple addresses. |
|
Subscriber IPv6 prefix. If you are using DHCPv6 prefix delegation, this is the delegated prefix. |
|
IPv6 prefix obtained through NDRA. |
|
Subscriber IPv6 address pool. The IPv6 address pool is used to allocate IPv6 prefixes to the DHCPv6 clients. |
|
Length of the network portion of the IPv6 address. |
|
Length of the subscriber IPv6 prefix. |
|
Logical system associated with the subscriber. |
|
Routing instance associated with the subscriber. |
|
(Enhanced subscriber management for MX Series routers) Name of the enhanced subscriber management logical interface, in the form |
|
Whether the subscriber interface is |
|
Internally generated name of the dynamic ACI or ALI interface set used by the subscriber session. The prefix of the name indicates the string received in DHCP or PPPoE control packets on which the interface set is based. For ALI interface sets, the prefix indicates that the value is configured as a trusted option to identify the subscriber line. The name of the interface set uses one of the following prefixes:
Note:
ACI interface sets are configured with the Besides dynamic ACI and ALI interface sets, this field can be an interface set based on a substring of the ARI string. This occurs when the dynamic profile includes the predefined variable $junos-pon-id-interface-set-name, and the profile is applied for a passive optical network (PON). The ARI string is inserted by the optical line terminal (OLT). The final substring in the string, unique for the PON, identifies individual subscriber circuits, and is used as the name of the interface set. |
|
Interface type of the ACI interface set: |
|
Identifier of the dynamic ACI interface set entry in the session database. |
|
Name of the underlying interface for the subscriber session. |
|
Dynamic profile used for the subscriber. |
|
Version number of the dynamic profile used for the subscriber. |
|
MAC address associated with the subscriber. |
|
Current state of the subscriber session ( |
|
Current state of the L2TP session, |
|
Name of the L2TP tunnel switch profile that initiates tunnel switching. |
|
IP address of the local gateway (LAC). |
|
IP address of the remote peer (LNS). |
|
Forwarding flow identifier. |
|
VLAN ID associated with the subscriber in the form tpid.vlan-id. |
|
Stacked VLAN ID associated with the subscriber in the form tpid.vlan-id. |
|
RADIUS accounting ID associated with the subscriber. |
|
For the For the |
|
For the For the |
|
Value of the $junos-aggregation-interface-set-name predefined variable; one of the following:
|
|
Actual transmitted subscriber accounting statistics by session ID or interface. Service accounting statistics are not included. These statistics do not include overhead bytes or dropped packets; they are the accurate statistics used by RADIUS. The statistics are counted when the |
|
IP address used by the DHCP relay agent. |
|
Date and time at which the subscriber logged in. |
|
|
|
|
|
|
|
|
|
Actual downstream traffic shaping rate for the subscriber, in kilobits per second. |
|
Input service set in access dynamic profile. |
|
Output service set in access dynamic profile. |
|
PCEF profile in access dynamic profile. |
|
PCC rule or rulebase used in dynamic profile. |
|
Values for variables that are passed into the dynamic profile from RADIUS. |
|
Time at which the first family in this service became active. |
|
Name of the filter applied by the dynamic profile to IPv4 packets that fail the RPF check. |
|
Name of the filter applied by the dynamic profile to IPv6 packets that fail the RPF check. |
|
|
|
ID number for a subscriber session. |
|
For DHCPv6 subscribers on a PPPoE network, displays the session ID of the underlying PPPoE interface. |
|
Number of service sessions (that is, a service activated using RADIUS CoA) associated with the subscribers. |
|
ID number for a subscriber service session. |
|
Service session profile name. |
|
Number of seconds of access provided to the subscriber before the session is automatically terminated. |
|
Number of seconds subscriber can be idle before the session is automatically terminated. |
|
Name of the pool used for DHCPv6 prefix delegation. |
|
Length of the prefix configured for the IPv6 delegated address pool. |
|
Address assigned by the Framed-Ipv6-Prefix AAA attribute. This field is displayed only when the predefined variable $junos-ipv6-address is used in the dynamic profile. |
|
Interface ID assigned by the Framed-Interface-Id AAA attribute. |
|
Name assigned to the Ascend-Data-Filter (ADF) interface IPv4 input filter (client or service session). The filter name is followed by the rules (in hexadecimal format) associated with the ADF filter and the decoded rule in Junos OS filter style. |
|
Name assigned to the Ascend-Data-Filter (ADF) interface IPv4 output filter (client or service session). The filter name is followed by the rules (in hexadecimal format) associated with the ADF filter and the decoded rule in Junos OS filter style. |
|
Name assigned to the Ascend-Data-Filter (ADF) interface IPv6 input filter (client or service session). The filter name is followed by the rules (in hexadecimal format) associated with the ADF filter and the decoded rule in Junos OS filter style. |
|
Name assigned to the Ascend-Data-Filter (ADF) interface IPv6 output filter (client or service session). The filter name is followed by the rules (in hexadecimal format) associated with the ADF filter and the decoded rule in Junos OS filter style. |
|
Name assigned to the IPv4 input filter (client or service session). |
|
Name assigned to the IPv4 output filter (client or service session). |
|
Name assigned to the IPv6 input filter (client or service session). |
|
Name assigned to the IPv6 output filter (client or service session). |
|
Name assigned to the logical interface input filter (client or service session). |
|
Name assigned to the logical interface output filter (client or service session). |
|
PPPoE subscriber’s access line type reported by the PPPoE intermediate agent in a PADI or PADO packet in the Vendor-Specific-Tags TLV in subattribute DSL-Type (0x0091). The DSL type is one of the following types: |
|
Mode type of the PPPoE subscriber’s access line determined by the PPPoE daemon based on the received subattribute DSL-Type (0x0091):
The value is stored in the subscriber session database. |
|
Number of bytes added to or subtracted from the actual downstream cell or frame overhead to account for the technology overhead of the DSL line type. The value is determined by the PPPoE daemon based on the received subattribute DSL-Type (0x0091). The value is stored in the subscriber session database. |
|
Unadjusted upstream data rate for the PPPoE subscriber’s access line reported by the PPPoE intermediate agent in a PADI or PADO packet in the Vendor-Specific-Tags TLV in subattribute Actual-Net-Data-Rate-Upstream (0x0081). |
|
Unadjusted downstream data rate for the PPPoE subscriber’s access line reported by the PPPoE intermediate agent in a PADI or PADO packet in the Vendor-Specific-Tags TLV in subattribute Actual-Net-Data-Rate-Downstream (0x0082). |
|
Adjusted downstream data rate for the PPPoE subscriber’s access line, calculated by the PPPoE daemon and stored in the subscriber session database. |
|
Adjusted upstream data rate for the PPPoE subscriber’s access line, calculated by the PPPoE daemon and stored in the subscriber session database. |
|
Tunnel endpoint identifier on the BNG for the GTP-U user plane tunnel to the eNodeB. The identifier is allocated by the BNG. A fully qualified local TEID-C consists of this identifier and the |
|
Tunnel endpoint identifier on the BNG for the GTP-C control plane tunnel to the MME. The identifier is allocated by the BNG. A fully qualified local TEID-C consists of this identifier and the |
|
Tunnel endpoint identifier on the eNodeB for the GTP-U user plane tunnel to the BNG. The identifier is allocated by the eNodeB. A fully qualified remote TEID-U consists of this identifier and the |
|
Tunnel endpoint identifier on the MME for the GTP-C control plane tunnel to the BNG. The identifier is allocated by the MME. A fully qualified remote TEID-C consists of this identifier and the |
|
IP address of the S1-U interface on the eNodeB for the GTP-U tunnel endpoint. A fully qualified remote TEID-U consists of this address and the |
|
IP address of the S1-U interface on the BNG for the GTP-U tunnel endpoint. A fully qualified local TEID-U consists of this address and the |
|
IP address of the S11 interface on the MME for the GTP-C tunnel endpoint. A fully qualified remote TEID-C consists of this address and the |
|
IP address of the S11 interface on the BNG for the GTP-C tunnel endpoint. A fully qualified local TEID-C consists of this address and the |
|
Access point name (APN) for the user equipment. The APN corresponds to the connection and service parameters that the subscriber’s mobile device can use for connecting to the carrier’s gateway to the Internet. |
|
Name of the tenant system. You can create multiple tenant system administrators for a tenant system with different permission levels based on your requirements. |
User Plane id |
ID number for the BNG User Plane that the subscriber belongs to. |
User Plane Name |
Name of the BNG User Plane that the subscriber belongs to. |
|
Name of the routing instance. When a custom routing instance is created for a tenant system, all the interfaces defined in that tenant system are added to that routing instance. |
|
Configured name for a specific variation of a base dynamic profile. IT’s presence indicates that the profile configuration is different from that of the base profile. The value is conveyed to the RADIUS server during authentication in the Client-Profile-Name VSA (26–4874–174). |
Sample Output
- show subscribers detail (DHCP)
- show subscribers accounting-statistics id
- show subscribers client-type (PPPoE)
- show subscribers client-type (DHCP)
show subscribers detail (DHCP)
user@host> show subscribers detail Type: DHCP IP Address: 16.0.0.2 IP Netmask: 255.0.0.0 Logical System: default Routing Instance: default User Plane ID: 1 Interface: up:green-arrow:demux0.3221225474 Interface type: Dynamic Underlying Interface: up:green-arrow:ge-0/3/5.2 Dynamic Profile Name: client-dhcp-demux MAC Address: 00:00:64:03:01:02 State: Active Radius Accounting ID: 8 Session ID: 8 PFE Flow ID: 12 VLAN Id: 10 Login Time: 2022-02-23 22:35:35 UTC DHCP Options: len 3 35 01 01 DHCP Header: len 44 01 01 06 00 dd 7d 5a 46 00 00 80 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 64 03 01 02 00 00 00 00 00 00 00 00 00 00 Type: DHCP IPv6 Address: 1000::3 Logical System: default Routing Instance: default User Plane ID: 1 Interface: up:green-arrow:demux0.3221225475 Interface type: Dynamic Underlying Interface: up:green-arrow:ge-0/3/5.2 Dynamic Profile Name: client-dhcp-demux MAC Address: 00:00:64:03:01:02 State: Active Radius Accounting ID: 9 Session ID: 9 PFE Flow ID: 13 VLAN Id: 10 Login Time: 2022-02-23 22:35:44 UTC DHCPV6 Options: len 42 00 08 00 02 00 00 00 01 00 0a 00 03 00 01 00 00 64 03 01 02 00 06 00 02 00 03 00 03 00 0c 00 00 00 00 00 00 00 00 00 00 00 00 DHCPV6 Header: len 4 01 03 00 00
show subscribers accounting-statistics id
user@host> show subscribers accounting-statistics id 206 Session ID: 206 Interface: pp0.3221225677 Accounting Statistics Input bytes: 0 Input packets: 0 Output bytes: 0 Output packets: 0 IPv6 Input bytes: 0 Input packets: 0 Output bytes: 0 Output packets: 0
show subscribers client-type (PPPoE)
user@host> show subscribers client-type pppoe Interface IP Address/VLAN ID User Name LS:RI up:green-arrow:pp0.3221225473 100.16.0.2 user-example-1 default:default * 1000::2
show subscribers client-type (DHCP)
user@host> show subscribers client-type pppoe Interface IP Address/VLAN ID User Name LS:RI up:green-arrow:demux0.3221225474 16.0.0.2 default:default up:green-arrow:demux0.3221225475 1000::3 default:default