diff --git a/backup.rst b/backup.rst index 0e8a36ec..e296b447 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 and for additional information, refer to this documentation: :ref:`restore_extra_packages-section`. Machines with a subscription ============================ diff --git a/install.rst b/install.rst index 06394c0f..b657ac48 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 and for additional information, refer to this documentation: :ref:`restore_extra_packages-section`. Install on VMWare ----------------- diff --git a/ups.rst b/package similarity index 97% rename from ups.rst rename to package index 5166b503..6a6c53b2 100644 --- a/ups.rst +++ b/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 ------------------------------------ diff --git a/remote_access.rst b/remote_access.rst index 019bacb2..2849a110 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,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`. diff --git a/updates.rst b/updates.rst index 776f9552..de387fe0 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. @@ -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 diff --git a/wol.rst b/wol.rst index 063faf43..fc2dd865 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 and for additional information, refer to this documentation: :ref:`restore_extra_packages-section`. Usage -----