Extra packages preserved during the upgrade from NethSecurity 8.7.2

backup.rst

@@ -36,7 +36,9 @@ If the backup is encrypted, enter the passphrase, and finally, click the :guilab
 
 After the restore the system will be rebooted.
 
-If you have installed extra packages, you can restore them by following the instructions in the :ref:`restore_extra_packages-section`.
+.. note::
+   Starting from version 8.7.2 of NethSecurity, extra packages are preserved during system upgrades.
+   For earlier versions and for additional information, refer to this documentation: :ref:`restore_extra_packages-section`.
 
 Machines with a subscription
 ============================

install.rst

@@ -146,8 +146,9 @@ After the installation, start the service: ::
 
 The QEMU guest agent will be available on the virtual machine and automatically started at boot.
 
-Please note that after an image upgrade the QEMU guest agent will be removed and you will need to reinstall it.
-See :ref:`restore_extra_packages-section` for more info.
+.. note::
+   Starting from version 8.7.2 of NethSecurity, extra packages are preserved during system upgrades.
+   For earlier versions and for additional information, refer to this documentation: :ref:`restore_extra_packages-section`.
 
 Install on VMWare
 -----------------

ups.rst → package

@@ -43,7 +43,9 @@ Install the required packages::
     opkg update
     opkg install nut-server nut-upsc nut-upsmon nut-upscmd
 
-These packages are not preserved during a system upgrade. For more info see :ref:`restore_extra_packages-section`.
+.. note::
+   Starting from version 8.7.2 of NethSecurity, extra packages are preserved during system upgrades.
+   For earlier versions and for additional information, refer to this documentation: :ref:`restore_extra_packages-section`.
 
 Step 2: setup the appropriate driver
 ------------------------------------

remote_access.rst

@@ -286,10 +286,6 @@ USB-to-Serial Adapters
 In case of need, NethSecurity can be used to access another server via the serial console. If the hardware does not have an RS-232 port, USB-to-serial adapters can be used. 
 For this reason, it is possible to download and install drivers for the most common adapters on NethSecurity. These drivers are provided as-is and are **not supported by Nethesis** (if using an Enterprise or Subscription version).
 
-.. warning::
-
- Extra packages, including kernel modules, are not preserved across image upgrades, so in the event of an upgrade, you will need to download and install them again if needed.
-
 Two packages are provided for installation, covering the vast majority of adapters available on the market.
 ::
 
@@ -309,3 +305,7 @@ Two packages are provided for installation, covering the vast majority of adapte
     Aug  6 08:08:17 nsec8 kernel: [ 2346.359247] usb 1-6: new full-speed USB device number 3 using xhci_hcd
     Aug  6 08:08:17 nsec8 kernel: [ 2346.543052] pl2303 1-6:1.0: pl2303 converter detected
     Aug  6 08:08:17 nsec8 kernel: [ 2346.550401] usb 1-6: pl2303 converter now attached to ttyUSB0
+
+.. note::
+   Starting from version 8.7.2 of NethSecurity, extra packages are preserved during system upgrades.
+   For earlier versions and for additional information, refer to this documentation: :ref:`restore_extra_packages-section`.

updates.rst

@@ -26,10 +26,6 @@ System upgrades
 
 This types of upgrages involve the transition to a new version of the firmware that introduces new features, improvements and wider hardware support.
 
-.. note::
-
-  The upgrade will preserve all the configurations and settings, but it will not preserve extra packages installed by the user.
-
 This type of update will reboot the device (which will therefore not be reachable for a few dozen seconds) and then completely rewrites the firmware, preserving all the configurations.
 However it is recommended to save a configuration backup before proceeding with the upgrade.
 
@@ -51,11 +47,22 @@ The ``sysupgrade`` command flashes the new image file to the device.
 
 Restore extra packages
 ----------------------
+Starting from version 8.7.2 of NethSecurity, extra packages are preserved during system upgrades.
+See the next section for earlier versions.
+
+After the upgrade, you can run the following command to list all extra packages: ::
+
+  grep overlay /etc/backup/installed_packages.txt
+
+This command returns all extra packages, allowing you to verify which ones are installed and present on the system.
+
+Restore extra packages on versions before 8.7.2
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-During the upgrade, the system will be completely rewritten, so all the extra packages installed by the user will be lost.
-Still, the list of installed packages is saved in the configuration backup, so it is possible to restore them after the upgrade.
+During the upgrade, the system is completely rewritten, and all extra packages installed by the user will be lost.
+However, the list of installed packages is saved in the configuration backup, allowing them to be restored after the upgrade.
 
-After the upgrade, make sure the system can access the internet, then restore previously installed packages using the following commands: ::
+After the upgrade, ensure that the system has internet access, then restore the previously installed packages using the following commands: ::
 
   opkg update
   grep -E '\w+\s+overlay$' /etc/backup/installed_packages.txt | awk '{print $1}' | xargs opkg install

wol.rst

@@ -18,7 +18,9 @@ Install the package with::
     opkg update
     opkg install etherwake
 
-These packages are not preserved during a system upgrade. For more info see :ref:`restore_extra_packages-section`.
+.. note::
+   Starting from version 8.7.2 of NethSecurity, extra packages are preserved during system upgrades.
+   For earlier versions and for additional information, refer to this documentation: :ref:`restore_extra_packages-section`.
 
 Usage
 -----