Skip to content

Commit 41d6d36

Browse files
committed
Change local driver support for docker
1 parent 9033331 commit 41d6d36

File tree

1 file changed

+18
-28
lines changed

1 file changed

+18
-28
lines changed

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

Lines changed: 18 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
ms.topic: include
3-
ms.date: 02/27/2024
3+
ms.date: 03/11/2024
44
author: PatAltimore
55
ms.author: patricka
66
ms.service: iot-edge
@@ -111,6 +111,17 @@ Install the Moby engine and CLI.
111111
sudo yum install moby-engine moby-cli
112112
```
113113

114+
> [!TIP]
115+
> If you get errors when you install the Moby container engine, verify your Linux kernel for Moby compatibility. Some embedded device manufacturers ship device images that contain custom Linux kernels without the features required for container engine compatibility. Run the following command, which uses the [check-config script](https://github.com/moby/moby/blob/master/contrib/check-config.sh) provided by Moby, to check your kernel configuration:
116+
>
117+
> ```bash
118+
> curl -ssl https://raw.githubusercontent.com/moby/moby/master/contrib/check-config.sh -o check-config.sh
119+
> chmod +x check-config.sh
120+
> ./check-config.sh
121+
> ```
122+
>
123+
> 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've deployed your newly modified kernel, run the check-config script again to verify that all the required features were successfully enabled.
124+
114125
# [Ubuntu Core snaps](#tab/snaps)
115126
116127
IoT Edge has dependencies on Docker and IoT Identity Service. Install the dependencies using the following commands:
@@ -134,47 +145,26 @@ The following steps show you how to configure your container to use [`local` log
134145
sudo nano /etc/docker/daemon.json
135146
```
136147

137-
# [Ubuntu Core snaps](#tab/snaps)
138-
139-
```bash
140-
sudo nano /var/snap/docker/current/config/daemon.json
141-
```
142-
143-
---
144-
145148
1. Set the default logging driver to the `local` logging driver as shown in the example.
146-
149+
147150
```JSON
148151
{
149152
"log-driver": "local"
150153
}
151154
```
152-
1. Restart the container engine for the changes to take effect.
153155

154-
# [Ubuntu / Debian / RHEL](#tab/ubuntu+debian+rhel)
156+
1. Restart the container engine for the changes to take effect.
155157

156158
```bash
157159
sudo systemctl restart docker
158160
```
159161

160-
# [Ubuntu Core snaps](#tab/snaps)
162+
# [Ubuntu Core snaps](#tab/snaps)
163+
164+
Currently, the local logging driver setting is not supported for the Docker snap.
161165

162-
```bash
163-
sudo systemctl restart snap.docker.dockerd.service
164-
```
166+
---
165167

166-
---
167-
168-
> [!TIP]
169-
> If you get errors when you install the Moby container engine, verify your Linux kernel for Moby compatibility. Some embedded device manufacturers ship device images that contain custom Linux kernels without the features required for container engine compatibility. Run the following command, which uses the [check-config script](https://github.com/moby/moby/blob/master/contrib/check-config.sh) provided by Moby, to check your kernel configuration:
170-
>
171-
> ```bash
172-
> curl -ssl https://raw.githubusercontent.com/moby/moby/master/contrib/check-config.sh -o check-config.sh
173-
> chmod +x check-config.sh
174-
> ./check-config.sh
175-
> ```
176-
>
177-
> 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've deployed your newly modified kernel, run the check-config script again to verify that all the required features were successfully enabled.
178168

179169
### Install the IoT Edge runtime
180170

0 commit comments

Comments
 (0)