Files
warewulf/userdocs/contents/known-issues.rst
Jonathon Anderson 0518af3da2 Initial documentation for "known issues"
Signed-off-by: Jonathon Anderson <janderson@ciq.com>
2024-12-03 16:24:32 -07:00

38 lines
1.6 KiB
ReStructuredText

============
Known issues
============
SELinux and IPMI write not working when using two-stage boot
============================================================
The dracut implementation of two-stage boot in versions of Warewulf prior to v4.6.0 bypasses the
``wwinit`` process by default, invoking the image's init system directly. While cluster nodes will
often still boot mostly successfully this way, features implemented by wwinit will not complete. In
particular, SELinux relabeling and IPMI write are not executed.
To ensure that dracut runs the full ``wwinit`` process, pass ``init=/init`` or
``init=/warewulf/wwinit`` on the kernel command line.
.. code-block:: bash
# wwctl profile set default --kernelargs="init=/init"
Containers are read-only
========================
Warewulf v4.5 uses the permissions on a container's ``rootfs/`` to determine a "read-only" state of
the container: if the root directory of the container image is ``u-w``, it will be mounted read-only
during ``wwctl container <exec|shell``, preventing interactive changes to the container image.
In the past, the root directory was ``u+w``, but Enterprise Linux 9.5 (including Red Hat, Rocky, _et
al._) includes an update to the ``filesystem`` package that marks the root directory ``u-w``. This
causes Warewulf container images to be "read only" by default.
To mark a Warewulf container as writeable, use `chmod u+w`.
.. code-block:: bash
# chmod u+w $(wwctl container show rockylinux-9.5)
This behavior is changed in v4.6 to use an explicit ``readonly`` file stored outside of ``rootfs/``.