Files
warewulf/userdocs/contents/kernel.rst
Jonathon Anderson 8f21d54243 Refactor kernel support
- Remove kernel imports and kmods images
- Repurpose KernelOverride as container path
- Support Kernel.Version as version prefix for kernel selection
- Compare initramfs by version

Signed-off-by: Jonathon Anderson <janderson@ciq.com>
2024-12-09 10:02:22 +01:00

42 lines
1.8 KiB
ReStructuredText

=================
Kernel Management
=================
Warewulf nodes require a Linux kernel to boot. As of Warewulf v4.6, the kernel
you wish to use must be present in the relevant container. Warewulf locates and
provisions the kernel automatically for any node configured to use that
container image.
You can see what kernels are available in imported containers by using the
``wwctl container list`` command:
.. code-block:: console
# wwctl kernel list
Container Kernel Version Preferred Nodes
--------- ------ ------- --------- -----
newroot-test /boot/vmlinuz-5.14.0-427.37.1.el9_4.aarch64 5.14.0-427.37.1 true 0
newroot-test /lib/modules/5.14.0-427.37.1.el9_4.aarch64/vmlinuz 5.14.0-427.37.1 false 0
rocky-8 /boot/vmlinuz-4.18.0-372.13.1.el8_6.x86_64 4.18.0-372.13.1 true 2
rocky-8 /lib/modules/4.18.0-372.13.1.el8_6.x86_64/vmlinuz 4.18.0-372.13.1 false 0
rocky-9.3 /lib/modules/5.14.0-362.13.1.el9_3.aarch64/vmlinuz 5.14.0-362.13.1 true 0
rockylinux-9-custom /lib/modules/5.14.0-427.40.1.el9_4.aarch64/vmlinuz 5.14.0-427.40.1 true 0
Kernel Version and Override
===========================
If a container includes multiple kernels, the desired kernel may be selected by
specifying the desired version or an explicit override.
``--kernelversion`` specifies the desired kernel version.
.. code-block:: console
# wwctl node set n1 --kernelversion=4.18.0-372.13.1
``--kerneloverride`` specifies the full path to the desired kernel.
.. code-block:: console
# wwctl node set n1 --kerneloverride=/boot/vmlinuz-4.18.0-372.13.1.el8_6.x86_64