create network-clock ptp

create network-clock ptp [boundary | ordinary] {domain domain_number} | end-to-end-transparent]

Description

Creates PTP clock instance and defines the mode of operation.

Syntax Description

boundary Create the clock instance as a boundary clock.
ordinary Create the clock instance as an ordinary clock.
domain_number PTP domain number (default 0, range 0 to 255).
end-to-end-transparent Create the clock instance as an end-to-end transparent clock.

Default

The PTP domain number defaults to 0 for boundary and ordinary clock instances.

Usage Guidelines

Use this command to create a PTP clock instance, and administratively configure the mode of operation of PTP on this instance. You can provision a boundary or ordinary clock instance to synchronize the node with another node with the most precise clock. In boundary clock configuration, the device synchronizes with the grand-master, or another boundary clock, and operates as a master clock for downstream nodes. In ordinary clock configuration, the device synchronizes with the grand-master, or another boundary clock, and acts as a slave. The ordinary clock is by default in the slave-only mode of operation, and does not propagate the clock downstream. The ordinary clock cannot have more than one clock port.

The end-to-end-transparent clock can be provisioned to correct for the residence delay incurred by PTP event packets passing through the switch (referred as residence time).

Note

Note

You can create a maximum of two clock instances in the switch—one boundary clock and one end-to-end transparent clock, or one ordinary clock and one end-to-end transparent clock. The boundary and ordinary clock instances cannot be simultaneously provisioned in the switch.

After you enable a boundary clock, you cannot create an ordinary clock. However, you can delete the boundary clock instance and create a new one in order to change the domain number. To create an ordinary clock instance in the switch that has the boundary clock instance enabled, delete the boundary clock instance, save the configuration and reboot the switch. After the reboot, you can create and enable the ordinary clock instance.

Similarly, to create and enable a boundary clock in a switch that has an ordinary clock enabled, delete the ordinary clock instance, save the configuration and reboot the switch. After the reboot you can create and enable a boundary clock.

The following message is displayed when you create the boundary clock instance in a device with no prior clock instances:

Warning: The ordinary clock cannot be created after enabling the boundary clock. A delete followed by save and reboot are required to create the ordinary clock.

After you enable a boundary clock instance, if you delete the instance and try to create an ordinary clock instance, the above message is displayed as an error, and the ordinary clock instance is not created.

Example

The following command creates an ordinary clock on domain 5:

create network-clock ptp ordinary domain 5

The following command creates a boundary clock on default domain (domain 0):

create network-clock ptp boundary domain 0

The following command creates an end-to-end transparent clock:

create network-clock ptp end-to-end-transparent

History

This command was first available in ExtremeXOS 15.1.

The ordinary clock parameter was added in ExtremeXOS 15.1 Revision 2.

Platform Availability

This command is available on the Summit X460-G2, X670-G2, and X770 series switches.