Update check and restart#

You will end up knowing whether an app's image has a newer version, and with the app restarted.

Before you start#

The operator role and a licence.
The app installed and running: Check for update and Restart appear on its page only while it runs.

Check for update#

Open the app's page: Manage on its catalogue card, its card on the Installed tab, or its menu entry.
Press Check for update. The button reads Checking… while the router downloads the app's image again; only the parts that changed are downloaded.
The notice says "Image is up to date", or "Newer image downloaded — Restart the app to use it." After a newer image, the page also shows "A newer image has been downloaded. Restart the app to use it."

A downloaded image is not used until the app is restarted: the running app keeps the image it started with.

The check compares the image on the router before and after the download. It does not show what changed in the app between the two.

Restart#

Press Restart on the app's page, or on its card on the Installed tab. The app restarts at once:

its settings do not change, nothing is added to the pending changes, and no revision is written;
the restart is recorded in the audit log;
the notice says "Restarted", with a sentence such as "adguard was restarted. Its settings did not change."

Wheelhouse then reads the app's status. If the app is not running afterwards, the message says so, with its status.

A stopped app cannot be restarted: start it instead.

An agent that does not run on the router cannot use the router's own restart. It restarts the app by stopping and starting it instead: two changes, applied one after the other, each a revision in the history. The notice then says "Restarted by stopping and starting the app; both changes are in the history." If the start fails, the message says that the app is not running.

Stop and start#

Stop on the app's page adds "Stop app “adguard”" to the pending changes, and the notice says "Stop saved — The app stops when you apply pending changes." On a stopped app, Start, on its page or its card, adds "Start app “adguard”". Both take effect with Apply changes.

Stopping and starting are changes to the app's settings, so each is a revision in the history, and restoring an earlier revision restores whether the app runs.

Check it worked#

On the app's page, the State tile reads Running and the Health check tile Healthy, for an app that has a health check.

If the badge reads not running, the Log tab usually says why, and the panel Settings and state differ offers Restart now.

What is not here#

Undoing it#

A restart cannot be undone. A stop is undone with Start, and a start with Stop.