Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
Next revisionBoth sides next revision
docs:guide-user:installation:attended.sysupgrade [2022/08/13 03:20] – Better link to Github richb-hanoverdocs:guide-user:installation:attended.sysupgrade [2023/11/20 22:29] – Add explanations and examples of auc command line options efahlgren
Line 3: Line 3:
 The Attended SysUpgrade (ASU) facility allows an OpenWrt device to update to The Attended SysUpgrade (ASU) facility allows an OpenWrt device to update to
 new firmware while preserving the packages and settings. new firmware while preserving the packages and settings.
-This dramatically simplifies the upgrade process to a couple clicks followed by +This dramatically simplifies the upgrade process: just a couple clicks and 
-a short wait while a new image is built that contains the necessary packages.+a short wait lets you retrieve and install a new image built with all your previous packages.
  
 ASU eliminates the need to make a list of packages you installed manually, ASU eliminates the need to make a list of packages you installed manually,
-or fuss with ''opkg'' just to upgrade your firmware.+or fuss with opkg just to upgrade your firmware.
  
-We call it "attended" sysupgrade because the process is not started automatically, +Because it is initiated by a person who waits until it's complete
-but is initiated by a person who waits until it's complete. +it's called “attended” sysupgrade
-There is both a LuCI (web page interface) and command-line package for Attended Sysupgrade.+You can see Attended Sysupgrade in action in a video from OneMarcFifty 
 +at: https://www.youtube.com/watch?v=FFTPA6GkJjg&t=1034s
  
 +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://github.com/openwrt/luci/tree/master/applications/luci-app-attendedsysupgrade|luci-app-attendedsysupgrade]]+The [[packages:pkgdata:luci-app-attendedsysupgrade]]
 package provides a page in the router's web interface. package provides a page in the router's web interface.
 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 45: Line 47:
 ===== From the CLI ===== ===== From the CLI =====
  
-The [[https://github.com/openwrt/packages/tree/master/utils/auc|auc]] package performs+The [[packages:pkgdata:auc]] package performs
 the same process as the ''luci-app-attendedsysupgrade'' from SSH/the command line. the same process as the ''luci-app-attendedsysupgrade'' from SSH/the command line.
  
-To install the ''auc'' package, go to **System -> Software**, update the package list,+To install the ''auc'' package, ssh into the router and enter ''opkg install auc'' or 
 +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. 
  
Line 73: Line 76:
 Please report issues to improve the server: Please report issues to improve the server:
 https://github.com/aparcar/asu/issues https://github.com/aparcar/asu/issues
 +</code>
 +
 +To use ''auc'' to check for new packages, or newer versions of the current branch, simply use the ''-c'' option.  This is completely benign, as ''auc'' terminates after reporting what it sees without doing anything further.  Using ''-c'' to experiment with the other options is a safe way to explore how ''auc'' works.
 +<code bash>
 +$ auc -c
 +auc/0.3.2-1
 +Server:    https://sysupgrade.openwrt.org
 +Running:   SNAPSHOT r24414-255d5c9bf8 on x86/64 (generic)
 +Available: SNAPSHOT r24414-255d5c9bf8
 +Requesting package lists...
 + base-files: 1548-r24414-255d5c9bf8 -> 1549-r24427-c4fe1bfc65
 + dnsmasq-full: 2.89-6 -> 2.89-7
 +</code>
 +
 +By default, ''auc'' works on the branch currently installed on your device.  The ''-b'' option can be used to change this behavior, so that you can upgrade or downgrade between release branches (like ''19.07'' or ''23.05'') or snapshot (where you just literally use ''snapshot'' as the value).  The ''-B'' option can be used to select a specific version within a branch, such as ''22.03.1'' or ''23.05.0''.
 +
 +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 ''-B'' to downgrade within a branch pretty safely.
 +<code bash>
 +$ auc -c -b 22.03 -B 22.03.4
 +auc/0.3.2-1
 +Server:    https://sysupgrade.openwrt.org
 +Running:   23.05.2 r23630-842932a63d on x86/64 (generic)
 +Available: 22.03.4 r20123-38ccc47687
 +WARNING: Downgrade to older branch may not work as expected!
 +Requesting package lists...
 + kmod-usb-storage: 5.15.137-1 -> 5.10.176-1
 + terminfo: 6.4-2 -> 6.3-2
 + openssh-sftp-server: 9.5p1-1 -> 9.3p2-1
 + libopenssl: 3.0.12-1 -> 1.1.1w-1
 + luci-app-statistics: git-23.315.63824-5a81162 -> git-23.153.53801-38f5b55
 +...
 </code> </code>
  
  • Last modified: 2024/07/02 16:09
  • by efahlgren