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 chassis synchronization (MX Series Routers)

date_range 06-Dec-24

Syntax

content_copy zoom_out_map
show chassis synchronization
<clock-module <(re0 | re1 | routing-engine (backup | both | local | master | other))>>
<extensive>
<interface interface-name>

Description

Display information about clocks used for chassis synchronization.

Note:

In hybrid mode, the EEC in the MPC derives frequency synchronization from Synchronous Ethernet and the phase and time of day from PTP; however, the show chassis synchronization extensive operational mode command output displays the lock status that is derived from the EEC located on the SCB.

Note:

The Switch Control Board (SCB) framer in MX Series routers supports only the first-generation Synchronization Status Message (SSM) format. Therefore, whenever the router needs to transmit an SSM value of st3e or tnc via an external interface, an SSM value of st3 is transmitted. However, on a Synchronous Ethernet interface, an ESMC packet with the unadjusted SSM is transmitted. The term unadjusted here means:

  • If the receive-quality statement at the [edit chassis synchronization selection-mode] hierarchy level is configured, the originally received SSM value st3e or tnc (corresponding to the currently active Synchronous Ethernet clock interface) is transmitted.

  • If the configured quality statement at the [edit chassis synchronization selection-mode] hierarchy level is configured, the originally configured SSM value of st3e or tnc (corresponding to the currently active Synchronous Ethernet clock interface) is transmitted.

Note that when the external interface receives an SSM value of either st3e or tnc, the SCB framer does not recognize either of these SSM codes, and therefore, it reports that the Do Not Use (DNU) quality value has been received.

SCBE2 does not support SSM when you configure the following framing format values on the external interface at the [edit chassis synchronization interfaces external] hierarchy level:

  • sf for the t1-options statement

  • g704-no-crc for the e1-options statement

Options

clock-module

(MX240, MX480, MX960, MX10003, MX204, MX2010, MX2020, and MX2008 routers with Enhanced MX Switch Control Board; ) (Optional) Display clock module information. You can optionally specify one of these Routing Engine qualifiers:

re0

Routing Engine 0

re1

Routing Engine 1

routing-engine (backup | both | local | master | other)

Routing Engine type

extensive

(Optional) Display clock synchronization information in detail.

interface interface-name

(Optional) Display clock synchronization information for the specified interface.

Required Privilege Level

maintenance

Output Fields

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

Table 1: show chassis synchronization Output Fields

Field Name

Field Description

Level of Output

Current clock status

Indicates the current status of chassis synchronization:

  • Locked—Clock is operational.

  • Holdover—Clock is not operational.

  • Freerun—Clock is locked to the free-run local oscillator.

none

Clock locked to

Indicates whether the clock is locked to either the primary source or the secondary source.

none

Configured sources

Heading for the list of interfaces configured for chassis synchronization and their subsequent status indicators.

none

Source name

Indicates the configured interface that is the source. The external source name indicates the external clock interface.

none

Configured Priority

Indicates the priority configured for the interface.

none

Interface Status

Indicates the status of the interface as primary, secondary, or n/a (external).

none

Configured quality

Indicates the configured quality of the interface.

  • prs —Primary reference source—Stratum 1

  • st2—Stratum 2

  • tnc—Transit node clock

  • st3e—Stratum 3E

  • st3—Stratum 3

  • smc—SONET minimum clock

  • st4—Stratum 4

  • prc—Primary reference clock

  • ssu-a—Synchronization supply unit A

  • ssu-b—Synchronization supply unit B

  • sec—SDH equipment clock

none

Interface

Indicates the configured interface:

  • ge-fpc/pic/port—Indicates the interface type and which FPC, PIC, and port are configured.

extensive

Status

Indicates the synchronization status of the indicated interface, as follows:

  • Primary—This interface is the selected primary chassis clock source.

  • Secondary—This interface is the selected secondary chassis clock source.

  • n/a—This interface is not a selected clock source.

extensive

Index

Unique numeric identifier for the established Synchronous Ethernet configuration.

extensive

Clock source state

Indicates the status of the Synchronous Ethernet clock source:

  • Clk qualified—The Synchronous Ethernet clock source is qualified.

  • n/a—The Synchronous Ethernet clock source is not qualified.

extensive

Priority

Indicates the configured priority. The range is from 1 through 5. The following values indicate whether the parameter is not specified or undefined:

  • Default(8)—The parameter is not specified.

  • - —The parameter is undefined or out of range.

extensive

Configured QL

Indicates the configured source interface quality level (QL), which is dependent on the source interface and option. The following quality levels are supported and the configured QL is indicated:

  • prc | ssu-a | ssu-b | sec—Network option-1 QLs

  • prs | st2 | tnc | st3e | st3 | smc | st4—Network option-2 QLs

extensive

ESMC QL

Indicates the configured Ethernet Synchronization Message Channel (ESMC) quality level:

  • DNU—Network option-1 source

  • DSU—Network option-2 source

extensive

Clock source type

Indicates that the configured chassis synchronization clock source is one of the following types:

  • ifd—Uses the free-run local oscillator.

  • extern—Uses a configured qualified clock source.

extensive

Clock Event

Indicates the event clock status:

  • Clock locked—Clock is established.

  • n/a—Clock is not established.

extensive

Configuration flags

Indicates Ext for external interface configuration

Wait-to-restore time

Indicates the amount of time in minutes for the port signal to be up before the port is opened to receive and transmit Ethernet Synchronization messages.

extensive

Hold-off time

Indicates the amount of time in milliseconds for hold off time for Synchronous Ethernet interfaces and external clock source interfaces to prevent rapid successive switching. If an interface goes down, hold-off time delays short signal failures from being sent to the clock selection process.

extensive

Kernel flags

Indicates the Synchronous Ethernet software operational status:

  • Up—The Synchronous Ethernet software is operational for the configured interface.

  • pri—The source is the selected primary clock source.

  • Dn—The Synchronous Ethernet software is not operational for the configured interface.

extensive

Ineligibility reason

Indicates the reason the interface is ineligible for the Synchronous Ethernet operation, including the following:

  • Link Down—The link between the Synchronous Ethernet interfaces is not operational.

  • Not restored—The Synchronous Ethernet link has not yet been restored because it is waiting for the specified wait-to-restore time to elapse.

  • Forbidden slot—Slot 10 is not supported.

  • Interface unit missing—The unit parameter is not set or is invalid.

  • Locked—The paired interface is not available.

  • No cfg—Synchronous Ethernet is not configured.

  • RX Disabled—The receiving interface is disabled.

  • Undefined/invalid QL—The QL mode is not specified in the configuration or, if specified, is not supported.

    Note:

    When GPS is configured as the clock source and the quality-mode-enable statement is configured, the Current Lock Status is displayed as Locked but Undefined/invalid QL is displayed as the Ineligibility reason. As a workaround, configure the no-ssm-support statement at the [edit chassis synchronization source interfaces interface-name] hierarchy level.

  • System initialization in progress—The remote system is performing initialization and not currently available for synchronization.

  • Unsupported interface—The configured interface does not support Synchronous Ethernet.

extensive

Clock module on

Indicates whether the clock module is on the Switch Control Board SCB0 or SCB1.

clock-module

Current role

Indicates the role of the clock module:

  • master—The clock module is on the primary SCB, which is the active chassis clock source.

  • backup—The clock module is on the backup SCB, which mirrors the state of the active clock.

clock-module

Current state

Indicates the state of the clock module:

  • freerun—The clock module is in free-run mode. When the system starts up, the default clock module state is free-run.

  • acquiring-lock on—The clock module is attempting to acquire a lock on the specified clock source.

  • locked to—The clock module is locked to the specified clock source.

  • holdover on—The clock module is in holdover mode on the specified clock source. Prior to the specified clock source becoming invalid, the clock module was locked on the source and holdover data was collected.

  • holdover—The clock module has transitioned into holdover prior to locking on a valid clock source and collecting holdover data.

clock-module

Monitored clock sources

Displays information about monitored clock sources.

clock-module

Interface

Indicates the interface type and which FPC, PIC, and port are configured:

  • external—External clock source

  • ge-fpc/pic/port—Line Synchronous Ethernet or PTP client

  • xe-fpc/pic/port—Line Synchronous Ethernet or PTP client

clock-module

Type

Indicates the type of clock source:

  • t1—BITS T1 framed

  • e1—BITS E1 framed

  • 2048khz—BITS unframed 2048 KHz frequency source

  • syncE—Synchronous Ethernet frequency source

  • ptp—PTP client source

  • ptp-hybrid—PTP client source using Synchronous Ethernet for frequency

clock-module

Status

Indicates the status of the clock source:

  • failed—The clock source is in the failed state.

  • qualifying—The clock source is being qualified.

  • qualified—The clock source is qualified and can be selected as the chassis clock source.

  • qualified-selected—The clock source is qualified and selected as the chassis clock source.

clock-module

Sample Output

show chassis synchronization

content_copy zoom_out_map
user@host> show chassis synchronization
Current clock status: Locked
Clock locked to : Primary

Configured sources
Source      Configured       Interface       Configured
Name        Priority         Status          Quality

ge-1/0/0       -             Primary         PRC

Sample Output

show chassis synchronization extensive

content_copy zoom_out_map
user@host> show chassis synchronization extensive
Current clock status: Locked
Clock locked to            : Primary

Configured sources:
Interface           : ge-1/0/0
Status              : Primary         Index : 143
Clock source state  : Clk qualified   Priority : -
Configured QL       : PRC             ESMC QL : DNU
Clock source type   : ifd             Clock Event : Clock locked
Kernel flags        : Up,pri,
Wait-to-restore time			: 1
Hold-off time             :  1200
Interface State           : Up,ESMC TX(QL SEC/SSM 0xb),

Sample Output

show chassis synchronization extensive (Synchronous Ethernet with link down)

content_copy zoom_out_map
user@host> show chassis synchronization extensive
Current clock status  : Holdover
Configured sources:

Interface           : ge-1/0/2
Status              : n/a           Index       : 142
Clock source state  : n/a           Priority    : Default(8)
Configured QL       : SSU-B         ESMC QL     : DNU
Clock source type   : ifd           Clock Event : n/a
Kernel flags        : Dn,
Ineligibility reason: Link Down,
Wait-to-restore time			: 1
Hold-off time             :  1200
Interface State           : Up,ESMC TX(QL SEC/SSM 0xb),

Sample Output

show chassis synchronization extensive (Synchronous Ethernet with physical interface not restored)

content_copy zoom_out_map
user@host> show chassis synchronization extensive
Current clock status  : Holdover
Configured sources:

Interface           : ge-1/0/2
Status              : n/a           Index       : 142
Clock source state  : n/a           Priority    : Default(8)
Configured QL       : SSU-B         ESMC QL     : DNU
Clock source type   : ifd           Clock Event : n/a
Kernel flags        : Restoring in 13s,ESMC TX(QL DNU/SSM 0xf),
Ineligibility reason: Not restored,
Wait-to-restore time			: 1
Hold-off time             :  1200
Interface State           : Up,ESMC TX(QL SEC/SSM 0xb),

Sample Output

show chassis synchronization extensive (Synchronous Ethernet configured on ineligible slot 10)

content_copy zoom_out_map
user@host> show chassis synchronization extensive
Current clock status  : Holdover
Configured sources:

Interface           : ge-10/0/2  # Note: configuration 10/x/y (slot 10), which does not support Synchronous Ethernet
Status              : n/a           Index       : 142
Clock source state  : n/a           Priority    : Default(8)
Configured QL       : SSU-B         ESMC QL     : DNU
Clock source type   : ifd           Clock Event : n/a
Kernel flags        : Up,
Ineligibility reason: Forbidden slot,
Wait-to-restore time			: 1
Hold-off time             :  1200
Interface State           : Up,ESMC TX(QL SEC/SSM 0xb),

Sample Output

show chassis synchronization extensive (on MX104 Router)

content_copy zoom_out_map
user@host> show chassis synchronization extensive
Current clock status  : Locked
Clock locked to       : Primary

Configured interfaces:

Name         : bits
Signal type  : e1 (g704 hdb3 sa4)
Rx status    : active
Tx status    : active

Configured sources:

Interface           : bits
Status              : Primary       Index       : 2
Clock source state  : Clk qualified Priority    : Default(7)
Configured QL       : SEC           ESMC QL     : SEC
Clock source type   : extern        Clock Event : Clock locked
Wait-to-restore     : 5  min        Hold-off    : 1000 ms
Interface State     : Up,pri,ESMC Rx(SSM 0xb)

Sample Output

show chassis synchronization clock-module (MX10003 Router)

content_copy zoom_out_map
user@host> show chassis synchronization clock-module
re0:
--------------------------------------------------------------------------

Clock module on SCB0
  Current role     : master
  Current state    : holdover
    State for      : 11 days, 01 hrs, 20 mins, 33 secs
    State since    : Sun Jan 29 20:11:48 2023

user@host> show chassis synchronization extensive

Current clock status : Locked
Clock locked to : Primary
SNMP trap status : Disabled

Configured sources:

Interface : et-0/1/3
Status : Secondary Index : 563
Clock source state : Clk qualified Priority : 1
Configured QL : PRC ESMC QL : DNU
Clock source type : ifd Clock Event : Clock qualified
Wait-to-restore : 0 min Hold-off : 1000 ms
Interface State : Up,sec,ESMC TX(QL PRC/SSM 0x2),

Interface : et-0/1/7
Status : n/a Index : 567
Clock source state : n/a Priority : 3
Configured QL : PRC ESMC QL : DNU
Clock source type : ifd Clock Event : n/a
Wait-to-restore : 0 min Hold-off : 1000 ms
Interface State : Up,ESMC TX(QL PRC/SSM 0x2),

Interface : et-0/1/8
Status : Primary Index : 568
Clock source state : Clk qualified Priority : 1
Configured QL : PRC ESMC QL : DNU
Clock source type : ifd Clock Event : Clock locked
Wait-to-restore : 0 min Hold-off : 1000 ms
Interface State : Up,pri,ESMC TX(QL DNU/SSM 0xf),

Interface : et-1/1/1
Status : n/a Index : 555
Clock source state : n/a Priority : 5
Configured QL : PRC ESMC QL : DNU
Clock source type : ifd Clock Event : n/a
Wait-to-restore : 0 min Hold-off : 1000 ms
Interface State : Dn,
Ineligibility reason: Link Down

Sample Output

show chassis synchronization clock-module (MX204 Router)

content_copy zoom_out_map
user@host> show chassis synchronization clock-module

re0:
--------------------------------------------------------------------------

Clock module on SCB0
  Current role     : master

Sample Output

show chassis synchronization interface

content_copy zoom_out_map
user@host> show chassis synchronization interface ge-1/0/2
Current clock status  : Locked 
Clock locked to       : Primary

Sample Output

show chassis synchronization clock-module

content_copy zoom_out_map
user@host> show chassis synchronization clock-module
Clock module on SCB0
  Current role     : master
  Current state    : locked to ge-4/1/0
    State for      : 0 days, 00 hrs, 00 mins, 15 secs
    State since    : Mon Jun  6 07:29:40 2011
  Monitored clock sources
    Interface      Type         Status
    ge-4/1/0       syncE        qualified-selected
    ge-4/3/0       syncE        qualified

show chassis synchronization clock-module (MX10008 with MX10k-LC2101 line cards)

content_copy zoom_out_map
user@host> show chassis synchronization clock-module
Clock module on SCB0
Current role : master
Current state : locked to external-0
State for : 0 days, 00 hrs, 01 mins, 16 secs
State since : Tue May 17 02:44:36 2022
Monitored clock sources
Interface Type Status
et-0/3/1 syncE-hybrid qualified
external-0 bits-hybrid qualified-selected

show chassis synchronization (configured external clock interface)

content_copy zoom_out_map
user@host> show chassis synchronization 
Current clock status  : Free-run

Configured interfaces:
Name            Signal type                Rx status      Tx status
external        e1 (g704 ami sa4)          loss of signal squelched     

Configured outputs:
Interface       Tx status   Minimum QL   Tx QL
external        squelched   SEC          DNU      

Configured sources:
Source         Configured    Interface   Configured
 Name           Priority     Status      Quality
external       Default(6)    n/a         SSU-A   

show chassis synchronization clock-module (configured external clock interface)

content_copy zoom_out_map
user@host> show chassis synchronization clock-module
re0:
--------------------------------------------------------------------------

Clock module on SCB0
  Current role     : master
  Current state    : freerun
    State for      : 2 days, 06 hrs, 16 mins, 57 secs
    State since    : Wed Nov 14 08:02:07 2012
  Monitored clock sources
    Interface      Type         Status
    external       e1           failed               

show chassis synchronization clock-module(configured external clock interfaces)

content_copy zoom_out_map
user@host> show chassis synchronization clock-module
re0:
--------------------------------------------------------------------------

Clock module on SCB0
Current role : master
Current state : locked to external-0
State for : 0 days, 00 hrs, 08 mins, 27 secs
State since : Tue May 17 02:44:36 2022
Monitored clock sources
Interface Type Status
external-0 bits-hybrid qualified-selected   

show chassis synchronization extensive (configured external clock interface)

content_copy zoom_out_map
user@host> show chassis synchronization extensive
Current clock status  : Free-run

Configured interfaces: 

Name         : external      
Signal type  : e1 (g704 ami sa4)     
Rx status    : loss of signal
Tx status    : squelched     
LED color    : red  

Configured outputs: 
                                        
Interface      : external     
Tx status      : squelched (holdover data invalid)
Minimum QL     : SEC             Tx QL         : DNU      
Holdover mode  : enabled         Wander filter : disabled 
Source mode    : chassis         Source Tx DNU : disabled 
Holdover data  : invalid  
Current state  : holdover                           
  State for    : 2 days, 06 hrs, 03 mins, 46 secs   
  State since  : Wed Nov 14 08:02:09 2012           

Configured sources: 
                                        
Interface           : external      
Status              : n/a           Index       : 0      
Clock source state  : n/a           Priority    : Default(6)    
Configured QL       : SSU-A         ESMC QL     : DNU       
Clock source type   : extern        Clock Event : n/a      
Interface State     : Dn,ESMC Rx(SSM 0xf),
Ineligibility reason: Link Down,

Release Information

Command introduced in Junos OS Release 10.4.

clock-module option introduced in Junos OS Release 12.2.

footer-navigation