From afc411406849caefdba38f08b7a2fc7d3e9520b1 Mon Sep 17 00:00:00 2001 From: Dominic Giebert Date: Thu, 11 Aug 2022 09:46:22 +0200 Subject: [PATCH 1/3] Added warning for cgroups to single node docker --- .../single-node-docker/_index.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/content/rancher/v2.6/en/installation/other-installation-methods/single-node-docker/_index.md b/content/rancher/v2.6/en/installation/other-installation-methods/single-node-docker/_index.md index a52c192fe8..816b92d297 100644 --- a/content/rancher/v2.6/en/installation/other-installation-methods/single-node-docker/_index.md +++ b/content/rancher/v2.6/en/installation/other-installation-methods/single-node-docker/_index.md @@ -186,6 +186,20 @@ Refer to [this page](./advanced) for details. Refer to [this page](./troubleshooting) for frequently asked questions and troubleshooting tips. +### Known Issues + +Newer operating systems switched to [cgroups v2](https://docs.kernel.org/admin-guide/cgroup-v2.html) instead of the older cgroups v1, which will make the rancher/rancher container crash. + +To see wether your system is effected, check for the existence of the cgroup.controller: + +```bash +$ cat /sys/fs/cgroup/cgroup.controllers + +cpuset cpu io memory hugetlb pids rdma +``` + +In this case it is recommend to use a local single node k3s Kubernetes cluster ([k3s](https://rancher.com/docs/k3s/latest/en/installation/install-options/) + [helm](https://rancher.com/docs/rancher/v2.6/en/installation/install-rancher-on-k8s/)) + ## What's Next? - **Recommended:** Review [Single Node Backup and Restore]({{}}/rancher/v2.6/en/backups/docker-installs). Although you don't have any data you need to back up right now, we recommend creating backups after regular Rancher use. From 9aba4cd88769f766a68e9bc211e69d3591fbfb33 Mon Sep 17 00:00:00 2001 From: Dominic Giebert Date: Thu, 18 Aug 2022 10:09:27 +0200 Subject: [PATCH 2/3] Implement feedback --- .../other-installation-methods/single-node-docker/_index.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/content/rancher/v2.6/en/installation/other-installation-methods/single-node-docker/_index.md b/content/rancher/v2.6/en/installation/other-installation-methods/single-node-docker/_index.md index 816b92d297..8108f6629c 100644 --- a/content/rancher/v2.6/en/installation/other-installation-methods/single-node-docker/_index.md +++ b/content/rancher/v2.6/en/installation/other-installation-methods/single-node-docker/_index.md @@ -188,9 +188,9 @@ Refer to [this page](./troubleshooting) for frequently asked questions and troub ### Known Issues -Newer operating systems switched to [cgroups v2](https://docs.kernel.org/admin-guide/cgroup-v2.html) instead of the older cgroups v1, which will make the rancher/rancher container crash. +Newer operating systems have switched to [cgroups v2](https://docs.kernel.org/admin-guide/cgroup-v2.html), which will make the rancher/rancher container crash. -To see wether your system is effected, check for the existence of the cgroup.controller: +To see whether your system is affected, check for the existence of the cgroup.controller: ```bash $ cat /sys/fs/cgroup/cgroup.controllers @@ -198,7 +198,7 @@ $ cat /sys/fs/cgroup/cgroup.controllers cpuset cpu io memory hugetlb pids rdma ``` -In this case it is recommend to use a local single node k3s Kubernetes cluster ([k3s](https://rancher.com/docs/k3s/latest/en/installation/install-options/) + [helm](https://rancher.com/docs/rancher/v2.6/en/installation/install-rancher-on-k8s/)) +In this case, it is recommend to use a local single node K3s Kubernetes cluster ([K3s](https://rancher.com/docs/k3s/latest/en/installation/install-options/) + [Helm](https://rancher.com/docs/rancher/v2.6/en/installation/install-rancher-on-k8s/)). ## What's Next? From 241927375263291eade11f4798ae7ca96a1472c2 Mon Sep 17 00:00:00 2001 From: Dominic Giebert Date: Thu, 18 Aug 2022 10:12:55 +0200 Subject: [PATCH 3/3] Remove incorrect coma --- .../other-installation-methods/single-node-docker/_index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/rancher/v2.6/en/installation/other-installation-methods/single-node-docker/_index.md b/content/rancher/v2.6/en/installation/other-installation-methods/single-node-docker/_index.md index 8108f6629c..af55d8ffaa 100644 --- a/content/rancher/v2.6/en/installation/other-installation-methods/single-node-docker/_index.md +++ b/content/rancher/v2.6/en/installation/other-installation-methods/single-node-docker/_index.md @@ -188,7 +188,7 @@ Refer to [this page](./troubleshooting) for frequently asked questions and troub ### Known Issues -Newer operating systems have switched to [cgroups v2](https://docs.kernel.org/admin-guide/cgroup-v2.html), which will make the rancher/rancher container crash. +Newer operating systems have switched to [cgroups v2](https://docs.kernel.org/admin-guide/cgroup-v2.html) which will make the rancher/rancher container crash. To see whether your system is affected, check for the existence of the cgroup.controller: