- Table of Contents
-
- 14-Network Management and Monitoring Command Reference
- 00-Preface
- 01-System maintenance and debugging commands
- 02-NQA commands
- 03-NTP commands
- 04-PTP commands
- 05-Network synchronization commands
- 06-SNMP commands
- 07-RMON commands
- 08-Event MIB commands
- 09-NETCONF commands
- 10-EAA commands
- 11-Process monitoring and maintenance commands
- 12-Sampler commands
- 13-Mirroring commands
- 14-NetStream commands
- 15-IPv6 NetStream commands
- 16-TCP connection trace commands
- 17-Fast log output commands
- 18-Flow log commands
- 19-Information center commands
- 20-GOLD commands
- 21-Packet capture commands
- Related Documents
-
Title | Size | Download |
---|---|---|
05-Network synchronization commands | 100.90 KB |
Contents
Network synchronization commands
display network-clock self-test-result
Network synchronization commands
Related commands
network-clock freq-deviation-detect enable
network-clock freq-deviation-threshold
display network-clock self-test-result
Use display network-clock self-test-result to display the self-test result of the network clock monitoring module.
Syntax
display network-clock self-test-result [ chassis chassis-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
chassis chassis-number: Specifies a cluster member device by its member ID. If you do not specify a member device, this command displays the test result on all member devices.
Examples
# Display the self-test result of the network clock monitoring module.
<Sysname> display network-clock self-test-result
Clock module work mode: Normal
SRAM : Normal
CPLD : Normal
E1A : Normal
E1B : Normal
Table 1 Command output
Field |
Description |
Clock module work mode |
State of the clock chip: · Normal—The clock chip is operating correctly. · Fault—The clock chip is not operating correctly. The clock chip changes to this state when its SRAM, CPLD, E1A, or E1B has failed. |
SRAM |
State of the SRAM: · Normal—The SRAM is operating correctly. · Fault—The SRAM has failed. |
CPLD |
State of the CPLD: · Normal—The CPLD is operating correctly. · Fault—The CPLD has failed. |
E1A |
State of the network clock chip E1A: · Normal—The E1A is operating correctly. · Fault—The E1A has failed. |
E1B |
State of the network clock chip E1B: · Normal—The E1B is operating correctly. · Fault—The E1B has failed. |
display network-clock source
Use display network-clock source to display information about the clock sources.
Syntax
display network-clock source [ chassis chassis-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
chassis chassis-number: Specifies a cluster member device by its member ID. If you do not specify a member device, this command displays information about the clock sources on all cluster member devices.
Examples
# Display information about the clock sources.
<Sysname> display network-clock source
Traced reference: GE1/2/0/1
Reference State Priority SSM level Force SSM Sa-Bit LPU port Frequency
BITS0 Lost 255 Unknown ON 4 N/A 2 Mbps
BITS1 Lost 255 Unknown ON 4 N/A 2 Mbps
PTP N/A 255 Unknown ON N/A N/A N/A
GE1/2/0/1 Normal 10 Unknown OFF N/A Yes N/A
Table 2 Command output
Field |
Description |
Traced reference |
Traced clock source. If a clock source is traced, the network clock monitoring module distributes its timing signal to all interface cards. If no clock source has been traced, this field displays N/A. |
Reference |
Clock source: · BITS0. · BITS1. · PTP. · Line clock. The value is the line clock input port. This information is displayed only when a line clock input port is configured. |
State |
State of the clock source: · Normal—The clock source is operating correctly. · Lost—The clock source is not available or is in an error condition. · N/A—PTP is used for time synchronization. |
Priority |
Priority of the clock source. |
SSM level |
Clock source quality level in the SSM, by descending order of quality: · PRC—G.811 primary reference clock. · SSU-A—G.812 primary-level SSU. · SSU-B—G.812 second-level SSU. · SEC—SDH equipment clock. · DNU—Do not use for synchronization. · Unknown—Unknown quality level. |
Force SSM |
Method for setting the quality of the clock source: · ON—Sets the clock source's quality level to the user-assigned SSM value. · OFF—Extracts the SSM quality level from the timing signal sent by the clock source. |
Sa bit |
Sa bit used by BITS to transmit the SSM: · sa4—Bit Sa4. · sa5—Bit Sa5. · sa6—Bit Sa6. · sa7—Bit Sa7. · sa8—Bit Sa8. This field displays N/A for line clock sources, because line clocks do not support the Sa bit configuration. |
LPU port |
Whether the line clock input port takes effect: · Yes—The line clock input port takes effect. · No—The line clock input port does not take effect. This field displays N/A for BITS 0, BITS 1, and PTP clock sources. |
Frequency |
Frequency of the BITS clock: · 2 Mbps. · 2 MHz. |
display network-clock status
Use display network-clock status to display the operating state of the network clock monitoring module.
Syntax
display network-clock status [ chassis chassis-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
chassis chassis-number: Specifies a cluster member device by its member ID. If you do not specify a member device, this command displays information for all cluster member devices.
Examples
# Display the operating state of the network clock monitoring module.
<Sysname> display network-clock status
Mode : Auto
Reference : N/A
Traced reference : N/A
Lock mode : Unknown
SSM output level : SSUB
SSM control enable: On
Table 3 Command output
Field |
Description |
Mode |
Clock reference selection mode: · Auto—Automatic reference selection. · Manual—Manual reference selection. |
Reference |
Manually specified clock reference. This field displays N/A if no clock reference has been specified. |
Traced reference |
Clock reference that has been selected and traced. This field displays N/A if no clock reference has been selected. |
Lock mode |
Phase lock state of the clock monitoring module: · Freerun—Freerun mode. · Locked—Locked (traced) mode. · Holdover—Holdover state. · Pre-locked—Pre-locked mode. · Lost—The clock signal has been lost. · Unknown—No timing signal is available. The network clock monitoring module is in an exceptional condition. |
SSM output level |
Signal quality level of the clock source in the SSM, by descending order of quality: · PRC—G.811 primary reference clock. · SSU-A—G.812 primary-level SSU. · SSU-B—G.812 second-level SSU. · SEC—SDH equipment clock. · DNU—Do not use for synchronization. · Unknown—Unknown quality level. |
SSM control enable |
Contribution of SSM to automatic reference selection: · On—SSM is used in the selection process. · Off—SSM is not used in the selection process. |
display network-clock version
Use display network-clock version to display the version of the network clock monitoring module.
Syntax
display network-clock version [ chassis chassis-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
chassis chassis-number: Specifies a cluster member device by its member ID. If you do not specify a member device, this command displays information for all cluster member devices.
Examples
# Display version information for the network clock monitoring module.
<Sysname> display network-clock version
Clock card
Type : SR01CK3A
Software : 106
PCB : A
Number of Cpld: 1
Cpld 0:
Software : 001
Table 4 Command output
Field |
Description |
Type |
Model of the clock daughter card. Available models are SR01CK3A and SR07CK3C. |
Software |
Software version of the network clock monitoring module. |
PCB |
PCB version of the clock daughter card. |
Number of Cpld |
Number of CPLDs on the clock daughter card. |
Cpld 0 |
The first CPLD on the clock daughter card. |
Software |
Software version of CPLD 0. |
network-clock source forcessm
Use network-clock source forcessm to configure the method for setting the quality level of a clock source.
Use undo network-clock source forcessm to restore the default.
Syntax
network-clock chassis chassis-number source { bits0 | bits1 | ptp } forcessm { off | on }
network-clock source lpuport interface-type interface-number forcessm { off | on }
undo network-clock chassis chassis-number source { bits0 | bits1 | ptp } forcessm
undo network-clock source lpuport interface-type interface-number forcessm
Default
The network clock monitoring module sets the quality level of a clock source to the user-assigned value. It does not extract the quality level from the SSM sent by the clock source.
Views
System view
Predefined user roles
network-admin
mdc-admin
Parameters
chassis chassis-number: Specifies a cluster member device by its member ID.
bits0: Specifies the BITS 0 clock.
bits1: Specifies the BITS 1 clock.
lpuport interface-type interface-number: Specifies a line clock. The interface-type interface-number arguments specify the type and number of the line clock input port.
ptp: Specifies the Precision Timing Protocol (PTP).
off: Sets the quality level of a clock source to the value extracted from the SSM sent by the clock source.
on: Sets the quality level of a clock source to the user-assigned value.
Examples
# Set the quality level of BITS 0 to the value extracted from the SSM sent by the clock source.
<Sysname> system-view
[Sysname] network-clock source bits0 forcessm off
Related commands
display network-clock source
network-clock source frequency
Use network-clock source frequency to set the frequency of a BITS clock.
Use undo network-clock source frequency to restore the default.
Syntax
network-clock chassis chassis-number source { bits0 | bits1 } frequency { bps-2m | hz-2m }
undo network-clock chassis chassis-number source { bits0 | bits1 } frequency
Default
The frequency of a BITS clock is 2 Mbps (bps-2m).
Views
System view
Predefined user roles
network-admin
Parameters
chassis chassis-number: Specifies a cluster member device by its member ID.
bits0: Specifies the BITS 0 clock.
bits1: Specifies the BITS 1 clock.
bps-2m: Sets the frequency to 2 Mbps.
hz-2m: Sets the frequency to 2 MHz.
Examples
# Set the frequency to 2 MHz for BITS 0.
<Sysname> system-view
[Sysname] network-clock source bits0 frequency hz-2m
Related commands
display network-clock source
network-clock source priority
Use network-clock source priority to set the priority of a clock source.
Use undo network-clock source priority to restore the default.
Syntax
network-clock chassis chassis-number source { bits0 | bits1 | ptp } priority priority
network-clock source lpuport interface-type interface-number priority priority
undo network-clock chassis chassis-number source { bits0 | bits1 | ptp } priority
undo network-clock source lpuport interface-type interface-number priority
Default
All clock sources have a priority of 255.
Views
System view
Predefined user roles
network-admin
mdc-admin
Parameters
chassis chassis-number: Specifies a cluster member device by its member ID.
bits0: Specifies the BITS 0 clock.
bits1: Specifies the BITS 1 clock.
lpuport interface-type interface-number: Specifies a line clock. The interface-type interface-number arguments specify the type and number of the line clock input port.
ptp: Specifies PTP.
priority priority: Sets a priority value in the range of 1 to 255. The lower the value, the higher quality the timing signal.
Examples
# Assign a priority of 3 to BITS 0.
<Sysname> system-view
[Sysname] network-clock source bits0 priority 3
Related commands
display network-clock source
network-clock source sa-bit
Use network-clock source sa-bit to set the Sa bit used to transmit the SSM for a BITS clock.
Use undo network-clock source sa-bit to restore the default.
Syntax
network-clock chassis chassis-number source { bits0 | bits1 } sa-bit { sa4 | sa5 | sa6 | sa7 | sa8 }
undo network-clock chassis chassis-number source { bits0 | bits1 } sa-bit
Default
BITS clocks use Sa4 to transmit the SSM.
Views
System view
Predefined user roles
network-admin
Parameters
chassis chassis-number: Specifies a cluster member device by its member ID.
bits0: Specifies the BITS 0 clock.
bits1: Specifies the BITS 1 clock.
sa-bit: Specifies an Sa bit.
· sa4—Specifies bit Sa4.
· sa5—Specifies bit Sa5.
· sa6—Specifies bit Sa6.
· sa7—Specifies bit Sa7.
· sa8—Specifies bit Sa8.
Usage guidelines
Examples
# Specify Sa5 as the SSM bit for BITS 0.
<Sysname> system-view
[Sysname] network-clock source bits0 sa-bit sa5
network-clock source ssm
Use network-clock source ssm to assign an SSM quality level to a clock source.
Use undo network-clock source ssm to restore the default.
Syntax
network-clock chassis chassis-number source { bits0 | bits1 | ptp } ssm { dnu | prc | sec | ssua | ssub | unknown }
network-clock source lpuport interface-type interface-number ssm { dnu | prc | sec | ssua | ssub | unknown }
undo network-clock chassis chassis-number source { bits0 | bits1 | ptp } ssm
undo network-clock source lpuport interface-type interface-number ssm
Default
The SSM quality level is unknown for all clock sources.
Views
System view
Predefined user roles
network-admin
mdc-admin
Parameters
chassis chassis-number: Specifies a cluster member device by its member ID.
bits0: Specifies the BITS 0 clock.
bits1: Specifies the BITS 1 clock.
lpuport interface-type interface-number: Specifies a line clock. The interface-type interface-number arguments specify the type and number of the line clock input port.
ptp: Specifies the PTP.
dnu: Sets the SSM quality level to DNU SSM quality level. DNU clock sources cannot participate in automatic clock reference selection.
prc: Sets the SSM quality level to G.811 primary reference clock.
sec: Sets the SSM quality level to SDH equipment clock.
ssua: Sets the SSM quality level to G.812 primary-level SSU.
ssub: Sets the SSM quality level to G.812 second-level SSU.
unknown: Sets the SSM quality level to unknown.
Usage guidelines
For the manually assigned SSM quality level to take effect, you must configure the network-clock source forcessm on command.
It takes time for an SSM quality level change to take effect. To verify the effectiveness of the change, use the display network-clock source command or check the log.
Examples
# Set the SSM quality level of BITS 0 to DNU.
<Sysname> system-view
[Sysname] network-clock source bits0 ssm dnu
network-clock ssmcontrol
Use network-clock ssmcontrol to control the use of SSM quality level in the automatic reference selection process.
Use undo network-clock ssmcontrol to restore the default.
Syntax
network-clock chassis chassis-number ssmcontrol { off | on }
undo network-clock chassis chassis-number ssmcontrol
Default
The SSM quality level is ignored in the automatic reference selection process.
Views
System view
Predefined user roles
network-admin
mdc-admin
Parameters
chassis chassis-number: Specifies a cluster member device by its member ID.
off: Ignores the SSM quality level in clock reference selection.
on: Includes the SSM quality level as a factor for clock reference selection.
Usage guidelines
This command takes effect for automatic clock reference selection.
Examples
# Include the SSM quality level into the automatic clock reference selection process.
<Sysname> system-view
[Sysname] network-clock ssmcontrol on
Related commands
display network-clock source
network-clock ssm
network-clock work-mode
Use network-clock work-mode to set the clock reference selection mode.
Use undo network-clock work-mode to restore the default.
Syntax
network-clock chassis chassis-number work-mode { auto | manual source { bits0 | bits1 } }
network-clock work-mode manual source lpuport interface-type interface-number
undo network-clock chassis chassis-number work-mode
Default
Automatic reference selection mode applies.
Views
System view
Predefined user roles
network-admin
mdc-admin
Parameters
chassis chassis-number: Specifies a cluster member device by its member ID.
auto: Enables automatic reference selection.
manual source: Enables manual reference selection.
bits0: Specifies BITS 0 as the reference.
bits1: Specifies BITS 1 as the reference.
lpuport interface-type interface-number: Specifies a line clock input port as the reference. The interface-type interface-number arguments specify an interface by its type and number.
Usage guidelines
To use the timing signal from an interface as the synchronization reference, you must also specify the interface as a line clock input port by using the network-clock lpuport command.
It takes time for a clock reference selection mode change to take effect. To verify the effectiveness of the change, use the display network-clock status command or check the log.
Examples
# Specify BITS 0 as the clock reference.
<Sysname> system-view
[Sysname] network-clock work-mode manual source bits0
# Enable automatic reference selection.
<Sysname> system-view
[Sysname] network-clock work-mode auto
Related commands
display network-clock source
display network-clock status
network-clock lpuport
Synchronous Ethernet commands
display esmc
Use display esmc to display ESMC information.
Syntax
display esmc [ interface interface-type interface-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
interface interface-type interface-number: Specifies an interface by its type and number. If you do not specify an interface, the command displays ESMC information for all interfaces.
Usage guidelines
ESMC information is not available for interfaces in asynchronous mode.
Examples
# Display ESMC information for all interfaces.
<Sysname> display esmc
Interface : GigabitEthernet1/2/0/1
Mode : Synchronous
ESMC status : Enable
Port status : Up
Duplex mode : Full
QL received : QL-SEC
QL sent : QL-PRC
ESMC information packets received : 2195
ESMC information packets sent : 6034
ESMC event packets received : 1
ESMC event packets sent : 16
ESMC information rate : 1 packets/sec
ESMC expiration : 5 seconds
Table 5 Command output
Field |
Description |
Interface |
Interface that receives ESMC messages. |
Mode |
Ethernet interface mode: Synchronous—Synchronous mode. Non-Synchronous—Asynchronous mode. |
ESMC status |
Whether ESMC is enabled: · Enable—ESMC is enabled. · Disable—ESMC is disabled. |
QL received QL sent |
Quality level in the ESMC packet most recently received or sent on the interface: · PRC—G.811 primary reference clock. · SSU-A—G.812 primary-level SSU. · SSU-B—G.812 second-level SSU. · SEC—SDH equipment clock. · DNU—Do not use for synchronization. · UNK—Unknown quality level. |
ESMC information packets received ESMC information packets sent |
Number of received or sent ESMC information packets. |
ESMC event packets received ESMC event packets sent |
Number of received or sent ESMC event packets. |
ESMC information rate |
Transmission rate of ESMC information packets. The value is fixed at 1 pps. |
ESMC expiration |
ESMC expiration timer. The timer is fixed at 5 seconds. |
Related commands
network-clock freq-deviation-detect enable
network-clock freq-deviation-threshold
esmc enable
Use esmc enable to enable the Ethernet synchronization messaging channel (ESMC) on an Ethernet interface.
Use undo esmc enable to disable the Ethernet synchronization messaging channel (ESMC) on an Ethernet interface.
Syntax
esmc enable
undo esmc enable
Default
ESMC is disabled on Ethernet interfaces.
Views
Layer 3 Ethernet interface view
Predefined user roles
network-admin
mdc-admin
Usage guidelines
Before you can enable ESMC, you must configure the interface to operate in synchronous mode.
Examples
# Enable ESMC on GigabitEthernet 1/2/0/1.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/2/0/1
[Sysname-GigabitEthernet1/2/0/1] esmc enable
Related commands
display esmc
synchronous mode
synchronous mode
Use synchronous mode to enable the synchronous mode on an Ethernet interface.
Use undo synchronous mode to restore the default.
Syntax
synchronous mode
undo synchronous mode
Default
Ethernet interfaces are regular Ethernet interfaces in non-synchronous mode. They do not extract timing signals, send, forward, or process ESMC packets.
Views
Layer 3 Ethernet interface view
Predefined user roles
network-admin
mdc-admin
Usage guidelines
You can configure an interface as a line clock input port only after you enable the synchronous mode on the interface.
Examples
# Enable the synchronous mode on GigabitEthernet 1/2/0/1.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/2/0/1
[Sysname-GigabitEthernet1/2/0/1] synchronous mode
Related commands
display esmc
esmc enable