Viewing Upgrade Details


You can view the OTA job status as well as edit the job from the job details. This section shows how to view the status and edit the job for both OTA verification and upgrade jobs.

Prerequisite

After submitting a batch upgrade, the platform will send upgrade notifications to the devices based on your settings. You can check the upgrade status of the target devices in the platform.

Procedures

Method 1

  1. Select OTA Upgrades > Firmware Management.

  2. Click the View button view on the right side of the firmware you want to check. In the details page, you can view the details of all devices or jobs related to the firmware.

Method 2

  1. Select OTA Upgrade > OTA Jobs.

  2. Click the View button view on the right side of the job you want to check. In the details page, click Expand to view the OTA job upgrade strategy.

  3. Click on the job status tabs to view the device information corresponding to the status. You can search for devices using the DeviceKey. For more information, see Job Status.

Job Status

The job status is categorized into five tabs as per the below. You can search for devices using the device key for all tabs.

  • To be Pushed: Devices with this status usually means that the cloud has not yet pushed the firmware for reasons such as the device is offline, or the total concurrency count is at the maximum number so the firmware cannot be pushed.

  • Pushed: Devices with this status means that the cloud has pushed the firmware, but the device has not returned the upgrade progress.

  • In Progress: Devices with this status means that firmware upgrade is currently in progress.

  • Upgrade Successful: Devices with this status means that the upgrade is successfully completed.

  • Upgrade Failed: Devices with this status means that the upgrade job has failed. A reason for the failure is provided for device developers to troubleshoot the errors accordingly. For this tab, you can not only search for devices using the device key, but also search using the current firmware version, reason of failure, and time range. The possible reasons of failure are as per the below.

    • Cancelled by user

    • Device ignored this upgrade

    • Device version not included in the target scope

    • Failed to write firmware to device

    • Firmware download failed

    • Firmware verification failed

    • Last upgrade in progress

    • Target device not found

    • Undefined failure

    • Upgrade timeout


    ../../_images/search_reason_failure.png


  • The total number of retry attempts includes both automatic retries and manual retries.

  • The upgrade duration is the time it takes for the device to transition from the Pushed status to either the Upgrade Failed or Upgrade Successful status.

  • A Cancel Upgrade button is provided in the To be Pushed and Pushed tabs for you to cancel the job in situations such as when you do not wish to wait for the system to timeout (two hours by default). Select the device key of the device to cancel the job for and click Cancel Upgrade. The status of the device will change to Upgrade Failed with the reason as Cancelled by user.

Next Steps

You can Verify the Firmware again and perform Upgrading Firmware. For firmware that is no longer needed, you can Delete Firmware.