Updates

_gatsby/slices/_gatsby-scripts-1.html

@@ -4,4 +4,4 @@
           >
             window.___chunkMapping="{\"app\":[\"/app-74c53b7be39893db3ecb.js\"],\"component---src-pages-404-js\":[\"/component---src-pages-404-js-a3455995e64cdd2229de.js\"],\"component---src-pages-docs-js\":[\"/component---src-pages-docs-js-d3cecf1c9db35f62a3b8.js\"],\"component---src-pages-getting-started-js\":[\"/component---src-pages-getting-started-js-fea2017453f2baeeccbb.js\"],\"component---src-pages-help-js\":[\"/component---src-pages-help-js-403cc5dfc38f2a598901.js\"],\"component---src-pages-index-js\":[\"/component---src-pages-index-js-de3bb2f743bfc3680992.js\"],\"component---src-pages-markdown-remark-frontmatter-slug-js\":[\"/component---src-pages-markdown-remark-frontmatter-slug-js-245c3a40133e425611eb.js\"],\"component---src-pages-news-js\":[\"/component---src-pages-news-js-7d3caad3a358f6e87530.js\"]}";
           </script>
-        <script>window.___webpackCompilationHash="bd78071ba95d09efaf55";</script><script src="/webpack-runtime-ee1787d0ddec2f7e42d6.js" async></script><script src="/framework-3df8a0b44e3c899c27c9.js" async></script><script src="/app-74c53b7be39893db3ecb.js" async></script>
+        <script>window.___webpackCompilationHash="322c52ecdd81aac5ede5";</script><script src="/webpack-runtime-9b27b71b75df772c4c41.js" async></script><script src="/framework-3df8a0b44e3c899c27c9.js" async></script><script src="/app-74c53b7be39893db3ecb.js" async></script>

docs/main/_sources/contents/known-issues.rst.txt

@@ -0,0 +1,37 @@
+============
+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/``.

docs/main/_sources/index.rst.txt

@@ -29,6 +29,7 @@ Welcome to the Warewulf User Guide!
    Templating <contents/templating>
    dnsmasq <contents/dnsmasq>
    Troubleshooting <contents/troubleshooting>
+   Known issues <contents/known-issues>
 
 .. toctree::
    :maxdepth: 2

docs/main/contents/background.html

@@ -68,6 +68,7 @@
 <li class="toctree-l1"><a class="reference internal" href="templating.html">Templating</a></li>
 <li class="toctree-l1"><a class="reference internal" href="dnsmasq.html">dnsmasq</a></li>
 <li class="toctree-l1"><a class="reference internal" href="troubleshooting.html">Troubleshooting</a></li>
+<li class="toctree-l1"><a class="reference internal" href="known-issues.html">Known issues</a></li>
 </ul>
 <p class="caption" role="heading"><span class="caption-text">Quickstart</span></p>
 <ul>

docs/main/contents/boot-management.html

@@ -87,6 +87,7 @@
 <li class="toctree-l1"><a class="reference internal" href="templating.html">Templating</a></li>
 <li class="toctree-l1"><a class="reference internal" href="dnsmasq.html">dnsmasq</a></li>
 <li class="toctree-l1"><a class="reference internal" href="troubleshooting.html">Troubleshooting</a></li>
+<li class="toctree-l1"><a class="reference internal" href="known-issues.html">Known issues</a></li>
 </ul>
 <p class="caption" role="heading"><span class="caption-text">Quickstart</span></p>
 <ul>

docs/main/contents/configuration.html

@@ -78,6 +78,7 @@
 <li class="toctree-l1"><a class="reference internal" href="templating.html">Templating</a></li>
 <li class="toctree-l1"><a class="reference internal" href="dnsmasq.html">dnsmasq</a></li>
 <li class="toctree-l1"><a class="reference internal" href="troubleshooting.html">Troubleshooting</a></li>
+<li class="toctree-l1"><a class="reference internal" href="known-issues.html">Known issues</a></li>
 </ul>
 <p class="caption" role="heading"><span class="caption-text">Quickstart</span></p>
 <ul>

docs/main/contents/containers.html

@@ -95,6 +95,7 @@
 <li class="toctree-l1"><a class="reference internal" href="templating.html">Templating</a></li>
 <li class="toctree-l1"><a class="reference internal" href="dnsmasq.html">dnsmasq</a></li>
 <li class="toctree-l1"><a class="reference internal" href="troubleshooting.html">Troubleshooting</a></li>
+<li class="toctree-l1"><a class="reference internal" href="known-issues.html">Known issues</a></li>
 </ul>
 <p class="caption" role="heading"><span class="caption-text">Quickstart</span></p>
 <ul>

docs/main/contents/disks.html

@@ -80,6 +80,7 @@
 <li class="toctree-l1"><a class="reference internal" href="templating.html">Templating</a></li>
 <li class="toctree-l1"><a class="reference internal" href="dnsmasq.html">dnsmasq</a></li>
 <li class="toctree-l1"><a class="reference internal" href="troubleshooting.html">Troubleshooting</a></li>
+<li class="toctree-l1"><a class="reference internal" href="known-issues.html">Known issues</a></li>
 </ul>
 <p class="caption" role="heading"><span class="caption-text">Quickstart</span></p>
 <ul>

docs/main/contents/dnsmasq.html

@@ -74,6 +74,7 @@
 </ul>
 </li>
 <li class="toctree-l1"><a class="reference internal" href="troubleshooting.html">Troubleshooting</a></li>
+<li class="toctree-l1"><a class="reference internal" href="known-issues.html">Known issues</a></li>
 </ul>
 <p class="caption" role="heading"><span class="caption-text">Quickstart</span></p>
 <ul>

docs/main/contents/glossary.html

@@ -67,6 +67,7 @@
 <li class="toctree-l1"><a class="reference internal" href="templating.html">Templating</a></li>
 <li class="toctree-l1"><a class="reference internal" href="dnsmasq.html">dnsmasq</a></li>
 <li class="toctree-l1"><a class="reference internal" href="troubleshooting.html">Troubleshooting</a></li>
+<li class="toctree-l1"><a class="reference internal" href="known-issues.html">Known issues</a></li>
 </ul>
 <p class="caption" role="heading"><span class="caption-text">Quickstart</span></p>
 <ul>

docs/main/contents/initialization.html

@@ -72,6 +72,7 @@
 <li class="toctree-l1"><a class="reference internal" href="templating.html">Templating</a></li>
 <li class="toctree-l1"><a class="reference internal" href="dnsmasq.html">dnsmasq</a></li>
 <li class="toctree-l1"><a class="reference internal" href="troubleshooting.html">Troubleshooting</a></li>
+<li class="toctree-l1"><a class="reference internal" href="known-issues.html">Known issues</a></li>
 </ul>
 <p class="caption" role="heading"><span class="caption-text">Quickstart</span></p>
 <ul>

docs/main/contents/installation.html

@@ -86,6 +86,7 @@
 <li class="toctree-l1"><a class="reference internal" href="templating.html">Templating</a></li>
 <li class="toctree-l1"><a class="reference internal" href="dnsmasq.html">dnsmasq</a></li>
 <li class="toctree-l1"><a class="reference internal" href="troubleshooting.html">Troubleshooting</a></li>
+<li class="toctree-l1"><a class="reference internal" href="known-issues.html">Known issues</a></li>
 </ul>
 <p class="caption" role="heading"><span class="caption-text">Quickstart</span></p>
 <ul>

docs/main/contents/introduction.html

@@ -73,6 +73,7 @@
 <li class="toctree-l1"><a class="reference internal" href="templating.html">Templating</a></li>
 <li class="toctree-l1"><a class="reference internal" href="dnsmasq.html">dnsmasq</a></li>
 <li class="toctree-l1"><a class="reference internal" href="troubleshooting.html">Troubleshooting</a></li>
+<li class="toctree-l1"><a class="reference internal" href="known-issues.html">Known issues</a></li>
 </ul>
 <p class="caption" role="heading"><span class="caption-text">Quickstart</span></p>
 <ul>

docs/main/contents/ipmi.html

@@ -80,6 +80,7 @@
 <li class="toctree-l1"><a class="reference internal" href="templating.html">Templating</a></li>
 <li class="toctree-l1"><a class="reference internal" href="dnsmasq.html">dnsmasq</a></li>
 <li class="toctree-l1"><a class="reference internal" href="troubleshooting.html">Troubleshooting</a></li>
+<li class="toctree-l1"><a class="reference internal" href="known-issues.html">Known issues</a></li>
 </ul>
 <p class="caption" role="heading"><span class="caption-text">Quickstart</span></p>
 <ul>

docs/main/contents/kernel.html

@@ -75,6 +75,7 @@
 <li class="toctree-l1"><a class="reference internal" href="templating.html">Templating</a></li>
 <li class="toctree-l1"><a class="reference internal" href="dnsmasq.html">dnsmasq</a></li>
 <li class="toctree-l1"><a class="reference internal" href="troubleshooting.html">Troubleshooting</a></li>
+<li class="toctree-l1"><a class="reference internal" href="known-issues.html">Known issues</a></li>
 </ul>
 <p class="caption" role="heading"><span class="caption-text">Quickstart</span></p>
 <ul>