• Documentation
• Firmware(OTA) Upgrade
• Viewing Upgrade Details
• Edit

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.

Prerequisites

• Ensure you have completed Verifying Firmware Upgrade Process or Batch Upgrading Firmware in order to view each status respectively.

• Ensure that you have obtained the Developer role to have the access to Application Portal > Developer Console. If not, contact your OU administrator.

Procedures

Choose one of the following methods to view upgrade details:

Method 1:

1. In the Developer Console of EnOS Application Portal, select Operation Monitoring > Firmware Management.

2. Click the View button on the right side of the firmware you want to check. On the details page, you can view all device details or job details related to this firmware upgrade.

Method 2:

1. In the Developer Console of EnOS Application Portal, select Operation Monitoring > OTA Jobs.

2. Click the View button on the right side of the job you want to check to enter the details page.

3. Click the job status tag to view devices under the corresponding status. You can use the DeviceKey to search for devices.

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

  
  

  

  
  

• 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 Firmware Upgrade Process again and perform Upgrading Firmware. For firmware that is no longer needed, you can Delete Firmware.