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.
There are two modes
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
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.
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>