Skip to content

Commit 25fa8be

Browse files
committed
Freshness updates for iot ops
1 parent ce49690 commit 25fa8be

8 files changed

Lines changed: 56 additions & 56 deletions

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

Lines changed: 10 additions & 9 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/19/2026
1111
ms.custom:
1212
- linux-related-content
1313
- sfi-ropc-nochange
@@ -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; for example 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)]
@@ -62,7 +62,6 @@ If you're using Visual Studio Code, there are helpful Azure IoT extensions that
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 -->
@@ -81,11 +80,13 @@ Now that the container engine and the IoT Edge runtime are installed on your dev
8180

8281
You can configure your IoT Edge device with symmetric key authentication using the following command:
8382

84-
```bash
85-
sudo iotedge config mp --connection-string 'PASTE_DEVICE_CONNECTION_STRING_HERE'
86-
```
83+
```bash
84+
sudo iotedge config mp --connection-string 'PASTE_DEVICE_CONNECTION_STRING_HERE'
85+
```
86+
87+
The following `iotedge config mp` command creates a configuration file on the device and enters your connection string in the configuration file:
8788

88-
This `iotedge config mp` command creates a configuration file on the device and enters your connection string in the configuration file.
89+
```bash
8990

9091
1. Apply the configuration changes.
9192

@@ -156,13 +157,13 @@ Verify that the runtime was successfully installed and configured on your IoT Ed
156157
157158
A successful status response shows the `aziot` services as running or ready.
158159
159-
1. If you need to troubleshoot the service, retrieve the service logs.
160+
1. If you need to troubleshoot the service, retrieve the service logs:
160161
161162
```bash
162163
sudo iotedge system logs
163164
```
164165
165-
1. Use the `check` tool to verify configuration and connection status of the device.
166+
1. Use the `check` tool to verify configuration and connection status of the device:
166167
167168
```bash
168169
sudo iotedge check

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

Lines changed: 7 additions & 7 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
@@ -67,7 +67,7 @@ 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 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`.
7171
7272
# [Red Hat Enterprise Linux](#tab/rhel)
7373
@@ -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
}

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

Lines changed: 1 addition & 1 deletion
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

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

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

Lines changed: 27 additions & 29 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 @@ ms.custom: sfi-ropc-nochange
1010

1111
## Register your device
1212

13-
You can use the **Azure portal**, **Visual Studio Code**, or **Azure CLI** to register your device, depending on your preference.
13+
You can use the Azure portal, Visual Studio Code, or Azure CLI to register your device, depending on your preference.
1414

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

@@ -41,23 +41,23 @@ Once Azure IoT Edge and Azure IoT Hub extensions are installed, you notice an Az
4141

4242
### Register a new device with Visual Studio Code
4343

44-
Registering a new device is akin to creating an IoT Edge device in the Azure portal. This virtual device is one of the *twins*, whereas the real world device is the other twin. Visual Studio Code can set up this virtual device for you through the following steps.
44+
Registering a new device is similar to creating an IoT Edge device in the Azure portal. This virtual device is one of the *twins*, whereas the real world device is the other twin. Visual Studio Code can set up this virtual device for you through the following steps:
4545

4646
1. In the Visual Studio Code Explorer menu, expand the **Azure IoT Hub** section.
47-
1. Select on the **...** in the **Azure IoT Hub** section header. If you don't see the ellipsis, select or hover over the header.
47+
1. Select the **...** ellipsis in the **Azure IoT Hub** section header. If you don't see the ellipsis, select or hover over the header.
4848
1. Select **Create IoT Edge Device**.
49-
1. In the text box that opens, give your device an ID, for example `my-edge-device-1` (all lowercase), then press enter.
49+
1. In the text box that opens, give your device an ID; for example, `my-edge-device-1` (all lowercase), then press **Enter**.
5050

51-
In the output console of Visual Studio Code, you see the result of the command: a JSON printout. The device information includes the **deviceId** that you provided and generates a **connectionString** that you can use to connect your physical device to your IoT hub. The output console also shows your keys and other device identifying information.
51+
In the output console of Visual Studio Code, you see the result of the command: a JSON printout. The device information includes the **deviceId** that you provided and generates a **connectionString** value that you can use to connect your physical device to your IoT hub. The output console also shows your keys and other device identifying information.
5252

53-
You can now see your device listed under the **Azure IoT Hub** > **Devices** section of the Explorer menu.
53+
You can now see your device listed under the **Azure IoT Hub > Devices** section of the Explorer menu.
5454

5555
> [!NOTE]
5656
> If your device isn't listed, you might need to choose your IoT hub from the link **Select IoT Hub** provided under **Azure IoT Hub** and then follow the prompts. The prompts ask you to choose your subscription first and then your IoT hub. This process lets Visual Studio Code know about your IoT hub (and all devices in it). Refresh Visual Studio Code and your device should show.
5757
5858
# [Azure CLI](#tab/azure-cli)
5959

60-
Use the [az iot hub device-identity create](/cli/azure/iot/hub/device-identity) command to create a new device identity in your IoT hub. Replace `device_id_here` with your own new and unique device ID, for example `my-edge-device-1` (all lowercase). Replace `hub_name_here` with your existing IoT hub.
60+
Use the [`az iot hub device-identity create`](/cli/azure/iot/hub/device-identity) command to create a new device identity in your IoT hub. Replace `device_id_here` with your own new and unique device ID; for example, `my-edge-device-1` (all lowercase). Replace `hub_name_here` with your existing IoT hub.
6161

6262
This command includes three parameters:
6363

@@ -69,53 +69,51 @@ This command includes three parameters:
6969
az iot hub device-identity create --device-id device_id_here --hub-name hub_name_here --edge-enabled
7070
```
7171

72-
If your CLI says **The command requires the extension azure-iot. Do you want to install it now?**, then type `Y` and press `Enter` to initiate the download to create your device.
72+
If your CLI says **The command requires the extension azure-iot. Do you want to install it now?**, type **Y** and press **Enter** to initiate the download and create your device.
7373

7474
---
7575

76-
Now that you have a device registered in IoT Hub, you can retrieve provisioning information used to complete the installation and provisioning of the [IoT Edge runtime](../iot-edge-runtime.md) in the next step.
76+
Now that you have a device registered in IoT Hub, in the next step you can retrieve provisioning information used to complete the installation and provisioning of the [IoT Edge runtime](../iot-edge-runtime.md).
7777

7878
## View registered devices and retrieve provisioning information
7979

80-
Devices that use symmetric key authentication need their connection strings to complete installation and provisioning of the IoT Edge runtime. The connection string gets generated for your IoT Edge device when you create the device. For Visual Studio Code and Azure CLI, the connection string is in the JSON output. If you use the Azure portal to create your device, you can find the connection string from the device itself. When you select your device in your IoT hub, it's listed as `Primary connection string` on the device page.
80+
Devices that use symmetric key authentication need their connection strings to complete installation and provisioning of the IoT Edge runtime. The connection string is generated for your IoT Edge device when you create the device. For Visual Studio Code and Azure CLI, the connection string appears in the JSON output. If you use the Azure portal to create your device, you can find the connection string from the device itself. When you select your device in your IoT hub, it's listed as **Primary connection string** on the device page.
8181

8282
# [Portal](#tab/azure-portal)
8383

84-
The edge-enabled devices that connect to your IoT hub are listed on the **Devices** page of your IoT hub. If you have multiple devices, you can filter the list by selecting the type **Iot Edge Devices**, then select **Apply**.
84+
The edge-enabled devices that connect to your IoT hub are listed on the **Devices** page of your IoT hub. If you have multiple devices, you can filter the list by selecting the **Iot Edge Devices** type, then select **Apply**.
8585

86-
When you're ready to set up your device, you need the connection string that links your physical device with its identity in the IoT hub. Devices that authenticate with symmetric keys have their connection strings available to copy in the portal. To find your connection string in the portal:
86+
When you're ready to set up your device, you need the connection string that links your physical device with its identity in the IoT hub. Devices that authenticate with symmetric keys have their connection strings available to copy in the portal. To find your connection string in the portal, perform the following steps:
8787

8888
1. From the **Devices** page, select the IoT Edge device ID from the list.
8989
2. Copy the value of either **Primary Connection String** or **Secondary Connection String**. Either key works.
9090

9191
# [Visual Studio Code](#tab/visual-studio-code)
9292

93-
All the devices that connect to your IoT hub are listed in the **Azure IoT Hub** section of the Visual Studio Code Explorer. IoT Edge devices are distinguishable from non-Edge devices because they have a different icon and you see the **$edgeAgent** and **$edgeHub** modules are deployed to each IoT Edge device.
93+
All the devices that connect to your IoT hub are listed in the **Azure IoT Hub** section of the Visual Studio Code Explorer. IoT Edge devices are distinguishable from non-edge devices because they have a different icon, and you can see that the **$edgeAgent** and **$edgeHub** modules are deployed to each IoT Edge device.
9494

95-
When you're ready to set up your device, you need the connection string that links your physical device with its identity in the IoT hub. Here's how to get your connection string from Visual Studio Code.
95+
When you're ready to set up your device, you need the connection string that links your physical device with its identity in the IoT hub. Here's how to get your connection string from Visual Studio Code:
9696

97-
1. Right-click on the ID (name) of your device in the **Azure IoT Hub** section.
98-
1. Select **Copy Device Connection String**.
97+
1. Right-click the ID (name) of your device in the **Azure IoT Hub** section.
98+
1. Select **Copy Device Connection String**. The connection string is copied to your clipboard.
9999

100-
The connection string is copied to your clipboard.
101-
102-
You can also select **Get Device Info** from the right-click menu to see all the device info, including the connection string, in the output window.
100+
You can also select **Get Device Info** from the right-click context menu to see all the device info, including the connection string, in the output window.
103101

104102
# [Azure CLI](#tab/azure-cli)
105103

106-
To see all devices in your IoT hub, use the [az iot hub device-identity list](/cli/azure/iot/hub/device-identity) command. Replace `hub_name_here` with your own IoT hub name.
104+
To see all devices in your IoT hub, use the [`az iot hub device-identity list`](/cli/azure/iot/hub/device-identity) command. Replace `hub_name_here` with your own IoT hub name:
107105

108-
```azurecli
109-
az iot hub device-identity list --hub-name hub_name_here
110-
```
106+
```azurecli
107+
az iot hub device-identity list --hub-name hub_name_here
108+
```
111109

112-
Any device that is registered as an IoT Edge device has the property **capabilities.iotEdge** set to **true**. You see a lot of other metadata as JSON output as well, including your device IDs.
110+
Any device that is registered as an IoT Edge device has the property **capabilities.iotEdge** set to **true**. You can see a lot of other metadata as JSON output as well, including your device IDs.
113111

114-
When you're ready to set up your device, you need its connection string that links your physical device with its identity in the IoT hub. Use the following [az iot hub device-identity connection-string show](/cli/azure/iot/hub/device-identity/connection-string) command to return the connection string for a single device. Replace `[device_id]` and `[hub_name]` with your own values. The value for the `device-identity` parameter is case-sensitive.
112+
When you're ready to set up your device, you need its connection string that links your physical device with its identity in the IoT hub. Use the following [`az iot hub device-identity connection-string show`](/cli/azure/iot/hub/device-identity/connection-string) command to return the connection string for a single device. Replace `[device_id]` and `[hub_name]` with your own values. The value for the `device-identity` parameter is case-sensitive.
115113

116-
```azurecli
117-
az iot hub device-identity connection-string show --device-id [device_id] --hub-name [hub_name]
118-
```
114+
```azurecli
115+
az iot hub device-identity connection-string show --device-id [device_id] --hub-name [hub_name]
116+
```
119117

120118
You should see JSON output in the console, similar to the following example:
121119

articles/iot-edge/index.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ metadata:
1010
ms.topic: landing-page
1111
author: sethmanheim
1212
ms.author: sethm
13-
ms.date: 03/31/2025
13+
ms.date: 02/19/2026
1414
ms.custom: e2e-hybrid
1515

1616
landingContent:

0 commit comments

Comments
 (0)