diff --git a/docs/Troubleshooting.md b/docs/Troubleshooting.md index f621823..bc81456 100644 --- a/docs/Troubleshooting.md +++ b/docs/Troubleshooting.md @@ -7,24 +7,57 @@ If your files are not updating you should check the [maximum permitted `inotify` The way some editors behave on save means the inumber of the file does not change, so unison does not pick up a difference and the files in your containers do not update. Notable culprits are `vim` and `Atom`. In both cases there are fixes - for example the `local-history` plugin for `Atom` forces it to behave as we need. If you have mysterious issues with files not changing in your containers and it isn't the `inotify` watcher limit above, check how your editor behaves. ## Cgroup Issues + If your ce-dev is failing to even start the controller then you'll see a response that looks like this. -``` + +```bash Creating ce_dev_controller ... done Ensure user UID match those on the host... Ensure user UID match those on the host... ! Error: Command failed: sudo docker exec ce_dev_controller /bin/sh /opt/ce-dev-ownership.sh 1000 1000 ``` + There will be very little in the way of logs or errors from this. Just an indication of a problem. +### Ubuntu 21.x + It turns out that if you are using Ubuntu 21.10 (or POP! OS) then it will be using kernelstub and not grub. This might create incompatabilities between docker and cgroup version 2. To fix this you need to run the following commands. -``` -sudo kernelstub -a "systemd.unified_cgroup_hierarchy=0" +```bash +sudo kernelstub -a "systemd.unified_cgroup_hierarchy=0" sudo update-initramfs -c -k all ``` They will take a while to run (about 10 minutes), but once complete reboot your machine and delete any created containers that velong to the ce_dev image. When you rebuild the ce-dev controller (by running any command) it should create fine. +### Ubuntu 22.x + +The resolution steps are similar to the ones above for `Ubuntu:21.x`, except that `Ubuntu:22.x` doesn't use `kernelstub`, so the changes have to be made in the grub file instead: + +1 - Edit the grub file in your editor of choice. + +```bash +sudo vi /etc/default/grub +``` + +2 - Modify the line for `GRUB_CMDLINE_LINUX_DEFAULT`, with the following value: + +```bash +GRUB_CMDLINE_LINUX_DEFAULT="systemd.unified_cgroup_hierarchy=0 quiet splash" +``` + +3 - Force a refresh of the system grub and an update of `initramfs` images: + +```bash +sudo update-grub +sudo update-initramfs -c -k all +``` + +4 - Lastly, ensure all existing containers are removed: + +```bash +docker rm $(docker ps -aq) + ### Cgroup On Older Projects ce-dev does allow for the use of Cgroup 2, but some older projects will need upgrading to allow this to work. This means that the ce-dev controller will work fine, but some projects may fail to start some containers. This error will become apparent if you see the "unreachable" error when running the `ce-dev provision` step.