Preflight check failures
When vNode starts on a node, the vnode-manager runs preflight checks that verify the node meets the minimum kernel, cgroup, and containerd requirements. If a check fails, the manager logs an error and does not configure the runtime. Pods scheduled to use vNode remain stuck in ContainerCreating.
To view the startup logs for the vnode-manager on a specific node:
kubectl logs -n vnode-runtime -l app=vnode-runtime --prefix | grep -i "preflight\|check\|kernel\|cgroup\|containerd"
See kernel and runtime compatibility for the full version requirements.
Kernel version check failed
The vnode-manager checks the kernel version at startup. A log line similar to the following indicates the check failed:
preflight: kernel version check failed: detected 5.15.0, minimum required is 6.1
Diagnose on the affected node:
uname -r
The output must show version 6.1 or later. A kernel below 6.1 must be upgraded before vNode can run on that node. See kernel and runtime compatibility for the minimum and recommended kernel versions.
cgroup v2 check failed
The vnode-manager checks that cgroup v2 is active. A log line similar to the following indicates cgroup v1 is in use:
preflight: cgroup check failed: cgroup v1 detected, vNode requires cgroup v2 (cgroup2fs)
Diagnose on the affected node:
stat -fc %T /sys/fs/cgroup/
| Output | cgroup version |
|---|---|
cgroup2fs | v2 (required) |
tmpfs | v1 (not supported) |
If the output is tmpfs, the node is running cgroup v1. cgroup v1 is not supported. Reconfigure the node to use cgroup v2 and reboot. See kernel and runtime compatibility for details.
containerd version check failed
The vnode-manager checks that a supported containerd version is installed. A log line similar to the following indicates an unsupported version was found:
preflight: containerd version check failed: detected 1.6.28, supported versions are 1.7.x and 2.0.x
Diagnose on the affected node:
containerd --version
Upgrade containerd to a supported version (1.7 or 2.0) and restart the DaemonSet. See kernel and runtime compatibility for supported containerd versions.