Added time section for EIB, metal3 and elemental (#666)

Co-authored-by: Atanas Dinov <[email protected]>
Co-authored-by: Alberto Morgante Medina <[email protected]>

Author: 3 people

asciidoc/quickstart/eib.adoc

@@ -136,6 +136,35 @@ operatingSystem:
 It's also possible to add additional users, create the home directories, set user-id's, add ssh-key authentication, and modify group information. Please refer to the {link-eib-building-images}[upstream building images guide] for further examples.
 ====
 
+=== Configuring OS time
+
+The `time` section is optional but it is highly recommended to be configured to avoid potential issues with certificates and clock skew. EIB will configure chronyd and `/etc/localtime` depending on the parameters here.
+
+[,console]
+----
+operatingSystem:
+  time:
+    timezone: Europe/London
+    ntp:
+      forceWait: true
+      pools:
+        - 2.suse.pool.ntp.org
+      servers:
+        - 10.0.0.1
+        - 10.0.0.2
+----
+
+* The `timezone` specifies the timezone in the format of "Region/Locality" (e.g. "Europe/London"). The full list may be found by running `timedatectl list-timezones` on a Linux system.
+* ntp - Defines attributes related to configuring NTP (using chronyd):
+  * forceWait - Requests that chronyd attempts to synchronize timesources before starting other services, with a 180s timeout.
+  * pools - Specifies a list of pools that chronyd will use as data sources (using `iburst` to improve the time taken for initial synchronization).
+  * servers - Specifies a list of servers that chronyd will use as data sources (using `iburst` to improve the time taken for initial synchronization).
+
+[NOTE]
+====
+The values provided in this example are for illustrative purposes only. Please adjust them to fit your specific requirements.
+====
+
 [#eib-configuring-rpm-packages]
 === Configuring RPM packages
 

asciidoc/quickstart/elemental.adoc

@@ -250,6 +250,15 @@ image:
     baseImage: {micro-base-image-iso}
     outputImageName: elemental-image.iso
 operatingSystem:
+  time:
+    timezone: Europe/London
+    ntp:
+      forceWait: true
+      pools:
+        - 2.suse.pool.ntp.org
+      servers:
+        - 10.0.0.1
+        - 10.0.0.2
   isoConfiguration:
     installDevice: /dev/vda
   users:
@@ -262,6 +271,7 @@ EOF
 
 [NOTE]
 ====
+* The `time` section is optional but it is highly recommended to configure it to avoid potential issues with certificates and clock skew. The values provided in this example are for illustrative purposes only. Please adjust them to fit your specific requirements.
 * The unencoded password is `eib`.
 * The `sccRegistrationCode` is needed to download and install the necessary RPMs from the official sources (alternatively, the `elemental-register` and `elemental-system-agent` RPMs can be manually side-loaded instead)
 * The `cat` command escapes each `$` with a backslash (`\`) so that Bash does not template them. Remove the backslashes if copying manually.

asciidoc/quickstart/metal3.adoc

@@ -219,6 +219,15 @@ image:
   baseImage: {micro-base-image-raw}
   outputImageName: SLE-Micro-eib-output.raw
 operatingSystem:
+  time:
+    timezone: Europe/London
+    ntp:
+      forceWait: true
+      pools:
+        - 2.suse.pool.ntp.org
+      servers:
+        - 10.0.0.1
+        - 10.0.0.2
   kernelArgs:
     - ignition.platform.id=openstack
     - net.ifnames=1
@@ -252,6 +261,8 @@ For the production environments, it is recommended to use the SSH keys that can
 This matches the default configuration for the Metal^3^ chart, but the setting must match the configured chart `predictableNicNames` value.
 
 Also note that `ignition.platform.id=openstack` is mandatory - without this argument SUSE Linux Micro configuration via ignition will fail in the Metal^3^ automated flow.
+
+The `time` section is optional but it is highly recommended to configure it to avoid potential issues with certificates and clock skew. The values provided in this example are for illustrative purposes only. Please adjust them to fit your specific requirements.
 ====
 
 ===== Growfs script