You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/iot-hub-device-update/delta-updates.md
+8-10Lines changed: 8 additions & 10 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -37,22 +37,20 @@ An update handler integrates with the Device Update agent to perform the actual
37
37
38
38
### Delta processor
39
39
40
-
The delta processor recreates the original SWU image file on your device after the delta file downloads, so your update handler can install the SWU file. The delta processor is available in the [Azure/iot-hub-device-update-delta](https://github.com/Azure/iot-hub-device-update-delta) GitHub repo.
40
+
The delta processor at [Azure/iot-hub-device-update-delta](https://github.com/Azure/iot-hub-device-update-delta) creates the original SWU image file on your device after the delta file downloads, so your update handler can install the SWU file. To add the delta processor component to your device image and configure it for use, you can download a Debian package for Ubuntu 20.04 and later from [https://github.com/Azure/iot-hub-device-update-delta/tree/main/preview/2.0.0](https://github.com/Azure/iot-hub-device-update-delta/tree/main/preview/2.0.0).
41
41
42
-
To add the delta processor component to your device image and configure it for use, you can download a Debian package from [https://github.com/Azure/iot-hub-device-update-delta/tree/main/preview/2.0.0](https://github.com/Azure/iot-hub-device-update-delta/tree/main/preview/2.0.0) that's supported on Ubuntu 20.04 and later.
43
-
44
-
If you're using another distro, follow the *README.md* instructions to use CMAKE to build the delta processor from source instead. From there, install the shared object *libadudiffapi.so* directly by copying it to the */usr/lib* directory, as follows:
42
+
If you use another distro, follow the *README.md* instructions to use CMAKE to build the delta processor from source instead. From there, install the shared object *libadudiffapi.so* directly by copying it to the */usr/lib* directory, as follows:
45
43
46
44
```bash
47
45
sudo cp <path to libadudiffapi.so> /usr/lib/libadudiffapi.so
48
46
sudo ldconfig
49
47
```
50
48
51
-
##Add a source SWU image file to your device
49
+
### Source SWU image file on the device
52
50
53
-
After the delta update file downloads to a device, it's compared against a valid `<source_archive>` previously cached on the device. This process enables the delta update to recreate the full target image.
51
+
After the delta update file downloads to a device, it compares against a valid `<source_archive>` previously cached on the device. This process enables the delta update to recreate the full target image.
54
52
55
-
The simplest way to populate this cached image is to [import](import-update.md) and [deploy](deploy-update.md) processes) a full image update to the device via the Device Update service. As long as the device is configured with Device Update agent version 1.0 or later and the delta processor, the Device Update agent caches the installed SWU file automatically for later delta update use.
53
+
The simplest way to populate this cached image is to [import](import-update.md) and [deploy](deploy-update.md) processes) a full image update to the device via the Device Update service. If the device is configured with Device Update agent version 1.0 or later and the delta processor, the agent caches the installed SWU file automatically for later delta update use.
56
54
57
55
If you want to directly prepopulate the source image on your device instead, the path where the image is expected is `<BASE_SOURCE_DOWNLOAD_CACHE_PATH>/sha256-<ENCODED HASH>`. By default, `<BASE_SOURCE_DOWNLOAD_CACHE_PATH>` is the path */var/lib/adu/sdc/\<provider>*. The `provider` value is the `provider` part of the [updateId](import-concepts.md#update-identity) for the source SWU file.
58
56
@@ -121,7 +119,7 @@ sudo ./DiffGenTool
121
119
/mnt/o/temp/<recompressed target file to create>.swu
122
120
```
123
121
124
-
If you also use the signing parameter, which you need if your SWU file is signed, you can use the sample *sign_file.sh* script from the [Azure/iot-hub-device-update-delta](https://github.com/Azure/iot-hub-device-update-delta/tree/main/src/scripts/signing_samples/openssl_wrapper) GitHub repo. Open the script, edit it to add the path to your private key file, save the script, and then run DiffGen as follows.
122
+
If you also use the signing parameter, which you must if your SWU file is signed, you can use the sample *sign_file.sh* script from the [Azure/iot-hub-device-update-delta](https://github.com/Azure/iot-hub-device-update-delta/tree/main/src/scripts/signing_samples/openssl_wrapper) GitHub repo. Open the script, edit it to add the path to your private key file, save the script, and then run DiffGen as follows.
125
123
126
124
The following code creates a diff between the input source file and a recompressed and re-signed target file:
127
125
@@ -138,7 +136,7 @@ sudo ./DiffGenTool
138
136
139
137
## Import for generated delta updates
140
138
141
-
The process of import a delta update to the Device Update service is the same as for any other update. If you haven't already, be sure to review [How to prepare an update to be imported into Azure Device Update for IoT Hub](create-update.md).
139
+
The process of importing a delta update to the Device Update service is the same as for any other update. If you haven't already, be sure to review [How to prepare an update to be imported into Azure Device Update for IoT Hub](create-update.md).
142
140
143
141
### Generate the import manifest
144
142
@@ -170,7 +168,7 @@ Use the `downloadHandler` object to specify how the Device Update agent orchestr
170
168
}
171
169
```
172
170
173
-
You can use the Azure CLI [az iot du update init v5](/cli/azure/iot/du/update/init?view=azure-cli-latest#az-iot-du-update-init-v5) command to generate an import manifest for your delta update. For more information, see [Create a basic import manifest](create-update.md#create-a-basic-device-update-import-manifest).
171
+
You can use the Azure CLI [`az iot du update init v5`](/cli/azure/iot/du/update/init#az-iot-du-update-init-v5) command to generate an import manifest for your delta update. For more information, see [Create a basic import manifest](create-update.md#create-a-basic-device-update-import-manifest).
0 commit comments