Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision Next revisionBoth sides next revision | ||
| docs:guide-user:installation:generic.sysupgrade [2023/01/17 12:56] – [Legacy: LuCI flash_keep section of /etc/config/luci] merged with docs:guide-user:troubleshooting:backup_restore#configuration vgaetera | docs:guide-user:installation:generic.sysupgrade [2023/01/18 10:38] – [Can you keep settings?] update link vgaetera | ||
|---|---|---|---|
| Line 7: | Line 7: | ||
| * [[docs: | * [[docs: | ||
| - | ==== How the OpenWrt upgrade works ==== | + | ===== How the OpenWrt upgrade works ===== |
| An OpenWrt **sysupgrade** will replace the entire current OpenWrt installation with a new version. | An OpenWrt **sysupgrade** will replace the entire current OpenWrt installation with a new version. | ||
| This includes the Linux kernel and SquashFS/ | This includes the Linux kernel and SquashFS/ | ||
| Line 24: | Line 24: | ||
| For [[tag: | For [[tag: | ||
| - | ---- | + | By compiling your own custom image with an OpenWrt buildroot or generating with the imagebuilder, |
| - | === Part 1 - Prepare === | + | ===== Upgrade steps ===== |
| + | ==== 1. Prepare | ||
| The first part of the upgrade process is to prepare for the upgrade. | The first part of the upgrade process is to prepare for the upgrade. | ||
| - Setup for data migration ( keep settings ) and additional sysupgrade.conf entries | - Setup for data migration ( keep settings ) and additional sysupgrade.conf entries | ||
| Line 36: | Line 37: | ||
| When it is possible to 'keep settings' | When it is possible to 'keep settings' | ||
| - | ---- | + | ==== 2. Upgrade |
| - | + | ||
| - | === Part 2 - Upgrade === | + | |
| Next is the actual upgrade. The two common upgrade methods to perform the upgrade are: | Next is the actual upgrade. The two common upgrade methods to perform the upgrade are: | ||
| * LuCI web interface System -> Backup / Flash Firmware -> "Flash new firmware image" | * LuCI web interface System -> Backup / Flash Firmware -> "Flash new firmware image" | ||
| * Command-line using '' | * Command-line using '' | ||
| - | Both use the same ' | + | Both use the same '' |
| - | ---- | + | ==== 3. Post Install Configuration, |
| - | + | ||
| - | === Part 3 - Post Install Configuration, | + | |
| After the OS upgrade, there are usually some additional configuration steps required to; | After the OS upgrade, there are usually some additional configuration steps required to; | ||
| - | * re-install additional packages not part of the base OpenWrt install | + | * Re-install additional packages not part of the base OpenWrt install |
| - | * configure | + | * Configure |
| - | * update | + | * Update |
| Please see the section below with more details. | Please see the section below with more details. | ||
| - | |||
| - | ---- | ||
| - | |||
| - | NOTE: By compiling your own custom image with an OpenWrt buildroot or generating with the imagebuilder, | ||
| - | |||
| - | ---- | ||
| ===== Preparing for upgrade ===== | ===== Preparing for upgrade ===== | ||
| ==== Can you keep settings? ==== | ==== Can you keep settings? ==== | ||
| See also: | See also: | ||
| - | [[docs: | + | [[docs: |
| Most of the time you can, jumping several versions, downgrading, | Most of the time you can, jumping several versions, downgrading, | ||
| Line 79: | Line 70: | ||
| ==== Configure your backup ==== | ==== Configure your backup ==== | ||
| - | Follow: | + | {{section> |
| - | [[docs: | + | |
| - | + | ||
| - | Based on the list of [[docs: | + | |
| - | Verify your backup configuration and ensure that all OpenWrt configurations and user data are going to be preserved. | + | |
| ==== Downloading the OpenWrt upgrade image ==== | ==== Downloading the OpenWrt upgrade image ==== | ||
| Line 158: | Line 145: | ||
| ==== Upgrade installed packages ==== | ==== Upgrade installed packages ==== | ||
| Follow: | Follow: | ||
| - | [[docs: | + | [[docs: |
| After the initial update, it is good to check for any updated packages released after the base OS firmware image was built. | After the initial update, it is good to check for any updated packages released after the base OS firmware image was built. | ||
| Line 164: | Line 151: | ||
| ==== Reinstall user-installed packages ==== | ==== Reinstall user-installed packages ==== | ||
| + | See also: | ||
| + | [[docs: | ||
| + | |||
| After a successful upgrade, you will need to reinstall all previously installed and saved packages. | After a successful upgrade, you will need to reinstall all previously installed and saved packages. | ||
| - | Package configuration files should have been preserved due to steps above, but not the actual packages themselves. | ||
| - | You can reinstall packages manually with [[docs: | ||
| ==== Configure user-installed packages ==== | ==== Configure user-installed packages ==== | ||
| + | See also: | ||
| + | [[docs: | ||
| + | |||
| The new package installations will have installed new, default versions of package configuration files. | The new package installations will have installed new, default versions of package configuration files. | ||
| If existing configuration files are in place, opkg displays a warning about this and saves the new configuration file versions under ''/ | If existing configuration files are in place, opkg displays a warning about this and saves the new configuration file versions under ''/ | ||
| Line 174: | Line 165: | ||
| The new package-provided config files should be compared with your older customized files to merge in any new options or changes of syntax. | The new package-provided config files should be compared with your older customized files to merge in any new options or changes of syntax. | ||
| The '' | The '' | ||
| - | |||
| - | * See [[docs: | ||
| - | |||
| - | ===== Upgrade compatibility ===== | ||
| - | See: | ||
| - | [[docs: | ||
| - | |||
| - | In some cases it is not possible to keep settings due to incompatibilities. | ||
| - | |||
| - | |||
| - | ==== Device Low Memory Workarounds: | ||
| - | * See [[docs: | ||