Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
ON THIS PAGE
 

Juniper BNG CUPS CLI Operational Commands

This topic provides an overview of clear, request, restart, and show commands, including syntax, option descriptions, and sample output.

clear user-plane ipv6 router-advertisement

Syntax

Description

Clear IPv6 router advertisement counters.

Options

up-name user-plane-name Clear IPv6 router advertisement counters for the specified BNG User Plane.

Required Privilege Level

view

Output Fields

When you enter this command, you are provided feedback on the status of your request.

Sample Output

clear user-plane ipv6 router-advertisement up-name

clear user-plane pppoe lockout

Syntax

Description

Clear the lockout condition for the PPPoE client associated with the specified BNG User Plane.

Options

up-name user-plane-name Clear the lockout condition for the PPPoE clients associated with the specified BNG User Plane.

Required Privilege Level

clear

Sample Output

clear use-plane pppoe lockout up-name

clear user-plane pppoe statistics

Syntax

Description

Reset PPPoE session statistics information.

Options

up-name user-plane-name Reset PPPoE statistics for the specified BNG User Plane.

Required Privilege Level

clear

Output Fields

When you enter this command, you are provided feedback on the status of your request.

Sample Output

clear user-plane pppoe statistics up-name

clear user-plane statistics

Syntax

Description

Clear subscriber-management statistics.

Options

up-name user-plane-name Clear subscriber-management statistics for the specified BNG User Plane.

Required Privilege Level

view and system

Output Fields

When you enter this command, you are provided feedback on the status of your request.

Sample Output

clear user-plane statistics up-name

request network-access aaa address-assignment domain-profile

Syntax

Description

Enable or disable logins for existing domains created from the domain profile and to control the creation of new domains from the domain profile.

Options

ri-name routing-instance-name

Specify the routing instance name.

profile-name profile-name

Specify the name of the profile.

[enable-logins | disable-logins]

Specify the desired action for enabling logins.

Required Privilege Level

root

Output Fields

When you enter this command, you receive feedback only if an error occurs.

request network-access aaa address-assignment subscriber-group

Syntax

Description

Enable or disable logins for a particular subscriber group.

Options

subscriber-group-name

Specify the name of the subscriber group.

[enable-logins | disable-logins]

Specify the desired action for enabling logins.

Required Privilege Level

root

Output Fields

When you enter this command, you receive feedback only if an error occurs.

request network-access aaa address-assignment user-plane

Syntax

Description

Enable or disable logins for subscribers originating from the specified BNG User Plane. When you use this command, you effectively enable or disable logins for existing domains associated with the BNG User Plane. You also control the creation of new domains for the BNG User Plane.

Options

user-plane user-plane-name Specify the BNG User Plane name.
[enable-login | disable-login] Specify the desired action.

Required Privilege Level

root

Output Fields

When you enter this command, you receive feedback only if an error occurs.

request subscriber-group switchover

Syntax

Description

Used to activate or deactivate a subscriber group on a BNG User Plane. You use this command to switch between active and backup BNG User Planes. This command runs on the BNG CUPS Controller.

Options

subscriber-group-name

Specify the subscriber group name that you want to make the active BNG User Plane.

Required Privilege Level

root

Output Fields

When you enter this command, you receive feedback only if an error occurs.

request user-plane maintenance associate serviced-user-plane

Syntax

Description

Creates a backup of a BNG User Plane. You can run this command multiple times for each logical port active and backup pair.

Options

serviced-user-plane user-plane-name

Specify the serviced BNG User Plane name.

serviced-port port-number

Specify the serviced port number.

backup-user-plane user-plane-name

Specify the backup BNG User Plane name.

backup-port port-number

Specify the backup port number.

Required Privilege Level

root

Output Fields

When you enter this command, you receive feedback only if an error occurs.

request user-plane maintenance complete serviced-user-plane

Syntax

Description

Completes the maintenance operation for a BNG User Plane. The command ensures that all resources that were used for the maintenance operation are restored.

Options

serviced-user-plane user-plane-name

Specify the BNG User Plane name that was serviced as part of the maintenance operation.

Required Privilege Level

root

Output Fields

When you enter this command, you receive feedback only if an error occurs.

request user-plane maintenance disassociate serviced-user-plane

Syntax

Description

Remove the active and backup BNG User Plane association and remove the database synchronization.

Options

serviced-user-plane user-plane-name

Specify the serviced BNG User Plane name.

serviced-port port-number

Specify the serviced port number.

backup-user-plane user-plane-name

Specify the backup BNG User Plane name.

backup-port port-number

Specify the backup port number.

Required Privilege Level

root

Output Fields

When you enter this command, you receive feedback only if an error occurs.

request user-plane maintenance switchover serviced-user-plane

Syntax

Description

Switch the role of the active and the backup BNG User Planes for the logical port pairing.

Options

serviced-user-plane user-plane-name

Specify the serviced BNG User Plane name.

Required Privilege Level

root

Output Fields

When you enter this command, you receive feedback only if an error occurs.

request user-plane manager restart up-name

Syntax

Description

Restart the managing SMD service instance on the BNG CUPS Controller associated to the specified BNG User Plane.

Options

up-plane bng-user-plane-name The BNG User Plane for which you want to restart the managing SMD service instance on its associated BNG CUPS Controller.

Required Privilege Level

view

Output Fields

When you enter this command, you receive feedback only if an error occurs.

Sample Output

request user-plane manager restart up-name

restart bbe-cpm-daemon

Syntax

Description

Restarts the Control Plane Manager daemon.

Options

This command does not have any options.

Required Privilege Level

root

Output Fields

When you enter this command, you receive feedback on the status of your request. This command runs on the BNG CUPS Controller.

Sample Output

restart bbe-cpm-daemon

restart bbe-stats-daemon

Syntax

Description

Restarts the Enhanced Session Management Statistics daemon.

Options

This command does not have any options.

Required Privilege Level

root

Output Fields

When you enter this command, you receive feedback on the status of your request. This command runs on the BNG CUPS Controller.

Sample Output

restart bbe-stats-daemon

restart bbe-stats-svcsd

Syntax

Description

Restarts the Statistics Services daemon.

Options

This command does not have any options.

Required Privilege Level

root

Output Fields

When you enter this command, you receive feedback on the status of your request. This command runs on the BNG User Planes.

Sample Output

restart bbe-stats-svcsd

restart bbe-upm-daemon

Syntax

Description

Restarts the User Plane Manager daemon. This command runs on the BNG CUPS Controller.

Options

This command does not have any options.

Required Privilege Level

root

Output Fields

When you enter this command, you receive feedback on the status of your request.

Sample Output

restart bbe-upm-daemon

restart bbe-upsf-daemon

Syntax

Description

Restarts the User Plane Selection Function daemon. This command runs on the BNG CUPS Controller.

Options

This command does not have any options.

Required Privilege Level

root

Output Fields

When you enter this command, you receive feedback on the status of your request.

Sample Output

restart bbe-upsf-daemon

restart cp-smg-server

Syntax

Description

Restarts the Enhanced Session Management BNG CUPS Controller process. This command runs on the BNG CUPS Controller.

Options

This command does not have any options.

Required Privilege Level

root

Output Fields

When you enter this command, you receive feedback on the status of your request.

Sample Output

restart cp-smg-server

restart replication-client-process

Syntax

Description

Restarts the Replication Client Process. A BNG User Plane hosts the Replication Client Process daemon and the Replication Server Process daemon. These daemons replicate the state between the BNG CUPS Controller and the BNG User Plane and the routing engines. This command runs on the BNG CUPS Controller.

Avoid using this command unless Juniper Networks Technical Assistance Center (JTAC) directs you to use it.

Options

This command does not have any options.

Required Privilege Level

root

Output Fields

When you enter this command, you receive feedback on the status of your request.

Sample Output

restart replication-client-process

restart replication-server-process

Syntax

Description

Restarts the Replication Server Process. A BNG User Plane hosts the Replication Client Process daemon and the Replication Server Process daemon. These daemons replicate the state between the BNG CUPS Controller and the BNG User Plane and the routing engines. This command runs on the BNG CUPS Controller.

Avoid using this command unless Juniper Networks Technical Assistance Center (JTAC) directs you to use it.

Options

This command does not have any options.

Required Privilege Level

root

Output Fields

When you enter this command, you receive feedback on the status of your request.

Sample Output

restart replication-server-process

restart up-helper-service

Syntax

Description

Restarts the Enhanced BBE Helper BNG User Plane process. This command runs on the BNG User Plane.

Options

This command does not have any options.

Required Privilege Level

root

Output Fields

When you enter this command, you receive feedback on the status of your request.

Sample Output

restart up-helper-service

show broadband-device

Syntax

Description

Displays information for a broadband edge device.

Options

interface

Displays information for a the specified BBE device interface.

detail Displays detailed information for all BBE devices.
state Displays the state for each port on the BBE device.
summary Displays summary information for all BBE devices.

Required Privilege Level

root

Output Fields

Table 1 lists the output fields for the show broadband-device command.

Table 1: show broadband-device Output Fields

Field Name

Field Description

Interface BBE interface.

Name

BBE device name.

Port

The fully qualified BNG User Plane port name of the format up:user-plane-name:physical-port-name.

Sessions

The number of sessions.

SGRP

The subscriber group that the BBE device belongs to.

User Plane

The BNG User Planes that belong to the subscriber group.

Redundancy interface name

The redundancy-interface name containing the member BNG User Plane logical ports.

Subscriber Group

The subscriber group that the BBE device belongs to.

Session ID

Session identifier.

Sample Output

show broadband-device summary

show broadband-device interface

show firewall

Syntax

Description

When running the show firewall command on the BNG CUPS Controller, the output displays only the filter names and the associated BNG User Plane. No counters or other information appears. To see the counters or the log or syslog output, you must run the show firewall command on the appropriate BNG User Plane.

Options

filter filter-name

(Optional) Name of a configured filter.

filter regex regular-expression

(Optional) Regular expression that matches the names of a subset of filters.

terse

(Optional) Display firewall filter names and BNG User Plane names.

Required Privilege Level

view

Output Fields

Table 2 lists the output fields for the show firewall command. Output fields are listed in the approximate order in which they appear.

Table 2: show firewall Output Fields

Field Name

Field Description

Filter

Name of a filter that has been configured with the filter statement at the [edit firewall] hierarchy level

User Plane BNG User Plane name

Sample Output

show firewall terse

show health

Syntax

Description

Displays the health information about the BNG CUPS Controller subsystems or the overall health of the BNG User Planes.

Options

none

Displays health information for all BNG CUPS Controller subsystems.

subsystem micro-service-name Displays health information for the specified micro service.
service service-name Displays health information for the associated endpoints for the specified service that is part of the micro service. Not all services have associated endpoints..
user-plane user-plane-name Displays BNG User Plane health information.
endpoint endpoint-name Displays health information for the specified endpoint of the BNG User Plane.

Required Privilege Level

root

Output Fields

Table 3 lists the output fields for the show health command.

Table 3: show health

Field Name

Field Description

Name Depending on which show health command output you are viewing, the name field can be one of the following:
  • Subsystem name

  • BNG User Plane name

HealthBNG CUPS Controller subsystems

Health of the BNG CUPS Controller subsystem. Following are the health levels:

  • Healthy—All of the following must exist: All services are up, shared memory is healthy, initial state recovery succeeded, and all key endpoints are up.

  • Unhealthy-major—If any of the following exist: Any of the services are permanently down, shared memory is unhealthy, or the initial state recovery failed.

  • Unhealthy-minor—If any of the following exist: Any of the services are down, initial state recovery is in-progress, any one of the key endpoints are down.

Unhealty-services

The number of unhealthy services.

Uptime

The amount of time the service has been up.

Subsystem

The subsystem for which the information is being displayed.

Shared-memory

The health of the shared memory.

Initial State Recovery

Displays whether the initial state recovery succeeded.

Services

List of services for the subsystem.

Status

Current status of the service. Either up or down.

Restarts

The number of times the service restarted.

Endpoint-Health

The health of the endpoint for the service.

Unhealthy-Endpoints

The number of unhealthy endpoints for the service.

Key-Endpoints

List of key endpoints.

State (Key-Endpoints)

State of the key endpoint.

Flapped

The number of times the key endpoint flapped.

Memory Usage

Memory usage of the service.

CPU%

The percentage of CPU being used by the service.

HealthBNG User Plane

Health of the BNG User Plane. Following are the health levels:

  • Healthy—All of the following must exist: The state is connected or connecting, the corresponding smd-N service is up, and all of its associated endpoints are connected.

  • Unhealthy-major—If any of the following exist: The state is not connected or connecting, or security-updating and the corresponding smd-N service is down.

  • Unhealthy-minor—All of the following must exist: The state is either not connected, connecting, or security-updating, and the corresponding smd-N service is down, and any of its associated endpoints are disconnected.

Address

BNG User Plane IP address.

Active/Backup-sess

The number of active and backup subscriber sessions served by the BNG User Plane.

State (user-plane)

The state of the BNG User Plane. The state can be one of the following:

  • initializing

  • ready

  • connecting

  • connected

  • disconnecting

  • disconnected

  • security-updating

  • warm-init

  • deconfiguring

  • misconfigured

User-plane

The BNG User Plane for which the information is being reported.

Id

ID of the BNG User Plane.

CPi

The control plane instance that handling the BNG User Plane.

Active-sessions

The number of active subscriber sessions served by the BNG User Plane.

Backup-sesions

The number of backup subscriber sessions served by the BNG User Plane.

Sample Output

show health

show health subsystem

show health subsystem <micro-service-name> service

show health user-plane

show health user-plane

show health user-plane <user-plane-name> endpoint

show igmp group

Syntax

Description

Display Internet Group Management Protocol (IGMP) group membership information. This command runs on BNG User Planes.

Required Privilege Level

view

Output Fields

Table 4 describes the output fields for the show igmp group command. Output fields are listed in the approximate order in which they appear.

Table 4: show igmp group Output Fields

Field Name

Field Description

Interface

Name of the interface that received the IGMP membership report. A name of local indicates that the local routing device joined the group itself.

Group

Group address.

Group Mode

Mode the SSM group is operating in: Include or Exclude.

Source

Source address.

Source timeout

Time remaining until the group traffic is no longer forwarded. The timer is refreshed when a listener in include mode sends a report. A group in exclude mode or configured as a static group displays a zero timer.

Last reported by

Address of the host that last reported membership in this group.

Timeout

Time remaining until the group membership is removed.

Group timeout

Time remaining until a group in exclude mode moves to include mode. The timer is refreshed when a listener in exclude mode sends a report. A group in include mode or configured as a static group displays a zero timer.

Type

Type of group membership:

  • Dynamic—Host reported the membership.

  • Static—Membership is configured.

Sample Output

show igmp group

Release Information

Statement introduced in Juniper BNG CUPS Release 22.4R1.

show igmp statistics

Syntax

Description

Display Internet Group Management Protocol (IGMP) statistics.

By default, Junos OS multicast devices collect statistics of received and transmitted IGMP control messages that reflect currently active multicast group subscribers.

Some devices also automatically maintain continuous IGMP statistics globally on the device in addition to the default active subscriber statistics—these are persistent, continuous statistics of received and transmitted IGMP control packets that account for both past and current multicast group subscriptions processed on the device. With continuous statistics, you can see the total count of IGMP control packets the device processed since the last device reboot or clear igmp statistics continuous command. The device collects and displays continuous statistics only for the fields shown in the IGMP packet statistics output section of this command, and does not display the IGMP Global statistics section.

Devices that support continuous statistics maintain this information in a shared database and copy it to the backup Routing Engine at a configurable interval to avoid too much processing overhead on the Routing Engine. These actions preserve statistics counts across the following events or operations (which doesn’t happen for the default active subscriber statistics):

  • Routing daemon restart

  • Graceful Routing Engine switchover (GRES)

  • In-service software upgrade (ISSU)

  • Line card reboot

You can change the default interval (300 seconds) using the cont-stats-collection-interval configuration statement at the [edit routing-options multicast] hierarchy level.

You can display either the default currently active subscriber statistics or continuous subscriber statistics (if supported), but not both at the same time. Include the continuous option to display continuous statistics, otherwise the command displays the statistics only for active subscribers.

Run the clear igmp statistics command to clear the currently active subscriber statistics. On devices that support continuous statistics, run the clear command with the continuous option to clear all continuous statistics. You must run these commands separately to clear both types of statistics because the device maintains and clears the two types of statistics separately.

Note:

The show igmp statistics command runs on BNG User Planes.

Options

none

Display IGMP statistics for all interfaces. These statistics represent currently active subscribers.

brief | detail

(Optional) Display the specified level of output.

continuous

(Optional) Display continuous IGMP statistics that account for both past and current multicast group subscribers instead of the default statistics that only reflect currently active subscribers.

Required Privilege Level

view

Output Fields

Table 5 describes the output fields for the show igmp statistics command. Output fields are listed in the approximate order in which they appear.

Table 5: show igmp statistics Output Fields

Field Name

Field Description

IGMP packet statistics

Heading for IGMP packet statistics for all interfaces or for the specified interface name.

Note:

Shows currently active subscriber statistics in this section by default, or when the command includes the continuous option, shows continuous, persistent statistics that account for all IGMP control packets processed on the device.

IGMP Message type

Summary of IGMP statistics:

  • Membership Query—Number of membership queries sent and received.

  • V1 Membership Report—Number of version 1 membership reports sent and received.

  • DVMRP—Number of DVMRP messages sent or received.

  • PIM V1—Number of PIM version 1 messages sent or received.

  • Cisco Trace—Number of Cisco trace messages sent or received.

  • V2 Membership Report—Number of version 2 membership reports sent or received.

  • Group Leave—Number of group leave messages sent or received.

  • Mtrace Response—Number of Mtrace response messages sent or received.

  • Mtrace Request—Number of Mtrace request messages sent or received.

  • Domain Wide Report—Number of domain-wide reports sent or received.

  • V3 Membership Report—Number of version 3 membership reports sent or received.

  • Other Unknown types—Number of unknown message types received.

  • IGMP v3 unsupported type—Number of messages received with unknown and unsupported IGMP version 3 message types.

  • IGMP v3 source required for SSM—Number of IGMP version 3 messages received that contained no source.

  • IGMP v3 mode not applicable for SSM—Number of IGMP version 3 messages received that did not contain a mode applicable for source-specific multicast (SSM). Beginning with certain releases, this type includes records received for groups in the SSM range of addresses and in which the mode is MODE_IS_EXCLUDE or CHANGE_TO_EXCLUDE_MODE. This includes records with a non-empty source list.

Received

Number of messages received.

Sent

Number of messages sent.

Rx errors

Number of received packets that contained errors.

Max Rx rate (pps)

Maximum number of IGMP packets received during 1 second interval.

IGMP Global Statistics

Summary of IGMP statistics for all interfaces.

Note:

These statistics are not supported or displayed with the continuous option.

  • Bad Length—Number of messages received with length errors so severe that further classification could not occur.

  • Bad Checksum—Number of messages received with a bad IP checksum. No further classification was performed.

  • Bad Receive If—Number of messages received on an interface not enabled for IGMP.

  • Rx non-local—Number of messages received from senders that are not local.

  • Timed out—Number of groups that timed out as a result of not receiving an explicit leave message.

  • Rejected Report—Number of reports dropped because of the IGMP group policy.

  • Total Interfaces—Number of interfaces configured to support IGMP.

Sample Output

show igmp statistics

show igmp statistics continuous

Release Information

Statement introduced in Juniper BNG CUPS Release 22.4R1.

show load-balancing-group

Syntax

Description

Displays information for the load-balancing group.

Options

Empty

If you do not enter a load-balancing group name, all load-balancing groups are listed.

group group-name

(Optional) Displays information about the listed load-balancing group.

Required Privilege Level

root

Output Fields

Table 6 lists the output fields for the show load-balancing-group command.

Table 6: show load-balancing-group Output Fields

Field Name

Field Description

Group Name

The name of the load-balancing group.

Logical-Port

BNG User Plane logical port.

% Usage

The logical port's current load, represented as a percentage.

CPU Exceeded

Indicates whether the CPU load has been exceeded.

Computed weight

Current computed weight.

Max weight

Configured maximum weight.

Sample Output

show load-balancing group

show mld group

Syntax

Description

Display information about Multicast Listener Discovery (MLD) group membership. This command runs on BNG User Planes.

Required Privilege Level

view

Output Fields

Table 7 describes the output fields for the show mld group command. Output fields are listed in the approximate order in which they appear.

Table 7: show mld group Output Fields

Field Name

Field Description

Interface

Name of the interface that received the MLD membership report; local means that the local router joined the group itself.

Group

Group address.

Source

Source address.

Group Mode

Mode the SSM group is operating in: Include or Exclude.

Last reported by

Address of the host that last reported membership in this group.

Source timeout

Time remaining until the group traffic is no longer forwarded. The timer is refreshed when a listener in include mode sends a report. A group in exclude mode or configured as a static group displays a zero timer.

Timeout

Time remaining until the group membership is removed.

Group timeout

Time remaining until a group in exclude mode moves to include mode. The timer is refreshed when a listener in exclude mode sends a report. A group in include mode or configured as a static group displays a zero timer.

Type

Type of group membership:

  • Dynamic—Host reported the membership.

  • Static—Membership is configured.

Sample Output

show mld group

Release Information

Statement introduced in Juniper BNG CUPS Release 22.4R1.

show mld statistics

Syntax

Description

Display information about Multicast Listener Discovery (MLD) statistics.

By default, Junos OS multicast devices collect statistics of received and transmitted MLD control messages that reflect currently active multicast group subscribers.

Some devices also automatically maintain continuous MLD statistics globally on the device in addition to the default active subscriber statistics—these are persistent, continuous statistics of received and transmitted MLD control packets that account for both past and current multicast group subscriptions processed on the device. With continuous statistics, you can see the total count of MLD control packets the device processed since the last device reboot or clear mld statistics continuous command. The device collects and displays continuous statistics only for the fields shown in the MLD packet statistics... output section of this command, and does not display the MLD Global statistics section.

Devices that support continuous statistics maintain this information in a shared database and copy it to the backup Routing Engine at a configurable interval to avoid too much processing overhead on the Routing Engine. These actions preserve statistics counts across the following events or operations (which doesn’t happen for the default active subscriber statistics):

  • Routing daemon restart

  • Graceful Routing Engine switchover (GRES)

  • In-service software upgrade (ISSU)

  • Line card reboot

You can change the default interval (300 seconds) using the cont-stats-collection-interval configuration statement at the [edit routing-options multicast] hierarchy level.

You can display either the default currently active subscriber statistics or continuous subscriber statistics (if supported), but not both at the same time. Include the continuous option to display continuous statistics, otherwise the command displays the statistics only for currently active subscribers.

Run the clear mld statistics command to clear the currently active subscriber statistics. On devices that support continuous statistics, run the clear command with the continuous option to clear all continuous statistics. You must run these commands separately to clear both types of statistics because the device maintains and clears the two types of statistics separately.

Note:

The show mld statistics command runs on BNG User Planes.

Options

none

Display MLD statistics for all interfaces. These statistics represent currently active subscribers.

continuous

(Optional) Display continuous MLD statistics that account for both past and current multicast group subscribers instead of the default statistics that only reflect currently active subscribers. This option is not available with the interface option for interface-specific statistics.

Required Privilege Level

view

Output Fields

Table 8 describes the output fields for the show mld statistics command. Output fields are listed in the approximate order in which they appear.

Table 8: show mld statistics Output Fields

Field Name

Field Description

MLD Packet Statistics...

Heading for MLD packet statistics for all interfaces or for the specified interface name.

Note:

Shows currently active subscriber statistics in this section by default, or when the command includes the continuous option, shows continuous, persistent statistics that account for all MLD control packets processed on the device.

Received

Number of received packets.

Sent

Number of transmitted packets.

Rx errors

Number of received packets that contained errors.

MLD Message type

Summary of MLD statistics.

  • Listener Query (v1/v2)—Number of membership queries sent and received.

  • Listener Report (v1)—Number of version 1 membership reports sent and received.

  • Listener Done (v1/v2)—Number of Listener Done messages sent and received.

  • Listener Report (v2)—Number of version 2 membership reports sent and received.

  • Other Unknown types—Number of unknown message types received.

  • MLD v2 source required for SSM—Number of MLD version 2 messages received that contained no source.

  • MLD v2 mode not applicable for SSM—Number of MLD version 2 messages received that did not contain a mode applicable for source-specific multicast (SSM).

MLD Global Statistics

Summary of MLD statistics for all interfaces.

Note:

These statistics are not supported or displayed with the continuous option.

  • Bad Length—Number of messages received with length errors so severe that further classification could not occur.

  • Bad Checksum—Number of messages received with an invalid IP checksum. No further classification was performed.

  • Bad Receive If—Number of messages received on an interface not enabled for MLD.

  • Rx non-local—Number of messages received from nonlocal senders.

  • Timed out—Number of groups that timed out as a result of not receiving an explicit leave message.

  • Rejected Report—Number of reports dropped because of the MLD group policy.

  • Total Interfaces—Number of interfaces configured to support IGMP.

Sample Output

show mld statistics

show mld statistics continuous

Release Information

Statement introduced in Juniper BNG CUPS Release 22.4R1.

show network-access address-assignment address-pool-manager status

Syntax

Description

Displays the status of Juniper Address Pool Manager (APM).

Required Privilege Level

root

Output Fields

Table 9 lists the output fields for the show network-access address-assignment address-pool-manager status command. Output fields are listed in alphabetical order.

Table 9: show network-access address-assignment address-pool-manager status Output Fields

Field Name

Field Description

Address Pool Manager IP address for APM
Status Connection status of APM
Pool Count Number of pools
Connect Timestamp Time at which APM first connected to BNG CUPS Controller
Security Connection status: secured or not secured
Appointment mode One of the following appointment modes:
  • None

  • Remote

  • Local

Sample Output

show network-access address-assignment address-pool-manager status

show network-access address-assignment domain

Syntax

Description

Displays the state of each pool domain (dynamic linked address pool) connected to APM and a count of the transmitted alarms for a specified routing instance.

Options

name domain-name | domain-profile (Optional) Displays information depending on which of the following variables are entered:
  • Empty—A summary of all domains for the routing instance that is entered.

  • domain-name—Displays the pool structure of the pool domain.

routing-instance routing-instance-name (Optional) Designate the routing instance to use. If left empty, the default routing instance is used.

Required Privilege Level

root

Output Fields

Table 10 lists the output fields for the show network-access address-assignment domain command. Output fields are listed in alphabetical order.

Table 10: show network-access address-assignment domain Output Fields

Field Name

Field Description

Abatement (Abate) The number of abatement alarms. An the alarm occurs when either of the following conditions changes, causing APM to disregard the original alarm:
  • The number of free addresses rises above the reclaim threshold.

  • The number of free addresses falls below the apportion threshold.

Active-Tag

The value of the route tag that is associated with the discard routes installed on the active BNG User Plane.

Addresses Total number of addresses in the pool domain.
Apportion (Apport) The number of apportion alarms. The alarm occurs when the number of free addresses falls below the apportion threshold.

Backup-Tag

The value of the route tag that is associated with the discard routes installed on the backup BNG User Plane.

Domain Name Name of the pool domain.
Free Number of addresses in the pool domain that are available for allocation.
Pool Count Number of pools.
Pool Drain (Drain) The number of pool drain alarms. The alarm occurs when a pool is completely drained.
Pool Name Name of the pool.
Prefix Subnetwork allocated to the address pool.
Programmed

The state of the pool state (discard routes, dhcp gateway address, and so on) programming to the BNG User Plane.

Reclaim The number of reclaim alarms. The alarm occurs when the number of free addresses for the pool domain on the BNG CUPS Controller rises above the reclaim threshold.
State

State of the pool domain.

Status

The pool is either active or in drain mode.

Type

The source of the pool prefix. It can be a local reserve partition or a remote (APM) partition.

Used

The number of addresses being used.

User-Plane

The BNG User Plane that is the target for the programmed pool state.

Sample Output

show network-access address-assignment domain

show network-access address-assignment domain name (routing instance)

show network-access address-assignment domain name

show network-access address-assignment domain name

show network-access address-assignment domain-state

Syntax

Description

Displays the alarm state (outstanding alarms) for each pool domain.

Options

routing-instance routing-instance-name (Optional) Designate the routing instance to use. If left empty, the default routing instance is used.

Required Privilege Level

root

Output Fields

Table 11 lists the output fields for the show network-access address-assignment domain-state command. Output fields are listed in alphabetical order.

Table 11: show network-access address-assignment domain-state Output Fields

Field Name

Field Description

Domain Name Name of the pool domain.
Alarm Name of the alarm.
  • reclaim—When the number of free addresses for the pool domain on BNG CUPS Controller rises above the reclaim threshold.

  • apportion—When the number of free addresses falls below the apportion threshold.

  • pool-drained—When a pool is completely drained.

  • abatement—BNG CUPS Controller sends an abatement alarm when either of the following conditions changes, causing APM to disregard the original alarm.

    • The number of free addresses rises above the reclaim threshold.

    • The number of free addresses falls below the apportion threshold.

Age How long an alarm has been outstanding.
Logins Whether logins are enabled.
State State of the pool domain.

Sample Output

show network-access address-assignment domain

show network-access address-assignment domain name (using domain profile)

show network-access address-assignment domain name

show routing-instances

Syntax

Description

Displays a list of BNG User Planes that are using the listed routing instance.

Options

routing-instance-name

The routing instance name for which you want the list of BNG User Planes.

Required Privilege Level

view

Output Fields

Table 33 lists the output fields for the show routing-instances command. Output fields are listed in the approximate order in which they appear.

Table 12: show routing-instances Output Fields

Field Name

Field Description

User Plane Name

Name of the BNG User Plane.

Routing Instance State

The routing instance state:

  • Connected—The node is connected to the network.

  • Isolated—The node is isolated from the rest of the network.

Sample Output

show routing-instances

show subscriber-group

Syntax

Description

Displays information for subscriber groups.

Options

subscriber-group subscriber-group-name

Subscriber group for which you want to display information. If you do not enter a subscriber-group-name, the command only displays information for subscriber groups that have logical-ports associated with the subscriber group. If you want to see information for a subscriber group that does not have any logical ports associated with it, you must include the subscriber-group-name in the command.

Required Privilege Level

root

Output Fields

Table 13 lists the output fields for the show subscriber-group command.

Table 13: show subscriber-group Output Fields

Field Name

Field Description

Name

Subscriber group name.

ID

ID number for the subscriber group.

SGRP Mode

The operational mode of the device, either Control Plane or User Plane

SGRP State

Health status of the subscriber group. Either healthy or unhealthy.

User Plane

The BNG User Planes that belong to the subscriber group.

Active UP

The active BNG User Plane.

Mode

The operational mode of the device, either Control Plane or User Plane.

BB device

The Broadband device that is a member of the subscriber group.

Name (Logical port mapping)

Logical port mapping name.

Logical-port

BNG User Plane logical port.

Sessions

The number of subscriber sessions.

Name (Address domains)

Address Domain name.

Prefixes

The number of address prefixes assigned to the specified BNG User Plane for the subscriber group.

User-Plane

The BNG User Plane that the specified subscriber group belongs to.

Programmed

The number of address prefixes programmed on the User Plane for the subscriber group

Name (Routing Instances)

Routing instances name.

User-Plane (Address domain)

BNG User Plane name.

Sample Output

show subscriber-group

show subscriber-group

show subscribers

Syntax

Description

Display information for active subscribers.

Options

detail | extensive | terse

(Optional) Display the specified level of output.

accounting-statistics

(Optional) Display subscriber accounting statistics

aci-interface-set-name

(Optional) Display all the dynamic subscriber sessions that use the specified agent circuit identifier (ACI) interface set. You must use the ACI interface set name generated by the router, such as aci-1003-ge-1/0/0.4001, and not the actual ACI value found in the Dynamic Host Configuration Protocol (DHCP) or Point-to-Point Protocol over Ethernet (PPPoE) control packets.

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.

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:

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.

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 show subscribers extensive command.

mac-address

(Optional) Display subscribers whose MAC address matches the specified MAC address.

user-name

(Optional) Display subscribers whose username matches the specified subscriber name.

Note:

Because of display limitations, logical system and routing instance output values are truncated when necessary.

Required Privilege Level

view

Output Fields

Table 14 lists the output fields for the show subscribers command. Output fields are listed in the approximate order in which they appear.

Table 14: show subscribers Output Fields

Field Name

Field Description

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.

IP Address/VLAN ID

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 Tunnel-switched.

User Name

Name of subscriber.

LS:RI

Logical system and routing instance associated with the subscriber.

Type

Subscriber client type (DHCP, FWA, GRE, L2TP, PPP, PPPoE, STATIC-INTERFACE, VLAN).

IP Address

Subscriber IPv4 address.

IP Netmask

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.

Primary DNS Address

IP address of primary DNS server.

This field is displayed with the extensive option only when the address is provided by RADIUS.

Secondary DNS Address

IP address of secondary DNS server.

This field is displayed with the extensive option only when the address is provided by RADIUS.

IPv6 Primary DNS Address

IPv6 address of primary DNS server.

This field is displayed with the extensive option only when the address is provided by RADIUS.

IPv6 Secondary DNS Address

IPv6 address of secondary DNS server.

This field is displayed with the extensive option only when the address is provided by RADIUS.

Domain name server inet

IP addresses for the DNS server, displayed in order of configuration.

This field is displayed with the extensive option only when the addresses are derived from the access profile or the global access configuration.

Domain name server inet6

IPv6 addresses for the DNS server, displayed in order of configuration.

This field is displayed with the extensive option only when the addresses are derived from the access profile or the global access configuration.

Primary WINS Address

IP address of primary WINS server.

Secondary WINS Address

IP address of secondary WINS server.

IPv6 Address

Subscriber IPv6 address, or multiple addresses.

IPv6 Prefix

Subscriber IPv6 prefix. If you are using DHCPv6 prefix delegation, this is the delegated prefix.

IPv6 User Prefix

IPv6 prefix obtained through NDRA.

IPv6 Address Pool

Subscriber IPv6 address pool. The IPv6 address pool is used to allocate IPv6 prefixes to the DHCPv6 clients.

IPv6 Network Prefix Length

Length of the network portion of the IPv6 address.

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

(Enhanced subscriber management for MX Series routers) Name of the enhanced subscriber management logical interface, in the form demux0.nnnn (for example, demux0.3221225472), to which access-internal and framed subscriber routes are mapped.

Interface Type

Whether the subscriber interface is Static or Dynamic.

Interface Set

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:

  • aci—ACI; for example, aci-1033-demux0.3221225524. This is the only prefix allowed for ACI interface sets.

  • ari—ARI; for example, ari-1033-demux0.3221225524.

  • aci+ari—Both the ACI and ARI; for example, aci+ari-1033-demux0.3221225524.

  • noids—Neither the ACI nor the ARI were received; for example, noids-1033-demux0.3221225524.

Note:

ACI interface sets are configured with the agent-circuit-identifier autoconfiguration stanza. ALI interface sets are configured with the line-identity autoconfiguration stanza.

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

Interface type of the ACI interface set: Dynamic. This is the only ACI interface set type currently supported.

Interface Set Session ID

Identifier of the dynamic ACI interface set entry in the session database.

Underlying Interface

Name of the underlying interface for the subscriber session.

Dynamic Profile Name

Dynamic profile used for the subscriber.

Dynamic Profile Version

Version number of the 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, Tunneled).

L2TP State

Current state of the L2TP session, Tunneled or Tunnel-switched. When the value is Tunnel-switched, two entries are displayed for the subscriber; the first entry is at the LNS interface on the LTS and the second entry is at the LAC interface on the LTS.

Tunnel switch Profile Name

Name of the L2TP tunnel switch profile that initiates tunnel switching.

Local IP Address

IP address of the local gateway (LAC).

Remote IP Address

IP address of the remote peer (LNS).

PFE Flow ID

Forwarding flow identifier.

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

For the dhcp client type, option 82 agent circuit ID associated with the subscriber. The ID is displayed as an ASCII string unless the value has nonprintable characters, in which case it is displayed in hexadecimal format.

For the vlan-oob client type, the agent circuit ID or access-loop circuit identifier that identifies the subscriber line based on the subscriber-facing DSLAM interface on which the subscriber request originates.

Agent Remote ID

For the dhcp client type, option 82 agent remote ID associated with the subscriber. The ID is displayed as an ASCII string unless the value has nonprintable characters, in which case it is displayed in hexadecimal format.

For the vlan-oob client type, the agent remote ID or access-loop remote identifier that identifies the subscriber line based on the NAS-facing DSLAM interface on which the subscriber request originates.

Aggregation Interface-set Name

Value of the $junos-aggregation-interface-set-name predefined variable; one of the following:

  • When the hierarchical-access-network-detection option is configured for the access lines and the value of the Access-Aggregation-Circuit-ID-ASCII attribute (TLV 0x0003) received either in the ANCP Port Up message or PPPoE PADR IA tags begins with a # character, then the variable takes the value of the remainder of the string after the # character.

  • When the hierarchical-access-network-detection option is not configured, or if the sting does not begin with the # character, then the variable takes the value specified with the predefined-variable-defaults statement.

Accounting Statistics

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 actual-transmit-statistics statement is included in the dynamic profile.

DHCP Relay IP Address

IP address used by the DHCP relay agent.

Login Time

Date and time at which the subscriber logged in.

DHCPV6 Options

len = number of hex values in the message. The hex values specify the type, length, value (TLV) for DHCPv6 options.

Server DHCP Options

len = number of hex values in the message. The hex values specify the type, length, value (TLV) for DHCP options.

Server DHCPV6 Options

len = number of hex values in the message. The hex values specify the type, length, value (TLV) for DHCPv6 options.

DHCPV6 Header

len = number of hex values in the message. The hex values specify the type, length, value (TLV) for DHCPv6 options.

Effective shaping-rate

Actual downstream traffic shaping rate for the subscriber, in kilobits per second.

IPv4 Input Service Set

Input service set in access dynamic profile.

IPv4 Output Service Set

Output service set in access dynamic profile.

PCEF Profile

PCEF profile in access dynamic profile.

PCEF Rule/Rulebase

PCC rule or rulebase used in dynamic profile.

Dynamic configuration

Values for variables that are passed into the dynamic profile from RADIUS.

Service activation time

Time at which the first family in this service became active.

IPv4 rpf-check Fail Filter Name

Name of the filter applied by the dynamic profile to IPv4 packets that fail the RPF check.

IPv6 rpf-check Fail Filter Name

Name of the filter applied by the dynamic profile to IPv6 packets that fail the RPF check.

DHCP Options

len = number of hex values in the message. The hex values specify the type, length, value (TLV) for DHCP options, as defined in RFC 2132.

Session ID

ID number for a subscriber session.

Underlying Session ID

For DHCPv6 subscribers on a PPPoE network, displays the session ID of the underlying PPPoE interface.

Service Sessions

Number of service sessions (that is, a service activated using RADIUS CoA) associated with the subscribers.

Service Session ID

ID number for a subscriber service session.

Service Session Name

Service session profile name.

Session Timeout (seconds)

Number of seconds of access provided to the subscriber before the session is automatically terminated.

Idle Timeout (seconds)

Number of seconds subscriber can be idle before the session is automatically terminated.

IPv6 Delegated Address Pool

Name of the pool used for DHCPv6 prefix delegation.

IPv6 Delegated Network Prefix Length

Length of the prefix configured for the IPv6 delegated address pool.

IPv6 Interface Address

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.

IPv6 Framed Interface Id

Interface ID assigned by the Framed-Interface-Id AAA attribute.

ADF IPv4 Input Filter Name

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.

ADF IPv4 Output Filter Name

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.

ADF IPv6 Input Filter Name

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.

ADF IPv6 Output Filter Name

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.

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

DSL type

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: ADSL, ADSL2, ADSL2+, OTHER, SDSL, VDSL, or VDSL2.

Frame/Cell Mode

Mode type of the PPPoE subscriber’s access line determined by the PPPoE daemon based on the received subattribute DSL-Type (0x0091):

  • Cell—When the DSL line type is one of the following: ADSL, ADSL2, or ADSL2+.

  • Frame—When the DSL line type is one of the following: OTHER, SDSL, VDSL, or VDSL2.

The value is stored in the subscriber session database.

Overhead accounting bytes

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.

Actual upstream data rate

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

Actual downstream data rate

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

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

Adjusted upstream data rate for the PPPoE subscriber’s access line, calculated by the PPPoE daemon and stored in the subscriber session database.

Local TEID-U

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 GTPU Tunnel Local IP address value.

Local TEID-C

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 GTPC Local IP address value.

Remote TEID-U

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 GTPU Tunnel Remote IP address value.

Remote TEID-C

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 GTPC Remote IP address value.

GTPU Tunnel Remote IP address

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 Remote TEID-U value.

GTPU Tunnel Local IP address

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 Local TEID-U value

GTPC Remote IP address

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 Remote TEID-C value.

GTPC Local IP address

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 Local TEID-C value.

Access Point Name

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.

Tenant

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.

User-plane:port

The BNG User Plane that the subscriber belongs to with its port number and whether it is configured as active or backup.

Routing instance

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.

Dynamic Profile Version Alias

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

CP-instance

BNG CUPS Controller instance.

SGRP

The subscriber group that the subscriber belongs to.

Active-UP

Lists the active BNG User Plane for the SGRP.

Sample Output

show subscribers user-name

show subscribers user-name

show subscribers detail (DHCP)

show subscribers accounting-statistics id

show subscribers client-type (PPPoE)

show subscribers client-type (DHCP)

show subscribers detail

show subscribers agent-circuit-identifier substring detail

show subscribers subscriber-group

Syntax

Description

Display information for subscribers as part of a subscriber group.

Options

broadband-device-name

Name of the broadband edge device.

client-type

(Optional) Display subscribers whose client type matches one of the following client types:

  • dhcp—DHCP clients only.

  • dotlx—Dotlx clients only.

  • essm—ESSM clients only.

  • fixed-wireless-access—Fixed wireless access clients only.

  • fwauth—FwAuth (authenticated across a firewall) clients only.

  • l2tp—L2TP clients only.

  • mlppp—MLPPP clients only.

  • ppp—PPP clients only.

  • pppoe—PPPoE clients only.

  • static—Static clients only.

  • vlan—VLAN clients only.

  • vlan-oob—VLAN out-of-band (ANCP-triggered) clients only.

  • vpls-pw—VPLS pseudowire clients only.

  • xauth—Xauth clients only.

interface

(Optional) Display subscribers whose interface matches the specified 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.

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 stacked-vlan-id stacked-vlan-id option to match the outer VLAN tag.

Note:

Because of display limitations, routing instance output values are truncated when necessary.

Required Privilege Level

view

Output Fields

Table 15 lists the output fields for the show subscribers subscriber-group command. Output fields are listed in the approximate order in which they appear.

Table 15: show subscribers subscriber-group Output Fields

Field Name

Field Description

Control-Plane-instance

The associated BNG CUPS Controller.

Broadband-device

The list of broadband edge devices.

IP Address

Subscriber IPv4 address.

User Name

Name of subscriber.

RI

Routing instance associated with the subscriber.

SID

ID number for a subscriber session.

Resiliency-state

Lists weather the device is configured as active or backup.

Sample Output

show subscribers subscriber-group sgrp-name

show subscribers summary

Syntax

Description

Display summary information for subscribers.

Options

user-plane user-plane-name

Display subscriber information for the designated BNG User Plane.

subscriber-group subscriber-group-name

Display subscriber information for the designated subscriber group.

control-plane-instance control-plane-instance-name

Display subscriber information for the designated control plane instance.

Required Privilege Level

view

Output Fields

Table 16 lists the output fields for the show subscribers summary command. Output fields are listed in the approximate order in which they appear.

Table 16: show subscribers summary Output Fields

Field Name

Field Description

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.

  • Total—Total number of subscribers for all states.

Subscribers by Client Type

Number of subscribers summarized by client type. Client types can include DHCP, GRE, L2TP, PPP, PPPoE, STATIC-INTERFACE, and VLAN. Also displays the total number of subscribers for all client types (Total).

Sample Output

show subscribers summary

show subscribers user-plane

Syntax

Description

Displays information for subscribers associated to a BNG User Plane.

Options

client-type

(Optional) Display subscribers whose client type matches one of the following client types:

  • dhcp—DHCP clients only.

  • dotlx—Dotlx clients only.

  • essm—ESSM clients only.

  • fixed-wireless-access—Fixed wireless access clients only.

  • fwauth—FwAuth (authenticated across a firewall) clients only.

  • l2tp—L2TP clients only.

  • mlppp—MLPPP clients only.

  • ppp—PPP clients only.

  • pppoe—PPPoE clients only.

  • static—Static clients only.

  • vlan—VLAN clients only.

  • vlan-oob—VLAN out-of-band (ANCP-triggered) clients only.

  • vpls-pw—VPLS pseudowire clients only.

  • xauth—Xauth clients only.

interface

(Optional) Display subscribers whose interface matches the specified interface.

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.

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 stacked-vlan-id stacked-vlan-id option to match the outer VLAN tag.

Note:

Because of display limitations, routing instance output values are truncated when necessary.

Required Privilege Level

view

Output Fields

Table 17 lists the output fields for the show subscribers user-plane command. Output fields are listed in the approximate order in which they appear.

Table 17: show subscribers user-plane Output Fields

Field Name

Field Description

Control-Plane-instance

The associated BNG CUPS Controller.

Broadband-device

The list of broadband edge devices.

IP Address

Subscriber IPv4 address.

User Name

Name of subscriber.

RI

Routing instance associated with the subscriber.

SID

ID number for a subscriber session.

Resiliency-state

Lists weather the device is configured as active or backup.

Sample Output

show subscribers user-plane up-name

show user-plane

Syntax

Description

Display a summary of information for all configured BNG User Planes, which includes their associations, health state, and CPi binding.

Options

Required Privilege Level

view

Output Fields

Table 18 lists the output fields for the show user-plane command. Output fields are listed in the approximate order in which they appear.

Table 18: show user-plane

Field Name

Field Description

Name

The BNG User Plane name.

Uptime

The amount of time the service has been up.

Health

Health of the BNG User Plane. Following are the health levels:

  • Healthy—All of the following must exist: The state is connected or connecting, the corresponding smd-N service is up, and all of its associated endpoints are connected.

  • Unhealthy-major—If any of the following exist: The state is not connected or connecting, or security-updating and the corresponding smd-N service is down.

  • Unhealthy-minor—All of the following must exist: The state is either not connected, connecting, or security-updating, and the corresponding smd-N service is down, and any of its associated endpoints are disconnected.

Address

BNG User Plane IP address.

Active/Backup-sess

The number of active and backup subscriber sessions served by the BNG User Plane.

State

The state of the BNG User Plane. The state can be one of the following:

  • initializing

  • ready

  • connecting

  • connected

  • disconnecting

  • disconnected

  • security-updating

  • warm-init

  • deconfiguring

  • misconfigured

CPi

The control plane instance that is handling the BNG User Plane.

Sample Output

show user-plane

show user-plane class-of-service scheduler-map

Syntax

Description

Displays BNG User plane specific information for the mapping of schedulers to forwarding classes and a summary of scheduler parameters for each entry.

Options

static-only

Displays only statically configured scheduler maps.

scheduler-name

Name of the scheduler for which you want to view information. Displays a summary of scheduler parameters for each forwarding class to which the named scheduler is assigned.

user-plane-name

Name of the user-plane for which you want to view information.

Required Privilege Level

view

Output Fields

Table 19 describes the output fields for the show user-plane class-of-service scheduler-map command. Output fields are listed in the approximate order in which they appear.

Table 19: show user-plane class-of-service scheduler-map Output Fields

Field Name

Field Description

Scheduler map

Name of the scheduler map.

(Enhanced subscriber management for MX Series routers) The name of the dynamic scheduler map object is associated with a generated UID (for example, SMAP-1_UID1002) instead of with a subscriber interface.

Index

Index of the indicated object. Objects having indexes in this output include scheduler maps, schedulers, and drop profiles.

Index values for dynamic CoS traffic control profiles are larger for enhanced subscriber management than they are for legacy subscriber management.

Scheduler

Name of the scheduler.

Forwarding class

Classification of a packet affecting the forwarding, scheduling, and marking policies applied as the packet transits the router.

Transmit rate

Configured transmit rate of the scheduler (in bps). The rate is a percentage of the total interface bandwidth, or the keyword remainder, which indicates that the scheduler receives the remaining bandwidth of the interface.

Rate Limit

Rate limiting configuration of the queue. Possible values are none, meaning no rate limiting, and exact, meaning the queue only transmits at the configured rate.

Maximum buffer delay

Amount of transmit delay (in milliseconds) or the buffer size of the queue. The buffer size is shown as a percentage of the total interface buffer allocation, or by the keyword remainder to indicate that the buffer is sized according to what remains after other scheduler buffer allocations.

Priority

Scheduling priority: low or high.

Excess priority

Priority of excess bandwidth: low, medium-low, medium-high, high, or none.

Adjust minimum

Minimum shaping rate for an adjusted queue, in bps.

Adjust percent

Bandwidth adjustment applied to a queue, in percent.

Drop profiles

Table displaying the assignment of drop profiles by name and index to a given loss priority and protocol pair.

Loss priority

Packet loss priority for drop profile assignment.

Protocol

Transport protocol for drop profile assignment.

Name

Name of the drop profile.

Sample Output

show user-plane class-of-service scheduler-map

show user-plane class-of-service traffic-control-profile

Syntax

Description

Display information for traffic shaping and scheduling profiles, for the specified BNG User Plane.

Options

static-only

Displays only statically configured traffic control profiles.

profile-name

Name of the traffic control profile for which you want to view information.

user-plane-name

The name of the BNG User Plane for which you want to view information.

Required Privilege Level

view

Output Fields

Table 20 describes the output fields for the show class-of-service traffic-control-profile command. Output fields are listed in the approximate order in which they appear.

Table 20: show user-plane class-of-service traffic-control-profile Output Fields

Field Name

Field Description

Traffic control profile

Name of the traffic control profile.

You can configure objects of the same type with the same name on the user plane and the control plane. The display designates between the control plane and the user plane by adding cp or up to the name. Also, the dynamically generated UID is displayed.

Index

Index number of the traffic control profile.

Shaping rate

Configured shaping rate, in bps.

Note:

(MX Series routers with ATM Multi-Rate CE MIC) Configured peak rate, in cps.

Scheduler map

Name of the associated scheduler map.

(Enhanced subscriber management for MX Series routers) The name of the dynamic scheduler map object is associated with a generated UID (for example, SMAP-1_UID1002) instead of with a subscriber interface.

User-plane

The associated BNG User Plane.

Sample Output

show user-plane class-of-service traffic-control-profile static-only

show user-plane <user-plane-name> class-of-service traffic-control-profile

show user-plane class-of-service traffic-control-profile static-only

show user-plane firewall filter

Syntax

Description

Display firewall instance information for the specified BNG User Plane.

Options

filter filter-name

Name of a configured filter.

up-name user-plane-name The BNG User Plane for which you want to view firewall filter information.

Required Privilege Level

view

Output Fields

Table 2 lists the output fields for the show user-plane firewall filter command. Output fields are listed in the approximate order in which they appear.

Table 21: show user-plane firewall filter Output Fields

Field Name

Field Description

Filter

Name of a filter that has been configured with the filter statement at the [edit firewall] hierarchy level.

User Plane BNG User Plane name.

Sample Output

show user-plane firewall filter

show user-plane firewall templates-in-use

Syntax

Description

Display the names of configured filter templates that are currently in use by dynamic subscribers and the number of times each template is referenced.

Options

user-plane-name Display the configured filter templates for the specified BNG User Plane.

Required Privilege Level

root

Output Fields

Table 22 lists the output fields for the show user-plane firewall templates-in-use command. Output fields are listed in the approximate order in which they appear.

Table 22: show user-plane firewall templates-in-use Output Fields

Field Name

Field Description

Filter Template

Name of a filter that has been configured using the filter statement at either the [edit firewall] or [edit dynamic-profiles profile-name firewall] hierarchy and is being used as a template for dynamic subscriber filtering.

User Plane

BNG User Plane name.

Reference Count

Number of times the filter has been referenced by subscribers accessing the network.

Sample Output

show user-plane firewall templates-in-use up-name up-example-1

show user-plane igmp interface

Syntax

Description

Displays information about Internet Group Management Protocol (IGMP)-enabled interfaces on BNG User Planes.

Options

none

When you run this command on the BNG CUPS Controller, the output displays standard information about all IGMP-enabled interfaces on all BNG User Planes associated to the BNG CUPS Controller.

When you run this command on a BNG User Plane, the output displays standard information about all IGMP-enabled interfaces on the BNG User Plane.

up-name user-plane-name

(Optional) Displays information about the IGMP-enabled interfaces on the specified BNG User Plane.

Required Privilege Level

view

Output Fields

Table 23 describes the output fields for the show user-plane igmp interface command. Output fields are listed in the approximate order in which they appear.

Table 23: show user-plane igmp interface Output Fields

Field Name

Field Description

Interface

Name of the interface.

Querier

Address of the routing device that has been elected to send membership queries.

State

State of the interface: Up or Down.

Timeout

How long until the IGMP querier is declared to be unreachable, in seconds.

Version

IGMP version being used on the interface: 1 , 2 , or 3.

Groups

Number of groups on the interface.

Group threshold

Configured threshold at which a warning message is generated.

This threshold is based on a percentage of groups received on the interface. If the number of groups received reaches the configured threshold, the device generates a warning message.

Group log-interval

Time (in seconds) between consecutive log messages.

SSM map policy

The SSM map policy applied to the IGMP interface..

Immediate Leave

State of the immediate leave option:

  • On—Indicates that the router removes a host from the multicast group as soon as the router receives a leave group message from a host associated with the interface.

  • Off—Indicates that after receiving a leave group message, instead of removing a host from the multicast group immediately, the router sends a group query to determine if another receiver responds.

Promiscuous Mode

State of the promiscuous mode option:

  • On—Indicates that the router can accept IGMP reports from subnetworks that are not associated with its interfaces.

  • Off—Indicates that the router can accept IGMP reports only from subnetworks that are associated with its interfaces.

Distributed

State of IGMP, which, by default, takes place on the Routing Engine for MX Series routers but can be distributed to the Packet Forwarding Engine to provide faster processing of join and leave events.

  • On—distributed IGMP is enabled.

Passive

State of the passive mode option:

  • On—Indicates that the router can run IGMP on the interface but not send or receive control traffic such as IGMP reports, queries, and leaves.

  • Off—Indicates that the router can run IGMP on the interface and send or receive control traffic such as IGMP reports, queries, and leaves.

The passive statement enables you to selectively activate up to two out of a possible three available query or control traffic options. When enabled, the following options appear after the on state declaration:

  • send-general-query—The interface sends general queries.

  • send-group-query—The interface sends group-specific and group-source-specific queries.

  • allow-receive—The interface receives control traffic.

Group policy

The group policy applied to the IGMP interface.

Sample Output

show user-plane igmp interface up-name

Release Information

Statement introduced in Juniper BNG CUPS Release.

show user-plane ipv6 router-advertisement

Syntax

Description

Display information about IPv6 router advertisements, including statistics about messages sent and received on interfaces, and information received from advertisements from other routers.

The router advertisement module does not function in the backup Routing Engine as the Routing Engine does not send an acknowledgment message after receiving the packets.

Options

interface interface

(Optional) Display IPv6 router advertisement information for the specified interface.

prefix prefix/prefix length

(Optional) Display IPv6 router advertisement information for the specified prefix.

up-name user-plane-name

The BNG User Plane for which you want to view IPv6 router advertisement information.

Additional Information

The display identifies conflicting information by enclosing the value the router is advertising in brackets.

Required Privilege Level

view

Output Fields

Table 24 describes the output fields for the show user-plane ipv6 router-advertisement command. Output fields are listed in the approximate order in which they appear.

Table 24: show user-plane ipv6 router-advertisement Output Fields

Field Name

Field Description

Interface

Name of the interface.

Advertisements sent

Number of router advertisements sent and the elapsed time since they were sent.

Solicits received

Number of solicitation messages received.

Advertisements received

Number of router advertisements received.

Advertisements from

Names of interfaces from which router advertisements have been received and the elapsed time since the last one was received.

Managed

Managed address configuration flag: 0 (stateless) or 1 (stateful).

Other configuration

Other stateful configuration flag: 0 (stateless) or 1 (stateful).

Reachable time

Time that a node identifies a neighbor as reachable after receiving a reachability confirmation, in milliseconds.

Default lifetime

Default lifetime, in seconds: from 0 seconds to 18.2 hours. A setting of 0 indicates that the router is not a default router.

Retransmit timer

Time between retransmitted Neighbor Solicitation messages, in milliseconds.

Current hop limit

Configured current hop limit.

Prefix

Name and length of the prefix.

Valid lifetime

How long the prefix remains valid for onlink determination.

Preferred lifetime

How long the prefix generated by stateless autoconfiguration remains preferred.

On link

Onlink flag: 0 (not onlink) or 1 (onlink).

Autonomous

Autonomous address configuration flag: 0 (not autonomous) or 1  (autonomous).

Upstream Mode

Configured interface as upstream interface for RA proxy

Downstream Mode

Configured interface as downstream interface for RA proxy.

Downstream

Downstream interface for RA proxy.

Passive Mode

RA receive only mode is enabled.

Proxy Blackout Timer

Proxy blackout timer interval is the time interval for which the interface must not be used as a proxy interface. Proxy functionality is disabled on that interface.

Parameter Preference

Preference to select configured or proxied parameters for downstream interface

error

Displays the details of the error.

Sample Output

show user-plane ipv6 router-advertisement up-name

Release Information

show user-plane maintenance

Syntax

Description

Displays the maintenance state for a BNG User Plane.

Options

user-plane-name

Display the maintenance status of the specified BNG User Plane.

Required Privilege Level

view

Output Fields

Table 25 lists the output fields for the show user-plane maintenance up-name command.

Table 25: show user-plane maintenance up-name Output Fields

Field Name

Field Description

Maintenance Status

The current maintenance status of the BNG User Plane.

Serviced UP

The BNG User Plane that is being serviced.

Backup UP

The backup BNG User Plane.

BB device

Broadband device for the logical port pair for the BNG User Plane being serviced and the backup BNG User Plane.

Name (Logical port mapping)

Redundancy interface name for the logical port pair for the BNG User Plane being serviced and the backup BNG User Plane.

Logical-port

The number of subscriber sessions configured on the BNG User Plane logical port.

Sesions

The number of subscriber sessions configured on the BNG User Plane logical port.

Name (address Domains)

Name of the address Domain.

Prefixes

The number of address prefixes assigned to the address domain.

User-Plane

The BNG User Plane name.

programmed

One of the following:
  • Address Domain—The number of address prefixes configured on the BNG User Plane.

  • Routing Instance—The programming state of the prefixes with the route tag on the BNG User Plane.

Name (Routing Instance)

Name of the routing instance.

Tag

The routing tag value used for the active BNG User Plane.

Backup-Tag

The routing tag value used for the backup BNG User Plane.

Sample Output

show user-plane maintenance up-name

show user-plane mld interface

Syntax

Description

Displays information about multipoint Listener Discovery (MLD)-enabled interfaces.

Options

none

When you run this command on the BNG CUPS Controller, the output displays standard information about all MLD-enabled interfaces on all BNG User Planes associated to the BNG CUPS Controller.

When you run this command on a BNG User Plane, the output displays standard information about all MLD-enabled interfaces on the BNG User Plane.

up-name user-plane-name

(Optional) Displays information about the MLD-enabled interfaces on the specified BNG User Plane.

Required Privilege Level

view

Output Fields

Table 26 describes the output fields for the show user-plane mld interface command. Output fields are listed in the approximate order in which they appear.

Table 26: show user-plane mld interface Output Fields

Field Name

Field Description

Interface

Name of the interface.

Querier

Address of the router that has been elected to send membership queries.

State

State of the interface: Up or Down.

Up Timeout

How long until the MLD querier is declared to be unreachable, in seconds.

Version

MLD version being used on the interface: 1 or 2.

Groups

Number of groups on the interface.

Passive

State of the passive mode option:

  • On—Indicates that the router can run IGMP or MLD on the interface but not send or receive control traffic such as IGMP or MLD reports, queries, and leaves.

  • Off—Indicates that the router can run IGMP or MLD on the interface and send or receive control traffic such as IGMP or MLD reports, queries, and leaves.

The passive statement enables you to selectively activate up to two out of a possible three available query or control traffic options. When enabled, the following options appear after the on state declaration:

  • send-general-query—The interface sends general queries.

  • send-group-query—The interface sends group-specific and group-source-specific queries.

  • allow-receive—The interface receives control traffic

Group threshold

Configured threshold at which a warning message is generated.

This threshold is based on a percentage of groups received on the interface. If the number of groups received reaches the configured threshold, the device generates a warning message.

Immediate Leave

State of the immediate leave option:

  • On—Indicates that the router removes a host from the multicast group as soon as the router receives a multicast listener done message from a host associated with the interface.

  • Off—Indicates that after receiving a multicast listener done message, instead of removing a host from the multicast group immediately, the router sends a group query to determine if another receiver responds.

Distributed

State of MLD, which, by default, takes place on the Routing Engine for MX Series routers but can be distributed to the Packet Forwarding Engine to provide faster processing of join and leave events.

  • On—distributed MLD is enabled.

Promiscuous Mode

State of the promiscuous mode option:

  • On—Indicates that the router can accept MLD reports from subnetworks that are not associated with its interfaces.

  • Off—Indicates that the router can accept MLD reports only from subnetworks that are associated with its interfaces.

Sample Output

show user-plane mld interface up-name

Release Information

Statement introduced in Juniper BNG CUPS Release

show user-plane pppoe interfaces

Syntax

Description

Display session-specific information about PPPoE interfaces.

Options

none

Display interface information for all PPPoE interfaces.

brief | detail | extensive

(Optional) Display the specified level of output.

up-name user-plane-name

The BNG User Plane for which you want to view PPPoE interface information.

Required Privilege Level

view

Output Fields

Table 27 lists the output fields for the show user-plane pppoe interfaces command. Output fields are listed in the approximate order in which they appear.

Table 27: show user-plane pppoe interfaces Output Fields

Field Name

Field Description

Level of Output

Logical Interface  

Logical interface

Name of the logical interface.

All levels

Index

Index number of the logical interface, which reflects its initialization sequence.

detail extensive none

State

State of the logical interface: up or down.

All levels

Session ID

Session ID.

All levels

Type

Origin of the logical interface: Static or Dynamic. Indicates whether the interface was statically or dynamically created.

detail extensive none

Service name

Type of service required (can be used to indicate an ISP name or a class or quality of service).

detail extensive none

Configured AC name

Configured access concentrator name.

detail extensive none

Session AC name

Name of the access concentrator.

detail extensive none

Remote MAC address or Remote MAC

MAC address of the remote side of the connection, either the access concentrator or the PPPoE client.

All levels

Session uptime

Length of time the session has been up, in hh:mm:ss.

detail extensive none

Dynamic Profile

Name of the dynamic profile that was used to create this interface. If the interface was statically created, this field is not displayed.

detail extensive none

Underlying interface

Interface on which PPPoE is running.

All levels

Agent Circuit ID

Agent circuit identifier (ACI) that corresponds to the DSLAM interface that initiated the client service request. An asterisk is interpreted as a wildcard character and can appear at the beginning, the end, or both the beginning and end of the string. If the agent circuit ID is not configured, this field is not displayed.

detail extensive none

Agent Remote ID

Agent remote identifier that corresponds to the subscriber associated with the DSLAM interface that initiated the service request. An asterisk is interpreted as a wildcard character and can appear at the beginning, the end, or both at the beginning and end of the string. If the agent remote ID is not configured, this field is not displayed.

detail extensive none

ACI Interface Set

Internally-generated name of the dynamic ACI interface set, if configured, and the set index number of the ACI entry in the session database.

detail extensive none

Packet Type

Number of packets sent and received during the PPPoE session, categorized by packet type and packet errors:

  • PADI—PPPoE Active Discovery Initiation packets.

  • PADO—PPPoE Active Discovery Offer packets.

  • PADR—PPPoE Active Discovery Request packets.

  • PADS—PPPoE Active Discovery Session-Confirmation packets.

  • PADT—PPPoE Active Discovery Termination packets.

  • Service name error—Packets for which the Service-Name request could not be honored.

  • AC system error—Packets for which the access concentrator experienced an error in performing the host request. For example, the host had insufficient resources to create a virtual circuit.

  • Generic error—Packets that indicate an unrecoverable error occurred.

  • Malformed packets—Malformed or short packets that caused the packet handler to discard the frame as unreadable.

  • Unknown packets—Unrecognized packets.

extensive

Sample Output

show user-plane pppoe interfaces up-name

show user-plane pppoe lockout

Syntax

Description

Display summary information about PPPoE clients currently undergoing lockout or currently in a lockout grace period on all PPPoE underlying logical interfaces or on a specified PPPoE underlying logical interface, for the specified BNG User Plane. You can configure PPPoE subscriber session lockout, also known as short-cycle protection, for VLAN, VLAN demux, and PPPoE-over-ATM dynamic subscriber interfaces.

Options

none

Display information about the lockout condition and the lockout grace period for PPPoE clients on all PPPoE underlying logical interfaces.

underlying-interface-name

(Optional) Name of the PPPoE underlying logical interface. If you do not specify an underlying interface, the router iteratively displays output for all existing clients undergoing lockout per PPPoE underlying logical interface.

up-name user-plane-name

The BNG User Plane for which you want to view PPPoE information.

Required Privilege Level

view

Output Fields

Table 28 lists the output fields for the show user-plane pppoe lockout command. Output fields are listed in the approximate order in which they appear.

Table 28: show user-plane pppoe lockout Output Fields

Field Name

Field Description

underlying-interface-name

Name of the PPPoE underlying logical interface.

Index

Index number of the logical interface, which reflects its initialization sequence.

Device

Name of the physical interface or aggregated Ethernet bundle.

SVLAN

Stacked VLAN ID, also known as the outer tag.

VLAN

VLAN ID, also know as the inner tag.

VPI

Virtual path identifier value for the PPPoE client.

VCI

Virtual circuit identifier value for the PPPoE client.

Short-Cycle Protection

State of PPPoE short-cycle protection, also known as PPPoE subscriber session lockout, on the underlying interface:

  • circuit-id—Filters PPPoE client sessions by their agent circuit identifier (ACI) value when configured for short-cycle protection

  • mac-address—Filters PPPoE client sessions by their unique media access control (MAC) address when configured for short-cycle protection

  • off—Short-cycle protection not configured for PPPoE client sessions

Enabling short-cycle protection temporarily prevents (locks out) a failed or short-lived (short-cycle) PPPoE subscriber session from reconnecting to the router for a default or configurable period of time.

Lockout Time (seconds)

Displays the PPPoE lockout time range, the number of PPPoE clients in lockout condition, and the number of PPPoE clients in a lockout grace period:

  • Min—Minimum lockout time, in seconds, configured on the PPPoE underlying interface.

  • Max—Maximum lockout time, in seconds, configured on the PPPoE underlying interface.

  • Total clients in lockout—Number of PPPoE clients currently undergoing lockout.

  • Total clients in lockout grace period—Number of PPPoE clients currently in a lockout grace period. A lockout grace period occurs when the time between lockout events is greater than either 15 minutes or the maximum lockout time.

Client Address

MAC source address or agent circuit idenfiier (ACI) value of the PPPoE client.

Current

Current lockout time, in seconds; displays 0 (zero) if the PPPoE client is not undergoing lockout.

Elapsed

Time elapsed into the lockout period, in seconds; displays 0 (zero) if the PPPoE client is not undergoing lockout

Next

Lockout time, in seconds, that the router uses for the next lockout event; displays a nonzero value if the PPPoE client is currently in a lockout grace period.

Sample Output

show user-plane pppoe lockout up-name

show user-plane pppoe lockout up-name

show user-plane pppoe service-name-tables

Syntax

Description

Display configuration information about PPPoE service name tables, for the specified BNG User Plane.

Options

none

Display the names of configured PPPoE service name tables.

table-name

(Optional) Name of a configured PPPoE service name table.

up-name user-plane-name

The BNG User Plane for which you want to view PPPoE service name table information.

Required Privilege Level

view

Output Fields

Table 29 lists the output fields for the show user-plane pppoe service-name-tables command. Output fields are listed in the approximate order in which they appear.

Table 29: show user-plane pppoe service-name-tables Output Fields

Field Name

Field Description

Level of Output

Service Name Table

Name of the PPPoE service name table.

none

Service Name

Name of a configured service in the PPPoE service name table:

  • <empty>—Service of zero length that represents an unspecified service

  • <any>—Default service for non-empty service entries that do not match the configured empty or named service entries

  • service-name—Named service entry

none

Action

Action taken when the PPPoE underlying interface interface receives a PPPoE Active Discovery Initiation (PADI) packet with the specified named service, empty service, any service, or ACI/ARI pair:

  • Delay seconds—Number of seconds that the interface delays before responding with a PPPoE Active Discovery Offer (PADO) packet

  • Drop—Interface drops (ignores) the packet.

  • Terminate—Interface responds immediately with a PADO packet

none

Dynamic Profile

Name of the dynamic profile with which the router creates a dynamic PPPoE subscriber interface. A dynamic profile can be assigned to a named service, empty service, any service, or ACI/ARI pair.

none

Routing Instance

Name of the routing instance in which to instantiate the dynamic PPPoE subscriber interface. A routing instance can be assigned to a named service, empty service, any service, or ACI/ARI pair.

none

Max Sessions

Maximum number of active PPPoE sessions that the router can establish with the specified named service, empty service, or any service.

none

Active Sessions

Current count of active PPPoE sessions created using the specified named service, empty service, or any service. The Active Sessions value cannot exceed the Max Sessions value.

none

ACI

Agent circuit identifier (ACI) that corresponds to the DSLAM interface that initiated the client service request. An asterisk is interpreted as a wildcard character and can appear at the beginning, the end, or both the beginning and end of the string. An ACI can be configured as part of an ACI/ARI pair for a named service, empty service, or any service.

none

ARI

Agent remote identifier (ARI) that corresponds to the subscriber associated with the DSLAM interface that initiated the service request. An asterisk is interpreted as a wildcard character and can appear at the beginning, the end, or both at the beginning and end of the string. An ARI can be configured as part of an ACI/ARI pair for a named service, empty service, or any service.

none

Static Interface

Name of the static PPPoE interface reserved for exclusive use by the PPPoE client with matching ACI/ARI information. A static interface can be configured only for an ACI/ARI pair.

none

Sample Output

show user-plane pppoe service-name-tables up-name

show user-plane pppoe service-name-tables up-name

show user-plane pppoe sessions

Syntax

Description

Display information about all active PPPoE sessions on the router, or about the active PPPoE sessions established for a specified service name, agent circuit identifier (ACI), or agent remote identifier (ARI).

Options

none

Display information for all active PPPoE sessions on the router.

aci circuit-id-string

(Optional) Display information only for active PPPoE sessions established with the specified agent circuit identifier. The agent circuit identifier corresponds to the DSLAM interface that initiated the service request.

ari remote-id-string

(Optional) Display information only for active PPPoE sessions established with the specified agent remote identifier. The agent remote identifier corresponds to the subscriber associated with the DSLAM interface that initiated the service request.

service service-name

(Optional) Display information only for active PPPoE sessions established with the specified service, where service-name can be empty, any, or a named service.

up-name user-plane-name

The BNG User Plane for which you want to view active PPPoE sessions.

Required Privilege Level

view

Output Fields

Table 30 lists the output fields for the show user-plane pppoe sessions command. Output fields are listed in the approximate order in which they appear.

Table 30: show user-plane pppoe sessions Output Fields

Field Name

Field Description

Level of Output

Interface

Name of the statically-created or dynamically-created PPPoE interface for the active PPPoE session.

none

Underlying interface

Interface on which PPPoE is running.

none

State

State of the PPPoE session; displays Session Up for active PPPoE sessions.

none

Session ID

PPPoE session identifier.

none

Remote MAC

MAC address of the remote side of the connection, either the access concentrator or the PPPoE client.

none

Sample Output

show user-plane pppoe sessions up-name

show user-plane pppoe statistics

Syntax

Description

Display statistics information about PPPoE interfaces.

Options

none

Display PPPoE statistics for all interfaces.

logical-interface-name

(Optional) Name of a PPPoE underlying logical interface.

up-name user-plane-name

The BNG User Plane for which you want to view PPPoE statistics.

Required Privilege Level

view

Output Fields

Table 31 lists the output fields for the show user-plane pppoe statistics command. Output fields are listed in the approximate order in which they appear.

Table 31: show user-plane pppoe statistics Output Fields

Field Name

Field Description

Active PPPoE sessions

Total number of active PPPoE sessions and the number of packets sent and received during the PPPoE session, categorized by packet type and packet errors:

  • PADI—PPPoE Active Discovery Initiation packets.

  • PADO—PPPoE Active Discovery Offer packets.

  • PADR—PPPoE Active Discovery Request packets.

  • PADS—PPPoE Active Discovery Session-Confirmation packets.

  • PADT—PPPoE Active Discovery Termination packets.

  • Service name error—Packets for which the Service-Name request could not be honored.

  • AC system error—Packets for which the access concentrator experienced an error in performing the host request. For example, the host had insufficient resources to create a virtual circuit.

  • Generic error—Packets that indicate an unrecoverable error occurred.

  • Malformed packets—Malformed or short packets that caused the packet handler to discard the frame as unreadable.

  • Unknown packets—Unrecognized packets.

Timeouts

Information about timeouts that occurred during the PPPoE session (not displayed for M120, M320, and MX Series routers):

  • PADI—No PADR packet has been received within the timeout period. (This value is always zero and is not supported.)

  • PADO—No PPPoE Active Discovery Offer packet has been received within the timeout period.

  • PADR—No PADS packet has been received within the timeout period.

Sample Output

show user-plane pppoe statistics up-name

show user-plane pppoe underlying-interfaces

Syntax

Description

Display information about PPPoE underlying interfaces.

Options

brief | detail | extensive

(Optional) Display the specified level of output.

lockout

(Optional) Display summary information about the lockout condition and the lockout grace period for PPPoE clients on the PPPoE underlying interface.

logical-interface-name

(Optional) Name of a PPPoE underlying logical interface.

up-name user-plane-name

The BNG User Plane for which you want to view PPPoE underlying interfaces information.

Required Privilege Level

view

Output Fields

Table 32 lists the output fields for the show user-plane pppoe underlying-interfaces command. Output fields are listed in the approximate order in which they appear.

Table 32: show user-plane pppoe underlying-interfaces Output Fields

Field Name

Field Description

Level of Output

Underlying Interface

Name of the PPPoE underlying logical interface.

All levels

Service Name Table

Name of the service name table.

All levels

Dynamic Profile

Name of the dynamic profile that was used to create this interface. If the interface was statically created, then the value is none.

All levels

Index

Index number of the logical interface, which reflects its initialization sequence.

detail extensive

State

Origin of the logical interface: Static or Dynamic. Indicates whether the interface was statically or dynamically created.

detail extensive

Operational States

Fields in this block are actual operational values rather than simply the configured values. The operational values can be the result of RADIUS-initiated changes.

detail extensive

Max Sessions

Maximum number of PPPoE logical interfaces that can be activated on the underlying interface. When this number of logical interfaces has been established, all subsequent PPPoE Active Discovery Initiation (PADI) packets are dropped and all subsequent PPPoE Active Discovery Request (PADR) packets trigger PPPoE Active Discovery Session (PADS) error responses.

detail extensive

Max Sessions VSA Ignore

Whether the router is configured to ignore (clear) the PPPoE maximum session value returned by RADIUS in the Max-Clients-Per-Interface Juniper Networks VSA [26-143] and restore the PPPoE maximum session value on the underlying interface to the value configure with the max-sessions statement: Off (default) or On.

detail extensive none

Active Sessions

Number of active PPPoE sessions on the underlying interface. If a dynamic profile is listed, then it is the number of active PPPoE sessions on the underlying interface that are using this profile. The Active Sessions value must not exceed the Max Sessions value.

detail extensive

Agent Circuit Identifier

Whether the underlying interface is configured with the agent-circuit-identifier statement to enable creation of autosensed dynamic VLAN subscriber interfaces based on agent circuit identifier (ACI) information.

Autosensing indicates that creation of ACI-based dynamic VLAN interfaces is enabled on the underlying interface. If creation of ACI-based dynamic VLANs is not configured on the underlying interface, this field does not appear.

Note:

The Agent Circuit Identifier field is replaced with the Line Identity field when an ALI interface set is configured with the line-identity autoconfiguration stanza.

detail extensive none

Line Identity

Whether the underlying interface is configured with the line-identity statement to enable creation of autosensed dynamic VLAN subscriber interfaces based on the specified trusted option: ACI, ARI, both, or neither.

Autosensing indicates that creation of ALI-based dynamic VLAN interfaces is enabled on the underlying interface. If creation of ALI dynamic VLANs based on trusted options is not configured on the underlying interface, this field does not appear.

Note:

The Line Identity field is replaced with the ACI VLAN field when an ACI interface set is configured with the agent-circuit-id autoconfiguration stanza.

detail extensive none

Duplicate Protection

State of PPPoE duplicate protection: On or Off. When duplicate protection is configured for the underlying interface, a dynamic PPPoE logical interface cannot be activated when an existing active logical interface is present for the same PPPoE client. The uniqueness of the PPPoE client is determined by the client's MAC address.

detail extensive

Short Cycle Protection

State of PPPoE short cycle protection: mac-address, circuit-id, or Off. Enabling short cycle protection, also known as PPPoE lockout, on the PPPoE underlying interface temporarily prevents (locks out) a failed or short-lived (short-cycle) PPPoE subscriber session from reconnecting to the router for a default or configurable period of time. PPPoE client sessions are identified by their unique media access control (MAC) source address or agent circuit identifier (ACI) value.

detail extensive

Direct Connect

State of the configuration to ignore DSL Forum VSAs: On or Off. When configured, the router ignores any of these VSAs received from a directly connected CPE device on the interface.

detail extensive none

AC Name

Name of the access concentrator.

detail extensive

PacketType

Number of packets sent and received during the PPPoE session, categorized by packet type and packet errors:

  • PADI—PPPoE Active Discovery Initiation packets.

  • PADO—PPPoE Active Discovery Offer packets.

  • PADR—PPPoE Active Discovery Request packets.

  • PADS—PPPoE Active Discovery Session-Confirmation packets.

  • PADT—PPPoE Active Discovery Termination packets.

  • Service name error—Packets for which the Service-Name request could not be honored.

  • AC system error—Packets for which the access concentrator experienced an error in performing the host request. For example, the host had insufficient resources to create a virtual circuit.

  • Generic error—Packets that indicate an unrecoverable error occurred.

  • Malformed packets—Malformed or short packets that caused the packet handler to discard the frame as unreadable.

  • Unknown packets—Unrecognized packets.

detail extensive

Lockout Time (sec)

The PPPoE lockout time range, the number of PPPoE clients in lockout condition, and the number of PPPoE clients in a lockout grace period if Short Cycle Protection is enabled (On):

  • Min—Minimum lockout time, in seconds, configured on the PPPoE underlying interface.

  • Max—Maximum lockout time, in seconds, configured on the PPPoE underlying interface.

  • Total clients in lockout—Number of PPPoE clients currently undergoing lockout.

  • Total clients in lockout grace period—Number of PPPoE clients currently in a lockout grace period. A lockout grace period occurs when the time between lockout events is greater than either 15 minutes or the maximum lockout time.

extensive

Client Address

MAC source address of the PPPoE client.

extensive

Current

Current lockout time, in seconds; displays 0 (zero) if the PPPoE client is not undergoing lockout.

extensive

Elapsed

Time elapsed into the lockout period, in seconds; displays 0 if the PPPoE client is not undergoing lockout

extensive

Next

Lockout time, in seconds, that the router uses for the next lockout event; displays a nonzero value if the PPPoE client is currently in a lockout grace period.

extensive

Sample Output

show user-plane pppoe underlying-interfaces brief up-name

show user-plane pppoe underlying-interfaces detail up-name

show user-plane pppoe underlying-interfaces extensive up-name

show user-plane route

Syntax

Description

Display information about how routes are mapped to specific enhanced subscriber management interfaces. You can customize the output by including one or more optional filters in the command. With the exception of the summary option, all filter options can be combined in a single command.

Note:

This command is only run on BNG User Planes.

Options

family family

(Optional) Display route mapping information for the specified protocol family: inet (IPv4) or inet6 (IPv6).

incomplete

(Optional) Display route mapping information for incomplete routes that are missing elements required to add the routes to the routing table.

level (brief | detail)

(Optional) Display the specified level of output: brief or detail.

next-hop index

(Optional) Display the next hop associated with the route entry with the specified next-hop index, in the range 1 through 65535.

prefix address

(Optional) Use the same prefix and prefix length as the subscriber host address. Output includes attributes that originate in the Famed-Route record of an upstream RADIUS server (Tag, Metric, Preference).

route-type type

(Optional) Display route mapping information for the specified route type: access, access-internal, kernel, or local.

routing-instance name

(Optional) Display route mapping information for the specified routing-instance

rrt-index index

(Optional) Display mapping information for the specified routing table index, in the range 0 through 65535. An rtt-index value of 0 (zero) denotes routes in the default routing table managed by enhanced subscriber management.

summary user-plane-name

(Optional) Display summary information about the routes managed by enhanced subscriber management for the specified BNG User Plane.

up-name user-plane-name

The BNG User Plane for which to display information about the routes managed by enhanced subscriber management.

Required Privilege Level

view

Output Fields

Table 33 lists the output fields for the show user-plane route command. Output fields are listed in the approximate order in which they appear.

Table 33: show user-plane route Output Fields

Field Name

Field Description

Level of Output

address

IPv4 or IPv6 address associated with the route entry.

All levels

Route

IPv4 or IPv6 address associated with the route entry.

All levels

Route Type

One of the following route types:

  • Access

  • Access-internal

  • Framed

  • Kernel

  • Local

All levels

Interface

Name of the enhanced subscriber management interface associated with the route entry.

All levels

Next-hop

Next-hop associated with the route entry.

All levels

Tag

Reflects the Tag attribute used in the RADIUS Framed-Route type record.

All levels

Metric

Reflects the Metric attribute used in the RADIUS Framed-Route type record.

All levels

Preference

Reflects the Preference attribute used in the RADIUS Framed-Route type record.

All levels

Rtt-index

Value of the routing table index. A value of 0 (zero) denotes a route in the default routing table managed by enhanced subscriber management.

detail

Bbe index

Value of the interface index for the control plane.

detail

Flow id

Value of the route object index.

detail

Reference Count

Used for internal accounting.

detail

Discard route count

Number of discard routes.

Summary

Discard route gateway

Number of gateway routes.

Summary

Dirty Flags

Used for internal accounting.

detail

Flags

Used for internal accounting.

detail

Family

One of the following protocol families:

  • AF_INET—IPv4

  • AF_INET6—IPv6

detail

UP Name

Name of the BNG User Plane.

All levels

Kernel rt-table id-instance

The kernel routing table ID number.

Summary

Local route count

The number of local routes.

Summary

Access route count

The number of access routes.

Summary

Access internal route count

The number of access internal routes.

Summary

Kernel route count

The number of kernel routes.

Summary

Dirty local route count

The number of local routes that have not been fully installed. It is always 0 for the active RE for the BNG User Plane. It can be non-zero for the standby RE (representing a transient condition).

Summary

Dirty access route count

The number of access routes that have not been fully installed. It is always 0 for the active RE for the BNG User Plane. It can be non-zero for the standby RE (representing a transient condition).

Summary

Dirty access internal route count

The number of access-internal routes that have not been fully installed. It is always 0 for the active RE for the User Plane. It can be non-zero for the standby RE (representing a transient condition).

Summary

Dirty kernel route count

The number of kernel routes that have not been fully installed. It is always 0 for the active RE for the BNG User Plane. It can be non-zero for the standby RE (representing a transient condition).

Summary

Dirty inflight route count

The number of inflight routes that have not been fully installed. It is always 0 for the active RE for the BNG User Plane. It can be non-zero for the standby RE (representing a transient condition).

Summary

Sample Output

show user-plane route up-name

show user-plane route summary up-name up-exampl-1

show user-plane route summary

show user-plane route route-type discard

show user-plane route prefix <address>

rtt-index 0

show user-plane route family route-type rtt-index level brief

The following example displays abbreviated information about IPv6 access routes in the default routing table (rtt-index 0) managed by enhanced subscriber management.

show user-plane route family route-type rtt-index level detail

The following example displays detailed information about IPv6 access routes in the default routing table (rtt-index 0) managed by enhanced subscriber management.

show user-plane route family route-type rtt-index level brief

The following example displays abbreviated information about IPv6 access routes in the default routing table (rtt-index 0) managed by enhanced subscriber management.

show user-plane routing-instances

Syntax

Description

Displays routing instances in use by a particular BNG User Plane.

Options

bng-user-plane

The BNG User Plane for which you want to know the routing instance that are being used.

Required Privilege Level

view

Output Fields

Table 33 lists the output fields for the show user-plane routing-instances command. Output fields are listed in the approximate order in which they appear.

Table 34: show user-plane routing-instances Output Fields

Field Name

Field Description

User Plane

Name of the BNG User Plane.

Routing Instance Name

Name of the routing instance.

State

The routing instance state:

  • Connected—The node is connected to the network.

  • Isolated—The node is isolated from the rest of the network.

Sample Output

show user-plane routing-instances

show user-plane statistics

Syntax

Description

Display statistics for the specified BNG User Plane. You can customize the output by including one or more optional filters in the command.

Options

all

(Optional) Display packet statistics for all protocols.

dhcp

(Optional) Display DHCP packet statistics.

dvlan

(Optional) Display DVLAN packet statistics.

l2tp

(Optional) Display L2TP packet statistics.

ppp

(Optional) Display PPP packet statistics.

pppoe

(Optional) Display PPPoE packet statistics.

up-name user-plane-name

The BNG User Plane for which you want to view packet statistics.

Required Privilege Level

view

Output Fields

Table 35 lists the output fields for the show user-plan statistics command. Output fields are listed in the approximate order in which they appear.

Table 35: show user-plane statistics Output Fields

Field Name

Field Description

User-plane

The BNG User Plane for which the information is being displayed.

Rx Statistics

Statistics for packets received.

Tx Statistics

Statistics for packets sent.

Enhanced I/O Statistics

Statistics for visibility into packet drops from the queue.

Error Statistics

Includes connection packets, flow control, and messages and packets sent to and received from the daemon.

ERA discards

Event Rate Analyzer discards. For DHCP and PPPoE in advanced subscriber management, ERA packet discard counts are included for Discover, Solicit, and PADI packets .

Layer 3 Statistics

Statistics for Layer 3 packets.

padis

PPPoE Active Discovery Initiation (PADI) packets.

PADI is the first step in the PPPoE establishment protocol.

padrs

PPPoE Active Discovery Request packets.

ppp

Point-to-Point Protocol packets.

router solicitations

Number of router solicitations sent or received.

Router solicitations are sent to prompt all on-link routers to send it router advertisements.

router advertisements

Number of router advertisements sent or received.

Sample Output

show user-plane statistics up-name

show user-plane statistics pppoe up-name

request network-access aaa address-assignment domain-profile

Syntax

Description

Enable or disable logins for existing domains created from the domain profile and to control the creation of new domains from the domain profile.

Options

ri-name routing-instance-name

Specify the routing instance name.

profile-name profile-name

Specify the name of the profile.

[enable-login | disable-login]

Specify the desired action.

Required Privilege Level

root

Output Fields

When you enter this command, you receive feedback only if an error occurs.

request network-access aaa address-assignment user-plane

Syntax

Description

Enable or disable logins for subscribers originating from the specified BNG User Plane. When you use this command, you effectively enable or disable logins for existing domains associated with the BNG User Plane. You also control the creation of new domains for the BNG User Plane.

Options

user-plane user-plane-name Specify the BNG User Plane name.
[enable-login | disable-login] Specify the desired action.

Required Privilege Level

root

Output Fields

When you enter this command, you receive feedback only if an error occurs.

request user-plane maintenance associate serviced-user-plane

Syntax

Description

Creates a backup of a BNG User Plane. You can run this command multiple times for each logical port active and backup pair.

Options

serviced-user-plane user-plane-name

Specify the serviced BNG User Plane name.

serviced-port port-number

Specify the serviced port number.

backup-user-plane user-plane-name

Specify the backup BNG User Plane name.

backup-port port-number

Specify the backup port number.

Required Privilege Level

root

Output Fields

When you enter this command, you receive feedback only if an error occurs.

request user-plane maintenance complete serviced-user-plane

Syntax

Description

Completes the maintenance operation for a BNG User Plane. The command ensures that all resources that were used for the maintenance operation are restored.

Options

serviced-user-plane user-plane-name

Specify the BNG User Plane name that was serviced as part of the maintenance operation.

Required Privilege Level

root

Output Fields

When you enter this command, you receive feedback only if an error occurs.

request user-plane maintenance disassociate serviced-user-plane

Syntax

Description

Remove the active and backup BNG User Plane association and remove the database synchronization.

Options

serviced-user-plane user-plane-name

Specify the serviced BNG User Plane name.

serviced-port port-number

Specify the serviced port number.

backup-user-plane user-plane-name

Specify the backup BNG User Plane name.

backup-port port-number

Specify the backup port number.

Required Privilege Level

root

Output Fields

When you enter this command, you receive feedback only if an error occurs.

request user-plane maintenance switchover serviced-user-plane

Syntax

Description

Switch the role of the active and the backup BNG User Planes for the logical port pairing.

Options

serviced-user-plane user-plane-name

Specify the serviced BNG User Plane name.

Required Privilege Level

root

Output Fields

When you enter this command, you receive feedback only if an error occurs.

restart bbe-cpm-daemon

Syntax

Description

Restarts the Control Plane Manager daemon.

Options

This command does not have any options.

Required Privilege Level

root

Output Fields

When you enter this command, you receive feedback on the status of your request. This command runs on the BNG CUPS Controller.

Sample Output

restart bbe-cpm-daemon

restart bbe-stats-daemon

Syntax

Description

Restarts the Enhanced Session Management Statistics daemon.

Options

This command does not have any options.

Required Privilege Level

root

Output Fields

When you enter this command, you receive feedback on the status of your request. This command runs on the BNG CUPS Controller.

Sample Output

restart bbe-stats-daemon

restart bbe-stats-svcsd

Syntax

Description

Restarts the Statistics Services daemon.

Options

This command does not have any options.

Required Privilege Level

root

Output Fields

When you enter this command, you receive feedback on the status of your request. This command runs on the BNG User Planes.

Sample Output

restart bbe-stats-svcsd

restart bbe-upm-daemon

Syntax

Description

Restarts the User Plane Manager daemon. This command runs on the BNG CUPS Controller.

Options

This command does not have any options.

Required Privilege Level

root

Output Fields

When you enter this command, you receive feedback on the status of your request.

Sample Output

restart bbe-upm-daemon

restart bbe-upsf-daemon

Syntax

Description

Restarts the User Plane Selection Function daemon. This command runs on the BNG CUPS Controller.

Options

This command does not have any options.

Required Privilege Level

root

Output Fields

When you enter this command, you receive feedback on the status of your request.

Sample Output

restart bbe-upsf-daemon

restart cp-smg-server

Syntax

Description

Restarts the Enhanced Session Management BNG CUPS Controller process. This command runs on the BNG CUPS Controller.

Options

This command does not have any options.

Required Privilege Level

root

Output Fields

When you enter this command, you receive feedback on the status of your request.

Sample Output

restart cp-smg-server

restart replication-client-process

Syntax

Description

Restarts the Replication Client Process. A BNG User Plane hosts the Replication Client Process daemon and the Replication Server Process daemon. These daemons replicate the state between the BNG CUPS Controller and the BNG User Plane and the routing engines. This command runs on the BNG CUPS Controller.

Avoid using this command unless Juniper Networks Technical Assistance Center (JTAC) directs you to use it.

Options

This command does not have any options.

Required Privilege Level

root

Output Fields

When you enter this command, you receive feedback on the status of your request.

Sample Output

restart replication-client-process

restart replication-server-process

Syntax

Description

Restarts the Replication Server Process. A BNG User Plane hosts the Replication Client Process daemon and the Replication Server Process daemon. These daemons replicate the state between the BNG CUPS Controller and the BNG User Plane and the routing engines. This command runs on the BNG CUPS Controller.

Avoid using this command unless Juniper Networks Technical Assistance Center (JTAC) directs you to use it.

Options

This command does not have any options.

Required Privilege Level

root

Output Fields

When you enter this command, you receive feedback on the status of your request.

Sample Output

restart replication-server-process

restart up-helper-service

Syntax

Description

Restarts the Enhanced BBE Helper BNG User Plane process. This command runs on the BNG User Plane.

Options

This command does not have any options.

Required Privilege Level

root

Output Fields

When you enter this command, you receive feedback on the status of your request.

Sample Output

restart up-helper-service

restart up-smg-server

Syntax

Description

Restarts the Enhanced Session Management BNG User Plane process. This command runs on the BNG CUPS Controller.

Options

This command does not have any options.

Required Privilege Level

root

Output Fields

When you enter this command, you receive feedback on the status of your request.

Sample Output

restart up-smg-server