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 13:25] – [How the OpenWrt upgrade works] 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 26: | Line 26: | ||
| By compiling your own custom image with an OpenWrt buildroot or generating with the imagebuilder, | By compiling your own custom image with an OpenWrt buildroot or generating with the imagebuilder, | ||
| - | === 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 === | + | ==== 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" | ||
| Line 43: | Line 44: | ||
| Both use the same '' | Both use the same '' | ||
| - | === 3. Post Install Configuration, | + | ==== 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. | ||
| Line 54: | Line 55: | ||
| ==== 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 69: | 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 148: | 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 154: | 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 164: | 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: | ||
| - | |||