1
0
mirror of https://github.com/openshift/openshift-docs.git synced 2026-02-05 12:46:18 +01:00

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
This commit is contained in:
Kevin Quinn
2025-12-01 13:52:50 +00:00
committed by openshift-cherrypick-robot
parent aa85ae390f
commit dd2b4dc1c2
6 changed files with 1115 additions and 4 deletions

View File

@@ -6,6 +6,7 @@ include::_attributes/common-attributes.adoc[]
toc::[]
[role="_abstract"]
Precision Time Protocol (PTP) is used to synchronize clocks in a network. When used in conjunction with hardware support, PTP is capable of sub-microsecond accuracy, and is more accurate than Network Time Protocol (NTP).
[IMPORTANT]
@@ -30,9 +31,13 @@ The PTP Operator works with PTP-capable devices on clusters provisioned only on
include::modules/nw-ptp-introduction.adoc[leveloffset=+1]
[role="_additional-resources"]
.Additional resources
* xref:../../../machine_configuration/machine-configs-configure.adoc#cnf-disable-chronyd_machine-configs-configure[Disabling chrony time service]
[IMPORTANT]
====
Before enabling PTP, ensure that NTP is disabled for the required nodes. You can disable the chrony time service (`chronyd`) using a `MachineConfig` custom resource. For more information, see xref:../../../machine_configuration/machine-configs-configure.adoc#cnf-disable-chronyd_machine-configs-configure[Disabling chrony time service].
Although PTP provides superior accuracy over NTP, you can configure NTP as a backup time source for PTP Grandmaster (T-GM) clocks. In GNSS-to-NTP failover configurations, the system uses GNSS as the primary time source through PTP, but automatically fails over to NTP (`chronyd`) if the GNSS signal is lost or degraded. This provides resilient timekeeping even when the primary GNSS time source is temporarily unavailable. For more information about configuring GNSS-to-NTP failover, see _Configuring GNSS/NTP failover_.
====
include::modules/ptp-linuxptp-introduction.adoc[leveloffset=+1]

View File

@@ -6,6 +6,7 @@ include::_attributes/common-attributes.adoc[]
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.
@@ -96,6 +97,12 @@ 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]