After you submit a batch update request, IoT Platform pushes an update notification to your devices based on your settings. You can view the update status of your devices, the update package information, and the statistics after the update.

Prerequisites

A batch update request is submitted. For more information, see Initiate a batch update task.

Procedure

  1. Log on to the IoT Platform console.
  2. In the left-side navigation pane, choose Maintenance > OTA Update.
    Note To provide better services, IoT Platform improves the OTA update feature and adds statistics on update package versions. When you use the new OTA update feature in the console for the first time, you must associate the uploaded update packages with products. You can associate an update package with only one product. For more information about how to associate update packages with products, see the instructions in the console.
  3. On the Update Packages tab, find the update package that you use for a batch update and click View in the Actions column. Then, you can view information and perform operations on the following tabs:
    • Batch Management
      • View the type of an update batch, such as Verify Update Package or Batch Update.
      • View the status of an update batch.

        Find an update batch and click View in the Actions column. On the Batch Details page, you can view devices in different update states on the Device List tab.

        State Description
        To Be Pushed The over-the-air (OTA) update notification has not been pushed to the device.

        This state may appear due to the following three causes: 1. The device is offline. 2. The notification is scheduled to be pushed. 3. The pushing rate exceeds the limit. The following states that correspond to these three causes are displayed:

        • To Be Pushed (Device Offline)
        • To Be Pushed (Scheduled:XX XX, XXXX, XX:XX:XX)
        • To Be Pushed
        Pushed The device has received the OTA update notification but has not submitted the update progress.
        In upgrade The device has received the OTA update notification and submitted the update progress.
        Updated The device has submitted a valid version number after the update.
        Note After a device is updated, make sure that the device submits a valid version number at the earliest opportunity. Otherwise, the update may fail due to a timeout issue.
        Updated Failed OTA updates may fail due to the following causes:
        • You initiate a new batch update for a device. However, you do not overwrite the previous update task that is not complete on the device.

          You can use one of the following methods to resolve the issue:

          • After the previous update task is complete, you can initiate a new update.
          • Before you initiate a new update for a device, overwrite the previous task that is still running on the device.
            Note If the device is in the In upgrade state, an update task that is running on the device cannot be overwritten.
        • The device submits the value of -1, -2, -3, or -4 that indicates a failure when the device uses a specific topic to submit the update progress to IoT Platform. The following content describes the values:
          • -1: indicates that the update fails.
          • -2: indicates that the download fails.
          • -3: indicates that the verification fails.
          • -4: indicate that the flashing fails.
        • During a device update, the update period starts from the first time the device submits the update progress. The device fails to submit the updated version number within the specified timeout period.
        • The device in the In upgrade state submits a version number that is not the source version or destination version.

        If you specify a version number to be updated and specify a retry interval when you initiate a batch update, retries are performed after the update fails. An update may fail due to one of the following causes:

        • The device in the In upgrade state submits a version number that is not the source version or destination version.
        • The device submits one of the following values when the device uses a specific topic to submit the update progress to IoT Platform: -1, -2, -3, and -4.

        During automatic retries, the update status of a device in IoT Platform remains unchanged. For example, if a retry occurs on a device that is in the Pushed state, the device status is still displayed as Pushed in the IoT Platform console. If a retry occurs on a device that is in the In upgrade state, the device status is still displayed as In upgrade in the IoT Platform console.

        Note

        IoT Platform does not perform update retries if an update fails due to one of the following causes:

        • The update times out.
        • You cancel the update.
        Cancelled The update for the device is canceled.
      • Cancel all update tasks of an update batch.

        Find an update batch and click Cancel in the Actions column.

        • By default, only scheduled update tasks are canceled for a static update batch. You can cancel all ongoing update tasks that are in the To Be Pushed, Pushed, and In upgrade states.
        • By default, only the dynamic update policy is canceled for a dynamic update batch. You can cancel all ongoing update tasks that are in the To Be Pushed, Pushed, and In upgrade states.
    • Device List

      View the information about the devices to which the update package is pushed, including the update status of devices, and the statistics on successful updates, failed updates, and canceled updates.

      You can find the device that you want to view and click View in the Actions column to view the batch details of the device. If you want to cancel the update of the device, click Cancel Upgrade

    • Update Package Information
      • View the basic information about the update package, such as the ID, name, signature, signature algorithm, version number, and status of the update package.
      • To obtain the update package file, click Download next to Update Package Signature

What to do next

After the OTA update task is complete, you can go to the Data analysis tab to view the distribution of update package versions and the statistics on the success rate of updates. This way, you can learn more about the OTA update task. For more information, see View statistics on update package versions and success rates.

Related API operations

Operation Description
ListOTAJobByFirmware Queries the update batches of an update package.
ListOTAJobByDevice Queries the update batches of an update package by device.
ListOTATaskByJob Queries the update tasks of a device by update batch.
QueryOTAJob Queries the details of an update task.

For more information about API operations related to the OTA update feature, see API operations for OTA updates.