- Table of Contents
-
- 11-Network Management and Monitoring Command Reference
- 00-Preface
- 01-System maintenance and debugging commands
- 02-NTP commands
- 03-PTP commands
- 04-Information center commands
- 05-SNMP commands
- 06-RMON commands
- 07-NQA commands
- 08-Mirroring commands
- 09-sFlow commands
- 10-Process monitoring and maintenance commands
- 11-EAA commands
- 12-CWMP commands
- 13-NETCONF commands
- 14-Packet capture commands
- Related Documents
-
Title | Size | Download |
---|---|---|
03-PTP commands | 133.52 KB |
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
If you specify neither a PTP profile nor PTP mode, no information is displayed.
Examples
# Display PTP clock information.
<Sysname> display ptp clock
PTP profile : IEEE 1588 Version 2
PTP mode : BC
Slave only : No
Clock ID : 000FE2-FFFE-FF0000
Clock type : Local
Clock domain : 0
Number of PTP ports : 2
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 : 1
Local clock time : Sun Jan 15 20:57:29 2011
Field |
Description |
PTP profile |
Standards that PTP complies with: · IEEE 1588 version 2. · IEEE 802.1AS. |
PTP mode |
Clock node type: · BC. · E2ETC. · E2ETC-OC. · OC. · P2PTC. · P2PTC-OC. |
Slave only |
Whether the OC operates in Slave only mode: · Yes. · No. |
Clock ID |
Clock ID for the device. |
Clock type |
Clock type of the device: · Local—Local clock. · Bits1—Bits1 clock. · Bits2—Bits2 clock. |
Clock domain |
PTP domain where the device resides. |
Priority1 |
Priority 1 value for the device. |
Priority2 |
Priority 2 value for the device. |
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, 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. |
display ptp corrections
Use display ptp corrections to display PTP corrections occurred on a subordinate port.
Syntax
display ptp corrections
Views
Any view
Predefined user roles
network-admin
network-operator
Usage guidelines
The device records the correction information every time when it performs time or frequency synchronization through a subordinate port. If you specify a PTP profile and PTP mode, and the device has a subordinate port, the correction information is displayed.
If the subordinate port is changed, information recorded will be cleared.
Examples
# Display PTP corrections occurred on a subordinate port.
<Sysname> display ptp corrections
Slave port Correction time Corrections(s,ns) Rate ratio
XGE1/0/1 Mar 11 03:14:54 2012 0,74 0.999999973
XGE1/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 |
Rate ratio. 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
If you specify the PTP profile as IEEE 1588 version 2, and specify a PTP mode, and the device has a subordinate port or a port in uncalibrated state, foreign master node information is displayed.
Examples
# Display information about foreign master nodes for all interfaces.
<Sysname> display ptp foreign-masters-record
P1=Priority1, P2=Priority2, C=Class, A=Accuracy,
OSLV=Offset-scaled-log-variance, SR=Steps-removed
GM=Grandmaster
--------- ----------------------- ---- ---- ---- ---- ----- ---------
Interface Clock ID P1 P2 C A OSLV SR GM
--------- ----------------------- ---- ---- ---- ---- ----- ---------
XGE1/0/1 000FE2-FFFE-FF0000 0 128 248 254 65535 0 Yes
XGE1/0/2 000FE2-FFFE-FF0001 0 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. |
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 an interface.
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 specify an interface, this command displays detailed PTP running information for the specified interface. If you do not specify an interface, this command displays PTP running information for all interfaces.
brief: Displays brief PTP running information for all interfaces. If you do not specify this keyword, this command displays detailed PTP running information for the specified interface or all interfaces.
Usage guidelines
If PTP is enabled on an interface, detailed running information can be displayed without the brief keyword in this command.
If PTP is operating on the interface, brief running information can be displayed with the brief keyword in this command.
Examples
# Display brief PTP running information for all interfaces.
<Sysname> display ptp interface brief
Name State Delay mechanism Clock step Asymmetry correction
XGE1/0/1 Slave E2E Two 0
XGE1/0/2 Passive E2E Two 0
# Display detailed PTP running information for Ten-GigabitEthernet 1/0/1.
<Sysname> display ptp interface ten-gigabitethernet 1/0/1
Clock ID : 000FE2-FFFE-FF0000
Port number : 15
PTP version : 2
PTP enable : Enabled
Transport of PTP : User Datagram Protocol (IPv4)
Port state : Slave
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
Peer delay request interval (log mean) : 0
Mean path delay : 0 (ns)
Table 4 Command output
Field |
Description |
Name |
Name of the PTP interface. |
State |
States of the PTP interface: · Slave—Receives synchronization time. · Uncalibrated—Temporary state before the Slave state. · Passive—Neither receives nor sends synchronization time (a state after the interface has received announce messages). · Master—Sends synchronization time. · Premaster—Temporary state before the Master state. · Listening—Neither receives nor sends synchronization time (a state after interface initialization). · Faulty—PTP runs incorrectly, and the interface does not process PTP messages. · Disabled—PTP does not run on the interface, and the interface does not process PTP messages. · Initializing—The interface is initializing, and does not process NTP messages. · N/A—No state is obtained for this field. |
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. |
Force state |
Whether the force state is configured: · Yes. · No. |
Announce interval (log mean) |
Announce message sending interval (in seconds) = 2value (this field displays the value for the value exponent). |
Announce receipt time out |
Timeout value for 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) = 2value (this field displays the value for the value exponent). |
Delay request interval (log mean) |
Minimum delay request message sending interval (in seconds) = 2value (this field displays the value for the value exponent). |
Peer delay request interval (log mean) |
Peer delay request message sending interval (in seconds) = 2value (this field displays the value for the value exponent). |
Mean path delay |
Mean path delay, in nanoseconds. |
display ptp parent
Use display ptp parent to display parent node information for the PTP device.
Syntax
display ptp parent
Views
Any view
Predefined user roles
network-admin
network-operator
Usage guidelines
Parent node information is not displayed, if you:
· Specify neither a PTP profile nor a PTP mode.
· Specify the clock node type as e2etc or p2ptc.
· Configure the ptp active force-state command.
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 statistics
Use display ptp statistics to display the 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 the PTP statistics for all interfaces.
Usage guidelines
The PTP statistics are not displayed if you specify neither a PTP profile nor a PTP mode.
Examples
# Display the PTP statistics on Ten-GigabitEthernet 1/0/1.
<Sysname> display ptp statistics interface ten-gigabitethernet1/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 6 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 time properties.
Syntax
display ptp time-property
Views
Any view
Predefined user roles
network-admin
network-operator
Usage guidelines
No PTP clock time properties are displayed, if you:
· Specify neither a PTP profile nor a PTP mode.
· Specify the clock node type as e2etc or p2ptc.
· Configure the ptp active force-state command.
Examples
# Display PTP clock time 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)
Table 7 Command output
Field |
Description |
Current UTC offset valid |
Whether the UTC offset is valid: · True—Yes. · False—No. |
Current UTC offset |
Cumulative offset (in seconds) between the Coordinated Universal Time (UTC) of the grandmaster clock and the International Atomic Time (TAI). |
Leap59 |
Whether cumulative offset minus 1: · Yes. · No. |
Leap61 |
Whether cumulative offset 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. |
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 mode.
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 announce-interval
Use ptp announce-interval to configure the interval for sending announce messages.
Use undo ptp announce-interval to restore the default.
Syntax
ptp announce-interval value
undo ptp announce-interval
Default
If the PTP profile is IEEE 1588 version 2, the announce message sending interval is 1 (21) second.
If the PTP profile is IEEE 802.1AS, the announce message sending interval is 1 (20) second.
Views
Layer 2 Ethernet interface view
Predefined user roles
network-admin
Parameters
value: Specifies the announce message sending interval (in seconds). The intervals use log base 2 values. If the PTP profile is IEEE 1588 version 2, the value range for the value argument is 0 to 4. If the PTP profile is IEEE 802.1AS, the value range for the value argument is 0 to 6.
Usage guidelines
This command is available only after you specify a PTP profile and a PTP mode.
Examples
# Configure the announce message sending interval on Ten-GigabitEthernet 1/0/1 as 4 (22) seconds.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode oc
[Sysname] interface ten-gigabitethernet 1/0/1
[Sysname-Ten-GigabitEthernet1/0/1] ptp announce-interval 2
Related commands
· ptp mode
· ptp profile
ptp announce-timeout
Use ptp announce-timeout to configure the timeout value for receiving announce messages.
Use undo ptp announce-timeout to restore the default.
Syntax
ptp announce-timeout multiple-value
undo ptp announce-timeout
Default
The timeout value for receiving announce messages is 3.
Views
Layer 2 Ethernet interface view
Predefined user roles
network-admin
Parameters
multiple-value: Specifies the number of announcement intervals before the receiving node stops receiving announce messages, in the range of 2 to 10.
Usage guidelines
· This command is available only after you specify a PTP profile and a PTP mode.
· A master node periodically sends announce messages to the member nodes.
¡ When the PTP profile is IEEE 1588 version 2:
If a member node does not receive any announce message from the master node within the specified interval (the announce message sending interval × multiple-value), it considers the master node invalid.
¡ When the PTP profile is IEEE 802.1AS:
If a member node does not receive any announce message from the master node within the specified interval (the announce message sending interval × multiple-value), it considers the master node invalid.
· To ensure a stable PTP network, configure the timeout value range for receiving announce messages as 5 to 7.
Examples
# Configure the timeout value for receiving announce messages on Ten-GigabitEthernet 1/0/1 as 5.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode oc
[Sysname] interface ten-gigabitethernet 1/0/1
[Sysname-Ten-GigabitEthernet1/0/1] ptp announce-timeout 5
Related commands
· ptp announce-interval
· ptp mode
· ptp profile
ptp asymmetry-correction
Use ptp asymmetry-correction to configure 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 delay correction is not performed.
Views
Layer 2 Ethernet 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 mode.
Examples
# Configure the asymmetric delay correction time on Ten-GigabitEthernet 1/0/1 as 100 nanoseconds.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode oc
[Sysname] interface ten-gigabitethernet 1/0/1
[Sysname-Ten-GigabitEthernet1/0/1] ptp asymmetry-correction plus 100
Related commands
· ptp mode
· ptp profile
ptp clock-source
Use ptp clock-source to configure parameters of the Bits clock.
Use undo ptp clock-source to restore the default.
Syntax
ptp clock-source { bits1 | bits2 } { accuracy acc-value | class class-value | time-source ts-value }
undo ptp clock-source { bits1 | bits2 } { accuracy | class | time-source }
Default
For a Bits clock, the time accuracy is 254, the time class is 248, and the attribute value is 160.
Views
System view
Predefined user roles
network-admin
Parameters
bits1: Configures the Bits1 clock parameters.
bits2: Configures the Bits2 clock parameters.
accuracy acc-value: Specifies the time accuracy of the Bits clock, in the range of 0 to 255. A numerically smaller value indicates a higher time accuracy. Table 8 shows the description of time accuracy values.
Table 8 Time accuracy value description
Time 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 seconds. |
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 Bits clock, in the range of 0 to 255. A numerically smaller value indicates a higher time class. Table 9 shows the description of time classes (those not listed are reserved by the protocol).
Table 9 Time class description
Time 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. |
time-source ts-value: Specifies the clock attribute value, in the range of 0 to 255. Table 10 shows the description of the GM attribute values (those not listed are reserved for the protocol).
Table 10 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 mode.
Examples
# Configure the time accuracy for the Bits1 clock as 44.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode oc
[Sysname] ptp clock-source bits1 accuracy 44
Related commands
· ptp mode
· ptp profile
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.
Views
Layer 2 Ethernet 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 mode.
If you specify the PTP profile as IEEE 802.1AS, only the two-step mode is supported.
If you specify the clock node type as E2ETC, P2PTC, E2ETC+OC, or P2PTC+OC, only the two-step mode is supported.
Examples
# Configure the mode for carrying timestamps on Ten-GigabitEthernet 1/0/1 as two-step.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode oc
[Sysname] interface ten-gigabitethernet 1/0/1
[Sysname-Ten-GigabitEthernet1/0/1] ptp clock-step two-step
Related commands
· ptp mode
· ptp profile
ptp delay-mechanism
Use ptp delay-mechanism to specify a delay measurement mechanism for a BC or OC.
Use undo ptp delay-mechanism to restore the default.
Syntax
ptp delay-mechanism { e2e | p2p }
undo ptp delay-mechanism
Default
· If the PTP profile is IEEE 1588 version 2, the delay measurement mechanism is request-response mechanism.
· If the PTP profile is IEEE 802.1AS, the delay measurement mechanism is peer delay mechanism.
Views
Layer 2 Ethernet interface view
Predefined user roles
network-admin
Parameters
e2e: Specifies the request-response mechanism used by E2ETC.
p2p: Specifies the peer delay mechanism used by P2PTC.
Usage guidelines
This command is applicable only to BCs and OCs.
This command is available only if you specify the PTP profile as IEEE 1588 version 2.
Examples
# Configure the clock node type as OC, and specify the delay measurement mechanism on Ten-GigabitEthernet 1/0/1 as e2e.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode oc
[Sysname] interface ten-gigabitethernet 1/0/1
[Sysname-Ten-GigabitEthernet1/0/1] ptp delay-mechanism e2e
Related commands
· ptp profile
· ptp mode
ptp destination-mac
Use ptp destination-mac to configure the destination MAC address for non-peer delay 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.
Views
Layer 2 Ethernet interface view
Predefined user roles
network-admin
Parameters
mac-address: Specifies the destination MAC address for non-peer delay messages, which can be 0180-C200-000E or 011B-1900-0000.
Usage guidelines
This command is available only after you specify a PTP profile and a PTP mode.
Peer delay messages include Pdelay_Req, Pdelay_Resp, and Pdelay_Resp_Follow_Up messages. By default, the destination MAC address for peer delay messages is 0180-C200-000E, which cannot be modified.
This command is available only if you specify the PTP profile as IEEE 1588 version 2.
This command is available only if PTP messages are transported over Ethernet.
Examples
# Configure the destination MAC address for non-peer delay messages as 0180-C200-000E on Ten-GigabitEthernet 1/0/1.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode oc
[Sysname] interface ten-gigabitethernet 1/0/1
[Sysname-Ten-GigabitEthernet1/0/1] ptp destination-mac 0180-c200-000e
Related commands
· ptp mode
· ptp profile
ptp domain
Use ptp domain to configure the domain number to use for the device.
Use undo ptp domain to restore the default.
Syntax
ptp domain domain-number
undo ptp domain
Default
The PTP domain number is 0.
Views
System view
Predefined user roles
network-admin
Parameters
domain-number: Specifies the PTP domain by its domain number, in the range of 0 to 255.
Usage guidelines
This command is available only after you specify a PTP profile and a PTP mode.
Examples
# Configure the 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 enable
Use ptp enable to enable PTP on a port.
Use undo ptp enable to disable PTP.
Syntax
ptp enable
undo ptp enable
Default
PTP is disabled on a port.
Views
Layer 2 Ethernet interface view
Predefined user roles
network-admin
Usage guidelines
This command is available only after you specify a PTP profile and a PTP mode.
An OC can have only one PTP port.
As a best practice, enable PTP on a port after you configure PTP parameters for the port.
Examples
# Configure the clock node type as OC and enable PTP on Ten-GigabitEthernet 1/0/1.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode oc
[Sysname] interface ten-gigabitethernet 1/0/1
[Sysname-Ten-GigabitEthernet1/0/1] ptp enable
# Configure the clock node type as E2ETC, and enable PTP on Ten-GigabitEthernet 1/0/1 and Ten-GigabitEthernet 1/0/2.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode e2etc
[Sysname] interface ten-gigabitethernet 1/0/1
[Sysname-Ten-GigabitEthernet1/0/1] ptp enable
[Sysname-Ten-GigabitEthernet1/0/1] interface ten-gigabitethernet 1/0/2
[Sysname-Ten-GigabitEthernet1/0/2] ptp enable
Related commands
· ptp mode
· ptp profile
ptp force-state
Use ptp force-state to configure the force state of 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 force state of a PTP port is automatically specified through BMC.
Views
Layer 2 Ethernet 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
This command is available only after you specify a PTP profile and a PTP mode.
You can configure only one subordinate port for a device.
Examples
# Configure the clock node type as OC and specify the PTP port Ten-GigabitEthernet 1/0/1 as a subordinate port.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode oc
[Sysname] interface ten-gigabitethernet 1/0/1
[Sysname-Ten-GigabitEthernet1/0/1] ptp force-state slave
Related commands
· ptp mode
· ptp profile
· ptp slave-only
ptp min-delayreq-interval
Use ptp min-delayreq-interval to configure the minimum interval for sending delay request messages.
Use undo ptp min-delayreq-interval to restore the default.
Syntax
ptp min-delayreq-interval value
undo ptp min-delayreq-interval
Default
If the PTP profile is IEEE 1588 version 2, the minimum interval for sending delay request messages is 1 (20) second.
Views
Layer 2 Ethernet interface view
Predefined user roles
network-admin
Parameters
value: Specifies the minimum interval for sending delay request messages (in seconds). The intervals use log base 2 values. The value range for the value argument is –4 to 6.
Usage guidelines
This command is available only after you specify a PTP profile and a PTP mode.
If the PTP profile is IEEE 802.1AS, you cannot execute this command.
Examples
# Configure the minimum interval for sending delay request messages as 4 (22) seconds on Ten-GigabitEthernet 1/0/1.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode oc
[Sysname] interface ten-gigabitethernet 1/0/1
[Sysname-Ten-GigabitEthernet1/0/1] ptp min-delayreq-interval 2
Related commands
· ptp mode
· ptp profile
ptp mode
Use ptp mode to specify a clock node type for the device.
Use undo ptp mode to restore the default.
Syntax
ptp mode { bc | e2etc | e2etc-oc | oc | p2ptc | p2ptc-oc }
undo ptp mode
Default
No clock node type is specified.
Views
System view
Predefined user roles
network-admin
Parameters
bc: Specifies the clock node type as boundary clock (BC).
e2etc: Specifies the clock node type as end-to-end transparent clock (E2ETC).
e2etc-oc: Specifies the clock node type as E2ETC+OC.
oc: Specifies the clock node type as ordinary clock (OC).
p2ptc: Specifies the clock node type as peer-to-peer transparent clock (P2PTC).
p2ptc-oc: Specifies the clock node type as P2PTC+OC.
Usage guidelines
This command is available only after you specify a PTP profile.
If the PTP profile is IEEE 802.1AS, you cannot specify the clock node type as E2ETC or E2ETC+OC.
If you change the clock node type for the device, all the configurations except for the PTP profile will be removed.
Examples
# Specify the clock node type as OC for the device.
<Sysname> system-view
[Sysname] ptp profile 1588v2
Related commands
ptp profile
ptp pdelay-req-interval
Use ptp pdelay-req-interval to configure the interval for sending peer delay request messages.
Use undo ptp pdelay-req-interval to restore the default.
Syntax
ptp pdelay-req-interval value
undo ptp pdelay-req-interval
Default
The interval for sending peer delay request messages is 1 (20) second.
Views
Layer 2 Ethernet interface view
Predefined user roles
network-admin
Parameters
value: Specifies the interval (in seconds) for sending peer delay request messages. The intervals use log base 2 values. The value range for this argument is –4 to 6. If the PTP profile is IEEE 1588 version 2, the value range for this argument is 0 to 5.
Usage guidelines
This command is available only after you specify a PTP profile and a PTP mode.
Examples
# Configure the interval for sending peer delay request messages on Ten-GigabitEthernet 1/0/1 as 4 (22) seconds.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode oc
[Sysname] interface ten-gigabitethernet 1/0/1
[Sysname-Ten-GigabitEthernet1/0/1] ptp pdelay-req-interval 2
Related commands
· ptp mode
· ptp profile
ptp port-mode
Use ptp port-mode to configure the port type as OC for a TC+OC (including E2ETC+OC and P2PTC+OC) clock.
Use undo ptp port-mode to restore the default.
Syntax
ptp port-mode oc
undo ptp port-mode
Default
The type of all ports on an E2ETC+OC or a P2PTC+OC clock is TC.
Views
Layer 2 Ethernet interface view
Predefined user roles
network-admin
Parameters
oc: Specifies the port type for a TC+OC clock as OC.
Usage guidelines
This command is available only after you specify a PTP profile and a PTP mode.
This command is applicable to an E2ETC+OC clock or a P2PTC+OC clock.
Examples
# Specify the clock node type as P2PTC+OC for the device. Configure the port type of Ten-GigabitEthernet 1/0/1 as OC.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode p2ptc-oc
[Sysname] interface ten-gigabitethernet 1/0/1
[Sysname-Ten-GigabitEthernet1/0/1] ptp port-mode oc
Related commands
· ptp mode
· ptp profile
ptp priority
Use ptp priority clock-source to configure the priority for the specified clock for GM election through BMC.
Use undo ptp priority clock-source to restore the default.
Syntax
ptp priority clock-source { bits1 | bits2 | local } { priority1 pri1-value | priority2 pri2-value }
undo ptp priority clock-source { bits1 | bits2 | local } { priority1 | priority2 }
Default
If the PTP profile is IEEE 1588 version 2, the default value for priority 1 and priority 2 are both 128.
If the PTP profile is IEEE 802.1AS, the default value is 246 for priority 1 and 248 for priority 2.
Views
System view
Predefined user roles
network-admin
Parameters
bits1: Specifies the priority for a Bits1 clock.
bits2: Specifies the priority for a Bits2 clock.
local: Specifies the priority for the local clock.
priority1 pri1-value: Specifies priority 1 for the clock, in the range of 0 to 255. A numerically smaller value has higher priority.
priority2 pri2-value: Specifies priority 2 for the clock, in the range of 0 to 255. A numerically smaller value has higher priority.
Usage guidelines
This command is available only after you specify a PTP profile and a PTP mode.
Examples
# Configure priority 1 as 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 configure a PTP profile for the device.
Use undo ptp profile to restore the default.
Syntax
ptp profile { 1588v2 | 8021as }
undo ptp profile
Default
PTP operates only after you configure a PTP profile.
Views
System view
Predefined user roles
network-admin
Parameters
1588v2: Specifies the PTP profile as IEEE 1588 version 2.
8021as: Specifies the PTP profile as IEEE 802.1AS.
Usage guidelines
Configure a PTP profile for the device before any other PTP configurations.
If you change or remove the PTP profile, PTP functions do not operate and all the configurations for that PTP profile will be removed.
Examples
# Configure the PTP profile as IEEE 1588 version 2.
<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 available only after you specify a PTP profile and a PTP mode.
This command is applicable only to OCs.
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 a PTP message that uses UDP for transport.
Use undo ptp source to restore the default.
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 a PTP message.
Views
System view
Predefined user roles
network-admin
Parameters
ip-address: Specifies the source IP address for a PTP message.
vpn-instance vpn-instance-name: Specifies the name of a VPN instance used for communication between the local device and the peer device, a case-sensitive string of 1 to 31 characters. If you do not specify the VPN, the peer device belongs to the public network.
Usage guidelines
This command is available only after you specify a PTP profile and a PTP mode.
If the PTP profile is IEEE 802.1AS, you cannot execute this command.
To enable the PTP functions to operate on the port, you must execute this command, if PTP messages are transported by UDP and IPv4.
Examples
# Configure the source IP address as 3.5.1.5 for the PTP message.
<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 configure the interval for sending Sync messages.
Use undo ptp syn-interval to restore the default.
Syntax
ptp syn-interval value
undo ptp syn-interval
Default
If the PTP profile is IEEE 1588 version 2, the interval for sending Sync messages is 1 (20) second.
If the PTP profile is IEEE 802.1AS, the interval for sending Sync messages is 1/8 (2-3) second.
Views
Layer 2 Ethernet interface view
Predefined user roles
network-admin
Parameters
value: Specifies the Sync message sending interval (in seconds). The intervals use log base 2 values. If the PTP profile is IEEE 802.1AS, the value range for the value argument is -4 to 6. If the PTP profile is IEEE 1588 version 2, the value range for the value argument is -1 to 1.
Usage guidelines
This command is available only after you specify a PTP profile and a PTP mode.
Examples
# Configure the Sync message sending interval on Ten-GigabitEthernet 1/0/1 as 2 (21) seconds.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode oc
[Sysname] interface ten-gigabitethernet 1/0/1
[Sysname-Ten-GigabitEthernet1/0/1] ptp syn-interval 1
Related commands
· ptp mode
· ptp profile
ptp transport-protocol
Use ptp transport-protocol to configure UDP and IPv4 as the transport protocols for PTP messages.
Use undo ptp transport-protocol to restore the default.
Syntax
ptp transport-protocol udp
undo ptp transport-protocol
Default
PTP messages are transported through IEEE 802.3 and Ethernet.
Views
Layer 2 Ethernet interface view
Predefined user roles
network-admin
Parameters
udp: Specifies the UDP and IPv4 protocols for PTP messages.
Usage guidelines
This command is available only after you specify a PTP profile and a PTP mode.
If the PTP profile is IEEE 802.1AS, you cannot execute this command.
Examples
# Configure UDP and IPv4 as the transport protocols for PTP messages on Ten-GigabitEthernet 1/0/1.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode oc
[Sysname] interface ten-gigabitethernet 1/0/1
[Sysname-Ten-GigabitEthernet1/0/1] ptp transport-protocol udp
Related commands
· ptp mode
· ptp profile
ptp utc
Use ptp utc to configure the correction date of the UTC.
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 correction date is configured for the UTC.
Views
System view
Predefined user roles
network-admin
Parameters
leap59-date: Adjusts the UTC at the last minute (23:59) of the specified date so that the UTC is one second slower than the TAI.
leap61-date: Adjusts the UTC at the last minute (23:59) of the specified date so that the UTC is one second faster than the TAI.
date: Specifies the date to adjust the 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. Do not specify a date earlier than the current date. Otherwise, the configuration does not take effect.
Usage guidelines
This command is available only after you specify a PTP profile and a PTP mode.
Specify either the leap59-date or leap61-date keyword in this command. The most recent configuration overwrites the earlier configuration.
Examples
# Assume the current date is August 8, 2010. Specify the clock node type as BC for the device, and adjust the UTC at the last minute of December 31, 2010 so that the UTC is one second slower than the TAI.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode bc
[Sysname] ptp utc leap59-date 2010/12/31
Related commands
· ptp mode
· ptp profile
ptp utc offset
Use ptp utc offset to configure the cumulative offset between the UTC and TAI.
Use undo ptp utc offset to restore the default.
Syntax
ptp utc offset utc-offset
undo ptp utc offset
Default
The cumulative offset between the UTC and TAI is 0 seconds.
Views
System view
Predefined user roles
network-admin
Parameters
utc-offset: Specifies the cumulative offset between the UTC and TAI, in the range of 0 to 999 seconds.
Usage guidelines
This command is available only after you specify a PTP profile and a PTP mode.
Examples
# Configure the cumulative offset between the UTC and TAI as 33 seconds.
<Sysname> system-view
[Sysname] ptp profile 1588v2
[Sysname] ptp mode oc
[Sysname] ptp utc offset 33
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: Clears PTP statistics on the specified port. If no port is specified, this command clears PTP statistics on all ports.
Examples
# Clear PTP statistics on Ten-GigabitEthernet 1/0/1.
<Sysname> reset ptp statistics interface ten-gigabitethernet 1/0/1
Related commands
display ptp statistics