From ba9172ee180207d54978667aca69954524132be0 Mon Sep 17 00:00:00 2001 From: Davide Marini Date: Tue, 17 Mar 2026 17:49:15 +0100 Subject: [PATCH 01/14] Update wol.rst with package upgrade information Added note about package preservation in NethSecurity 8.7.2. --- wol.rst | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/wol.rst b/wol.rst index 063faf43..eb79ae86 100644 --- a/wol.rst +++ b/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, please refer to the following documentation to restore extra packages after an upgrade :ref:`restore_extra_packages-section`. Usage ----- From f3683adc67b98c31d20611b36ef9256a67de3571 Mon Sep 17 00:00:00 2001 From: Davide Marini Date: Tue, 17 Mar 2026 17:50:20 +0100 Subject: [PATCH 02/14] Update remote_access.rst to clarify package preservation Removed warning about extra packages not being preserved across upgrades and added note about preservation starting from version 8.7.2. --- remote_access.rst | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/remote_access.rst b/remote_access.rst index 019bacb2..87eef979 100644 --- a/remote_access.rst +++ b/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,8 @@ 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, please refer to the following documentation to restore extra packages after an upgrade :ref:`restore_extra_packages-section`. + From 56f587f3976eb18a0bb4ab724acb0415e34249b0 Mon Sep 17 00:00:00 2001 From: Davide Marini Date: Tue, 17 Mar 2026 17:51:34 +0100 Subject: [PATCH 03/14] Clarify QEMU guest agent upgrade instructions Updated note regarding QEMU guest agent behavior after upgrades. --- install.rst | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/install.rst b/install.rst index 06394c0f..aec1e7b4 100644 --- a/install.rst +++ b/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, please refer to the following documentation to restore extra packages after an upgrade :ref:`restore_extra_packages-section`. Install on VMWare ----------------- From 35f65d604bb6dfe1d597c7a8057817f644e05d7d Mon Sep 17 00:00:00 2001 From: Davide Marini Date: Tue, 17 Mar 2026 17:57:30 +0100 Subject: [PATCH 04/14] Revise upgrade documentation for package preservation Update firmware upgrade notes to reflect changes in package preservation starting from version 8.7.2. --- updates.rst | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/updates.rst b/updates.rst index 776f9552..73e73588 100644 --- a/updates.rst +++ b/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. @@ -47,12 +43,16 @@ Then run the following command: :: The ``sysupgrade`` command flashes the new image file to the device. +.. note:: + Starting from version 8.7.2 of NethSecurity, extra packages are preserved during system upgrades. + For earlier versions, please refer to the following documentation to restore extra packages after an upgrade :ref:`restore_extra_packages-section`. + .. _restore_extra_packages-section: Restore extra packages ---------------------- -During the upgrade, the system will be completely rewritten, so all the extra packages installed by the user will be lost. +During the upgrade, the system will be completely rewritten, so all the extra packages installed by the user will be lost. This applies to versions earlier than 8.7.2. Still, the list of installed packages is saved in the configuration backup, so it is possible to restore them after the upgrade. After the upgrade, make sure the system can access the internet, then restore previously installed packages using the following commands: :: From e0bc7d72a65147b3082f624863bb2301538b8cdb Mon Sep 17 00:00:00 2001 From: Davide Marini Date: Tue, 17 Mar 2026 17:59:01 +0100 Subject: [PATCH 05/14] Update ups.rst with package upgrade information Added note about package preservation in NethSecurity 8.7.2. --- ups.rst | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/ups.rst b/ups.rst index 5166b503..3e9a9c57 100644 --- a/ups.rst +++ b/ups.rst @@ -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, please refer to the following documentation to restore extra packages after an upgrade :ref:`restore_extra_packages-section`. Step 2: setup the appropriate driver ------------------------------------ From f7d9630b6d7b500d23adc7f60664410ba96a28d4 Mon Sep 17 00:00:00 2001 From: Davide Marini Date: Tue, 17 Mar 2026 17:59:51 +0100 Subject: [PATCH 06/14] Update backup.rst --- backup.rst | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/backup.rst b/backup.rst index 0e8a36ec..cb9b6272 100644 --- a/backup.rst +++ b/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, please refer to the following documentation to restore extra packages after an upgrade :ref:`restore_extra_packages-section`. Machines with a subscription ============================ From 8e7efb150055500d77b72b06e3647001d63c6440 Mon Sep 17 00:00:00 2001 From: Davide Marini Date: Wed, 18 Mar 2026 11:47:32 +0100 Subject: [PATCH 07/14] Revise upgrade notes for package restoration process Updated notes regarding package preservation during upgrades for NethSecurity version 8.7.2 and earlier versions. --- updates.rst | 22 +++++++++++++++------- 1 file changed, 15 insertions(+), 7 deletions(-) diff --git a/updates.rst b/updates.rst index 73e73588..89f2d085 100644 --- a/updates.rst +++ b/updates.rst @@ -43,19 +43,27 @@ Then run the following command: :: The ``sysupgrade`` command flashes the new image file to the device. -.. note:: - Starting from version 8.7.2 of NethSecurity, extra packages are preserved during system upgrades. - For earlier versions, please refer to the following documentation to restore extra packages after an upgrade :ref:`restore_extra_packages-section`. - .. _restore_extra_packages-section: Restore extra packages ---------------------- +.. note:: + Starting from version 8.7.2 of NethSecurity, extra packages are preserved during system upgrades. + Refer to the following documentation for earlier versions or for troubleshooting scenarios. + +After the upgrade has been done, to list all extra packages, run the following command: :: + + grep overlay /etc/backup/installed_packages.txt + +This command returns all extra packages, making it easier to verify which ones are installed and whether they are running correctly. + +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. This applies to versions earlier than 8.7.2. -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 From 3ffe638fa3c7da9942aec937c7e5a5f3421a6ae3 Mon Sep 17 00:00:00 2001 From: Davide Marini Date: Wed, 18 Mar 2026 11:49:17 +0100 Subject: [PATCH 08/14] Apply suggestion from @cotosso --- backup.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/backup.rst b/backup.rst index cb9b6272..4887b463 100644 --- a/backup.rst +++ b/backup.rst @@ -38,7 +38,7 @@ After the restore the system will be rebooted. .. note:: Starting from version 8.7.2 of NethSecurity, extra packages are preserved during system upgrades. - For earlier versions, please refer to the following documentation to restore extra packages after an upgrade :ref:`restore_extra_packages-section`. + For earlier versions and for additional informations please refer to the following documentation :ref:`restore_extra_packages-section`. Machines with a subscription ============================ From 8a406203453b97b956401d820b3c11b9e283f17a Mon Sep 17 00:00:00 2001 From: Davide Marini Date: Wed, 18 Mar 2026 11:53:25 +0100 Subject: [PATCH 09/14] Update note for extra packages restoration Clarify documentation reference for earlier versions. --- install.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/install.rst b/install.rst index aec1e7b4..b657ac48 100644 --- a/install.rst +++ b/install.rst @@ -148,7 +148,7 @@ The QEMU guest agent will be available on the virtual machine and automatically .. note:: Starting from version 8.7.2 of NethSecurity, extra packages are preserved during system upgrades. - For earlier versions, please refer to the following documentation to restore extra packages after an upgrade :ref:`restore_extra_packages-section`. + For earlier versions and for additional information, refer to this documentation: :ref:`restore_extra_packages-section`. Install on VMWare ----------------- From 56f72afb6fe6f51a6dba2cb933f1eeba21a1e5ff Mon Sep 17 00:00:00 2001 From: Davide Marini Date: Wed, 18 Mar 2026 11:54:25 +0100 Subject: [PATCH 10/14] Fix grammar in backup.rst note section Corrected grammar and phrasing in documentation. --- backup.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/backup.rst b/backup.rst index 4887b463..e296b447 100644 --- a/backup.rst +++ b/backup.rst @@ -38,7 +38,7 @@ After the restore the system will be rebooted. .. note:: Starting from version 8.7.2 of NethSecurity, extra packages are preserved during system upgrades. - For earlier versions and for additional informations please refer to the following documentation :ref:`restore_extra_packages-section`. + For earlier versions and for additional information, refer to this documentation: :ref:`restore_extra_packages-section`. Machines with a subscription ============================ From 6fbcc156a211d99a0d2a5f722d51cb08040baccd Mon Sep 17 00:00:00 2001 From: Davide Marini Date: Wed, 18 Mar 2026 11:55:49 +0100 Subject: [PATCH 11/14] Update note on restoring extra packages for upgrades --- remote_access.rst | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/remote_access.rst b/remote_access.rst index 87eef979..2849a110 100644 --- a/remote_access.rst +++ b/remote_access.rst @@ -308,5 +308,4 @@ Two packages are provided for installation, covering the vast majority of adapte .. note:: Starting from version 8.7.2 of NethSecurity, extra packages are preserved during system upgrades. - For earlier versions, please refer to the following documentation to restore extra packages after an upgrade :ref:`restore_extra_packages-section`. - + For earlier versions and for additional information, refer to this documentation: :ref:`restore_extra_packages-section`. From 2c0938b7c3973a240b82f5ccdf19849f40d4357d Mon Sep 17 00:00:00 2001 From: Davide Marini Date: Wed, 18 Mar 2026 11:56:59 +0100 Subject: [PATCH 12/14] Update documentation for extra packages restoration Clarified note regarding extra packages for earlier versions. --- ups.rst => package | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) rename ups.rst => package (98%) diff --git a/ups.rst b/package similarity index 98% rename from ups.rst rename to package index 3e9a9c57..6a6c53b2 100644 --- a/ups.rst +++ b/package @@ -45,7 +45,7 @@ Install the required packages:: .. note:: Starting from version 8.7.2 of NethSecurity, extra packages are preserved during system upgrades. - For earlier versions, please refer to the following documentation to restore extra packages after an upgrade :ref:`restore_extra_packages-section`. + For earlier versions and for additional information, refer to this documentation: :ref:`restore_extra_packages-section`. Step 2: setup the appropriate driver ------------------------------------ From 41916191eb9c9ace047cccf5fd5ca44b46a7aaba Mon Sep 17 00:00:00 2001 From: Davide Marini Date: Wed, 18 Mar 2026 11:57:40 +0100 Subject: [PATCH 13/14] Update note for extra packages restoration documentation Clarified note regarding documentation for earlier versions. --- wol.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/wol.rst b/wol.rst index eb79ae86..fc2dd865 100644 --- a/wol.rst +++ b/wol.rst @@ -20,7 +20,7 @@ Install the package with:: .. note:: Starting from version 8.7.2 of NethSecurity, extra packages are preserved during system upgrades. - For earlier versions, please refer to the following documentation to restore extra packages after an upgrade :ref:`restore_extra_packages-section`. + For earlier versions and for additional information, refer to this documentation: :ref:`restore_extra_packages-section`. Usage ----- From 6b1337e2d13174bd1556ecfc5686a5bdfb8e8279 Mon Sep 17 00:00:00 2001 From: Davide Marini Date: Wed, 18 Mar 2026 12:09:42 +0100 Subject: [PATCH 14/14] Update restore extra packages section in updates.rst Revised wording for clarity and conciseness in the updates documentation. --- updates.rst | 9 ++++----- 1 file changed, 4 insertions(+), 5 deletions(-) diff --git a/updates.rst b/updates.rst index 89f2d085..de387fe0 100644 --- a/updates.rst +++ b/updates.rst @@ -47,15 +47,14 @@ The ``sysupgrade`` command flashes the new image file to the device. Restore extra packages ---------------------- -.. note:: - Starting from version 8.7.2 of NethSecurity, extra packages are preserved during system upgrades. - Refer to the following documentation for earlier versions or for troubleshooting scenarios. +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 has been done, to list all extra packages, run the following command: :: +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, making it easier to verify which ones are installed and whether they are running correctly. +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 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^