Skip to content

Commit 22fe436

Browse files
committed
Edited screenshots and their instruction
1 parent 1871ed1 commit 22fe436

File tree

3 files changed

+47
-39
lines changed

3 files changed

+47
-39
lines changed
28.2 KB
Loading
24.6 KB
Loading

articles/iot-edge/troubleshoot-common-errors.md

Lines changed: 47 additions & 39 deletions
Original file line numberDiff line numberDiff line change
@@ -254,9 +254,9 @@ In the Azure portal:
254254

255255
4. Select **Runtime Settings**.
256256

257-
5. In the **Edge Hub** module settings, delete everything from the **Create Options** text box.
257+
5. In the **Edge Hub** module settings, delete everything from the **Container Create Options** text box.
258258

259-
6. Save your changes and create the deployment.
259+
6. Select **Apply** to save your changes and create the deployment.
260260

261261
In the deployment.json file:
262262

@@ -265,31 +265,30 @@ In the deployment.json file:
265265
2. Find the `edgeHub` settings in the edgeAgent desired properties section:
266266

267267
```json
268-
"edgeHub": {
269-
"settings": {
270-
"image": "mcr.microsoft.com/azureiotedge-hub:1.1",
271-
"createOptions": "{\"HostConfig\":{\"PortBindings\":{\"8883/tcp\":[{\"HostPort\":\"8883\"}],\"443/tcp\":[{\"HostPort\":\"443\"}]}}}"
272-
},
273-
"type": "docker",
274-
"status": "running",
275-
"restartPolicy": "always"
276-
}
268+
"edgeHub": {
269+
"restartPolicy": "always",
270+
"settings": {
271+
"image": "mcr.microsoft.com/azureiotedge-hub:1.4",
272+
"createOptions": "{\"HostConfig\":{\"PortBindings\":{\"443/tcp\":[{\"HostPort\":\"443\"}],\"5671/tcp\":[{\"HostPort\":\"5671\"}],\"8883/tcp\":[{\"HostPort\":\"8883\"}]}}}"
273+
},
274+
"status": "running",
275+
"type": "docker"
276+
}
277277
```
278278

279279
3. Remove the `createOptions` line, and the trailing comma at the end of the `image` line before it:
280280

281281
```json
282-
"edgeHub": {
283-
"settings": {
284-
"image": "mcr.microsoft.com/azureiotedge-hub:1.1"
285-
},
286-
"type": "docker",
287-
"status": "running",
288-
"restartPolicy": "always"
282+
"edgeHub": {
283+
"restartPolicy": "always",
284+
"settings": {
285+
"image": "mcr.microsoft.com/azureiotedge-hub:1.4",
286+
"status": "running",
287+
"type": "docker"
289288
}
290289
```
291290

292-
4. Save the file and apply it to your IoT Edge device again.
291+
4. Select **Create** to apply it to your IoT Edge device again.
293292

294293
### IoT Edge module fails to send a message to edgeHub with 404 error
295294

@@ -329,25 +328,33 @@ For the IoT Edge hub, set an environment variable **OptimizeForPerformance** to
329328

330329
In the Azure portal:
331330

332-
In your IoT Hub, select your IoT Edge device and from the device details page and select **Set Modules** > **Runtime Settings**. Create an environment variable for the IoT Edge hub module called *OptimizeForPerformance* that is set to *false*.
331+
1. In your IoT Hub, select your IoT Edge device and from the device details page and select **Set Modules** > **Runtime Settings**.
332+
1. Create an environment variable for the IoT Edge hub module called *OptimizeForPerformance* with type *True/False* that is set to *False*.
333333

334-
![OptimizeForPerformance set to false](./media/troubleshoot/optimizeforperformance-false.png)
334+
:::image type="content" source="./media/troubleshoot/optimizeforperformance-false.png" alt-text="Screenshot that shows where to add the OptimizeForPerformance environment variable in the Azure portal.":::
335335

336-
In the deployment manifest:
336+
1. Select **Apply** to save changes, then select **Review + create**.
337337

338-
```json
339-
"edgeHub": {
340-
"type": "docker",
341-
"settings": {
342-
"image": "mcr.microsoft.com/azureiotedge-hub:1.1",
343-
"createOptions": <snipped>
344-
},
345-
"env": {
346-
"OptimizeForPerformance": {
347-
"value": "false"
348-
}
349-
},
350-
```
338+
The environment variable is now in the `edgeHub` property of the deployment manifest:
339+
340+
```json
341+
"edgeHub": {
342+
"env": {
343+
"OptimizeForPerformance": {
344+
"value": false
345+
}
346+
},
347+
"restartPolicy": "always",
348+
"settings": {
349+
"image": "mcr.microsoft.com/azureiotedge-hub:1.4",
350+
"createOptions": "{\"HostConfig\":{\"PortBindings\":{\"443/tcp\":[{\"HostPort\":\"443\"}],\"5671/tcp\":[{\"HostPort\":\"5671\"}],\"8883/tcp\":[{\"HostPort\":\"8883\"}]}}}"
351+
},
352+
"status": "running",
353+
"type": "docker"
354+
}
355+
```
356+
357+
1. Select **Create** to save your changes and deploy the module.
351358

352359
### Security daemon couldn't start successfully
353360

@@ -443,13 +450,14 @@ When you see this error, you can resolve it by configuring the DNS name of your
443450

444451
1. In the Azure portal, navigate to the overview page of your virtual machine.
445452

446-
2. Select **configure** under DNS name. If your virtual machine already has a DNS name configured, you don't need to configure a new one.
453+
2. Open the configuration panel by selecting **Not configured** (if your virtual machine is new) under DNS name, or select your existing DNS name. If your virtual machine already has a DNS name configured, you don't need to configure a new one.
447454
448-
![Configure DNS name of virtual machine](./media/troubleshoot/configure-dns.png)
455+
:::image type="content" source="./media/troubleshoot/configure-dns.png" alt-text="Screenshot of how to open the configuration panel of your DNS name.":::
449456
450-
3. Provide a value for **DNS name label** and select **Save**.
457+
3. Provide a value for **DNS name label** if you don't have one already and select **Save**.
451458

452-
4. Copy the new DNS name, which should be in the format **\<DNSnamelabel\>.\<vmlocation\>.cloudapp.azure.com**.
459+
4. Copy the new DNS name, which should be in the format: <br>
460+
**\<DNSnamelabel\>.\<vmlocation\>.cloudapp.azure.com**.
453461

454462
5. On the IoT Edge device, open the config file.
455463

0 commit comments

Comments
 (0)