Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

Announcement: Try the Ask AI chatbot for answers to your technical questions about Juniper products and solutions.

close
header-navigation
keyboard_arrow_up
close
keyboard_arrow_left
Junos CLI Reference
Table of Contents Expand all
list Table of Contents

show ancp subscriber

date_range 17-Dec-24

Syntax

content_copy zoom_out_map
show ancp subscriber
<brief | detail>
<access-aggregation-circuit-id circuit-identifier>
<identifier identifier>
<ip-address ip-address>
<system-name mac-address>

Description

Display information about active subscribers regardless of the subscriber’s operational state, for all subscribers (local access loops), the subscriber associated with the access line specified by an ACI, or the subscriber associated with the specified ANCP neighbor (access node).

After an ancpd restart, this command displays orphaned entries (marked with an o) for subscriber sessions that were established before the restart but which have not yet been reestablished. As sessions are reestablished, the number of orphaned entries displayed by the command decreases. The number reaches zero when all sessions are reestablished or when the orphaned-interface timer expires.

Options

none

Display information about all subscribers.

brief | detail

(Optional) Display the specified level of detail.

access-aggregation-circuit-id circuit-identifier

(Optional) Display information about ANCP subscribers whose Access-Aggregation-Circuit-ID-ASCII attribute (TLV 0x0003) matches the specified value.

A circuit-identifier that begins with the# character indicates a backhaul line identifier. You can specify a wildcard (*) anywhere in the string.

identifier identifier

(Optional) Display information about the subscriber associated with the access line (ACI) specified by the access identifier.

ip-address ip-address

(Optional) Display information about the subscribers connected to the access node specified by the IP address.

system-name mac-address

(Optional) Display information about the subscribers connected to the access node specified by the MAC address.

Required Privilege Level

view

Output Fields

Table 1 lists the output fields for the show ancp subscriber command. Output fields are listed in the approximate order in which they appear.

Table 1: show ancp subscriber Output Fields

Field Name

Field Description

Level of Output

Loop Identifier

Access loop identifier as sent by the access node and configured to map the subscriber to an interface.

An asterisk (*) indicates that the information might be stale due to receiving a Port Down message with a DSL Line State of Idle.

Two asterisks (**) indicate that the neighbor associated with the subscriber has lost its adjacency. In this case, the DSL Line State might be Established.

An o indicates that the entry is for an orphaned interface and represents a previously established subscriber session that has not been reestablished after an ancpd restart.

The number of orphaned entries decreases as the ANCP neighbors reestablish adjacencies and the protocol subscriber sessions are reestablished. The command output indicates this by removing the o marker.

Eventually the number of orphaned entries reaches zero, because either all the adjacencies and subscriber sessions have been reestablished or any remaining orphaned entries are removed when the orphaned-interface timer expires.

brief none

DSL Line State

State of the DSL line: Idle, Showtime, or Silent.

brief detail

Access Type

Type of access line employed by the access node: ADSL1, ADSL2, ADSL2+, VDSL1, VDSL2, SDSL, G.fast, VDSL2 Annex Q, SDSL bonded, VDSL2 bonded, G.fast bonded VDSL2 Annex Q bonded or OTHER.

brief detail none

Interface

Name of the interface set or logical interface.

brief detail none

Rate Kbps

Actual downstream data rate for this local loop.

brief none

Neighbor

IP address of ANCP neighbor (access node).

brief none

Access Loop Circuit Identifier

Access loop circuit identifier as sent by the access node and configured to map the subscriber to an interface.

An asterisk (*) indicates that the information might be stale due to receiving a Port Down message with a DSL Line State of Idle.

Two asterisks (**) indicate that the neighbor associated with the subscriber has lost its adjacency. In this case, the DSL Line State might be Established.

detail

Neighbor IP Address

IP address of the ANCP neighbor (access node).

detail

Aggregate Circuit Identifier

ASCII identifier for the subscriber access loop; value of the Access-Aggregation-Circuit-ID-ASCII attribute (TLV 0x0003).

detail

Aggregate Circuit Identifier Binary

Binary identifier for the VLAN circuit ID.

detail

Tech Type

Type of technology employed by the subscriber. Currently Junos OS supports DSL technology type only.

detail

DSL Line Data Link

Data link protocol employed on the access loop: AAL5 or Ethernet.

detail

DSL Line Encapsulation

Encapsulation type on the access loop, for Ethernet only:

  • 0—NA, type not conveyed

  • 1—Untagged Ethernet

  • 2—Single-tagged Ethernet

detail

DSL Line Encapsulation Payload

Payload carried across the access loop:

  • 0—NA, type not conveyed

  • 1—PPPoA LLC

  • 2—PPPoA null

  • 3—IPoA LLC

  • 4—IPoA null

  • 5—Ethernet over AAL5 LLC with FCS

  • 6—Ethernet over AAL5 LLC without FCS

  • 7—Ethernet over AAL5 null with FCS

  • 8—Ethernet over AAL5 null without FCS

detail

Interface Type

Type of interface employed for subscriber traffic: ifl for a single VLAN or interface-set for a configured group of VLANs.

detail

Actual Net Data Upstream

Actual upstream data rate for this local loop, in Kbps.

detail

Actual Net Data Downstream

Actual downstream data rate for this local loop, in Kbps.

detail

Minimum Net Data Upstream

Minimum upstream data rate desired by the operator for this local loop, in Kbps.

detail

Minimum Net Data Downstream

Minimum downstream data rate desired by the operator for this local loop, in Kbps.

detail

Maximum Net Data Upstream

Maximum upstream data rate desired by the operator for this local loop, in Kbps.

detail

Maximum Net Data Downstream

Maximum downstream data rate desired by the operator for this local loop, in Kbps.

detail

Attainable Net Data Upstream

Maximum attainable upstream data rate for this local loop, in Kbps.

detail

Attainable Net Data Downstream

Maximum attainable downstream data rate for this local loop, in Kbps.

detail

Minimum Low Power Data Downstream

Minimum downstream data rate desired by the operator for this local loop in low power state, in Kbps.

detail

Minimum Low Power Data Upstream

Minimum upstream data rate desired by the operator for this local loop in low power state, in Kbps.

detail

Maximum Interleave Delay Downstream

Maximum interleaving delay for downstream data, in milliseconds.

detail

Maximum Interleave Delay Upstream

Maximum interleaving delay for upstream data, in milliseconds.

detail

Actual Interleave Delay Downstream

Actual interleaving delay for downstream data, in milliseconds.

detail

Actual Interleave Delay Upstream

Actual interleaving delay for upstream data, in milliseconds.

detail

Port-Up Timestamp

Timestamp when port comes up or port enabled. detail

Port Down Timestamp

Timestamp when port goes down or disabled. detail

Port Down Event

Reason for port to be disabled. detail

Sample Output

show ancp subscriber

content_copy zoom_out_map
user@host> show ancp subscriber
  Loop Identifier        DSL Line  Tech Type     Access Type   Interface       Rate   Neighbor
                         State                                Kbps
**circuit 101            Idle      DSL       ADSL1    ----              32       203.0.113.13
**circuit 102            Idle      DSL       ADSL1    ----              32       203.0.113.13
  circuit 301            Showtime  DSL       ADSL1    ----              32       203.0.113.15
  circuit 302            Showtime  DSL       ADSL1    ----              32       203.0.113.15

show ancp subscriber (After ancpd Restart)

content_copy zoom_out_map
user@host> show ancp subscriber
  Loop Identifier        DSL Line  Tech Type     Access Type  Interface         Rate     Neighbor
                         State                                Kbps
o circuit 201            Showtime  DSL        ADSL1    ----              222222       
o circuit 202            Showtime  DSL        ADSL1    ----              222222       

show ancp subscriber brief

content_copy zoom_out_map
user@host> show ancp subscriber brief

  Loop Identifier          Type      Interface        Rate          Neighbor
                                                      Kbps
  port-1-10                VDSL2    set-ge-10410       64       203.0.113.102      
  port-1-11                VDSL2    set-ge-10411       64       203.0.113.111      
  port-2-10                VDSL2    ge-1/0/4.12        64       203.0.113.112  
  port-2-11                VDSL2    ge-1/0/4.13        64       203.0.113.113      

show ancp subscriber detail (Access type DSL)

content_copy zoom_out_map
user@host> show ancp subscriber detail
 Subscriber Information
*  Access Loop Circuit Identifier : circuit 101
     Neighbor IP Address                  : 203.0.113.13
     Aggregate Circuit Identifier Binary  : 0/0
     Tech Type																	 : DSL
     Access Type                          : ADSL1
     DSL Line State                       : Idle
     DSL Line Data Link                   : Data link 2
     DSL Line Encapsulation               : N/A
     DSL Line Encapsulation Payload       : N/A
     Interface Type                       : N/A
     Interface                            : ----
     Actual Net Data Upstream             : 32
     Actual Net Data Downstream           : 32
     Minimum Net Data Upstream            : 0
     Minimum Net Data Downstream          : 0
     Maximum Net Data Upstream            : 0
     Maximum Net Data Downstream          : 0
     Attainable Net Data Upstream         : 1024
     Attainable Net Data Downstream       : 8192
     Minimum Low Power Data Downstream    : 32
     Minimum Low Power Data Upstream      : 32
     Maximum Interleave Delay Downstream  : 20
     Maximum Interleave Delay Upstream    : 20
     Actual Interleave Delay Downstream   : 20
     Actual Interleave Delay Upstream     : 20
*  Access Loop Circuit Identifier: circuit 102
     Neighbor IP Address                  : 213.0.113.13
     Aggregate Circuit Identifier Binary  : 0/0
     Tech Type																	 : DSL  
     Access Type                          : ADSL1
     DSL Line State                       : Idle
     DSL Line Data Link                   : Data link 2
     DSL Line Encapsulation               : N/A
     DSL Line Encapsulation Payload       : N/A
     Interface Type                       : N/A
     Interface                            : ----
     Actual Net Data Upstream             : 32
     Actual Net Data Downstream           : 32
     Minimum Net Data Upstream            : 0
     Minimum Net Data Downstream          : 0
     Maximum Net Data Upstream            : 0
     Maximum Net Data Downstream          : 0
     Attainable Net Data Upstream         : 1024
     Attainable Net Data Downstream       : 8192
     Minimum Low Power Data Downstream    : 32
     Minimum Low Power Data Upstream      : 32
     Maximum Interleave Delay Downstream  : 20
     Maximum Interleave Delay Upstream    : 20
     Actual Interleave Delay Downstream   : 20
     Actual Interleave Delay Upstream     : 20
...
     Port-Up Timestamp                    : Wed, 12 Sep 2024 18:19:38 
     Port-Down Timestamp                  : Wed, 14 Sep 2024 20:19:00 
     Port-Down Event                      : Orphaned subscriber timeout

show ancp subscriber detail (Access type PON)

content_copy zoom_out_map
user@root> show ancp subscriber detail
Subscriber Information
   Access Loop Circuit Identifier : circuit1
     Neighbor IP Address                  : 192.85.1.4
     Access Loop Remote Identifier        : remote
     Aggregate Circuit Identifier Binary  : 2:1
     Tech Type                            : PON
     Access Type                          : GPON
     Interface Type                       : N/A
     Interface                            : ----
     Line Attributes:
       ONT/ONU Average Data Rate Downstream      :     100000 Kbps
       ONT/ONU Peak Data Rate Downstream         :     200000 Kbps
       ONT/ONU Maximum Data Rate Upstream        :     300000 Kbps
       ONT/ONU Assured Data Rate Upstream        :     300000 Kbps
     Port-Up Timestamp                    : Wed, 14 Aug 2024 18:19:38 
     Port-Down Timestamp                  : Wed, 15 Aug 2024 20:19:00 
     Port-Down Event                      : Orphaned subscriber timeout  

show ancp subscriber access-aggregation-circuit-id detail

content_copy zoom_out_map
user@host> show ancp subscriber access-aggregation-circuit-id "#TEST-DPU-C-100" detail
Subscriber Information
 * Access Loop Circuit Identifier : circuit 201
     Neighbor IP Address                  : 192.0.2.1
     Access Loop Remote Identifier        : remote 123
     Aggregate Circuit Identifier         : #TEST-DPU-C-100
     Aggregate Circuit Identifier Binary  : 50
     Tech Type:                           : DSL
     Interface Type                       : interface
     Interface                            : ge-1/0/0.3221225475
     Actual Net Data Upstream             : 1024
     Actual Net Data Downstream           : 2048
     Maximum Net Data Upstream            : 0 
     Maximum Net Data Downstream          : 0 
* Access Loop Circuit Identifier : circuit 202
     Neighbor IP Address                  : 192.0.2.1
     Access Loop Remote Identifier        : remote 185
     Aggregate Circuit Identifier         : #TEST-DPU-C-100
     Aggregate Circuit Identifier Binary  : 50
     Tech Type:                           : DSL
     Interface Type                       : interface
     Interface                            : ge-1/0/0.3221225476
     Actual Net Data Upstream             : 1024
     Actual Net Data Downstream           : 2048 
     Maximum Net Data Upstream            : 0 
     Maximum Net Data Downstream          : 0 
     Port-Up Timestamp                    : Wed, 14 Aug 2024 18:19:38 
     Port-Down Timestamp                  : Wed, 15 Aug 2024 20:19:00 
     Port-Down Event                      : Orphaned subscriber timeout

show ancp subscriber identifier identifier-string detail

content_copy zoom_out_map
user@host> show ancp subscriber identifier port-1-11 detail  
          Access Loop Identifier : port-1-11             
          Neighbor IP Address                  : 203.0.113.112            
          Aggregate Circuit Identifier Binary  : 0/0                   
          DSL Type                             :  DSL  0               
          Interface Type                       : interface-set             
          Interface                            : set-ge-10411
          DSL Line State                       : Show Time             
          Actual Net Data Upstream             : 64                    
          Actual Net Data Downstream           : 64                    
          DSL Line Data Link                   : AAL5                  
          DSL Line Encapsulation               : N/A                   
          DSL Line Encapsulation Payload       : N/A                   
          Minimum Net Data Upstream            : 64                    
          Minimum Net Data Downstream          : 64                    
          Maximum Net Data Upstream            : 64                    
          Maximum Net Data Downstream          : 64                    
          Attainable Net Data Upstream         : 64                    
          Attainable Net Data Downstream       : 64                    
          Minimum Low Power Data Downstream    : 64                    
          Minimum Low Power Data Upstream      : 64                    
          Maximum Interleave Delay Downstream  : 50                    
          Maximum Interleave Delay Upstream    : 50                    
          Actual Interleave Delay Downstream   : 50                    
          Actual Interleave Delay Upstream     : 50                    
          Port-Up Timestamp                    : Wed, 14 Aug 2024 18:19:38 
          Port-Down Timestamp                  : Wed, 15 Aug 2024 20:19:00 
          Port-Down Event                      : Orphaned subscriber timeout

Release Information

Command introduced in Junos OS Release 9.4.

neighbor option replaced with ip-address in Junos OS Release 16.1.

system-name option introduced in Junos OS Release 16.1.

access-aggregation-circuit-id option introduced in Junos OS Release 18.4R1.

footer-navigation