Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 

show unified-edge tdf subscribers

 

Syntax

Release Information

Statement introduced in Junos OS Release 17.1.

Description

Display the subscriber information for one or more TDF gateways. If a TDF gateway is not specified, then subscriber information for all TDF gateways is displayed.

Options

none(Same as brief) Display subscriber information in brief for all TDF gateways.
brief | detail | extensive(Optional) Display the specified level of output.
business-subscribers(Optional) Display subscriber information for only enterprise business subscribers (subscribers whose IPv4 prefix length is less than 32).
data-plane(Optional) Display subscriber information for the data plane.
domain domain-name(Optional) Display subscriber information for the specified TDF domain.
fpc-slot fpc-slot(Optional) Display subscriber information for the specified FPC slot number.
gateway gateway(Optional) Display subscriber information for the specified TDF gateway.
pdn-type (ipv4 | ipv4-v6 | ipv6)(Optional) Display subscriber information according to the type of Packet Data Network (PDN): IPv4, IPv6, and both IPv4 and IPv6.
pic-slot pic-slot(Optional) Display subscriber information for the specified PIC slot number. You must first specify an FPC slot number before specifying the PIC slot number.
routing-instance routing-instance(Optional) Display subscriber information for the specified routing instance.
stuck(Optional) Display subscribers for the TDF gateway that are not logged in successfully and are in a blocked state.
subscriber-name subscriber-name(Optional) Display subscriber information for the specified IFL-based subscriber.
v4-addr v4-addr(Optional) Display subscriber information for the specified IPv4 address of the subscriber’s user equipment.
v6-addr v6-addr(Optional) Display subscriber information for the specified IPv6 address of the subscriber’s user equipment.

Required Privilege Level

view

List of Sample Output

show unified-edge tdf subscribers (IP-Based Subscriber)

show unified-edge tdf subscribers (IFL-Based Subscriber)

show unified-edge tdf subscribers extensive

show unified-edge tdf subscribers detail

show unified-edge tdf subscribers data-plane

Output Fields

Table 1 lists the output fields for the show unified-edge tdf subscribers command. Output fields are listed in the approximate order in which they appear.

Table 1: show unified-edge tdf subscribers Output Fields

Field Name

Field Description

Level of Output

Gateway

Name of the TDF gateway.

All levels

none

MSISDN/Name

MSISDN number of the IP-based subscriber’s user equipment.

brief

none

V4 Address

IPv4 address of the IP-based subscriber.

brief

none

V6 Address

IPv6 address, if any, of the IP-based subscriber. Otherwise, None is displayed.

brief

none

NAS-IP-Address

IP address to be used for the NAS IP address attribute of the IP-based subscriber when sending the requests to the RADIUS server.

brief

none

Domain

TDF domain, on the TDF gateway, to which the subscriber is attached.

brief

none

IFL-Subscriber-Name

Name of the IFL-based subscriber.

brief

none

Subscriber Information

Subscriber Type

Type of subscriber:

  • IFL—Interface-based subscriber.

  • IP—IP-based subscriber.

detail

extensive

IMSI

IMSI of the IP-based subscriber’s user equipment.

detail

extensive

none

IMEI

International Mobile Station Equipment Identity (IMEI) of the IP-based subscriber’s user equipment.

detail

extensive

MSISDN/Username

MSISDN number of the IP-based subscriber’s user equipment.

detail

extensive

Subscriber Name

Name of the IFL-based subscriber.

detail

extensive

State

State of the subscriber session on the signaling plane.

detail

extensive

Session Duration

Duration of the PDP session.

detail

extensive

Domain

Name of the TDF domain that is used to establish the session on the TDF gateway for the subscriber.

detail

extensive

Data VRF

Name of the data plane VRF.

detail

extensive

TDF domain Name

Unique identifier that denotes the TDF domain to be used for the subscriber’s session. This setting is applicable only when the domain specified in the Create Session Request message from the subscriber is virtual.

detail

extensive

NAS-IP-Addr

IP address to be used for the NAS IP address attribute of the IP-based subscriber when sending the requests to the RADIUS server.

detail

extensive

APN name

Name of the APN for the IP-based subscriber that is denoted by a unique identifier.

detail

extensive

V4 Address

IPv4 address of the IP-based subscriber.

detail

extensive

V4 Prefix Length

IPv4 prefix length of the IP-based subscriber’s IPv4 address. This is displayed only if the length is less than 32.

detail

extensive

data-plane

V6 Address

IPv6 address of the IP-based subscriber, if any. Otherwise, None is displayed.

detail

extensive

V6 Prefix Length

IPv6 prefix length of the IP-based subscriber’s IPv6 address.

detail

Session PIC

FPC and PIC slots for the session PIC on which the subscriber control session is present.

detail

extensive

Service PIC

FPC and PIC slots for the service PIC on which the subscriber control session is present.

detail

extensive

PCRF Event Triggers

Policy and charging rules function (PCRF) event triggers, if any. If no trigger is configured, None is displayed. The notation used for the event triggers displayed in the output and the corresponding event triggers as per the 3GPP specifications are as follows:

  • SGSN—SGSN CHANGE (0)

  • QoS—QOS CHANGE (1)

  • RAT—RAT CHANGE (2)

  • TFT—TFT CHANGE (3)

  • PLMN—PLMN CHANGE (4)

  • BL—subscriber LOSS (5)

  • BR—subscriber RECOVERY (6)

  • IPCAN—IPCAN CHANGE (7)

  • EAUTH—EXCEEDING AUTH (11)

  • RAI—RAI CHANGE (12)

  • ULI—ULI CHANGE (13)

  • NET—NO EVENT TRIGGERS (14)

  • OOC—OUT OF CREDIT (15)

  • ROC—REALLOCATION OF CREDIT (16)

  • REVALIDATION_TIMEOUT—REVALIDATION TIMEOUT (17)

  • IP ALLOC—UE_IP_ADDRESS_ALLOCATE (18)

  • IP RELEASE—UE_IP_ADDRESS_RELEASE (19)

  • DEFAULT QoS—DEFAULT QoS (20)

  • GW—AN GW CHANGE (21)

  • RA—RESOURCE_ALLOCATION (22)

  • RM—RESOURCE_MODIFICATION (23)

  • TRACE—PGW TRACE CONTROL (24)

  • TZ —UE_TZ_CHANGE (25)

  • TAI—TAI CHANGE (26)

  • ECGI—ECGI CHANGE (27)

  • CCE—CHARGING CORRELATION EXCHANGE (28)

  • AMBR—AMBR CHANGE (29)

  • UCIC—USR CSG INFO CHANGE (30)

  • QMF—QoS MODIFICATION FAILURE (31)

  • UR—USAGE REPORT (33)

detail

extensive

Revalidation due in

Time remaining in days, hours, minutes, and seconds until PCEF session revalidation takes place if the REVALIDATION_TIMEOUT event trigger is armed. Otherwise N/A is displayed.

detail

extensive

Idle Timeout

Idle timeout for the session, in minutes.

detail

extensive

Subscriber MBR

TDF subscriber maximum bit rate (MBR) for uplink and downlink traffic. Uplink traffic originates from the subscriber towards the public data network (PDN), and downlink traffic comes from the PDN and is destined for the subscriber.

detail

extensive

Subscriber burst

TDF subscriber burst size configured for uplink and downlink traffic. Uplink traffic originates from the subscriber towards the PDN, and downlink traffic comes from the PDN and is destined for the subscriber.

detail

extensive

Access IFL List

The following is displayed for each interface assigned to an IFL-based subscriber:

  • Name—Name of the interface.

  • Index—Index number of the interface.

  • State—Operational state of the interface: Active or Inactive.

PCC Profile Name

Name of the PCEF profile that is assigned to the subscriber.

detail

extensive

Usage Monitoring Information

The following is displayed for each monitoring key, which corresponds to a data set that is being monitored for the subscriber:

  • Monitoring Key—Identifier for the monitoring key.

  • Level—Indication of whether the monitoring key applies to particular PCC rules (Rule) or to the entire TDF subscriber session (Session).

  • Status—Indication of whether monitoring with the key is active or inactive.

  • Total Available Quota—Volume and time quota sent from the PCRF to indicate when a report should be sent to the PCRF. A value of zero indicates that the field is not applicable to the key.

    • Input—Uplink traffic volume quota.

    • Output—Downlink traffic volume quota.

    • Total—Uplink and downlink traffic volume quota.

    • Time—Time quota, in seconds.

detail

extensive

PCC Rule Information

Note: Both ePCC rules and PCC rules appear under PCC Rule Information. Fields that apply only to ePCC rules are identified in the description.

The following information for each PCC or ePCC rule is displayed per subscriber:

  • Rule Name—Name of the rule. In addition, the following is displayed:

    • Type—Rrule type: Static or Dynamic.

    • Associated Rule Base—Rule set with which the rule is associated, if any.

    • Precedence—Rule precedence, which defines the order in which the policy is applied for incoming or outgoing packets; the lower the number, the higher its precedence.

    • Activation due in—Day, time, or both at which the rule is scheduled for activation for the subscriber. If activation/deactivation settings have not been applied to the rule, then N/A appears.

    • Deactivation due in—Day, time, or both at which the rule is scheduled for deactivation for the subscriber. If activation/deactivation settings have not been applied to the rule, then N/A appears.

    • Status—Rule status: Initialized, Active, Inactive, or Removal Pending.

    • Application Id—(ePCC rules only) Name of the application identification parameter associated with the rule.

    • Application Id Base–(ePCC rules only) Name of the base application that serves as the primary application identification service if a group or cluster are configured.

    • Mute Notification—(ePCC rules only) Whether the Mute-Notification AVP is included in the rule.

  • QoS Parameters—The following QoS attributes are displayed for each rule per subscriber:

    • MBR Uplink (kbps)—Maximum bit rate (MBR) in the uplink direction, in kbps. Identifier.

    • MBR Downlink (kbps)—MBR in the downlink direction, in kbps.

    • Burst size Uplink (bytes)—TDF domain’s default TDF subscriber burst size configured for uplink traffic, in bytes.

    • Burst size Downlink (bytes)—TDF domain’s default TDF subscriber burst size configured for downlink traffic, in bytes. Uplink traffic originates from the subscriber towards the public data network (PDN), and downlink traffic comes from the PDN and is destined for the subscriber.

  • Charging Attributes—The following charging attributes are displayed for each rule per subscriber:

    • Rating Group—Rating group for the rule.

    • Service Id—Service ID for the rule.

    • Gating Status—Whether the flow is enabled or not. One of the following:

      • enable-uplink

      • enable-downlink

      • enable-both

      • disable-both

    • AF Charging Id—Application function record information, which contains an octet string and the charging ID.

    • Charging Method—Charging method for the rule (none, offline, offline-online, or online).

    • Metering Method—Charging metering method for the rule:

      • Time—Time based.

      • Volume—Volume based.

      • Volume-Time—Both volume and time based.

      • None—No metering.

    • Usage Monitoring Key—Monitoring key that is associated with the rule.

  • Services Attributes—The following information about resource management and steering is displayed for the subscribers connected to the TDF gateway or the TDF domain:

    • Steering IP—IPv4 or IPv6 address for HTTP steering of the packets.

    • Keep existing steering—Whether existing steering is enabled or disabled.

    • Service Chain VRF—Routing instance for steering of packets. Use this to steer traffic to either a local service chain or external service chain.

    • Forwarding Class—Forwarding class that needs to be assigned to the packet.

    • HCM ID—Profile that identifies the HTTP header enrichment rules to apply. This action is restricted to PCC rules that are only matching HTTP-based applications.

    • LRF ID—Unique ID of the Location Retrieval Function

  • Filter Attributes—The following filter attributes are displayed per filter in each rule:

    • Remote IP/Mask—Remote IP address and subnet mask of the filter.

    • Protocol—Protocol configured for the filter. If all protocols are supported for the filter, Any is displayed. For the explanation of what the numbers represent, refer to the 3GPP specifications.

    • Direction—Direction in which the filter is applicable (Downlink, Uplink, or Both).

    • Local Ports—Local ports or port range for the filter. Any indicates that the filter does not restrict the local ports.

    • Remote Ports—Remote ports or port range for the filter. Any indicates that the filter does not restrict the remote ports.

    • Application Name—(ePCC rules only) Name of the predefined or custom application signature.

detail

extensive

Data Plane statistics

The following information about packets processed by the data plane for subscribers connected to the TDF domains in the TDF gateway:

  • Subscriber-Name—Name of the IFL-based subscriber.

  • V4 Address—IPv4 address of the IP-based subscriber.

  • V6 Address—IPv6 address of the IP-based subscriber.

  • V6 Prefix Length—IPv6 prefix length of the IP-based subscriber’s IPv6 address.

  • Vrf Id—Name of the data plane VRF.

  • Subscriber Stats—Total statistics for the subscriber.

  • Rule—Statistics for traffic that was handled by the specified PCC rule.

  • Uplink—Statistics for traffic in the uplink direction from the TDF gateway to the PDN (Internet).

  • Downlink—Statistics for traffic in the downlink direction from the PDN (Internet) to the TDF gateway.

  • Sessions—Number of sessions in the uplink and downlink direction.

  • Packets—Number of packets forwarded in the uplink direction and in the downlink direction.

  • Bytes—Number of bytes forwarded in the uplink direction and in the downlink direction.

  • Dropped Packets—Number of packets dropped in the uplink direction and in the downlink direction.

  • Dropped Bytes—Number of bytes dropped in the uplink direction and in the downlink direction.

data-plane option

Sample Output

show unified-edge tdf subscribers (IP-Based Subscriber)

user@host> show unified-edge tdf subscribers

show unified-edge tdf subscribers (IFL-Based Subscriber)

user@host> show unified-edge tdf subscribers

show unified-edge tdf subscribers extensive

user@host> show unified-edge tdf subscribers extensive

show unified-edge tdf subscribers detail

user@host> show unified-edge tdf subscribers detail

show unified-edge tdf subscribers data-plane

user@host> show unified-edge tdf subscribers data-plane