Merge pull request #110704 from openshift-cherrypick-robot/cherry-pick-108867-to-enterprise-4.22

[enterprise-4.22] TELCODOCS-2819 adding chrony links

Author: slovern

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 <mc-name> -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 <mc-name> -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::[]