Skip to end of metadata
Go to start of metadata

(warning) There are updates under way to a new setup, updating to latest version of Aktualizr.  Be aware that the instructions here may be no longer relevant.


Aktualizr is RVI SOTA client written in the C++ programming language. It has replaced the RVI SOTA Client written in the Rust programming language in GENIVI Development Platform (GDP). Aktualizr is shipped by default with GDP.

Step-by-step guide

  1. Login to https://sota.genivi.org/login (Ask GENIVI IT department for credentials if you don't have username and password).
  2. Select Vehicles from the navigation menu on the left side of the screen.
  3. Click NEW VIN.
  4. Enter a name for the new vehicle and click Add Vehicle. The new vehicle will be saved and will appear on the list below.
  5. Click on the name of the new vehicle from the list.
  6. Copy the UUID of the new vehicle from the URL.
  7. Build and boot GENIVI Development Platform (GDP) following the instructions from the wiki.
  8. Login to the device (via SSH or alternatively via USB to serial cable connected to the hardware).
  9. Edit /etc/sota.toml and save the UUID of the device generated from the web UI.
  10. Restart the systemd service of Aktualizr: 

     systemctl restart aktualizr
  11. Check the status and verify that Aktualizr has connected successfully to the RVI node:

    systemctl status -l aktualizr
  12. Go back the web UI and select Packages from the navigation menu.
  13. Click NEW PACKAGE.
  14. Fill in all details, upload a package and click Add PACKAGE.
  15. Click on the new package from the list of all packages.
  16. Click NEW CAMPAIGN.
  17. Fill in all details for the new campaign.
  18. Click Generate Update Id.
  19. Click Create Update.
  20. Select Updates from the navigation menu.
  21. Locate the package and click Details to check the status of the campaign.


Please allow up to 45 seconds for Aktualizr to load after restarting its systemd service