Skip to content

Commit 35e452d

Browse files
authored
Merge pull request #312078 from sethmanheim/iotfrsh2-19
Freshness updates for iot ops
2 parents 22fd38b + 4dd72e5 commit 35e452d

11 files changed

Lines changed: 176 additions & 185 deletions

articles/iot-edge/how-to-provision-single-device-linux-symmetric.md

Lines changed: 12 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ ms.author: sethm
77
ms.service: azure-iot-edge
88
services: iot-edge
99
ms.topic: how-to
10-
ms.date: 04/29/2025
10+
ms.date: 02/20/2026
1111
ms.custom:
1212
- linux-related-content
1313
- sfi-ropc-nochange
@@ -19,7 +19,7 @@ ms.custom:
1919

2020
This article provides end-to-end instructions for registering and provisioning a Linux IoT Edge device that includes installing IoT Edge.
2121

22-
Each device that connects to an [IoT hub](../iot-hub/index.yml) has a device ID that's used to track [cloud-to-device](../iot-hub/iot-hub-devguide-c2d-guidance.md) or [device-to-cloud](../iot-hub/iot-hub-devguide-d2c-guidance.md) communications. You configure a device with its connection information, which includes:
22+
Each device that connects to an [IoT hub](../iot-hub/index.yml) has a device ID that tracks [cloud-to-device](../iot-hub/iot-hub-devguide-c2d-guidance.md) or [device-to-cloud](../iot-hub/iot-hub-devguide-d2c-guidance.md) communications. You configure a device with its connection information, which includes:
2323

2424
* IoT hub hostname
2525
* Device ID
@@ -29,7 +29,7 @@ The steps in this article walk through a process called *manual provisioning*, w
2929

3030
* **Symmetric keys**: When you create a new device identity in IoT Hub, the service creates two keys. You place one of the keys on the device, and it presents the key to IoT Hub when authenticating.
3131

32-
This authentication method is faster to get started, but not as secure.
32+
This authentication method is faster to get started, but isn't as secure.
3333

3434
* **X.509 self-signed**: You create two X.509 identity certificates and place them on the device. When you create a new device identity in IoT Hub, you provide thumbprints from both certificates. When the device authenticates to IoT Hub, it presents one certificate and IoT Hub verifies that the certificate matches its thumbprint.
3535

@@ -46,7 +46,7 @@ This article covers using symmetric keys as your authentication method. If you w
4646
4747
## Prerequisites
4848

49-
This article shows how to register your IoT Edge device and install IoT Edge (also called IoT Edge runtime) on your device. Make sure you have the device management tool of your choice, for example Azure CLI, and device requirements before you register and install your device.
49+
This article shows how to register your IoT Edge device and install IoT Edge (also called IoT Edge runtime) on your device. Make sure you have the device management tool of your choice, such as Azure CLI, and review device requirements before you register and install your device.
5050

5151
<!-- Device registration prerequisites H3 and content -->
5252
[!INCLUDE [iot-edge-prerequisites-register-device.md](includes/iot-edge-prerequisites-register-device.md)]
@@ -57,12 +57,11 @@ This article shows how to register your IoT Edge device and install IoT Edge (al
5757
<!-- Azure IoT extensions for Visual Studio Code-->
5858
### Visual Studio Code extensions
5959

60-
If you're using Visual Studio Code, there are helpful Azure IoT extensions that make the device creation and management process easier.
60+
If you're using Visual Studio Code, helpful Azure IoT extensions make the device creation and management process easier.
6161

6262
Install both the Azure IoT Edge and Azure IoT Hub extensions:
6363

6464
* [Azure IoT Edge](https://marketplace.visualstudio.com/items?itemName=vsciot-vscode.azure-iot-edge). The *Azure IoT Edge tools for Visual Studio Code* extension is in [maintenance mode](https://github.com/microsoft/vscode-azure-iot-edge/issues/639).
65-
6665
* [Azure IoT Hub](https://marketplace.visualstudio.com/items?itemName=vsciot-vscode.azure-iot-toolkit)
6766

6867
<!-- Prerequisites end -->
@@ -75,17 +74,15 @@ Install both the Azure IoT Edge and Azure IoT Hub extensions:
7574

7675
## Provision the device with its cloud identity
7776

78-
Now that the container engine and the IoT Edge runtime are installed on your device, you're ready to set up the device with its cloud identity and authentication information.
77+
After you install the container engine and the IoT Edge runtime on your device, set up the device with its cloud identity and authentication information.
7978

8079
# [Ubuntu / Debian / RHEL](#tab/ubuntu+debian+rhel)
8180

82-
You can configure your IoT Edge device with symmetric key authentication using the following command:
83-
84-
```bash
85-
sudo iotedge config mp --connection-string 'PASTE_DEVICE_CONNECTION_STRING_HERE'
86-
```
81+
You can configure your IoT Edge device with symmetric key authentication by using the following command:
8782

88-
This `iotedge config mp` command creates a configuration file on the device and enters your connection string in the configuration file.
83+
```bash
84+
sudo iotedge config mp --connection-string 'PASTE_DEVICE_CONNECTION_STRING_HERE'
85+
```
8986

9087
1. Apply the configuration changes.
9188

@@ -156,13 +153,13 @@ Verify that the runtime was successfully installed and configured on your IoT Ed
156153
157154
A successful status response shows the `aziot` services as running or ready.
158155
159-
1. If you need to troubleshoot the service, retrieve the service logs.
156+
1. If you need to troubleshoot the service, retrieve the service logs:
160157
161158
```bash
162159
sudo iotedge system logs
163160
```
164161
165-
1. Use the `check` tool to verify configuration and connection status of the device.
162+
1. Use the `check` tool to verify configuration and connection status of the device:
166163
167164
```bash
168165
sudo iotedge check

articles/iot-edge/includes/iot-edge-install-linux.md

Lines changed: 17 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
ms.topic: include
3-
ms.date: 04/29/2025
3+
ms.date: 02/19/2026
44
author: sethmanheim
55
ms.author: sethm
66
ms.service: azure-iot-edge
@@ -17,12 +17,12 @@ Run the following commands to add the package repository and then add the Micros
1717
> [!IMPORTANT]
1818
> On June 30, 2022, Raspberry Pi OS Stretch was retired from the Tier 1 OS support list. To avoid potential security vulnerabilities, update your host OS to Bullseye.
1919
>
20-
> For [tier 2 supported platform operating systems](../support.md#tier-2), installation packages are made available at [Azure IoT Edge releases](https://github.com/Azure/azure-iotedge/releases). See the installation steps in [Offline or specific version installation (optional)](../how-to-provision-single-device-linux-symmetric.md#offline-or-specific-version-installation-optional).
20+
> For [tier 2 supported platform operating systems](../support.md#tier-2), installation packages are available at [Azure IoT Edge releases](https://github.com/Azure/azure-iotedge/releases). See the installation steps in [Offline or specific version installation (optional)](../how-to-provision-single-device-linux-symmetric.md#offline-or-specific-version-installation-optional).
2121
2222

2323
# [Ubuntu](#tab/ubuntu)
2424

25-
Installing can be done with a few commands. Open a terminal and run the following commands:
25+
You can install IoT Edge by using a few commands. Open a terminal and run the following commands:
2626

2727
* **24.04**:
2828

@@ -50,7 +50,7 @@ Installing can be done with a few commands. Open a terminal and run the followin
5050

5151
# [Debian](#tab/debian)
5252

53-
Installing with APT can be done with a few commands. Open a terminal and run the following commands:
53+
You can install it by using APT and running a few commands. Open a terminal and run the following commands:
5454

5555
* **12 - Bookworm (arm32v7)**:
5656

@@ -67,11 +67,11 @@ Installing with APT can be done with a few commands. Open a terminal and run the
6767
```
6868

6969
> [!TIP]
70-
> If you gave the "root" account a password during the OS install, you don't need 'sudo' and can run the previous command by starting with 'apt'.
70+
> If you set a password for the "root" account during the OS installation, you don't need `sudo`. You can run the previous command by starting with `apt`.
7171
7272
# [Red Hat Enterprise Linux](#tab/rhel)
7373
74-
Installing can be done with a few commands. Open a terminal and run the following commands:
74+
You can install IoT Edge by using a few commands. Open a terminal and run the following commands:
7575
7676
* **9.x (amd64)**:
7777
@@ -91,7 +91,7 @@ Installing can be done with a few commands. Open a terminal and run the followin
9191
9292
# [Ubuntu Core snaps](#tab/snaps)
9393
94-
You install IoT Edge runtime from the snap store in a later step. Continue to the next section.
94+
You install the IoT Edge runtime from the snap store in a later step. Continue to the next section.
9595
9696
---
9797
@@ -102,7 +102,7 @@ For more information about operating system versions, see [Azure IoT Edge suppor
102102
103103
### Install a container engine
104104
105-
Azure IoT Edge relies on an [OCI](https://opencontainers.org/)-compatible container runtime. For production scenarios, we recommend that you use the Moby engine. The Moby engine is the container engine officially supported with IoT Edge. Docker CE/EE container images are compatible with the Moby runtime. If you're using Ubuntu Core snaps, the Docker snap is serviced by Canonical and supported for production scenarios.
105+
Azure IoT Edge relies on an [OCI](https://opencontainers.org/)-compatible container runtime. For production scenarios, use the Moby engine. The Moby engine is the container engine officially supported with IoT Edge. Docker CE and Docker EE container images work with the Moby runtime. If you're using Ubuntu Core snaps, Canonical services the Docker snap and supports it for production scenarios.
106106

107107
# [Ubuntu](#tab/ubuntu)
108108

@@ -139,11 +139,11 @@ Install the Moby engine and CLI.
139139
> ./check-config.sh
140140
> ```
141141
>
142-
> In the output of the script, check that all items under `Generally Necessary` and `Network Drivers` are enabled. If you're missing features, enable them by rebuilding your kernel from source and selecting the associated modules for inclusion in the appropriate kernel .config. Similarly, if you're using a kernel configuration generator like `defconfig` or `menuconfig`, find and enable the respective features and rebuild your kernel accordingly. After you deploy your newly modified kernel, run the check-config script again to verify that all the required features were successfully enabled.
142+
> In the output of the script, check that all items under `Generally Necessary` and `Network Drivers` are enabled. If you're missing features, enable them by rebuilding your kernel from source and selecting the associated modules for inclusion in the appropriate kernel .config. Similarly, if you're using a kernel configuration generator like `defconfig` or `menuconfig`, find and enable the respective features and rebuild your kernel accordingly. After you deploy your newly modified kernel, run the check-config script again to verify that all the required features are successfully enabled.
143143

144144
# [Ubuntu Core snaps](#tab/snaps)
145145

146-
IoT Edge has dependencies on Docker and IoT Identity Service. Install the dependencies using the following commands:
146+
IoT Edge has dependencies on Docker and IoT Identity Service. Install the dependencies by using the following commands:
147147

148148
```bash
149149
sudo snap install docker
@@ -154,21 +154,21 @@ The Docker snap is serviced by Canonical and supported for production scenarios.
154154

155155
---
156156

157-
By default, the container engine doesn't set container log size limits. Over time, this situation can lead to the device filling up with logs and running out of disk space. However, you can configure your log to show locally, though it's optional. To learn more about logging configuration, see [Prepare to deploy your IoT Edge solution in production](../production-checklist.md#set-up-default-logging-driver).
157+
By default, the container engine doesn't set container log size limits. Over time, this situation can lead to the device filling up with logs and running out of disk space. However, you can configure your log to show locally, though it's optional. For more information about logging configuration, see [Prepare to deploy your IoT Edge solution in production](../production-checklist.md#set-up-default-logging-driver).
158158

159-
The following steps show you how to configure your container to use [`local` logging driver](https://docs.docker.com/config/containers/logging/local/) as the logging mechanism.
159+
The following steps show you how to configure your container to use the [`local` logging driver](https://docs.docker.com/config/containers/logging/local/) as the logging mechanism.
160160

161161
# [Ubuntu / Debian / RHEL](#tab/ubuntu+debian+rhel)
162162

163-
1. Create or edit the existing Docker [daemon's config file](https://docs.docker.com/config/daemon/)
163+
1. Create or edit the existing Docker [daemon's config file](https://docs.docker.com/config/daemon/):
164164
165165
```bash
166166
sudo nano /etc/docker/daemon.json
167167
```
168168
169-
1. Set the default logging driver to the `local` logging driver as shown in the example.
169+
1. Set the default logging driver to the `local` logging driver as shown in the example:
170170
171-
```JSON
171+
```json
172172
{
173173
"log-driver": "local"
174174
}
@@ -182,7 +182,7 @@ The following steps show you how to configure your container to use [`local` log
182182
183183
# [Ubuntu Core snaps](#tab/snaps)
184184
185-
Currently, the `local` logging driver setting isn't supported for the Docker snap.
185+
Currently, the Docker snap doesn't support the `local` logging driver setting.
186186

187187
---
188188

@@ -241,7 +241,7 @@ sudo snap install azure-iot-edge
241241
242242
### Connect snaps
243243
244-
By default, snaps are dependency-free, untrusted, and strictly confined. Hence, snaps must be connected to other snaps and system resources after installation. Use the following commands to connect the IoT Identity Service and IoT Edge snaps to each other and to system resources. To get started, snaps need to be manually connected. For production deployments, they can be configured to automatically connect to reduce the provisioning workload.
244+
By default, snaps are dependency-free, untrusted, and strictly confined. Hence, you must connect snaps to other snaps and system resources after installation. Use the following commands to connect the IoT Identity Service and IoT Edge snaps to each other and to system resources. To get started, manually connect the snaps. For production deployments, you can configure them to automatically connect to reduce the provisioning workload.
245245
246246
```bash
247247
#------------------------

articles/iot-edge/includes/iot-edge-prerequisites-device-requirements-linux.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
ms.topic: include
3-
ms.date: 04/29/2025
3+
ms.date: 02/19/2026
44
author: sethmanheim
55
ms.author: sethm
66
ms.service: azure-iot-edge
@@ -10,7 +10,7 @@ services: iot-edge
1010

1111
### Device requirements
1212

13-
An X64, ARM32, or ARM64 Linux device.
13+
An x64, ARM32, or ARM64 Linux device.
1414

1515
Microsoft publishes installation packages for various operating systems.
1616

articles/iot-edge/includes/iot-edge-prerequisites-register-device.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
ms.topic: include
3-
ms.date: 04/29/2025
3+
ms.date: 02/19/2026
44
author: sethmanheim
55
ms.author: sethm
66
ms.service: azure-iot-edge
@@ -9,7 +9,7 @@ services: iot-edge
99

1010
### Device management tools
1111

12-
You can use the **Azure portal**, **Visual Studio Code**, or **Azure CLI** for the steps to register your device. Each utility has its own prerequisites or might need to be installed:
12+
You can use the Azure portal, Visual Studio Code, or the Azure CLI to register your device. Each utility has its own prerequisites or might need to be installed:
1313

1414
# [Portal](#tab/azure-portal)
1515

0 commit comments

Comments
 (0)