1
0
mirror of https://github.com/openshift/openshift-docs.git synced 2026-02-05 12:46:18 +01:00
Files
openshift-docs/networking/advanced_networking/ptp/configuring-ptp.adoc
Kevin Quinn dd2b4dc1c2 TELCODOCS-2500 GNSS (GPS) as the Primary System Clock Time Source with NTP Fallback
# - Add complete linuxptp-daemon pods to example output
 # - Update NodePtpDevice to show 5 workers with E810 NICs
 # - Fix MCP output with correct columns
 # - Change interface names to ens7f0 (E810 standard)
 # - Add note about customizing interface names

 # Resolves: TELCODOCS-2500
2026-01-06 15:30:12 +00:00

111 lines
5.5 KiB
Plaintext

:_mod-docs-content-type: ASSEMBLY
[id="configuring-ptp"]
= Configuring PTP devices
include::_attributes/common-attributes.adoc[]
:context: configuring-ptp
toc::[]
[role="_abstract"]
The PTP Operator adds the `NodePtpDevice.ptp.openshift.io` custom resource definition (CRD) to {product-title}.
When installed, the PTP Operator searches your cluster for Precision Time Protocol (PTP) capable network devices on each node. The Operator creates and updates a `NodePtpDevice` custom resource (CR) object for each node that provides a compatible PTP-capable network device.
Network interface controller (NIC) hardware with built-in PTP capabilities sometimes require a device-specific configuration. You can use hardware-specific NIC features for supported hardware with the PTP Operator by configuring a plugin in the `PtpConfig` custom resource (CR). The `linuxptp-daemon` service uses the named parameters in the `plugin` stanza to start `linuxptp` processes, `ptp4l` and `phc2sys`, based on the specific hardware configuration.
[IMPORTANT]
====
In {product-title} {product-version}, the Intel E810 NIC is supported with a `PtpConfig` plugin.
====
include::modules/nw-ptp-installing-operator-cli.adoc[leveloffset=+1]
include::modules/nw-ptp-installing-operator-web-console.adoc[leveloffset=+1]
include::modules/nw-ptp-device-discovery.adoc[leveloffset=+1]
include::modules/nw-ptp-configuring-linuxptp-services-as-grandmaster-clock.adoc[leveloffset=+1]
include::modules/nw-ptp-configuring-linuxptp-services-as-grandmaster-clock-dual-nic.adoc[leveloffset=+2]
include::modules/nw-ptp-configuring-linuxptp-services-as-grandmaster-clock-three-nic.adoc[leveloffset=+2]
[role="_additional-resources"]
.Additional resources
* xref:../../../networking/advanced_networking/ptp/ptp-cloud-events-consumer-dev-reference-v2.adoc#cnf-configuring-the-ptp-fast-event-publisher-v2_ptp-consumer[Configuring the PTP fast event notifications publisher]
include::modules/nw-ptp-grandmaster-clock-configuration-reference.adoc[leveloffset=+1]
include::modules/nw-ptp-grandmaster-clock-class-reference.adoc[leveloffset=+2]
include::modules/nw-ptp-e810-hardware-configuration-reference.adoc[leveloffset=+2]
include::modules/nw-ptp-dual-wpc-hardware-config-reference.adoc[leveloffset=+2]
include::modules/nw-ptp-three-nic-hardware-config-reference.adoc[leveloffset=+2]
include::modules/nw-ptp-holdover-in-a-grandmaster-clock.adoc[leveloffset=+1]
include::modules/nw-ptp-t-bc-t-tsc-holdover.adoc[leveloffset=+1]
[role="_additional-resources"]
.Additional resources
* xref:../../../networking/advanced_networking/ptp/configuring-ptp.adoc#nw-ptp-grandmaster-clock-class-reference_configuring-ptp[Grandmaster clock class sync state reference]
include::modules/ptp-configuring-dynamic-leap-seconds-handling-for-tgm.adoc[leveloffset=+1]
include::modules/nw-ptp-configuring-linuxptp-services-as-boundary-clock.adoc[leveloffset=+1]
[role="_additional-resources"]
.Additional resources
* xref:../../../networking/advanced_networking/ptp/configuring-ptp.adoc#cnf-configuring-fifo-priority-scheduling-for-ptp_configuring-ptp[Configuring FIFO priority scheduling for PTP hardware]
* xref:../../../networking/advanced_networking/ptp/ptp-cloud-events-consumer-dev-reference-v2.adoc#cnf-configuring-the-ptp-fast-event-publisher-v2_ptp-consumer[Configuring the PTP fast event notifications publisher]
include::modules/ptp-configuring-linuxptp-services-as-boundary-clock-dual-nic.adoc[leveloffset=+2]
include::modules/ptp-configuring-linuxptp-services-as-ha-bc-for-dual-nic.adoc[leveloffset=+2]
include::modules/nw-ptp-configuring-linuxptp-services-as-ordinary-clock.adoc[leveloffset=+1]
[role="_additional-resources"]
.Additional resources
* xref:../../../networking/advanced_networking/ptp/configuring-ptp.adoc#cnf-configuring-fifo-priority-scheduling-for-ptp_configuring-ptp[Configuring FIFO priority scheduling for PTP hardware]
* xref:../../../networking/advanced_networking/ptp/ptp-cloud-events-consumer-dev-reference-v2.adoc#cnf-configuring-the-ptp-fast-event-publisher-v2_ptp-consumer[Configuring the PTP fast event notifications publisher]
include::modules/nw-columbiaville-ptp-config-refererence.adoc[leveloffset=+2]
include::modules/nw-ptp-configuring-linuxptp-services-dual-port-oc.adoc[leveloffset=+2]
[role="_additional-resources"]
.Additional resources
* For a complete example CR that configures `linuxptp` services as an ordinary clock with PTP fast events, see xref:../../../networking/advanced_networking/ptp/configuring-ptp.adoc#configuring-linuxptp-services-as-ordinary-clock_configuring-ptp[Configuring linuxptp services as ordinary clock].
* xref:../../../networking/advanced_networking/ptp/about-ptp.adoc#ptp-dual-ports-oc_about-ptp[Using dual-port NICs to improve redundancy for PTP ordinary clocks]
include::modules/cnf-configuring-fifo-priority-scheduling-for-ptp.adoc[leveloffset=+1]
include::modules/cnf-configuring-log-reduction-for-linuxptp.adoc[leveloffset=+1]
include::modules/cnf-configuring-log-filtering-for-linuxptp.adoc[leveloffset=+2]
include::modules/cnf-configuring-enhanced-log-filtering-for-linuxptp.adoc[leveloffset=+2]
include::modules/cnf-configuring-time-synchronization-continuity.adoc[leveloffset=+1]
include::modules/nw-ptp-configuring-gnss-to-ntp-failover.adoc[leveloffset=+2]
include::modules/nw-ptp-configuring-gnss-to-ntp-failover-sno.adoc[leveloffset=+2]
include::modules/cnf-troubleshooting-common-ptp-operator-issues.adoc[leveloffset=+1]
include::modules/cnf-getting-the-dpll-firmware-version-for-intel-800-series-nics.adoc[leveloffset=+1]
include::modules/cnf-about-collecting-ptp-data.adoc[leveloffset=+1]