Skip to content

Commit 2a753c9

Browse files
authored
Merge pull request #154043 from ValOlson/patch-10
Device Update agent provisioning
2 parents 8f06910 + 76907ba commit 2a753c9

File tree

1 file changed

+26
-8
lines changed

1 file changed

+26
-8
lines changed

articles/iot-hub-device-update/device-update-agent-provisioning.md

Lines changed: 26 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -76,8 +76,25 @@ Follow these instructions to provision the Device Update agent on [IoT Edge enab
7676

7777
1. Follow the instructions to [Install and provision the Azure IoT Edge runtime](https://docs.microsoft.com/azure/iot-edge/how-to-install-iot-edge?view=iotedge-2020-11&preserve-view=true).
7878

79-
1. Then install the Device Update agent from [Artifacts](https://github.com/Azure/iot-hub-device-update/releases) and you are now ready to start the Device Update agent on your IoT Edge device.
80-
79+
1. Install the Device Update image update agent
80+
- We provide sample images in [Artifacts](https://github.com/Azure/iot-hub-device-update/releases) to try image update rollouts to different versions using a base image (adu-base-image) and one update image (adu-update-image). See example of [how to flash the image to your IoT Hub device](https://docs.microsoft.com/azure/iot-hub-device-update/device-update-raspberry-pi#flash-sd-card-with-image).
81+
82+
1. Install the Device Update package update agent
83+
- For latest agent versions from packages.miscrosoft.com: Update package lists on your device and install the Device Update agent package and its dependencies using:
84+
```shell
85+
sudo apt-get update
86+
```
87+
88+
```shell
89+
sudo apt-get install deviceupdate-agent deliveryoptimization-plugin-apt
90+
```
91+
92+
- For upcoming release candidate versions from [Artifacts](https://github.com/Azure/iot-hub-device-update/releases) : Download the .dep file to the machine you want to install the Device Update agent on, then:
93+
```shell
94+
Sudo apt-get install -y ./"<PATH TO FILE>"/"<.DEP FILE NAME>"
95+
```
96+
97+
1. You are now ready to start the Device Update agent on your IoT Edge device.
8198

8299
### On non-Edge IoT Linux devices
83100

@@ -125,14 +142,15 @@ Follow these instructions to provision the Device Update agent on your IoT Linux
125142
sudo aziotctl config apply
126143
```
127144

128-
1. Finally install the Device Update agent from [Artifacts](https://github.com/Azure/iot-hub-device-update/releases) and you are now ready to start the Device Update agent on your IoT Edge device.
145+
1. Finally install the Device Update agent. We provide sample images in [Artifacts](https://github.com/Azure/iot-hub-device-update/releases) to try image update rollouts to different versions using a base image (adu-base-image) and one update image (adu-update-image). See example of [how to flash the image to your IoT Hub device](https://docs.microsoft.com/azure/iot-hub-device-update/device-update-raspberry-pi#flash-sd-card-with-image).
129146

147+
1. You are now ready to start the Device Update agent on your IoT device.
130148

131149
### Other IoT devices
132150

133151
The Device Update agent can also be configured without the IoT Identity service for testing or on constrained devices. Follow the below steps to provision the Device Update agent using a connection string (from the Module or Device).
134152

135-
1. Install Device Update agent from [Artifacts](https://github.com/Azure/iot-hub-device-update/releases).
153+
1. We provide sample images in [Artifacts](https://github.com/Azure/iot-hub-device-update/releases) to try image update rollouts to different versions using a base image (adu-base-image) and one update image (adu-update-image). See example of [how to flash the image to your IoT Hub device](https://docs.microsoft.com/azure/iot-hub-device-update/device-update-raspberry-pi#flash-sd-card-with-image).
136154

137155
1. Log onto the machine or IoT Edge device/IoT device.
138156

@@ -145,16 +163,16 @@ The Device Update agent can also be configured without the IoT Identity service
145163

146164
1. You should see a window open with some text in it. Delete the entire string following 'connection_String=' the first-time you provision the Device Update agent on the IoT device. It is just place holder text.
147165

148-
1. In the terminal, replace <your-connection-string> with the connection string of the device for your instance of Device Update agent.
166+
1. In the terminal, replace "<your-connection-string>" with the connection string of the device for your instance of Device Update agent.
149167

150168
> [!Important]
151169
> Do not add quotes around the connection string.
152170

153-
- connection_string=<your-connection-string>
171+
- connection_string= "<ADD CONNECTION STRING HERE>"
154172

155173
1. Enter and save.
156174

157-
1. Now you are now ready to start the Device Update agent on your IoT Edge device.
175+
1. Now you are now ready to start the Device Update agent on your IoT device.
158176

159177

160178
## How to start the Device Update Agent
@@ -187,7 +205,7 @@ You can also build and modify your own customer Device Update agent.
187205
Follow the instructions to [build](https://github.com/Azure/iot-hub-device-update/blob/main/docs/agent-reference/how-to-build-agent-code.md) the Device Update Agent
188206
from source.
189207

190-
Once the agent is successfully building, it's time [run](https://github.com/Azure/iot-hub-device-update/blob/main/docs/agent-reference/how-to-run-agent.md)
208+
Once the agent is successfully building, it's time to [run](https://github.com/Azure/iot-hub-device-update/blob/main/docs/agent-reference/how-to-run-agent.md)
191209
the agent.
192210
193211
Now, make the changes needed to incorporate the agent into your image. Look at how to

0 commit comments

Comments
 (0)