Managing the Device

The FoundriesFactory provides you the ability to produce your own custom platform images, and a mechanism to securely deploy them to any of the registered devices.

A couple of quick notes:

  • The default user and password is fio; we recommend changing it now if you haven’t already.

  • For dynamic host name resolution to work, your local network needs to support Zeroconf and the hostname must be otherwise unclaimed.

Registering the Device with the OTA Server

Your Linux microPlatform image includes a tool, lmp-device-register that will register your device(s) via Foundries.io REST API.

  1. From a console on the device run this command to register the device into your factory:

    # -a - this allows you to specify an optional comma separated list of
    #      Docker Apps to manage on the device
    # -n - the name of the device as you'd like it to appear in fioctl and the UI
    sudo lmp-device-register -a shellhttpd -n device-name-01
    
  2. There will be a challenge that needs to be pasted into the URL printed out on the screen. Enter the challenge into the text field on the website.

    Device activation page

    Device activation page

  3. Once the device has been registered, from a console on the device run the following command:

    sudo systemctl restart aktualizr-lite
    
  4. Now your device is registered, and any new platform builds produced will be pushed down to this device, and be applied. You can view all the devices registered to your factory at: https://app.foundries.io/devices/. You can also work with your fleet using the fioctl command line tool.

    Devices page

    Devices listing

  5. If for some reason you would like to re-provision a device, you will need to remove the credentials generated by lmp-device-register, and re-provision the device. Using the same device name twice is not supported:

    sudo -s
    systemctl stop aktualizr-lite
    rm -rf /var/sota/*
    lmp-device-register -a shellhttpd -n your_device_name
    systemctl start aktualizr-lite
    
  6. If you would like to monitor the update status on the device, here are a couple of useful commands:

    sudo journalctl -f -u aktualizr-lite
    sudo ostree admin status