aktualizr-lite

The default OTA client shipped with the Linux microPlatform is aktualizr-lite. This client is a build variant of the Aktualizr project. It is targeting users who wish to have the security aspects of TUF but do not want the complexity of Uptane.

../_images/aktualizr-diagram.png

There are two modes aktualizr-lite supports.

Daemon Mode (Default)

This is the default mode of aktualizr-lite in the Linux microPlatform. It is a systemd service, which is enabled by default on Community Factory images. Additionally, the daemon will only be enabled in a Personal or Enterprise factory after lmp-device-register has sucessfully registered your device. The daemon will periodically check for new updates, and apply them when found.

To disable daemon mode:

sudo systemctl disable aktualizr-lite

To enable daemon mode:

sudo systemctl enable aktualizr-lite

To restart the daemon:

sudo systemctl restart aktualizr-lite

To stop the daemon:

sudo systemctl stop aktualizr-lite

To view the daemon logs:

sudo journalctl -f -u aktualizr-lite

Manual Mode

If you have disabled daemon mode, you can use aktualizr-lite manually from the command line to fetch updates and apply them. Manual mode can be useful for debugging, testing, or demoing a device.

Note

Manual mode will require you to reboot your device to apply an update.

View Current Status

You can run sudo aktualizr-lite status to view the current status of the device.

Fetch and List Updates

This command will refresh the targets metadata from the OTA server, and present you with a list of available targets which can be applied.

sudo aktualizr-lite list

Apply Latest Update

This command will apply the latest available update to the device. This includes both OSTree and Docker app targets.

sudo aktualizr-lite update

Apply Specific Update

If you would like to update to a specifc build number, you can use the following command.

sudo aktualizr-lite update --update-name <build_number>