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: content/en/docs/installation/installation-windows.md
+25-5Lines changed: 25 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -14,11 +14,23 @@ With WSL you are working with a real Linux distribution (e.g. Ubuntu). Therefore
14
14
15
15
If you ever get stuck during this installation, be sure to reboot WSL once. It may help to correctly load some configurations and/or daemons.
16
16
17
-
## Docker Desktop for Windows
17
+
## Installation of Docker
18
18
19
-
Docker provides a great installation help on their website: [https://docs.docker.com/desktop/install/windows-install/](https://docs.docker.com/desktop/install/windows-install/)
19
+
There are two different ways to install and use Docker:
20
20
21
-
You can just use the Docker Desktop for Windows bundle. Make sure the WSL 2 feature is enabled.
21
+
- Docker Desktop for Windows (with WSL 2 backend)
22
+
- Native Docker installation inside of WSL 2
23
+
24
+
[Docker Desktop for Windows](https://docs.docker.com/desktop/install/windows-install/) provides an easy way to install Docker on your system.
25
+
Using it for GMT comes with the following issues:
26
+
27
+
- possible license issues (commercial use of Docker Desktop in larger enterprises required a paid subscription)
28
+
- resource overhead (due to extra VM `docker-desktop`)
29
+
- the metric provider [Network IO - cgroup - container]({{< relref "/docs/measuring/metric-providers/network-io-cgroup-container" >}}) does not work due to the virtualization barrier between the container processes (running inside the special environment `docker-desktop`) and the default WSL environment (e.g. `ubuntu`)
30
+
- PID resolution fails: `cgroup.procs` files contain placeholder values (typically "0") instead of actual container PIDs
If one of the mentioned issues is a problem for you, consider installing Docker natively inside of your prefered WSL 2 distribution (e.g. [Ubuntu](https://docs.docker.com/engine/install/ubuntu/)).
22
34
23
35
## Setup
24
36
@@ -29,7 +41,7 @@ Before following the setup instructions given in [Installation on Linux →]({{<
29
41
Required changes:
30
42
31
43
- Disable automatic generation of hosts file
32
-
- Enable systemd (install script currently enforces the usage of systemd)
@@ -66,7 +79,7 @@ To be able to access the frontend and the API of the GMT, you have to add the UR
66
79
67
80
### Enable CGroups v2
68
81
69
-
This is an optional step, but necessary to be able to get container specific metrics like CPU utilization and memory usage (see section [Metric providers](#metric-providers) below for more information).
82
+
This is an optional step, but necessary to be able to get container specific metrics like CPU utilization, memory usage, network transfer and disk I/O (see section [Metric providers](#metric-providers) below for more information).
70
83
71
84
Create the file `%USERPROFILE%\.wslconfig` (or edit it) and add the following content:
72
85
@@ -97,6 +110,13 @@ However, for testing your usage scenarios you can use at least the following met
0 commit comments