From 4b8261fc6d7fe9d501b554ce9ff0b5447dd715f8 Mon Sep 17 00:00:00 2001 From: kcoriordan Date: Tue, 12 Oct 2021 15:48:28 +0100 Subject: [PATCH] add doc: bootstrap prereq for linux cgroup1 Signed-off-by: kcoriordan --- docs/site/content/docs/assets/prereq-linux.md | 22 +++++++++++++++++++ 1 file changed, 22 insertions(+) diff --git a/docs/site/content/docs/assets/prereq-linux.md b/docs/site/content/docs/assets/prereq-linux.md index 44c1f38372..31823e5119 100644 --- a/docs/site/content/docs/assets/prereq-linux.md +++ b/docs/site/content/docs/assets/prereq-linux.md @@ -7,3 +7,25 @@ |[Kubectl](https://kubernetes.io/docs/tasks/tools/install-kubectl-linux/) | |Latest version of Chrome, Firefox, Safari, Internet Explorer, or Edge| |System time is synchronized with a Network Time Protocol (NTP) server.| +|Ensure your Linux bootstrap machine is using cgroup v1, for more information, see **Check and set the cgroup** below.| + +#### Check and set the cgroup + +1. Check the cgroup by running the following command: + + ```sh + docker info | grep -i cgroup + ``` + + You should see the following output: + + ```sh + Cgroup Driver: cgroupfs + Cgroup Version: 1 + ``` + +2. If your Linux distribution is configured to use cgroups v2, you will need to set the `system.unified_cgroup_hierarchy=0` kernel parameter to restore cgroups v1. See the instructions for setting kernel parameters for your Linux distribution, including: + + [Fedora 32+](https://fedoramagazine.org/docker-and-fedora-32/) + [Arch Linux](https://wiki.archlinux.org/title/Kernel_parameters) + [OpenSUSE](https://doc.opensuse.org/documentation/leap/reference/html/book-reference/cha-grub2.html)