This shows you the differences between two versions of the page.
Both sides previous revision Previous revision | |||
wiki:upgrade_keros5:keros_custo:upgrade [2025/05/28 10:39] ehe removed |
— (current) | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== System upgrade ====== | ||
- | |||
- | ===== Introduction ===== | ||
- | |||
- | ==== Software upgrade files ==== | ||
- | |||
- | The firmware is released in two formats: __KerOS__ and __Liveburner__. | ||
- | These have very different behavior, so please use the appropriate file before updating, see the difference in [[.:upgrade#upgrade_process| upgrade process]] section. | ||
- | |||
- | ==== Major firmware upgrades ==== | ||
- | |||
- | === From KerOS version 4.3.3 to KerOS version 5.X === | ||
- | |||
- | To upgrade the system from KerOS version 4.3.3 to KerOS version 5.X the use of a liveburner is mandatory. | ||
- | Two possibilities are available: | ||
- | |||
- | * Upgrade with a custom liveburner. It allows to keep some elements like gateway configuration. To use a custom liveburner, please refer to the dedicated page: [[wiki:keros_custo:upgrade_major_version|Major version upgrade with a custom liveburner]] | ||
- | * Upgrade with a regular liveburner (erasing the whole partition to reinstall the firmware). Use the liveburner provided in the [[wiki:firmware:lastversion | 5.X last version]] and the upgrade process below. | ||
- | |||
- | |||
- | === From KerOS version 3.x to KerOS version 4.1 === | ||
- | |||
- | The upgrade from KerOS version 3.x to KerOS version 4.1 directly is not recommended by Kerlink. To do so, it must be done in 2 steps: | ||
- | - Upgrade to KerOS version 4.0 using a liveburner | ||
- | - Upgrade from KerOS version 4.0 to KerOS version 4.1 using a KerOS package | ||
- | |||
- | |||
- | === From KerOS version 3.x to KerOS version 4.0 === | ||
- | |||
- | To upgrade the system from KerOS version 3.x to KerOS version 4.0 the use of a liveburner is mandatory. | ||
- | Two possibilities are available: | ||
- | |||
- | * Upgrade with a custom liveburner. It allows to keep some elements like gateway configuration. To build a custom liveburner, please refer to the dedicated page: [[wiki:keros_custo:upgrade_keros3_to_4|Upgrade from KerOS version 3.x to 4.0]] | ||
- | * Upgrade with a regular liveburner (erasing the whole partition to reinstall the firmware). Use the liveburner provided in the [[wiki:keros_custo:upgrade_keros3_to_4|Upgrade from KerOS version 3.x to 4.0]] page and the upgrade process below. | ||
- | |||
- | ===== Upgrade process ===== | ||
- | |||
- | ==== Upgrade using a KerOS package ==== | ||
- | |||
- | Upgrade using a KerOS package (i.e. ''keros_4.X.Y_klk-lpbs-signed.ipk'' file) could be done only with the same major version. \\ | ||
- | Example: \\ | ||
- | * Upgrade from Keros 4.X.X to KerOS 4.Y.Y is possible with a KerOS package (same major version) | ||
- | * Upgrade from Keros 4.X.X to KerOS 5.X.X is not possible with a KerOS package (major version is different) | ||
- | |||
- | The upgrade will install the new KerOS firmware with some consequences on the data: | ||
- | * User partition files will be preserved. | ||
- | * Passwords will be preserved. | ||
- | * The stock restore version will not be updated. | ||
- | * RootFS modifications will NOT be kept except files indicated in [[#configuration_management_sysupgrade|sysupgrade]] configuration files | ||
- | |||
- | The upgrade process itself is the following sequence: | ||
- | - Backup files indicated in configuration (system files and software/customer defined files). | ||
- | - Remove hotfix packages. | ||
- | - Upgrade the system itself. | ||
- | - Restore sysupgrade files => will override new firmware files!! | ||
- | |||
- | To upgrade your system, follow the software update process. Information [[wiki:keros_custo:sw_updates|here]]. | ||
- | |||
- | ==== Upgrade using a liveburner package ==== | ||
- | |||
- | ===== Configuration management (sysupgrade) ===== | ||
- | |||
- | ===== Hotfix packages management ===== | ||
- | |||