Firmware updates (admin side)

The phases of a firmware deployment

Firmware deployments are created and managed throughout their lifecycle from the "Firmware updates" section of the management app. Admins with the proper permissions are capable of creating new deployments and managing them as they pass through QA and production rollout.

There are 3 stages that a deployment can be in:

  1. Test deployment when a package is being deployed to a selection of devices in a pilot run.
  2. Production deployment when a package is being automatically distributed to an entire fleet of devices (either immediately after promotion from test, or on a schedule).
  3. Archived deployment when a package is either successfully deployed or canceled for any reason.

Running a test deployment

  1. Under Devices, go the the Firmware deployment section.

  2. Choose a small number of devices to deploy this firmware as a pilot deployment.

    • These devices must be from the same template.
    • Try a lower number of devices during test deployments, to make troubleshooting easier.
  1. Select the files that you want to include in this firmware package (and provide a name and version).
    • The version of this package will be used as a unique identifier throughout the app to indicate which is the latest package deployed to a device.
  1. Confirm that you are ready to perform a test deployment to these devices and click Run Test.

    • Devices will be informed of the availability of new files the next time they check with the broker. Note: There is no 24-hour rollout schedule for test deployments.
    • Devices do not need to be online at the time you initiate a deployment.

Rolling out a production deployment

When you are satisfied with a test deployment, admins can roll out the firmware package to every device in the device template.

  1. Find the test deployment and click "Deploy".
  1. Schedule a start date or start the deployment immediately.
  1. In the summary window, select the checkbox to confirm you're deploying the right files, and click "Start" or "Authenticate & Start" (if multi-factor authentication is enabled).
  • If your account has multi-factor authentication (MFA) enabled, enter the code from the LastPass Authenticator or use the backup option to receive the code as a text message on your phone, and click "Done".

Your deployment is now in progress.

Monitoring a production rollout

The firmware update availability to devices takes place over 24 hours, so some devices will not get the available update immediately.

While a new package is being deployed, admins can track the status of the rollout using the firmware dashboard.

This view will show the percentage of the devices in the template family that has received and acknowledged the new firmware package. From here, you can cancel the deployment.

Leveraging firmware deployments and device logs

When a device reports the successful receipt and verification of a new file package, a log event is added to that Device's log.

This is particularly useful if the devices themselves are also using device logs to report regular status and error messages, as it allows you to have a full report of the diagnostic and operational health of each device that can also be queried programmatically.

Archived deployments

A deployment is moved to "Archived" in the following conditions:

  • A production deployment completes successfully.
  • A production deployment is canceled.
  • A test deployment is moved to Archived before being transitioned to a production deployment.

Firmware updates (admin side)