Merge pull request #60 from NethServer/feat-6835

Add Scheduled updates section

os_updates.rst

@@ -4,20 +4,22 @@
 Operating system updates
 ========================
 
-NethServer 8 is installed on top of GNU/Linux distributions and tries to preserve default configurations as much as possible.
-It's up to the system administrator to choose how the operating system updates are applied.
+NethServer 8 is installed on top of Linux distributions and strives to
+preserve default configurations as much as possible. The system
+administrator has the flexibility to choose how operating system updates
+are applied.
 
-Usually, it's a good practice to apply security updates as soon as possible.
-But, even if NethServer depends on few packages, not all system administrators feel confident about automatic updates.
-
-Please, take a look to your distribution documentation:
+It is generally advisable to apply operating system updates promptly. If
+you have an active subscription, updates are automatically applied as
+described in the :ref:`scheduled-updates` section. Otherwise, consult your
+distribution documentation for guidance:
 
 * `Rocky Linux/AlmaLinux <https://docs.rockylinux.org/guides/security/dnf_automatic/>`_
 * `Debian <https://wiki.debian.org/UnattendedUpgrades>`_
 
-.. note::
-
-   It's not recommended to enable automatic updates on CentOS Stream, since it is considered a preview of next RHEL stable release.
-   Updates could bring major releases of podman and SELinux policies introducing unexpected bugs.
+CentOS Stream is regarded as a preview of the next stable RHEL release.
+Updates may introduce new software versions that could potentially cause
+unexpected issues. To enable automatic updates on CentOS Stream, simply
+follow the same instructions as outlined for Rocky Linux.
 
-If you are looking for core and modules see :ref:`updates-section`.
+For updates to core and modules, refer to :ref:`updates-section`.

subscription.rst

@@ -19,9 +19,18 @@ enabled:
 - Remote support by Nethesis
 - Resources monitoring and alerting
 - Upload of leader node inventory
-- Automatic updates of core and applications
+- Scheduled updates for node operating systems, core components, and
+  applications
 - Upload of cluster backup (Enterprise only)
 
+Regarding software repositories, only the ``subscription`` repository
+remains enabled.
+
+.. hint::
+
+  Please avoid enabling third-party repositories and refrain from
+  installing software not covered by the subscription plan
+
 
 Register the cluster
 ====================
@@ -45,6 +54,30 @@ If the procedure is successful the Subscription page displays the ``System
 ID``, ``Plan`` type and ``Expiration`` date.
 
 
+.. _scheduled-updates:
+
+Scheduled updates
+=================
+
+An overnight scheduled task installs software updates available from
+managed software repositories. The task runs daily, from Tuesday through
+Friday, within a randomly selected time slot between midnight and 6 AM.
+This variability helps distribute the load on the network and servers.
+Updates concern:
+
+- **Operating system**: updates are sourced from Nethesis managed
+  repositories, specifically from DNF repositories labeled as
+  ``ns-baseos`` and ``ns-appstream``. These repositories provide delayed
+  snapshots of Rocky Linux repositories, aiming to prevent the
+  distribution of updates that may lead to unexpected issues.
+
+- **Core components**: Updates are fetched from the ``subscription``
+  repository
+
+- **Applications**: Updates are fetched from the ``subscription``
+  repository
+
+
 Remove the subscription
 =======================
 

updates.rst

@@ -11,6 +11,9 @@ NethServer 8 can handle two different types of updates:
 
 :ref:`Operating system updates <os_updates-section>` are demanded to the underlying Linux distribution.
 
+If you have an active subscription, available updates are applied
+automatically as described in :ref:`scheduled-updates`.
+
 You can see if there are any available updates by accessing the ``Cluster status`` page.
 Updates are applied from the :ref:`software_center-section`.