diff --git a/modules/installation-special-config-chrony.adoc b/modules/installation-special-config-chrony.adoc index f16fe9ed77a6..dc28bf1109fb 100644 --- a/modules/installation-special-config-chrony.adoc +++ b/modules/installation-special-config-chrony.adoc @@ -19,6 +19,7 @@ endif::[] [id="installation-special-config-chrony_{context}"] = Configuring chrony time service +[role="_abstract"] You ifdef::restricted[must] ifndef::restricted[can] @@ -40,25 +41,29 @@ include::snippets/butane-version.adoc[] variant: openshift version: {product-version}.0 metadata: - name: 99-worker-chrony <1> + name: 99-worker-chrony labels: - machineconfiguration.openshift.io/role: worker <1> + machineconfiguration.openshift.io/role: worker storage: files: - path: /etc/chrony.conf - mode: 0644 <2> + mode: 0644 overwrite: true contents: inline: | - pool 0.rhel.pool.ntp.org iburst <3> + pool 0.rhel.pool.ntp.org iburst driftfile /var/lib/chrony/drift makestep 1.0 3 rtcsync logdir /var/log/chrony ---- -<1> On control plane nodes, substitute `master` for `worker` in both of these locations. -<2> Specify an octal value mode for the `mode` field in the machine config file. After creating the file and applying the changes, the `mode` is converted to a decimal value. You can check the YAML file with the command `oc get mc -o yaml`. -<3> Specify any valid, reachable time source, such as the one provided by your DHCP server. ++ +-- +* `name: 99-worker-chrony` - Specify a name for the machine config file. On control plane nodes, substitute `master` for `worker`. +* `machineconfiguration.openshift.io/role: worker` - On control plane nodes, substitute `master` for `worker`. +* `mode: 0644` - Specify an octal value mode for the `mode` field in the machine config file. After creating the file and applying the changes, the `mode` is converted to a decimal value. You can check the YAML file with the command `oc get mc -o yaml`. +* `pool 0.rhel.pool.ntp.org iburst` - Specify any valid, reachable time source, such as the one provided by your DHCP server. +-- + [NOTE] @@ -85,6 +90,13 @@ $ butane 99-worker-chrony.bu -o 99-worker-chrony.yaml $ oc apply -f ./99-worker-chrony.yaml ---- +For more information on chrony best practices, see the following resources: + +* https://access.redhat.com/solutions/3073261[Configuring chrony] +* https://access.redhat.com/solutions/778603[Best practices for NTP] +* https://docs.redhat.com/en/documentation/red_hat_ceph_storage/8/html-single/troubleshooting_guide/basic-chrony-NTP-troubleshooting_diag#basic-chrony-NTP-troubleshooting_diag[Basic chrony NTP troubleshooting] + + ifeval::["{context}" == "installing-restricted-networks-bare-metal"] :!restricted: endif::[]