- Table of Contents
-
- 14-Network Management and Monitoring Command Reference
- 00-Preface
- 01-System maintenance and debugging commands
- 02-NQA commands
- 03-iNQA commands
- 04-iFIT commands
- 05-SRPM commands
- 06-NTP commands
- 07-PTP commands
- 08-Network synchronization commands
- 09-SNMP commands
- 10-RMON commands
- 11-NETCONF commands
- 12-CWMP commands
- 13-EAA commands
- 14-Process monitoring and maintenance commands
- 15-Sampler commands
- 16-Mirroring commands
- 17-NetStream commands
- 18-IPv6 NetStream commands
- 19-TCP connection trace commands
- 20-Performance management commands
- 21-Flow log commands
- 22-Information center commands
- 23-Packet capture commands
- 24-Flow monitor commands
- Related Documents
-
Title | Size | Download |
---|---|---|
07-PTP commands | 275.41 KB |
display ptp foreign-masters-record
ptp alarm-threshold clock-source-class
ptp alarm-threshold { time-lock | time-unlock }
ptp alarm-threshold time-offset
ptp alarm-threshold time-offset-sum pk-pk
PTP commands
display ptp clock
Use display ptp clock to display PTP clock information.
Syntax
display ptp clock
Views
Any view
Predefined user roles
network-admin
network-operator
Usage guidelines
This command does not display any information if you have not specified a PTP profile (PTP standard) or a PTP mode (PTP clock node type).
Examples
# Display PTP clock information.
<Sysname> display ptp clock
PTP profile : IEEE 1588 Version 2
PTP mode : BC
Slave only : No
Sync uncertain : Disabled
Clock state : Disabled
Clock ID : 62EA70-FFFE-AA0100
Clock type : Local
Clock domain : 1
Number of PTP ports : 0
Priority1 : 128
Priority2 : 128
Clock quality :
Class : 248
Accuracy : 254
Offset (log variance) : 65535
Offset from master : 0 (ns)
Mean path delay : 0 (ns)
Steps removed : 0
Local clock time : Fri Jul 17 14:17:41 2020
Clock source info:
Clock Pri1 Pri2 Accuracy Class TimeSrc Direction In-Status Offset(log variance)
-------------------------------------------------------------------
Local 128 128 254 248 160 N/A Active 65535
ToD0 128 128 32 6 32 N/A Inactive 65535
ToD1 128 128 32 6 32 N/A Inactive 65535
Field |
Description |
PTP profile |
PTP standard: · IEEE 1588 version 2. · ITU-T G.8275.1. · ITU-T G.8275.2. |
PTP mode |
PTP clock node type: · BC. · E2ETC. · E2ETC-OC. · OC. · P2PTC. · P2PTC-OC. · T-BC. · T-TC. · T-TSC. · T-BC-P. · T-TSC-P. |
Slave only |
Whether the OC operates in Slave only mode: · Yes. · No. |
Sync uncertain |
Whether the device is enabled to notify the downstream nodes of its time synchronization state: · Disabled. · Enabled. |
Clock state |
PTP clock state: · Disabled—The PTP clock state feature is disabled. · Free-Run—The PTP clock has never been synchronized to a time source and is not in the process of synchronizing to a time source. · Acquiring—The PTP clock is in the process of synchronizing to a time source. · Locked—The PTP clock has been synchronized to a time source. · Holdover—The PTP clock is in holdover state. |
Clock ID |
Clock ID for the device, which uniquely identifies a PTP device. |
Clock type |
Clock type of the device: · Local—Local clock. · ToD0—ToD 0 clock. · ToD1—ToD 1 clock. |
ToD direction |
ToD input or output: · IN—The device receives clock signals from an external ToD clock. · N/A—The device neither receives nor transmits ToD clock signals. This field is not displayed for a local clock. |
ToD delay time |
Delay correction value in nanoseconds for the ToD clock. This field is not displayed when the device is a local clock. |
Clock domain |
PTP domain where the device resides. |
Priority1 |
Priority 1 value for the PTP clock. |
Priority2 |
Priority 2 value for the PTP clock. |
Local priority |
Local priority of the PTP clock. (This field is available only for the ITU-T G.8275.1 and ITU-T G.8275.2 PTP profiles.) |
Class |
Time class of the device. |
Accuracy |
Time accuracy of the device. |
Offset (log variance) |
Offset of the grandmaster clock. |
Offset from master |
Offset from the master clock node (parent clock node), in nanoseconds. N/A indicates that information for this field is not obtained. |
Mean path delay |
Mean path delay, in nanoseconds. N/A indicates that information for this field is not obtained. |
Steps removed |
Hops from the grandmaster to the local clock node. N/A indicates that information for this field is not obtained. |
Clock source info |
Information about the clock source. |
Clock |
Clock source type: · Local—Local clock. · ToD0—ToD 0 clock. · ToD1—ToD 1 clock. |
Pri1 |
Priority 1 value of the clock source. |
Pri2 |
Priority 2 value of the clock source. |
LP |
Local priority of the clock source. (This field is available only for the ITU-T G.8275.1 PTP profile.) |
TimeSrc |
Time source of the clock source. |
Direction |
For a local clock source, this field displays N/A. For a ToD clock source, the values include: · In—The device receives ToD clock signals. · Out—The device transmits ToD clock signals. · N/A—The device does not receive or transmit ToD clock signals. |
In-Status |
Whether the clock source is active: · Active. · Inactive. |
display ptp corrections
Use display ptp corrections to display PTP corrections that have occurred on a subordinate port.
Syntax
display ptp corrections
Views
Any view
Predefined user roles
network-admin
network-operator
Usage guidelines
The PTP corrections are displayed only when the following conditions are met:
· You have specified a PTP profile and PTP clock node type for the device.
· The device has a subordinate port and has performed time or frequency synchronization through the port.
If the subordinate port is changed, the recorded information will be cleared.
Examples
# Display PTP corrections that have occurred on a subordinate port.
<Sysname> display ptp corrections
Slave port Correction time Corrections(s,ns) Rate ratio
XGE3/0/1 Mar 11 03:14:54 2012 0,74 0.999999973
XGE3/0/1 Mar 11 03:14:55 2012 -1,17 0.999999980
Table 2 Command output
Field |
Description |
Slave port |
Name of the subordinate port. |
Correction time |
Time when the correction occurred. |
Corrections(s,ns) |
Time corrections in seconds or nanoseconds. N/A indicates that no correction occurred this time. |
Rate ratio |
Ratio of the subordinate port rate to the master port rate. N/A indicates that no correction occurred this time. |
display ptp foreign-masters-record
Use display ptp foreign-masters-record to display information about foreign master nodes.
Syntax
display ptp foreign-masters-record [ interface interface-type interface-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
interface interface-type interface-number: Specifies an interface by its type and number. If you do not specify an interface, this command displays information about foreign master nodes for all interfaces.
Usage guidelines
Foreign master node information is displayed only when the following conditions are met:
· The PTP profile is IEEE 1588 version 2 or ITU-T G.8275.1.
· You have specified a PTP clock node type for the device.
· The device has a PTP port in slave, passive, or uncalibrated state.
Examples
# Display information about foreign master nodes for all interfaces.
<Sysname> display ptp foreign-masters-record
P1=Priority1, P2=Priority2, LP=LocalPriority, C=Class, A=Accuracy,
OSLV=Offset-scaled-log-variance, SR=Steps-removed
GM=Grandmaster
--------- ----------------------- ---- ---- ---- ---- ----- ---------
Interface Clock ID P1 P2 LP C A OSLV SR GM
--------- ----------------------- ---- ---- ---- ---- ----- ---------
XGE3/0/1 000FE2-FFFE-FF0000 0 128 128 248 254 65535 0 Yes
XGE3/0/2 000FE2-FFFE-FF0001 0 128 128 248 254 65535 1 No
Table 3 Command output
Field |
Description |
Interface |
Name of a PTP interface. |
Clock ID |
Clock ID of the foreign master node. |
LP |
Local priority of the interface. It will be used as the local priority of the peer node in BMC selection. This field is available only for the ITU-T G.8275.1 PTP profile. |
C |
Time class. |
A |
Time accuracy. |
OSLV |
Offset of the grandmaster clock. |
SR |
Hops from the grandmaster to the local clock node. |
GM |
Whether the node represents the grandmaster clock: · Yes. · No. |
display ptp interface
Use display ptp interface to display PTP running information for one or all PTP interfaces.
Syntax
display ptp interface [ interface-type interface-number | brief ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
interface-type interface-number: Specifies an interface by its type and number. If you do not specify an interface, this command displays PTP running information for all PTP interfaces.
brief: Displays brief PTP running information for all PTP interfaces. If you do not specify this keyword, this command displays detailed PTP running information for the specified PTP interface or all PTP interfaces.
Usage guidelines
This command displays detailed PTP information only for PTP-enabled interfaces. The brief PTP running information can be displayed only when PTP is operating on the interface.
Examples
# Display brief PTP running information for all PTP interfaces.
<Sysname> display ptp interface brief
Name State Delay mechanism Clock step Asymmetry correction
XGE3/0/1 Slave E2E Two 0
XGE3/0/2 Passive E2E Two 0
# Display detailed PTP running information for Ten-GigabitEthernet 3/0/1.
<Sysname> display ptp interface ten-gigabitethernet 3/0/1
Clock ID : 000FE2-FFFE-FF0000
Port number : 15
PTP version : 2
PTP enable : Enabled
Transport of PTP : User Datagram Protocol (IPv4)
Unicast destination address : 10.10.10.2
DSCP priority : 56
Port state : Slave
Unicast negotiate port role : Request-port
Force state : No
Clock step : Two
Asymmetry correction : 0
Delay mechanism : End to End
Announce interval (log mean) : 1
Announce receipt time out : 3
Sync interval (log mean) : 2
Delay request interval (log mean) : 2
Delay response interval (log mean) : 0
Peer delay request interval (log mean) : 0
Local priority : 128
NotSlave : FALSE
Mean path delay : 1357 (ns)
Table 4 Command output
Field |
Description |
Name |
Name of the PTP interface. |
State |
States of the PTP interface: · Slave—Receives synchronization messages. · Uncalibrated—Temporary state before the interface enters Slave state. · Passive—Neither receives nor sends synchronization messages. A PTP interface is in passive state after it receives an announce messages. · Master—Sends synchronization messages. · Premaster—Temporary state before the interface enters Master state. · Listening—Neither receives nor sends synchronization messages. A PTP interface is in listening state after being initialized. · Faulty—PTP is running incorrectly. A PTP interface in faulty state does not process PTP messages. · Disabled—PTP is not running on the interface. A PTP interface in disabled state does not process PTP messages. · Initializing—The interface is initializing. A PTP interface in initializing state does not process PTP messages. · N/A—No PTP interface state is obtained. |
Delay mechanism |
Delay measurement mechanism: · End to End—Request-response mechanism. · Peer to Peer—Peer delay mechanism. |
Clock step |
Mode for carrying timestamps: · One—Single-step mode. · Two—Two-step mode. |
Asymmetry correction |
Asymmetric delay correction value (in nanoseconds). |
Clock ID |
Clock ID of the device where the interface resides. |
PTP version |
PTP version number. The version number is always 2. |
PTP enable |
Whether PTP is enabled or disabled: · Enabled. · Disabled. |
Transport of PTP |
PTP messages are transported by: · User Datagram Protocol (IPv4). · IEEE 802.3/Ethernet. |
Unicast destination address |
Destination IP address for unicast PTP messages transmitted over IPv4 UDP. This field is not displayed if the ptp unicast-destination command is not executed. |
Unicast negotiate port role |
This field is available only when the PTP profile is ITU-T G.8275.2. Role of the port for unicast negotiation. This field displays Disabled when unicast negotiation is disabled on the port. · Request-port · Grant-port |
DSCP priority |
DSCP value for PTP messages transmitted over IPv4 UDP. This field is not displayed if the ptp dscp command is not executed. |
VLAN |
VLAN ID for PTP messages. This field is not displayed if the ptp vlan command is not executed. |
Dot1p priority |
802.1p precedence for PTP messages. This field is not displayed if the ptp vlan command is not executed. |
Force state |
Whether the force state is configured: · Yes. · No. |
Announce interval (log mean) |
Announce message sending interval (in seconds) = 2interval (this field displays the value for the interval exponent). |
Announce receipt time out |
Number of announcement intervals before the receiving node stops receiving announce messages. If a member node does not receive any announce message from the master node within the specified value, it considers the master node invalid. |
Sync interval (log mean) |
Sync message sending interval (in seconds) = 2interval (this field displays the value for the interval exponent). |
Delay request interval (log mean) |
Minimum delay request message sending interval (in seconds) = 2interval (this field displays the value for the interval exponent). |
Delay response interval (log mean) |
Delay response message sending interval (in seconds) = 2interval (this field displays the value for the interval exponent). |
Peer delay request interval (log mean) |
Peer delay request message sending interval (in seconds) = 2interval (this field displays the value for the interval exponent). |
Local priority |
Priority of the peer node. This field is available only for the ITU-T G.8275.1 profile. |
NotSlave |
Whether or not the NotSlave feature is enabled. This field is available only for the ITU-T G.8275.1 profile. |
Mean path delay |
Mean path delay, in nanoseconds. |
display ptp parent
Use display ptp parent to display parent node (master node) information for the PTP device.
Syntax
display ptp parent
Views
Any view
Predefined user roles
network-admin
network-operator
Usage guidelines
The command does not display any information when any of the following conditions are met:
· No PTP profile is specified.
· No PTP clock node type is specified, or the PTP clock node type is TC or T-TC.
· The ptp active force-state command has been executed.
Examples
# Display parent node information for the PTP device.
<Sysname> display ptp parent
Parent clock:
Parent clock ID : 000FE2-FFFE-FF0005
Parent port number : 15
Observed parent offset (log variance) : N/A
Observed parent clock phase change rate : N/A
Grandmaster clock:
Grandmaster clock ID: 000FE2-FFFE-FF0000
Grandmaster clock quality:
Class : 248
Accuracy : 254
Offset (log variance) : 65535
Priority1 : 128
Priority2 : 128
Table 5 Command output
Field |
Description |
Parent port number |
Outgoing interface number of the parent clock. |
Observed parent offset (log variance) |
Offset from the parent clock node. N/A indicates that information for this field is not obtained. |
Class |
Time class of the grandmaster clock. |
Accuracy |
Time accuracy of the grandmaster clock. |
Offset (log variance) |
Offset of the grandmaster clock. |
Priority1 |
Priority 1 value of the grandmaster clock. |
Priority2 |
Priority 2 value of the grandmaster clock. |
display ptp path-trace
Use display ptp path-trace to display brief information about the PTP synchronization path from the GM to the device.
Syntax
display ptp path-trace
Views
Any view
Predefined user roles
network-admin
network-operator
Usage guidelines
The command displays information correctly only after you have specified a PTP profile and a PTP clock node type.
This command does not take effect if one of the following conditions exists:
· No PTP profile, PTP clock node type, or PTP domain is configured.
· The clock node type is E2ETC, E2ETC-OC, P2PTC, P2PTC-OC, or T-TC.
· The ptp active force-state command has been configured.
Examples
# Display brief information about the PTP synchronization path from the GM to the device.
<Sysname> display ptp path-trace
Sequence number Clock ID
1 000FE2-FFFE-FF0000
2 000FE3-FFFE-F90000
3 000FE4-FFFE-F50000
4 000FE5-FFFE-F20000
5 000FE6-FFFE-F70000
Table 6 Command output
Field |
Description |
Sequence number |
Sequence number of the clock node. |
Clock ID |
ID of the clock node |
Related commands
ptp active force-state
ptp domain
ptp mode
ptp profile
display ptp statistics
Use display ptp statistics to display PTP statistics.
Syntax
display ptp statistics [ interface interface-type interface-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
interface interface-type interface-number: Specifies an interface by its type and number. If you do not specify an interface, this command displays PTP statistics for all interfaces.
Usage guidelines
The command does not display any PTP statistics if you have not specified a PTP profile or a PTP clock node type.
Examples
# Display PTP statistics on Ten-GigabitEthernet 3/0/1.
<Sysname> display ptp statistics interface ten-gigabitethernet 3/0/1
Received packets
--------------------------------------------------------------------------
Announce :0 Sync :0 Signaling :0
DelayReq :0 DelayResp :0 FollowUp :0
PdelayReq:0 PdelayResp:0 PdelayRespFollowUp :0
Sent packets
--------------------------------------------------------------------------
Announce :476 Sync :2543 Signaling :0
DelayReq :0 DelayResp :0 FollowUp :2542
PdelayReq:238 PdelayResp:0 PdelayRespFollowUp :0
Discarded packets
--------------------------------------------------------------------------
Announce :0 Sync :0 Signaling :0
DelayReq :0 DelayResp :0 FollowUp :0
PdelayReq:0 PdelayResp:0 PdelayRespFollowUp :0
Table 7 Command output
Field |
Description |
Received packets |
Statistics about received PTP messages. |
Sent packets |
Statistics about sent PTP messages. |
Discarded packets |
Statistics about discarded PTP messages. |
display ptp time-property
Use display ptp time-property to display PTP clock properties.
Syntax
display ptp time-property
Views
Any view
Predefined user roles
network-admin
network-operator
Usage guidelines
This command does not display any information in any of the following circumstances:
· You have not specified a PTP standard or a clock node type.
· You have specified the clock node type as e2etc or p2ptc.
· You have executed the ptp active force-state command.
Examples
# Display PTP clock properties.
<Sysname> display ptp time-property
PTP clock time property:
Current UTC offset valid : True
Current UTC offset : 33
Leap59 : Yes
Leap61 : No
Time traceable : True
Frequency traceable : True
PTP timescale : True
Time source : 0xA0 (Internal oscillator)
Sync uncertain : False
Table 8 Command output
Field |
Description |
Current UTC offset valid |
Whether the Coordinated Universal Time (UTC) offset is valid: · True—Yes. · False—No. |
Current UTC offset |
Cumulative offset (in seconds) between the UTC of the grandmaster clock and the International Atomic Time (TAI). |
Leap59 |
Whether cumulative offset is minus 1: · Yes. · No. |
Leap61 |
Whether cumulative offset is plus 1: · Yes. · No. |
Time traceable |
Whether the PTP time is traceable: · True—Yes. · False—No. |
Frequency traceable |
Whether the PTP frequency is traceable: · True—Yes. · False—No. |
PTP timescale |
The possible timescales available for use by the grandmaster clock: · True—PTP timescale. · False—Non-PTP timescale. |
Time source |
Attributes of the grandmaster clock: · Atomic clock. · GPS. · Handset. · Internal oscillator. · NTP. · Other. · PTP. · Terrestrial radio. · Unknown. |
Sync uncertain |
Whether the upstream clock is not reliable: · True—The upstream clock is not reliable. · False—The upstream clock is reliable. |
ptp { tod0 | tod1 }
Use ptp { tod0 | tod1 } to configure ToD input or output.
Use undo ptp { tod0 | tod1 } to restore the default.
Syntax
ptp { tod0 | tod1 } { input [ delay input-delay-time ] | output [ delay output-delay-time ] }
undo ptp { tod0 | tod1 } { input | output }
Default
Whether to receive or transmit ToD clock signals is not configured.
Views
System view
Predefined user roles
network-admin
Parameters
tod0: Specifies the ToD 0 clock. The device can receive clock signas from ToD 0, and cannot transmit clock signals from ToD 0.
tod1: Specifies the ToD 1 clock. The device can only transmit clock signals from ToD 1 and canot receive clock signals from ToD 1.
input: Configures the device to receive ToD clock signals.
delay input-delay-time: Specifies the receiving delay correction value in nanoseconds. The value is in the range of 0 to 2000000. The default value is 0.
output: Configures the device to transmit ToD clock signals as a master.
delay output-delay-time: Specifies the transmitting delay correction value in nanoseconds. The value is in the range of 0 to 1600. The default value is 0.
Usage guidelines
This command is available only after you specify a PTP profile and a PTP clock node type.
If you execute this command multiple times, the most recent configuration takes effect.
For the undo form of the command to take effect, first modify ToD input or output settings by executing this command.
Examples
# Configure the device to receive ToD clock signals from ToD 0 and set the receiving delay correction value to 1000 nanoseconds.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode oc
[Sysname] ptp tod0 input delay 1000
Related commands
ptp mode
ptp profile
ptp active force-state
Use ptp active force-state to activate the port role configuration.
Use undo ptp active force-state to restore the default.
Syntax
ptp active force-state
undo ptp active force-state
Default
The port role configuration is not activated.
Views
System view
Predefined user roles
network-admin
Usage guidelines
This command is available only after you specify a PTP profile and a PTP clock node type.
The T-TSC, T-TSC-P, and T-BC-P clock nodes do not support this command.
After you change the role of a PTP port, you must execute this command to activate the port role configuration.
Examples
# Activate the port role configuration.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode oc
[Sysname] ptp active force-state
Related commands
ptp force-state
ptp mode
ptp profile
ptp alarm-threshold clock-source-class
Use ptp alarm-threshold clock-source-class to set the class threshold for the clock source.
Use undo ptp alarm-threshold clock-source-class to restore the default.
Syntax
ptp alarm-threshold clock-source-class class-value
undo ptp alarm-threshold clock-source-class
Default
The class threshold for the clock source is 6.
Views
System view
Predefined user roles
network-admin
Parameters
class-value: Specifies a class threshold, in the range of 0 to 255.
Usage guidelines
Each PTP clock source has a class value. For a ToD clock source, you can set its class value by using the ptp clock-source command. The higher the value, the lower the class. When the class value of the clock source crosses the class threshold, the system outputs a log for notification.
This command is available only after you specify a PTP profile and PTP clock node type.
Only the IEEE 1588 version 2, ITU-T G.8275.1, and ITU-T G.8275.2 PTP profiles support this command.
Examples
# Set the class threshold to 20 for the clock source.
<Sysname> system-view
[Sysname] ptp profile g8275.1
[Sysname] ptp clock mode t-bc
[Sysname] ptp alarm-threshold clock-source-class 20
Related commands
ptp clock mode
ptp clock-source
ptp profile
ptp alarm-threshold { time-lock | time-unlock }
Use ptp alarm-threshold { time-lock threshold-value | time-unlock unlock-value } * to set the PTP time locking and unlocking thresholds.
Use undo ptp alarm-threshold { time-lock | time-unlock } * to restore the default.
Syntax
ptp alarm-threshold { time-lock lock-value | time-unlock unlock-value } *
undo ptp alarm-threshold { time-lock | time-unlock } *
Default
PTP time locking threshold and unlocking threshold are both 500 ns.
Views
System view
Predefined user roles
network-admin
Parameters
time-lock lock-value: Specifies the PTP time locking threshold in ns. The value is in the range of 20 to 3000.
time-unlock unlock-value: Specifies the PTP time unlocking threshold in ns. The value is in the range of 20 to 3000.
Usage guidelines
This command is available only after you specify a PTP profile and PTP clock node type.
When the time offset of the PTP reference clock crosses the PTP time unlocking threshold, the PTP time is put into unlocked state. The system outputs a time-unlocked log entry for notification. When the time offset of the PTP reference clock drops to or below the PTP time locking threshold, the PTP time is put into locked state. The system outputs a time-locked log entry for notification.
The PTP time unlocking threshold must be greater than or equal to the locking threshold.
You can execute the command multiple times. If different values are configured for a threshold, the most recent configuration takes effect.
Examples
# Set the PTP time locking threshold to 100 ns.
<Sysname> system-view
[Sysname] ptp profile g8275.1
[Sysname] ptp mode t-bc
[Sysname] ptp alarm-threshold time-lock 100
Related commands
ptp mode
ptp profile
ptp alarm-threshold time-offset
Use ptp alarm-threshold time-offset to set the time-offset threshold between the external reference clock and the PTP clock.
Use undo ptp alarm-threshold time-offset to restore the default.
Syntax
ptp alarm-threshold time-offset time-offset-value
undo ptp alarm-threshold time-offset
Default
The time-offset threshold between the external reference clock and the PTP clock is 500 ns.
Views
System view
Predefined user roles
network-admin
Parameters
time-offset-value: Specifies the time-offset threshold between the external reference clock and the PTP clock, in the range of 200 to 1000, in ns.
Usage guidelines
If the device uses an external ToD reference clock, it calculates the time offset between the external reference clock and the PTP clock at a pre-defined interval (not configurable). When the offset exceeds the threshold, the device outputs a log for notification.
This command is available only after you specify a PTP profile and a PTP clock node type.
Only the IEEE 1588 version 2, ITU-T G.8275.1, and ITU-T G.8275.2 PTP profiles support this command.
Examples
# Set the threshold to 800 for the time offset between the external reference clock and the PTP clock.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp clock mode t-bc
[Sysname] ptp alarm-threshold time-offset 800
Related commands
ptp mode
ptp profile
ptp alarm-threshold time-offset-sum pk-pk
Use ptp alarm-threshold time-offset-sum pk-pk to set the time-offset-sum peak-to-peak threshold.
Use undo ptp alarm-threshold time-offset-sum pk-pk to restore the default.
Syntax
ptp alarm-threshold time-offset-sum pk-pk threshold-value
undo ptp alarm-threshold time-offset-sum pk-pk
Default
The time-offset-sum peak-to-peak threshold is 500 ns.
Views
System view
Predefined user roles
network-admin
Parameters
threshold-value: Sets the time-offset-sum peak-to-peak threshold in the range of 0 to 2000, in ns.
Usage guidelines
This command is available only after you specify a PTP profile and PTP clock node type.
The PTP module calculates the time-offset-sum peak-to-peak value at specific intervals and compares the value with the threshold configured by this command. If the value is larger than the threshold, the system outputs a log for notification.
Examples
# Set the time-offset-sum peak-to-peak threshold to 1500 ns.
<Sysname> system-view
[Sysname] ptp profile g8275.1
[Sysname] ptp mode t-bc
[Sysname] ptp alarm-threshold time-offset-sum pk-pk 1500
Related commands
ptp mode
ptp profile
ptp announce-interval
Use ptp announce-interval to set the interval for sending announce messages.
Use undo ptp announce-interval to restore the default.
Syntax
ptp announce-interval interval
undo ptp announce-interval
Default
When the PTP profile is IEEE 1588 version 2, the interval argument value is 1 and the announce message sending interval is 2 (21) seconds.
When the PTP profile is ITU-T G.8275.1 and ITU-T G.8275.2, the interval argument value is –3 and the announce message sending interval is 1/8 (2-3) seconds.
Views
Layer 2 Ethernet interface view
Layer 3 Ethernet interface view
FlexE physical interface view
Predefined user roles
network-admin
Parameters
interval: Specifies an exponent, to the power of which base 2 is raised to get the interval in seconds for sending announce messages. The value range for the interval argument is 0 to 4 for the IEEE 1588 version 2 PTP profile, –3 to 6 for the ITU-T G.8275.1 PTP profile, and –3 to 0 for the ITU-T G.8275.2 PTP profile.
Usage guidelines
This command is available only after you specify a PTP profile and a PTP clock node type.
The configuration of the interval at which the master node sends announce messages depends on the PTP profile in the PTP domain.
· PTP profile other than ITU-T G.8275.2, or ITU-T G.8275.2 PTP profile not using unicast negotiation—You must configure the interval on the interface of the master node.
· ITU-T G.8275.2 PTP profile using unicast negotiation—You must configure the interval on the request-port of the client. The request-port uses the configured interval to negotiate with the grant-port on the server for the interval at which the grant-port sends announce messages to the client. If the negotiation succeeds, the grant-port sends announce messages at the configured interval to the client. If the negotiation fails, the grant-port does not send announce messages to the client.
Examples
# Set the announce message sending interval to 4 (22) seconds on Ten-GigabitEthernet 3/0/1.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode oc
[Sysname] interface ten-gigabitethernet 3/0/1
[Sysname-Ten-GigabitEthernet3/0/1] ptp announce-interval 2
Related commands
ptp mode
ptp profile
ptp announce-timeout
Use ptp announce-timeout to set the timeout multiplier for the announce message receiving interval.
Use undo ptp announce-timeout to restore the default.
Syntax
ptp announce-timeout multiple-value
undo ptp announce-timeout
Default
The timeout multiplier for the announce message receiving interval is 3.
Views
Layer 2 Ethernet interface view
Layer 3 Ethernet interface view
FlexE physical interface view
Predefined user roles
network-admin
Parameters
multiple-value: Sets the timeout multiplier for the announce message receiving interval, in the range of 2 to 10.
Usage guidelines
A master node sends announce messages to the member nodes at the specified interval. If a member node does not receive any announce message from the master node after the timeout expires, it determines that the master node is invalid. The timeout = timeout multiplier × interval at which the master node sends announce messages.
This command is available only after you specify a PTP profile and a PTP clock node type.
To ensure a stable PTP network, set the timeout multiplier for receiving announce messages to a value in the range of 5 to 7.
The ITU-T G.8275.2 PTP profile does not support this command.
Examples
# Set the timeout multiplier for the announce message sending interval to 5 on Ten-GigabitEthernet 3/0/1.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode oc
[Sysname] interface ten-gigabitethernet 3/0/1
[Sysname-Ten-GigabitEthernet3/0/1] ptp announce-timeout 5
Related commands
ptp announce-interval
ptp mode
ptp profile
ptp asymmetry-correction
Use ptp asymmetry-correction to set the asymmetric delay correction time.
Use undo ptp asymmetry-correction to restore the default.
Syntax
ptp asymmetry-correction { minus | plus } value
undo ptp asymmetry-correction
Default
The asymmetric delay correction time is 0 nanoseconds, which means that delay correction is not performed.
Views
Layer 2 Ethernet interface view
Layer 3 Ethernet interface view
FlexE physical interface view
Predefined user roles
network-admin
Parameters
minus: Subtracts the specified asymmetric delay correction value.
plus: Adds the specified asymmetric delay correction value.
value: Specifies the asymmetric delay correction value in the range of 0 to 2000000 nanoseconds.
Usage guidelines
This command is available only after you specify a PTP profile and a PTP clock node type.
Examples
# Set the asymmetric delay correction time to 100 nanoseconds on Ten-GigabitEthernet 3/0/1.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode oc
[Sysname] interface ten-gigabitethernet 3/0/1
[Sysname-Ten-GigabitEthernet3/0/1] ptp asymmetry-correction plus 100
Related commands
ptp mode
ptp profile
ptp clock-source
Use ptp clock-source to configure clock source parameters.
Use undo ptp clock-source to restore the default.
Syntax
Local clock source:
ptp clock-source local { accuracy acc-value | class class-value | time-source ts-value }
undo ptp clock-source local { accuracy | class | time-source }
ToD clock source:
ptp clock-source { tod0 | tod1 } { accuracy acc-value | class class-value | grandmaster-clockid clock-id | offsetscaled-logvariance value | time-source ts-value }
undo ptp clock-source { tod0 | tod1 } { accuracy | class | grandmaster-clockid | offsetscaled-logvariance | time-source }
Default
The clock ID of a GM clock is 000000-0000-000000.
· ITU-T G.8275.1 PTP profile
¡ T-TSC clock node type
- Local clock source—The accuracy value is 254, the time class value is 255, the offset (log variance) value is 65535, and the time source value is 160. The four values are not configurable.
- ToD clock source—The accuracy value is 254, the time class value is 255, the offset (log variance) value is 65535, and the time source value is 32.
¡ T-BC or T-TC clock node type
- Default PTP technical standard
Local clock source—The accuracy value is 254, the time class value is 248, the offset (log variance) value is 65535 and the time source value is 160. The offset (log variance) value is not configurable.
ToD clock source—The accuracy value is 32, the time class value is 6, the offset (log variance) value is 65535, and the time source value is 32.
- PTP OAM technical standard
Local clock source—The accuracy value is 254, the time class value is 165, the offset (log variance) value is 65535, and the time source value is 160. The offset (log variance) value is not configurable.
ToD clock source—The accuracy value is 254, the time class value is 165, the offset (log variance) value is 65535, and the time source value is 160.
- PTP Unicom technical standard
Local clock source—The accuracy value is 254, the time class value is 248, the offset (log variance) value is 65535, and the time source value is 160. The offset (log variance) value is not configurable.
ToD clock source—The accuracy value is 33, the time class value is 6, the offset (log variance) value is 20061, and the time source value is 32.
· IEEE 1588 version 2
¡ The accuracy value is 254, the time class value is 248, the offset (log variance) value is 65535, and the time source value is 160. The offset (log variance) value is fixed and not configurable.
¡ ToD clock source—The accuracy value is 32, the time class value is 6, the offset (log variance) is 65535, and the time source value is 32.
· ITU-T G.8275.2
¡ T-TSC-P clock node type
- Local clock source—The accuracy value is 254, the time class value is 255, the offset (log variance) value is 65535, and the time source value is 160. The four values are not configurable.
- ToD clock source—The accuracy value is 254, the time class value is 255, the offset (log variance) value is 65535, and the time source value is 32.
¡ T-BC-P clock node type
- Local clock source—The accuracy value is 254, the time class value is 248, the offset (log variance) value is 65535, and the time source value is 160. The offset (log variance) value is fixed and not configurable.
- ToD clock source—The accuracy value is 32, the time class value is 6, the offset (log variance) value is 65535, and the time source value is 32.
|
NOTE: Only the ITU-T G.8275.1 PTP profile supports PTP technical standards. |
Views
System view
Predefined user roles
network-admin
Parameters
local: Specifies the local clock.
tod0: Specifies the ToD 0 clock.
tod1: Specifies the ToD 1 clock. The device does not support this keyword.
accuracy acc-value: Specifies the accuracy of the ToD clock, in the range of 0 to 255. A smaller value indicates a higher accuracy. Table 9 shows the description for clock accuracy values.
Table 9 Clock accuracy value description
Clock accuracy value (in hexadecimal format) |
Description |
00 through 1F |
Reserved. |
20 |
Less than 25 nanoseconds (1 nanosecond = 10-9 second). |
21 |
Less than 100 nanoseconds. |
22 |
Less than 250 nanoseconds. |
23 |
Less than 1 microsecond (10-6 second). |
24 |
Less than 2.5 microseconds. |
25 |
Less than 10 microseconds. |
26 |
Less than 25 microseconds. |
27 |
Less than 100 microseconds. |
28 |
Less than 250 microseconds. |
29 |
Less than 1 millisecond (10-3 second). |
2A |
Less than 2.5 milliseconds. |
2B |
Less than 10 milliseconds. |
2C |
Less than 25 milliseconds. |
2D |
Less than 100 milliseconds. |
2E |
Less than 250 milliseconds. |
2F |
Less than 1 second. |
30 |
Less than 10 seconds. |
31 |
More than 10 seconds. |
32 through 7F |
Reserved. |
80 through FD |
For use by alternate PTP profiles. |
FE |
Unknown. |
FF |
Reserved. |
class class-value: Specifies the time class of the clock, in the range of 0 to 255. A smaller value indicates a higher time class. Table 10 shows the description for clock classes. The values not listed in the table are reserved by the protocol. As a best practice, do not use those values. The clock's time class is an attribute of the device. For a local clock source, keep its default time class and do not modify it as a best practice.
Table 10 Clock class description
Clock class (in decimal format) |
Description |
6 |
The clock node synchronizes its time to the master reference time source. PTP assigns a time table to the clock node. A clock node with time class 6 cannot become a member clock of any other clocks in the domain. |
7 |
The former time class is 6. The clock node cannot synchronize its time to a time source. It enters the reappointment mode and meets the reappointment conditions. PTP assigns a time table to the clock node. A clock node with time class 7 cannot become a member clock of any other clocks in the domain. |
13 |
The clock node synchronizes its time to a time source. ARB assigns a time table to the clock node. A clock node with time class 13 cannot become a member clock of any other clocks in the domain. |
14 |
The former time class is 13. The clock node cannot synchronize its time to a time source. It enters the reappointment mode and meets the reappointment conditions. ARB assigns a time table to the clock node. A clock node with time class 14 cannot become a member clock of any other clocks in the domain. |
52 |
The clock node with time class 7 becomes optional clock A because it does not meet the reappointment conditions. A clock node with time class 52 cannot become a member clock of any other clocks in the domain. |
58 |
The clock node with time class 14 becomes optional clock A because it does not meet the reappointment conditions. A clock node with time class 58 cannot become a member clock of any other clocks in the domain. |
187 |
The clock node with time class 7 becomes optional clock B because it does not meet the reappointment conditions. A clock node with time class 187 can become a member clock of another clock in the domain. |
193 |
The clock node with time class 14 becomes optional clock B because it does not meet the reappointment conditions. A clock node with time class 193 can become a member clock of another clock in the domain. |
248 |
Default time class value. |
255 |
Clock node operating in slave-only mode. |
grandmaster-clockid clock-id: Specifies the GM clock ID. The clock-id argument is in the XXXXXX-XXXX-XXXXXX format. X represents a hexadecimal number. A full 0 number is not supported. This option is not available for a local clock source. For a ToD clock source, you must specify this option.
offsetscaled-logvariance value: Specifies the offset (log variance). The value is in the range of 0 to 65535. This option is not available for a local clock source.
time-source ts-value: Specifies the clock attribute value in the range of 0 to 255. Table 11 shows the description for the clock attribute values (those not listed are reserved for the protocol).
Table 11 GM attribute value description
GM attribute values (in hexadecimal format) |
Description |
10 |
Atomic clock. |
20 |
GPS. |
30 |
Terrestrial radio. |
40 |
PTP. |
50 |
NTP. |
60 |
Handset. |
90 |
Other. |
A0 |
Internal oscillator. |
F0 to FE |
For use by alternate PTP profiles. |
FF |
Reserved. |
Usage guidelines
This command is available only after you specify a PTP profile and a PTP clock node type.
You can execute this command multiple times to configure different parameters. If you configure a parameter multiple times, the most recent configuration takes effect.
Examples
# Set the time accuracy for the ToD 0 clock to 44.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode oc
[Sysname] ptp clock-source tod0 accuracy 44
Related commands
ptp mode
ptp profile
ptp technical-standard
PTP clock-state enable
Use ptp clock-state enable to enable the PTP clock state feature.
Use undo ptp clock-state enable to disable the PTP clock state feature.
Syntax
ptp clock-state enable
undo ptp clock-state enable
Default
The PTP clock state feature is disabled.
Views
System view
Predefined user roles
network-admin
Usage guidelines
The PTP clock state feature defines and clarifies the following PTP clock states:
· Free-Run—The PTP clock has never been synchronized to a time source and is not in the process of synchronizing to a time source.
· Acquiring—The PTP clock is in the process of synchronizing to a time source.
· Locked—The PTP clock has been synchronized to a time source within the acceptable accuracy.
· Holdover—The PTP clock is no longer synchronized to a time source and is using information obtained when it was previously synchronized.
This command is available only after you specify a PTP profile and a PTP clock node type. The PTP profile must be IEEE 1588 version 2 or ITU-T G.8275.1.
This command is mutually exclusive with the ptp technical-standard command.
Examples
# Enable the PTP clock state feature.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode bc
[Sysname] ptp clock-state enable
Related commands
ptp mode
ptp profile
ptp technical-standard
ptp clock-step
Use ptp clock-step to configure the mode for carrying timestamps.
Use undo ptp clock-step to restore the default.
Syntax
ptp clock-step { one-step | two-step }
undo ptp clock-step
Default
Two-step mode is used for carrying timestamps.
Views
Layer 2 Ethernet interface view
Layer 3 Ethernet interface view
FlexE physical interface view
Predefined user roles
network-admin
Parameters
one-step: Specifies the single-step mode.
two-step: Specifies the two-step mode.
Usage guidelines
This command is available only after you specify a PTP profile and a PTP clock node type.
Examples
# Specify the two-step timestamp carrying mode on Ten-GigabitEthernet 3/0/1.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode oc
[Sysname] interface ten-gigabitethernet 3/0/1
[Sysname-Ten-GigabitEthernet3/0/1] ptp clock-step two-step
Related commands
ptp mode
ptp profile
ptp delay-mechanism
Use ptp delay-mechanism to specify a PTP delay measurement mechanism.
Use undo ptp delay-mechanism to restore the default.
Syntax
ptp delay-mechanism { e2e | p2p }
undo ptp delay-mechanism
Default
The request-response delay measurement mechanism applies.
Views
Layer 2 Ethernet interface view
Layer 3 Ethernet interface view
FlexE physical interface view
Predefined user roles
network-admin
Parameters
e2e: Specifies the request-response mechanism.
p2p: Specifies the peer delay mechanism.
Usage guidelines
You can configure this command only after you have specified a PTP profile and PTP mode for the device.
When the PTP profile is IEEE 1588 version 2, the following restrictions apply:
· You can configure this command only on a BC or OC clock node.
· You cannot configure this command on an E2ETC, E2ETC+OC, P2PTC, or P2PTC+OC clock node. The E2ETC and E2ETC+OC clock nodes support both request-response and peer delay measurement mechanisms. A P2PTC clock node supports only the peer delay measurement mechanism.
The ITU-T G.8275.1 PTP profile supports only the request-response delay measurement mechanism and does not support this command.
The ITU-T G.8275.2 PTP profile supports only the request-response delay measurement mechanism and does not support this command.
Examples
# Specify the OC clock type. On Ten-GigabitEthernet 3/0/1, specify the request-response delay measurement mechanism (e2e).
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode oc
[Sysname] interface ten-gigabitethernet 3/0/1
[Sysname-Ten-GigabitEthernet3/0/1] ptp delay-mechanism e2e
Related commands
ptp mode
ptp profile
ptp delay-resp-interval
Use ptp delay-resp-interval to set the interval at which the server sends Delay_resp messages to the client.
Use undo ptp delay-resp-interval to restore the default.
Syntax
ptp delay-resp-interval interval
undo ptp delay-resp-interval
Default
The value of the interval argument is –4 and the minimum interval for sending Delay_resp messages is 1/16 (2-4) seconds.
Views
Layer 3 Ethernet interface view
FlexE physical interface view
Predefined user roles
network-admin
Parameters
interval: Specifies an exponent, to the power of which base 2 is raised to get the interval in seconds for sending Delay_resp messages. The value range for this argument is –5 to 0.
Usage guidelines
Only the ITU-T G.8275.2 PTP profile supports this command.
This command, configured on a request-port, specifies the interval at which the grant-port sends Delay_resp messages to the request-port.
After receiving a Delay_req message from a request port, the grant-port responses by sending a Delay_resp message and starts a timer defined by this command. The grant-port will not send another Delay_resp message until it receives a Delay_req message after the timer expires.
Examples
# Set the Delay_resp message sending interval to 2-3 seconds.
<Sysname> system-view
[Sysname] ptp profile g8275.2
[Sysname] ptp mode t-bc-p
[Sysname] interface ten-gigabitethernet 3/0/1
[Sysname-Ten-GigabitEthernet3/0/1] ptp unicast-destination 10.10.10.2
[Sysname-Ten-GigabitEthernet3/0/1] ptp unicast-negotiate request-port
[Sysname-Ten-GigabitEthernet3/0/1] ptp delay-resp-interval -3
Related commands
ptp mode
ptp profile
ptp unicast-destination
ptp unicast-negotiate
ptp destination-mac
Use ptp destination-mac to configure the destination MAC address for PTP messages.
Use undo ptp destination-mac to restore the default.
Syntax
ptp destination-mac mac-address
undo ptp destination-mac
Default
The destination MAC address for non-peer delay messages is 011B-1900-0000.
The destination MAC address for peer delay messages is 0180-C200-000E.
Views
Layer 2 Ethernet interface view
Layer 3 Ethernet interface view
FlexE physical interface view
Predefined user roles
network-admin
Parameters
mac-address: Specifies the destination MAC address for PTP unicast messages as any unicast MAC address or specifies the destination MAC address for non-peer delay multicast messages as 0180-C200-000E or 011B-1900-0000.
Usage guidelines
This command is available only after you specify a PTP profile and a PTP clock node type.
This command is not available for the ITU-T G.8275.2 PTP profile.
This command takes effect only if PTP messages are transported over IEEE 802.3/Ethernet packets.
IEEE 802.3/Ethernet-encapsulated PTP messages can be sent through multicast (default) or unicast. In multicast mode, the destination MAC address is 0180-C200-000E or 011B-1900-0000 for non-Pdelay messages and 0180-C200-000E for Pdelay messages. Non-Pdelay messages include delay_Req, delay_Resp, delay_Resp_Follow_Up, Announce, Sync, and FollowUp messages. Pdelay messages include Pdelay_Req, Pdelay_Resp, and Pdelay_Resp_Follow_Up messages.
If a clock node uses the unicast mode, you must configure any unicast MAC address on the uplink node of this clock node as the destination MAC address for PTP messages.
Examples
# Set the destination MAC address for non-peer delay messages to 0180-C200-000E on Ten-GigabitEthernet 3/0/1.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode oc
[Sysname] interface ten-gigabitethernet 3/0/1
[Sysname-Ten-GigabitEthernet3/0/1] ptp destination-mac 0180-c200-000e
Related commands
ptp mode
ptp profile
ptp domain
Use ptp domain to specify a PTP domain.
Use undo ptp domain to restore the default.
Syntax
ptp domain domain-number
undo ptp domain
Default
When the PTP profile is IEEE 1588 version 2, the device is in PTP domain 0.
When the PTP profile is ITU-T G.8275.1, the device is in PTP domain 24.
When the PTP profile is ITU-T G.8275.2, the device is in PTP domain 44.
Views
System view
Predefined user roles
network-admin
Parameters
domain-number: Specifies a PTP domain by its number in the range of 0 to 255. For the ITU-T G.8275.1 PTP profile, the value range for the argument is 24 to 43. For the ITU-T G.8275.2 PTP profile, the value range for the argument is 44 to 63.
Usage guidelines
This command is available only after you specify a PTP profile and a PTP clock node type.
Examples
# Configure the PTP domain number to use for the device as 2.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode oc
[Sysname] ptp domain 2
Related commands
ptp mode
ptp profile
ptp dscp
Use ptp dscp to set a DSCP value for PTP messages transmitted over IPv4 UDP.
Use undo ptp dscp to restore the default.
Syntax
ptp dscp dscp
undo ptp dscp
Default
The DSCP value is 56 for PTP messages transmitted over IPv4 UDP.
Views
Layer 2 Ethernet interface view
Layer 3 Ethernet interface view
Predefined user roles
network-admin
Parameters
dscp: Sets a DSCP value in the range of 0 to 63 for PTP messages.
Usage guidelines
This command is available only after you specify a PTP profile and a PTP clock node type. The ITU-T G.8275.1 profile does not support this command.
This command takes effect only if PTP messages are transmitted over IPv4 UDP.
Examples
# Set the DSCP value to 63 for PTP messages transmitted over IPv4 UDP on Ten-GigabitEthernet 3/0/1.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode oc
[Sysname] interface ten-gigabitethernet 3/0/1
[Sysname-Ten-GigabitEthernet3/0/1] ptp transport-protocol udp
[Sysname-Ten-GigabitEthernet3/0/1] ptp dscp 63
Related commands
ptp mode
ptp profile
ptp transport-protocol
ptp enable
Use ptp enable to enable PTP.
Use undo ptp enable to disable PTP.
Syntax
ptp enable
undo ptp enable
Default
PTP is disabled.
Views
Layer 2 Ethernet interface view
Layer 3 Ethernet interface view
FlexE physical interface view
Predefined user roles
network-admin
Usage guidelines
This command is available only after you specify a PTP profile and a PTP clock node type.
For an OC, T-TSC, or T-TSC-P clock node, you can enable PTP only on one port.
As a best practice, enable PTP on an interface after you configure PTP parameters.
To enable PTP on a Layer 3 Ethernet interface that has been assigned to a VPN instance, you must specify this VPN instance in the ptp source ip-address vpn-instance vpn-instance-name command if PTP messages are to be transmitted in multicast mode over IPv4 UDP.
Examples
# Specify the OC clock node type and enable PTP on Ten-GigabitEthernet 3/0/1.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode oc
[Sysname] interface ten-gigabitethernet 3/0/1
[Sysname-Ten-GigabitEthernet3/0/1] ptp enable
# Specify the E2ETC clock node type, and enable PTP on Ten-GigabitEthernet 3/0/1 and Ten-GigabitEthernet 3/0/2.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode e2etc
[Sysname] interface ten-gigabitethernet 3/0/1
[Sysname-Ten-GigabitEthernet3/0/1] ptp enable
[Sysname-Ten-GigabitEthernet3/0/1] interface ten-gigabitethernet 3/0/2
[Sysname-Ten-GigabitEthernet3/0/2] ptp enable
Related commands
ptp mode
ptp profile
ptp source
ptp force-state
Use ptp force-state to configure a role for a PTP port.
Use undo ptp force-state to restore the default.
Syntax
ptp force-state { master | passive | slave }
undo ptp force-state
Default
The PTP port role is automatically calculated by the BMC algorithm.
Views
Layer 2 Ethernet interface view
Layer 3 Ethernet interface view
FlexE physical interface view
Predefined user roles
network-admin
Parameters
master: Specifies the PTP port as a master port.
passive: Specifies the PTP port as a passive port.
slave: Specifies the PTP port as a subordinate port.
Usage guidelines
By default, the PTP port roles are automatically negotiated based on the BMC algorithm. If you use this command to change the role of one PTP port, all the other PTP ports in the PTP domain stop working. For these PTP ports to function, you must specify roles for each of them by using this command. As a best practice, enable automatic negotiation of PTP port roles based on the BMC algorithm.
This command is available only after you specify a PTP profile and a PTP clock node type.
The T-TSC, T-TSC-P, and T-BC-P clock nodes do not support this command.
You can configure only one subordinate port for a device.
After you change the role of a PTP port, you must execute the ptp active force-state command to activate the port role configuration.
Examples
# Specify the OC clock node type and configure Ten-GigabitEthernet 3/0/1 as a subordinate port.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode oc
[Sysname] interface ten-gigabitethernet 3/0/1
[Sysname-Ten-GigabitEthernet3/0/1] ptp force-state slave
Related commands
ptp active force-state
ptp mode
ptp profile
ptp slave-only
ptp local-priority
Use ptp local-priority to configure a local priority for an interface.
Use undo ptp local-priority to restore the default.
Syntax
ptp local-priority local-priority
undo ptp local-priority
Default
The local priority of an interface is 128.
Views
Layer 2 Ethernet interface view
Layer 3 Ethernet interface view
FlexE physical interface view
Predefined user roles
network-admin
Parameters
local-priority: Specifies a priority in the range of 1 to 255. The lower the value, the higher the priority.
Usage guidelines
This command is available only after you specify a PTP profile and a PTP clock node type. Only the ITU-T G.8275.1 and ITU-T G.8275.2 PTP profiles support this command.
An announce message does not carry the local priority of the clock node. Under the ITU-T G.8275.1 or ITU-T G.8275.2 PTP profile, each PTP-enabled interface on a clock node has a local priority. This priority will be used as the local priority of the peer node in BMC selection and is one of the factors that determine whether the peer node can be elected as the GM.
Examples
# Set the local priority for Ten-GigabitEthernet3/0/1 to 10.
<Sysname> system-view
[Sysname] ptp profile g8275.1
[Sysname] ptp mode t-bc
[Sysname] interface ten-gigabitethernet 3/0/1
[Sysname-Ten-GigabitEthernet3/0/1] ptp local-priority 10
Related commands
ptp mode
ptp profile
ptp ignore sync-uncertain
Use ptp ignore sync-uncertain to enable the device to ignore the synchronizationUncertain flag.
Use undo ptp ignore sync-uncertain to disable ignoring the synchronizationUncertain flag.
Syntax
ptp ignore sync-uncertain
undo ptp ignore sync-uncertain
Default
The device does not ignore the synchronizationUncertain flag.
Views
System view
Predefined user roles
network-admin
Usage guidelines
By default, the device reads the value of the synchronizationUncertain flag in the announce message it receives.
· A synchronizationUncertain bit value of 1 indicates that synchronization information from the upstream node is unlocked.
· A synchronizationUncertain bit value of 0 indicates that synchronization information from the upstream node is locked.
If synchronization information from the upstream node is unlocked, the device will not use that information for time synchronization. Only if synchronization information from the upstream node is locked, the device uses that information for time synchronization.
Typically, you are not required to configure this command. If the upstream clock is very reliable, you can configure this command to enable the device to ignore the synchronizationUncertain flag. After this command is configured, the device will synchronize the time directly with synchronization information from the upstream clock without reading the synchronizationUncertain bit value.
This command is available only after you specify a PTP profile and a PTP clock node type. The PTP profile must be IEEE 1588 version 2 or ITU-T G.8275.1.
Related commands
# Enable the device to ignore the synchronizationUncertain flag.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode bc
[Sysname] ptp ignore sync-uncertain
ptp max-steps-removed
Use ptp max-steps-removed to specify the maximum number of removed steps (clock nodes) from the GM to the device.
Use undo ptp max-steps-removed to restore the default.
Syntax
ptp max-steps-removed step-removed-value
undo ptp max-steps-removed
Default
The maximum number of removed steps is 255 from the GM to the device.
Views
System view
Predefined user roles
network-admin
Parameters
step-removed-value: Specifies the maximum number of removed steps from the GM to the device, in the range of 1 to 255.
Usage guidelines
If the number of removed steps from the GM to the device exceeds the maximum number, the device cannot synchronize time through PTP.
This command is available only after you specify a PTP profile and a PTP clock node type.
Examples
# Set the maximum number of removed steps from the GM to the device to 20.
<Sysname> system-view
[Sysname] ptp profile g8275.1
[Sysname] ptp mode t-bc
[Sysname] ptp max-steps-removed 20
Related commands
ptp mode
ptp profile
ptp min-delayreq-interval
Use ptp min-delayreq-interval to set the minimum interval for sending delay request messages.
Use undo ptp min-delayreq-interval to restore the default.
Syntax
ptp min-delayreq-interval interval
undo ptp min-delayreq-interval
Default
When the PTP profile is IEEE 1588 version 2, the value of the interval argument is 0 and the minimum interval for sending delay request messages is 1 (20) second.
When the PTP profile is ITU-T G.8275.1 or ITU-T G.8275.2, the value of the interval argument is –4 and the minimum interval for sending delay request messages is 1/16 (2-4) seconds.
Views
Layer 2 Ethernet interface view
Layer 3 Ethernet interface view
FlexE physical interface view
Predefined user roles
network-admin
Parameters
interval: Specifies an exponent, to the power of which base 2 is raised to get the interval in seconds for sending delay request messages. The value range for the interval argument is –4 to 6. For the ITU-T G8275.2 PTP profile, the value range for the interval argument is –5 to 0.
Usage guidelines
When a member clock receives a Sync message, it responds by sending a Delay_Req message and starts a timer defined by this command. The member clock will not send another Delay_Req message until it receives a Sync message after the timer expires.
This command is available only after you specify a PTP profile and a PTP clock node type.
In PTP multicast transport mode, this command takes effect only when configured on the master clock. The master clock sends the value to a member clock through PTP messages to control the interval for the member clock to send Delay_Req messages. To view the value on a member clock, execute the display ptp interface command on the member clock.
In PTP unicast transport mode, this command takes effect when configured on member clocks. It does not take effect when configured on the master clock.
Examples
# Set the minimum interval to 4 (22) seconds for sending delay request messages on Ten-GigabitEthernet 3/0/1.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode oc
[Sysname] interface ten-gigabitethernet 3/0/1
[Sysname-Ten-GigabitEthernet3/0/1] ptp min-delayreq-interval 2
Related commands
ptp mode
ptp profile
ptp syn-interval
ptp mode
Use ptp mode to specify a clock node type for the device.
Use undo ptp mode to restore the default.
Syntax
IEEE 1588v2 PTP profile:
ptp mode { bc | e2etc | e2etc-oc | oc | p2ptc | p2ptc-oc }
undo ptp mode
ITU-T G.8275.1 PTP profile:
ptp mode { t-bc | t-tc | t-tsc }
undo ptp mode
ITU-T G.8275.2 PTP profile:
ptp mode { t-bc-p | t-tsc-p }
undo ptp mode
Default
No clock node type is specified for the device.
Views
System view
Predefined user roles
network-admin
Parameters
bc: Specifies the boundary clock (BC) type.
e2etc: Specifies the end-to-end transparent clock (E2ETC) type.
e2etc-oc: Specifies the E2ETC+OC type.
oc: Specifies the ordinary clock (OC) type.
p2ptc: Specifies the peer-to-peer transparent clock (P2PTC) type.
p2ptc-oc: Specifies the P2PTC+OC type.
t-bc: Specifies the telecom boundary clock (T-BC) type.
t-tc: Specifies the telecom transparent clock (T-TC) type.
t-tsc: Specifies the telecom time slave clock (T-TSC) type.
t-bc-p: Specifies the partial-support telecom boundary clock (T-BC-P) type.
t-tsc-p: Specifies the partial-support telecom time slave clock (T-TSC-P) type.
Usage guidelines
CAUTION: If you change the clock node type for the device, all settings except for the PTP profile will be removed. |
This command is available only after you specify a PTP profile.
· When the PTP profile is IEEE 1588 version 2, you cannot specify the T-TC, T-BC, or T-TSC clock node type.
· When the PTP profile is ITU-T G.8275.1, you can specify only the T-TC, T-BC, or T-TSC clock node type.
· When the PTP profile is ITU-T G.8275.2, you can specify only the T-BC-P or T-TSC-P clock node type.
You can specify only one clock node type for a device.
Changing or removing the clock node type will restore the default settings of the PTP profile.
Examples
# Specify the OC clock node type for the device.
<Sysname> system-view
[Sysname] ptp profile 1588v2
Related commands
ptp profile
ptp notslave disable
Use ptp notslave disable to disable the NotSlave feature.
Use undo ptp notslave disable to restore the default.
Syntax
ptp notslave disable
undo ptp notslave disable
Default
The NotSlave feature is enabled on a PTP interface.
Views
Layer 2 Ethernet interface view
Layer 3 Ethernet interface view
FlexE physical interface view
Predefined user roles
network-admin
Usage guidelines
The NotSlave feature, available only for the ITU-T G.8275.1 and ITU-T G.8275.2 PTP profiles, enables a PTP port to select the clock node where it resides as the master node. You can use this feature to control master/member role of the clock node. For automatic master/member clock node selection in a PTP domain under the ITU-T G.8275.1 PTP profile, you must disable NotSlave on all PTP ports.
This command is available only after you specify a PTP profile and PTP clock node type.
Under the ITU-T G.8275.1 PTP profile, only the T-BC and T-TC clock node types support this command.
Under the ITU-T G.8275.2 PTP profile, only the T-BC-P clock node type supports this command.
By default, the ports on the T-BC-P and T-BC clock nodes are in master-only mode. To use a port on a T-BC-P or T-BC clock node as a subordinate port, first execute the ptp notslave disable command on the port.
Examples
# Disable the NotSlave feature on Ten-GigabitEthernet3/0/1.
<Sysname> system-view
[Sysname] ptp profile g8275.1
[Sysname] ptp mode t-bc
[Sysname] interface ten-gigabitethernet 3/0/1
[Sysname-Ten-GigabitEthernet3/0/1] ptp notslave disable
Related commands
ptp mode
ptp profile
ptp path-trace disable
Use ptp path-trace disable to disable PTP path tracing.
Use undo ptp path-trace disable to enable PTP path tracing.
Syntax
ptp path-trace disable
undo ptp path-trace disable
Default
PTP path tracing is enabled.
Views
System view
Predefined user roles
network-admin
Usage guidelines
PTP path tracing traces the clock nodes that the clock signals traverse from the GM to the device. The system can obtain complete path tracing information only when all clock nodes on the path are enabled with PTP path tracing. If a device on the path does not support PTP path tracing, disable this feature to prevent PTP intercommunication issues.
This command is available only after you have specified a PTP profile and PTP clock node type.
Examples
# Disable PTP path tracing.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode bc
[Sysname] ptp path-trace disable
Related commands
display ptp path-trace
ptp mode
ptp profile
ptp pdelay-req-interval
Use ptp pdelay-req-interval to set the interval for sending peer delay request messages.
Use undo ptp pdelay-req-interval to restore the default.
Syntax
ptp pdelay-req-interval interval
undo ptp pdelay-req-interval
Default
The interval argument value is 0 and the interval for sending peer delay request messages is 1 (20) second.
Views
Layer 2 Ethernet interface view
Layer 3 Ethernet interface view
FlexE physical interface view
Predefined user roles
network-admin
Parameters
interval: Specifies an exponent, to the power of which base 2 is raised to get the interval in seconds for sending peer delay request messages. The value range for the interval argument is –4 to 6. If the PTP profile is IEEE 1588 version 2, the value range for the interval argument is 0 to 5.
Usage guidelines
This command is available only after you specify a PTP profile and a PTP clock node type.
The ITU-T G.8275.1 and ITU G.8275.2 PTP profiles do not support this command.
Examples
# Set the interval to 4 (22) seconds for sending peer delay request messages on Ten-GigabitEthernet 3/0/1.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode oc
[Sysname] interface ten-gigabitethernet 3/0/1
[Sysname-Ten-GigabitEthernet3/0/1] ptp pdelay-req-interval 2
Related commands
ptp mode
ptp profile
ptp port-mode
Use ptp port-mode to configure the interface type as OC for a TC+OC (including E2ETC+OC and P2PTC+OC) clock node.
Use undo ptp port-mode to restore the default.
Syntax
ptp port-mode oc
undo ptp port-mode
Default
All interfaces on an E2ETC+OC or a P2PTC+OC clock node is TC type.
Views
Layer 2 Ethernet interface view
Layer 3 Ethernet interface view
FlexE physical interface view
Predefined user roles
network-admin
Parameters
oc: Specifies the OC interface type.
Usage guidelines
This command is available only after you specify a PTP profile and a PTP clock node type. Only E2ETC+OC and P2PTC+OC clock nodes support this command.
The ITU-T G.8275.1 and ITU G.8275.2 PTP profiles do not support this command.
Examples
# Specify the P2PTC+OC clock node type for the device. Configure the interface type for Ten-GigabitEthernet 3/0/1 as OC.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode p2ptc-oc
[Sysname] interface ten-gigabitethernet 3/0/1
[Sysname-Ten-GigabitEthernet3/0/1] ptp port-mode oc
Related commands
ptp mode
ptp profile
ptp priority clock-source
Use ptp priority clock-source to configure the priority for a clock source.
Use undo ptp priority clock-source to restore the default.
Syntax
ptp priority clock-source { local | tod0 | tod1 } { local-priority local-priority | priority1 priority1 | priority2 priority2 }
undo ptp priority clock-source { local | tod0 | tod1 } { local-priority | priority1 | priority2 }
Default
When the PTP profile is IEEE 1588 version 2, the priority 1 and priority 2 values are both 128.
When the PTP profile is ITU-T G.8275.1, the priority 1 value is 128. The priority 2 value is 128 for both T-BC and T-TC clock nodes and 225 for a T-TSC clock node. The local priority value is 128.
When the PTP profile is ITU-T G.8275.2, the priority 1 value is 128. The priority 2 value is 128 for a T-BC-P clock node and 255 for a T-TSC-P clock node. The local priority value is 128.
Views
System view
Predefined user roles
network-admin
Parameters
local: Specifies the local clock.
tod0: Specifies the ToD 0 clock.
tod1: Specifies the ToD 1 clock.
local-priority local-priority: Specifies the local priority for the clock. The value is in the range of 0 to 255. A numerically smaller value has higher priority. This option is available only for the ITU-T G.8275.1 and ITU-T G.8275.2 PTP profiles.
priority1 priority1: Specifies priority 1 for the clock. The value is in the range of 0 to 255 for the IEEE 1588 version 2 PTP profile, and is 128 for the ITU-T G.8275.1 and ITU-T G.8275.2 PTP profiles. A numerically smaller value indicates higher priority.
priority2 priority2: Specifies priority 2 for the clock. The value is in the range of 0 to 255 for the IEEE 1588 version 2 PTP profile. For the ITU-T G.8275.1 PTP profile, the value is in the range of 0 to 255 for T-BC and T-TC clock nodes and 255 for a T-TSC clock node. For the ITU-T G.8275.2 PTP profile, the value is in the range of 0 to 255 for a T-BC-P clock node and 255 for a T-TSC clock node. A numerically smaller value indicates higher priority.
Usage guidelines
This command is available only after you specify a PTP profile and a PTP clock node type.
The local priority of a clock will not be carried in PTP announce messages.
Examples
# Set priority 1 to 10 for the local clock.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode oc
[Sysname] ptp priority clock-source local priority1 10
Related commands
ptp mode
ptp profile
ptp profile
Use ptp profile to specify a PTP profile.
Use undo ptp profile to restore the default.
Syntax
ptp profile { 1588v2 | g8275.1 | g8275.2 }
undo ptp profile
Default
No PTP profile is specified for a device.
Views
System view
Predefined user roles
network-admin
Parameters
1588v2: Specifies the IEEE 1588 version 2 PTP profile.
g8275.1: Specifies the ITU-T G.8275.1 PTP profile.
g8275.2: Specifies the ITU-T G.8275.2 PTP profile.
Usage guidelines
You must first specify a PTP profile before configuring PTP commands.
Changing or removing a PTP profile clears all settings under the PTP profile.
Examples
# Specify the IEEE 1588 version 2 PTP profile.
<Sysname> system-view
[Sysname] ptp profile 1588v2
ptp slave-only
Use ptp slave-only to configure the OC to operate only as a member clock.
Use undo ptp slave-only to restore the default.
Syntax
ptp slave-only
undo ptp slave-only
Default
An OC can operate either as a master clock or a member clock.
Views
System view
Predefined user roles
network-admin
Usage guidelines
This command is applicable only to OCs and is available only after you specify a PTP profile and a PTP clock node type.
You can execute the ptp force-state command to specify a subordinate port as a master port or passive port even if the OC operates as a member clock.
Examples
# Specify the clock node type as OC for the device. Configure the OC to operate only as a member clock.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode oc
[Sysname] ptp slave-only
Related commands
ptp force-state
ptp mode
ptp profile
ptp source
Use ptp source to configure the source IP address for multicast PTP messages transported over IPv4 UDP.
Use undo ptp source to remove the specified source IP address for multicast PTP messages transported over IPv4 UDP.
Syntax
ptp source ip-address [ vpn-instance vpn-instance-name ]
undo ptp source ip-address [ vpn-instance vpn-instance-name ]
Default
No source IP address is configured for multicast PTP messages transported over IPv4 UDP.
Views
System view
Predefined user roles
network-admin
Parameters
ip-address: Specifies the source IP address for multicast PTP messages transported over IPv4 UDP.
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance used for communication between the local device and the peer device. The vpn-instance-name argument is a case-sensitive string of 1 to 31 characters. If the peer device belongs to the public network, do not specify this option.
Usage guidelines
This command is available only after you specify a PTP profile and a PTP clock type. The ITU-T G.8275.1 and ITU G.8275.2 PTP profiles do not support this command.
This command takes effect only when PTP messages are transmitted over IPv4 UDP in multicast mode.
If a PTP-enabled Layer 3 Ethernet interface has been assigned to a VPN instance, you must specify the VPN instance in the ptp source ip-address vpn-instance vpn-instance-name command.
Examples
# Specify 3.5.1.5 as the source address for multicast PTP messages transported over IPv4 UDP.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode oc
[Sysname] ptp source 3.5.1.5
Related commands
ptp mode
ptp profile
ptp transport-protocol
ptp syn-interval
Use ptp syn-interval to set the interval for sending Sync messages.
Use undo ptp syn-interval to restore the default.
Syntax
ptp syn-interval interval
undo ptp syn-interval
Default
When the PTP profile is IEEE 1588 version 2, the interval argument value is 0 and the interval for sending Sync messages is 1 (20) second.
When the PTP profile is ITU-T G.8275.1 or ITU G.8275.2, the interval argument value is –4 and the interval for sending Sync messages is 1/16 (2-4) seconds.
Views
Layer 2 Ethernet interface view
Layer 3 Ethernet interface view
FlexE physical interface view
Predefined user roles
network-admin
Parameters
interval: Specifies an exponent, to the power of which base 2 is raised to get the interval in seconds for sending Sync messages. The value range for the interval argument is –4 to 6 for the ITU-T G.8275.1 PTP profile, –4 to 6 for the IEEE 1588 version 2 PTP profile, and –5 to 0 for the ITU-T G.8275.2 PTP profile.
Usage guidelines
This command is available only after you specify a PTP profile and a PTP clock node type.
The configuration of the interval at which the master node sends Sync messages depends on the PTP profile in the PTP domain.
· PTP profile other than ITU-T G.8275.2, or ITU-T G.8275.2 PTP profile not using unicast negotiation—You must configure the interval on the interface of the master node.
· ITU-T G.8275.2 PTP profile using unicast negotiation—You must configure the interval on the request-port of the client. The request-port uses the configured interval to negotiate with the grant-port on the server for the interval at which the grant-port sends Sync messages to the client. If the negotiation succeeds, the grant-port sends Sync messages at the configured interval to the client. If the negotiation fails, the grant-port does not send Sync messages to the client.
Examples
# Set the Sync message sending interval to 2 (21) seconds on Ten-GigabitEthernet 3/0/1.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode oc
[Sysname] interface ten-gigabitethernet 3/0/1
[Sysname-Ten-GigabitEthernet3/0/1] ptp syn-interval 1
Related commands
ptp mode
ptp profile
ptp sync-uncertain enable
Use ptp sync-uncertain enable to enable the device to notify the downstream nodes of its time synchronization state.
Use undo ptp sync-uncertain enable to disable the device from notifying the downstream nodes of its time synchronization state.
Syntax
ptp sync-uncertain enable
undo ptp sync-uncertain enable
Default
The device does not notify the downstream nodes of its time synchronization state.
Views
System view
Predefined user roles
network-admin
Usage guidelines
By default, the device transfers only the locked and unlocked status of the upstream node to the downstream nodes, and does not transfer its locked or unlocked status to the downstream nodes.
After this command is configured, the device notifies the downstream nodes of its locked and unlocked status through the synchronizationUncertain flag in the announce messages. The downstream nodes do not synchronize to the device when they receive information that the device time is unlocked and synchronize to the device when they receive information that the device time is locked.
This command is available only after you specify a PTP profile and a PTP clock node type. The PTP profile must be IEEE 1588 version 2 or ITU-T G.8275.1.
Examples
# Enable the device to notify the downstream nodes of its time synchronization state.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode bc
[Sysname] ptp sync-uncertain enable
Related commands
ptp mode
ptp profile
ptp technical-standard
Use ptp technical-standard to specify a PTP technical standard.
Use undo ptp technical-standard to restore the default.
Syntax
ptp technical-standard { oam | unicom }
undo ptp technical-standard
Default
The default PTP technical standard applies.
Views
System view
Predefined user roles
network-admin
Parameters
oam: Specifies the OAM standard.
unicom: Specifies the Unicom standard.
Usage guidelines
This command is available only after you specify a PTP profile and a PTP clock type.
Only the ITU-T G.8275.1 PTP profile supports this command.
The default values of the clock source parameters including accuracy, time class, time source, and offset (log variance) depend on the technical standard.
This command is mutually exclusive with the ptp clock-state enable command.
Examples
# Specify the Unicom PTP technical standard.
<Sysname> system-view
[Sysname] ptp profile g8275.1
[Sysname] ptp mode t-bc
[Sysname] ptp technical-standard unicom
Parameters of Clock Attribute will be restored to the default values. Continue? [Y/N]:y
Related commands
ptp clock-source
ptp clock-state enable
ptp mode
ptp profile
ptp transport-protocol
Use ptp transport-protocol to specify the IPv4 UDP transport protocol for PTP messages.
Use undo ptp transport-protocol to restore the default.
Syntax
ptp transport-protocol udp
undo ptp transport-protocol
Default
The IEEE 1588 version 2 and ITU-T G.8275.1 PTP profiles transport PTP messages over IEEE 802.3/Ethernet.
The ITU-T G.8275.2 PTP profile transports PTP messages over IPv4 UDP.
Views
Layer 2 Ethernet interface view
Layer 3 Ethernet interface view
Predefined user roles
network-admin
Parameters
udp: Specifies the IPv4 UDP transport protocol.
Usage guidelines
This command is available only after you specify a PTP profile and a PTP clock type. The ITU-T G.8275.1, and ITU G.8275.2 PTP profiles do not support this command.
Examples
# Specify the IPv4 UDP transport protocol for PTP messages on Ten-GigabitEthernet 3/0/1.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode oc
[Sysname] interface ten-gigabitethernet 3/0/1
[Sysname-Ten-GigabitEthernet3/0/1] ptp transport-protocol udp
Related commands
ptp mode
ptp profile
ptp unicast-destination
Use ptp unicast-destination to configure the destination IP address for unicast PTP messages transported over IPv4 UDP.
Use undo ptp unicast-destination to restore the default.
Syntax
ptp unicast-destination ip-address
undo ptp unicast-destination ip-address
Default
No destination IP address is configured for unicast PTP messages transported over IPv4 UDP.
Views
Layer 3 Ethernet interface view
Predefined user roles
network-admin
Parameters
ip-address: Specifies the destination IP address for unicast PTP messages transported over IPv4 UDP.
Usage guidelines
This command is available only after you specify a PTP profile and a PTP clock node type. The ITU-T G.8275.1 PTP profile does not support this command.
When the PTP profile is ITU-T G.8275.2, you must configure this command.
This command takes effect only for unicast PTP messages transported over IPv4 UDP.
Examples
# Configure 10.10.10.2 as the destination address for unicast PTP messages transported over IPv4 UDP.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode oc
[Sysname] interface ten-gigabitethernet 3/0/1
[Sysname-Ten-GigabitEthernet3/0/1] ptp transport-protocol udp
[Sysname-Ten-GigabitEthernet3/0/1] ptp unicast-destination 10.10.10.2
Related commands
ptp mode
ptp profile
ptp transport-protocol
ptp unicast-negotiate
Use ptp unicast-negotiate to enable unicast negotiation.
Use undo ptp unicast-negotiate to disable unicast negotiation.
Syntax
ptp unicast-negotiate { grant-port | request-port }
undo ptp unicast-negotiate
Default
Unicast negotiation is disabled.
Views
Layer 3 Ethernet interface view
Predefined user roles
network-admin
Parameters
grant-port: Specifies the port as a grant-port.
request-port: Specifies the port as a request-port.
Usage guidelines
Only the ITU-T G.8275.2 PTP profile supports this command.
The ITU-T G.8275.2 PTP profile allows you to establish a PTP synchronization tree by specifying the request-ports and master-ports.
A request-port initiates a connection request to a specific grant-port. They negotiate PTP parameters and exchange PTP messages to synchronize the client time to the server. Plan the network in advance and specify the ports on the member (client) clock nodes as request-ports and the ports on the master (server) clock nodes as grant-ports.
If you do not configure this command, the synchronization tree is established through dynamic election.
For unicast negotiation to take effect, you must execute also the ptp unicast-destination command. The ports on a T-TSC-P clock node cannot be specified as grant-ports.
Examples
# Enable unicast negotiation on Ten-GigabitEthernet 3/0/1 and specify the port as a request-port.
<Sysname> system-view
[Sysname] ptp profile g8275.2
[Sysname] ptp mode t-bc-p
[Sysname] interface ten-gigabitethernet 3/0/1
[Sysname-Ten-GigabitEthernet3/0/1] ptp unicast-destination 10.10.10.2
[Sysname-Ten-GigabitEthernet3/0/1] ptp unicast-negotiate request-port
[Sysname-Ten-GigabitEthernet3/0/1] ptp enable
Related commands
ptp mode
ptp profile
ptp unicast-destination
ptp utc
Use ptp utc to add or subtract one second from the UTC scale on the specified date.
Use undo ptp utc to restore the default.
Syntax
ptp utc { leap59-date | leap61-date } date
undo ptp utc { leap59-date | leap61-date }
Default
No second is added to or subtracted from the UTC scale.
Views
System view
Predefined user roles
network-admin
Parameters
leap59-date: Subtracts one second from the UTC time scale at the last minute (23:59) on the specified date.
leap61-date: Adds one second to the UTC time scale at the last minute (23:59) on the specified date.
date: Sets the date to adjust UTC, in the format of YYYY/MM/DD. The value range for YYYY and MM is 2000 to 2035 and 1 to 12, respectively. The value range for DD depends on the specified month. For the configuration to take effect, do not specify a date earlier than the current date.
Usage guidelines
UTC is based on International Atomic Time (TAI), a high-precision atomic coordinate time scale, and adjusted by leap seconds for synchronization with astronomical time.
UTC is constantly compared with UT1 (astronomical time, reflecting the earth's rotation). The International Bureau of Weights and Measures (BIPM) will notify to add or subtract one second from the UTC time scale at the last minute on a specific date (typically June 30 or December 31) to ensure that the difference between UTC and UT1 is within one second.
You can use this command to add or subtract one second from the UTC time on the specific date as published by BIPM.
You can configure this command only after you have specified a PTP profile and PTP mode for the device.
This command takes effect only when it is configured on the master clock node and the local clock of the master clock node is the GM.
If you execute this command multiple times, the most recent configuration takes effect.
Examples
# Assume that the current date is August 8, 2016. Specify the BC clock node type for the device. According to information published by BIPM, add one second to the UTC time at 23:59:60 on December 31, 2016.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode bc
[Sysname] ptp utc offset 36
[Sysname] ptp utc leap61-date 2016/12/31
Related commands
ptp mode
ptp profile
ptp utc offset
ptp utc offset
Use ptp utc offset to set the cumulative offset of UTC relative to TAI.
Use undo ptp utc offset to restore the default.
Syntax
ptp utc offset utc-offset
undo ptp utc offset
Default
The cumulative offset of UTC relative to TAI is 0 seconds.
Views
System view
Predefined user roles
network-admin
Parameters
utc-offset: Sets the cumulative offset of UTC relative to TAI, in seconds. The value is in the range of 0 to 999.
Usage guidelines
A time difference exists between UTC and TAI. Internet devices typically use the UTC time. To provide more accurate time, PTP also uses TAI. If the device acts as a subordinate clock node, it uses the UTC time and TAI time of the clock reference. If the device acts as the clock reference, it will calculate the TAI time based on the UTC time, and synchronize the UTC and TAI time to the subordinate clocks. TAI provided by the device = Current UTC + cumulative offset.
BIPM periodically publishes the cumulative offset of UTC relative to TAI. Use the value published by BIPM to configure this command.
You can configure this command only after you have specified a PTP profile and PTP mode for the device.
This command takes effect only when it is configured on the master clock node and the local clock of the master clock node is the GM.
Examples
# According to information published by BIPM, the cumulative offset of UTC relative to TAI is 37 seconds. Set the cumulative offset of UTC relative to TAI to 37 seconds.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode oc
[Sysname] ptp utc offset 37
Related commands
ptp mode
ptp profile
ptp utc
ptp vlan
Use ptp vlan to specify a VLAN tag for PTP messages.
Use undo ptp vlan to restore the default.
Syntax
ptp vlan vlan-id [ dot1p dot1p-value ]
undo ptp vlan [ dot1p ]
Default
PTP messages do not have a VLAN tag.
Views
Layer 2 Ethernet interface view
Predefined user roles
network-admin
Parameters
vlan vlan-id: Specifies a VLAN by its ID. The value is in the range of 1 to 4094.
dot1p dot1p-value: Specifies an 802.1p precedence for PTP messages. The value is in the range of 0 to 7. The default value is 7 (the highest). The device uses the default precedence value of 7 for PTP messages no matter which value is specified.
Usage guidelines
This command is available only after you specify a PTP profile and a PTP clock node type.
Examples
# Specify VLAN 2 and set the 802.1p precedence to 6 for PTP messages.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode oc
[Sysname] interface ten-gigabitethernet 3/0/1
[Sysname-Ten-GigabitEthernet3/0/1] ptp vlan 2 dot1p 6
Related commands
ptp mode
ptp profile
reset ptp statistics
Use reset ptp statistics to clear PTP statistics.
Syntax
reset ptp statistics [ interface interface-type interface-number ]
Views
User view
Predefined user roles
network-admin
Parameters
interface interface-type interface-number: Specifies an interface by its type and number. If you do not specify an interface, this command clears PTP statistics on all interfaces.
Examples
# Clear PTP statistics on Ten-GigabitEthernet 3/0/1.
<Sysname> reset ptp statistics interface ten-gigabitethernet 3/0/1
Related commands
display ptp statistics
snmp-agent trap enable ptp
Use snmp-agent trap enable ptp to enable SNMP notification for the PTP module.
Use undo snmp-agent trap enable ptp to disable SNMP notification for the PTP module.
Syntax
snmp-agent trap enable ptp
undo snmp-agent trap enable ptp
Default
SNMP notification is enabled for the PTP module.
Views
System view
Predefined user roles
network-admin
Usage guidelines
Application scenarios
To be informed of important events of the PTP module, enable SNMP notification for the PTP module.
Prerequisites
The notifications generated for the PTP module will be sent to the SNMP module of the device. Configure SNMP notification parameters on the device for the SNMP module to send the notifications as required. For information about SNMP notifications, see SNMP configuration in Network Management and Monitoring Configuration Guide.
Examples
# Disable SNMP notification for the PTP module.
<Sysname> system-view
[Sysname] undo snmp-agent trap enable ptp
Related commands
display snmp-agent trap-list (SNMP commands in Network Management and Monitoring Command Reference)