Deploy an update by using Device Update for Azure IoT Hub

Learn how to deploy an update to an IoT device by using Device Update for Azure IoT Hub.

Prerequisites

• Access to an IoT hub with Device Update for IoT Hub enabled. We recommend that you use an S1 (Standard) tier or above for your IoT Hub instance.
• At least one update has been successfully imported for the provisioned device.
• An IoT device (or simulator) provisioned for Device Update within IoT Hub.
• The device is part of at least one default group or user-created update group.
• Supported browsers:
  • Microsoft Edge
  • Google Chrome

Deploy the update

1. Go to the Azure portal.

2. Go to the Device Update pane of your IoT Hub instance.

   

3. Select the Groups and Deployments tab at the top of the page. Learn more about device groups.

   

4. View the update compliance chart and groups list. You should see a new update available for your device group listed under Best update. You might need to refresh once. Learn more about update compliance.

5. Select the target group by selecting the group name. You're directed to the group details under Group basics.

   

6. To start the deployment, go to the Current deployment tab. Select the deploy link next to the desired update from the Available updates section. The best available update for a given group is denoted with a Best highlight.

   

7. Schedule your deployment to start immediately or in the future. Then select Create.

   Tip

   By default, the Start date and time is 24 hours from your current time. Be sure to select a different date and time if you want the deployment to begin earlier.

   

8. Under Deployment details, Status turns to Active. The deployed update is marked with (deploying).

   

9. View the compliance chart to see that the update is now in progress.

   

10. After your device is successfully updated, you see that your compliance chart and deployment details updated to reflect the same.

    

Monitor the update deployment

1. Select the Deployment history tab at the top of the page.

   

2. Select Details next to the deployment you created.

   

3. Select Refresh to view the latest status details.

Retry an update deployment

If your deployment fails for some reason, you can retry the deployment for failed devices.

1. Go to the Current deployment tab on the Group details screen.

   

2. Select Retry failed devices and acknowledge the confirmation notification.

Next steps

Troubleshoot common issues