Change version
This option is available in the System Settings > Update tab
Note! Always back up your data and configuration before changing the software version.
Upgrade to the latest version
Note! If a new software version includes an updated ZFS version, do not upgrade your zpools unless you're ready for a permanent change. Upgrading zpools to a more recent version of ZFS is irreversible. After upgrading, the zpool won't work with older software versions.
As a rule, you should upgrade the software from version to version. In case such an upgrade is not possible and some versions must be omitted, please contact the Support Team to confirm the best procedure.
To upgrade the software:
- Go to the “System Settings” and then the “Update” tab.
- Click the “Upload update” button. Select the iso file with the release you want to install, and apply by clicking the “Upload” button.
- After the file is uploaded, the popup with the following options appears:
- Cancel - use this option to close the popup window if you want to install the uploaded version later. See the details below. This is also recommended if you install a system version older than the one currently running. To downgrade the system to an older version, we recommend using the Change Version option to decide whether to keep the current system settings. Downgrading the system version is described in the “Downgrade to an older version” section.
- Change and reboot later - using this option will install the uploaded version, set it up as default, and boot it after the next restart. In this case, all current system settings will be saved and applied to the installed version.
- Change and reboot now - using this option will install the uploaded version, set it up as default, and the new version will be applied immediately after the automatic reboot. In this case, all current system settings will be saved and applied to the installed version.
If the "Cancel" option has been chosen after downloading the iso file, you can finish the update with the "Change version" option.
- Go to the “Available version” table.
- Select the uploaded version.
- Using the context menu, select the “Change version” option.
- The popup appears.
- Check the "Keep all current system settings" option while upgrading to the newer version. All current system settings will be saved and applied to the installed version.
- Finish by clicking one of the available buttons:
- Change and reboot later - using this option will install the selected version, set it as the default, and boot it after the next restart.
- Change and reboot now - using this option will install the selected version and apply it immediately after the automatic reboot.
- Cancel - use this option to close the popup window without taking any action if you do not want to continue.
Downgrade to an older version
Downgrading is not recommended and must be done after careful consideration. The newer software version may include bug fixes and security updates. Downgrading to an older version may result in exposure to known vulnerabilities or issues that have been addressed in the newer release.
To avoid issues when downgrading:
- Always check compatibility and differences between iterations.
- Back up your data and configurations.
- Do not downgrade the system by more than one version.
- Do not keep the current system settings. Downgrading the system with saved configuration settings from a newer version can cause issues for several reasons, for example:
- Incompatibility: A newer software version may introduce some changes in configuration settings or dependencies. When you downgrade to an older version, it might cause issues with interpreting or using the settings created by the newer version. This can lead to errors, crashes, or unexpected behavior.
- Missing features: A newer version of software may include new features, options, or optimizations unavailable in older versions. When you downgrade, you might lose access to these features, and the software may not handle the missing functionalities.
- Regression issues: Downgrading might not always be a straightforward process. Some changes made in the newer version may be tightly integrated into the system, and reverting to an older version could break these dependencies, causing problems.
- Configuration settings migration: If you have made significant changes to configuration settings in the newer version, these changes might not easily translate to the older version's configuration format. This can result in configuration conflicts or incomplete settings.
- Be prepared to reconfigure settings or adapt to any changes between versions.
To downgrade the system it is recommended to use the “Change version” option:
- Go to the “System Settings” and then the “Update” tab.
- Go to the “Available version” table.
- Select the version to be installed.
- Using the context menu select the “Change version” option.
- The popup appears.
- Choose whether to keep the current system settings.
- Leave the "Keep all current system settings" option unchecked while downgrading to the older version. This will launch the older version with the default system settings of that version.
- Finish by clicking one of the available buttons:
- Change and reboot later - using this option will install the selected version, set it as the default, and boot it after the next restart.
- Change and reboot now - using this option will install the selected version and apply it immediately after the automatic reboot.
- Cancel - use this option to close the popup window without taking any action if you do not want to continue.