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:attended.sysupgrade [2022/08/13 02:19] – Good enough to criticize richb-hanover | docs:guide-user:installation:attended.sysupgrade [2023/11/20 22:29] – Add explanations and examples of auc command line options efahlgren | ||
|---|---|---|---|
| Line 1: | Line 1: | ||
| ====== Upgrade using Attended Sysupgrade ====== | ====== Upgrade using Attended Sysupgrade ====== | ||
| - | The Attended | + | The Attended |
| new firmware while preserving the packages and settings. | new firmware while preserving the packages and settings. | ||
| - | This dramatically simplifies the upgrade process | + | This dramatically simplifies the upgrade process: just a couple clicks |
| - | a short wait while a new image is built that contains the necessary | + | a short wait lets you retrieve and install |
| - | There is both a LuCI (web page interface) and command-line package for Attended Sysupgrade. | + | ASU eliminates the need to make a list of packages you installed manually, |
| + | or fuss with opkg just to upgrade your firmware. | ||
| + | Because it is initiated by a person who waits until it's complete, | ||
| + | it's called “attended” sysupgrade. | ||
| + | You can see Attended Sysupgrade in action in a video from OneMarcFifty | ||
| + | at: https:// | ||
| + | |||
| + | There is both a LuCI (web page interface) and command-line package for Attended Sysupgrade. | ||
| ===== From LuCI web page ===== | ===== From LuCI web page ===== | ||
| - | The [[https:// | + | The [[packages: |
| package provides a page in the router' | package provides a page in the router' | ||
| It requests a new firmware image built with the current set of packages, | It requests a new firmware image built with the current set of packages, | ||
| Line 22: | Line 29: | ||
| To upgrade your firmware: | To upgrade your firmware: | ||
| - | * Go to **System -> Atttended Sysupgrade**. You'll see the "main window" | + | |
| + | | ||
| * Click **Search for sysupgrade** You will see choices for the firmware version that are available. | * Click **Search for sysupgrade** You will see choices for the firmware version that are available. | ||
| * Select the desired version from the dropdown, and click **Request Sysupgrade** | * Select the desired version from the dropdown, and click **Request Sysupgrade** | ||
| Line 35: | Line 43: | ||
| {{: | {{: | ||
| - | {{: | + | {{: |
| choose Keep Settings (or not) and click **Install Sysupgrade** | choose Keep Settings (or not) and click **Install Sysupgrade** | ||
| ===== From the CLI ===== | ===== From the CLI ===== | ||
| - | The [[https:// | + | The [[packages:pkgdata:auc]] package performs |
| the same process as the '' | the same process as the '' | ||
| - | To install the '' | + | To install the '' |
| + | in the web intrface, go to **System -> Software**, update the package list, | ||
| and search for //auc//. Install it in the usual manner. | and search for //auc//. Install it in the usual manner. | ||
| - | Enter '' | + | To upgrade your device firmware, first **Make A Backup** //(see first step above)// |
| + | Then enter '' | ||
| The default is to get the next version. | The default is to get the next version. | ||
| You can specify the following options on the command line. | You can specify the following options on the command line. | ||
| Line 66: | Line 76: | ||
| Please report issues to improve the server: | Please report issues to improve the server: | ||
| https:// | https:// | ||
| + | </ | ||
| + | |||
| + | To use '' | ||
| + | <code bash> | ||
| + | $ auc -c | ||
| + | auc/0.3.2-1 | ||
| + | Server: | ||
| + | Running: | ||
| + | Available: SNAPSHOT r24414-255d5c9bf8 | ||
| + | Requesting package lists... | ||
| + | | ||
| + | | ||
| + | </ | ||
| + | |||
| + | By default, '' | ||
| + | |||
| + | This example detects that 23.05.2 is installed, and shows information related to downgrading to 22.03.4. | ||
| + | As indicated by the warning, this is probably not a good idea as the jump in versions is "too far", but you *can* use '' | ||
| + | <code bash> | ||
| + | $ auc -c -b 22.03 -B 22.03.4 | ||
| + | auc/0.3.2-1 | ||
| + | Server: | ||
| + | Running: | ||
| + | Available: 22.03.4 r20123-38ccc47687 | ||
| + | WARNING: Downgrade to older branch may not work as expected! | ||
| + | Requesting package lists... | ||
| + | | ||
| + | | ||
| + | | ||
| + | | ||
| + | | ||
| + | ... | ||
| </ | </ | ||
| Line 73: | Line 115: | ||
| It coordinates several OpenWrt ImageBuilders and caches the resulting images in a Redis database. | It coordinates several OpenWrt ImageBuilders and caches the resulting images in a Redis database. | ||
| If an image is cached, the server can provide it immediately without rebuilding. | If an image is cached, the server can provide it immediately without rebuilding. | ||
| + | |||
| + | The ASU Server provides an API to request custom firmware images with | ||
| + | any selection of packages pre-installed. | ||
| + | This avoids the need to set up a build environment, | ||
| + | to create a custom firmware image even using a mobile device. | ||
| * The current production ASU Server is '' | * The current production ASU Server is '' | ||
| - | * There is an experimental | + | * There is an development |
| * < | * < | ||
| + | * The [[https:// | ||
| - | ASU relies on significant updates over the last several years to the ImageBuilder, | + | ASU relies on significant updates over the last several years to the ImageBuilder, |
| - | + | [[https:// | |