Update main docs

Author: actions-user

static/docs/main/_sources/reference/wwctl_configure.rst.txt

@@ -42,4 +42,5 @@ SEE ALSO
 * :ref:`wwctl configure nfs <wwctl_configure_nfs>` 	 - Manage and initialize NFS
 * :ref:`wwctl configure ssh <wwctl_configure_ssh>` 	 - Manage and initialize SSH
 * :ref:`wwctl configure tftp <wwctl_configure_tftp>` 	 - Manage and initialize TFTP
+* :ref:`wwctl configure warewulfd <wwctl_configure_warewulfd>` 	 - Enable and start warewulfd
 

static/docs/main/_sources/reference/wwctl_configure_warewulfd.rst.txt

@@ -0,0 +1,38 @@
+.. _wwctl_configure_warewulfd:
+
+wwctl configure warewulfd
+-------------------------
+
+Enable and start warewulfd
+
+Synopsis
+~~~~~~~~
+
+
+Enable and starts the warewulfd service.
+
+::
+
+  wwctl configure warewulfd [OPTIONS]
+
+Options
+~~~~~~~
+
+::
+
+  -h, --help   help for warewulfd
+
+Options inherited from parent commands
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+::
+
+  -d, --debug                 Run with debugging messages enabled.
+  -v, --verbose               Run with increased verbosity.
+      --warewulfconf string   Set the warewulf configuration file
+
+SEE ALSO
+~~~~~~~~
+
+* :ref:`wwctl configure <wwctl_configure>` 	 - Manage system services
+

static/docs/main/_sources/troubleshooting/troubleshooting.rst.txt

@@ -201,3 +201,35 @@ Running Containers on Cluster Nodes
 Some container runtimes, notably Podman, require file system features that are
 not available in ``initrootfs``. Cluster nodes using Podman (and some other
 container runtimes) should be configured with ``--root=tmpfs``.
+
+tmpfs and NUMA
+==============
+
+Warewulf can optionally mount the root filesystem as ``tmpfs`` instead of the
+default ``initramfs``. Warewulf will add ``mpol=interleave`` to the mount point
+which will distribute the memory across all NUMA nodes. This avoids the
+hotspotting that occurs when the default initramfs stores large node images on a
+single NUMA node. To enable this, set the rootfs type to tmpfs:
+
+.. code-block:: shell
+   
+   wwctl profile set default --root=tmpfs
+   
+You may also adjust the tmpfs size via the ``wwinit.tmpfs.size`` kernel
+argument:
+
+.. code-block:: shell
+   
+   # Set tmpfs to use maximum 1GB  
+   wwctl profile set default --kernelargs="wwinit.tmpfs.size=1G"
+   # You can also use a percentage of physical RAM
+   wwctl profile set default --kernelargs="wwinit.tmpfs.size=25%" 
+
+By default this is set to 50% of physical RAM. Note that tmpfs is required for
+SELinux overlays since initramfs cannot preserve SELinux contexts.
+
+.. note::
+
+   On some systems, it may also be necessary to include the ``noefi`` kernel
+   argument. This works around specific EFI firmware bugs that can prevent
+   proper memory release during the transition from ``initramfs`` to ``tmpfs``.

static/docs/main/contributing/contributing.html

@@ -117,6 +117,7 @@
 <li class="toctree-l1"><a class="reference internal" href="../reference/wwctl_configure_nfs.html">wwctl configure nfs</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../reference/wwctl_configure_ssh.html">wwctl configure ssh</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../reference/wwctl_configure_tftp.html">wwctl configure tftp</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../reference/wwctl_configure_warewulfd.html">wwctl configure warewulfd</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../reference/wwctl_image.html">wwctl image</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../reference/wwctl_image_build.html">wwctl image build</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../reference/wwctl_image_copy.html">wwctl image copy</a></li>

static/docs/main/contributing/debugging.html

@@ -112,6 +112,7 @@
 <li class="toctree-l1"><a class="reference internal" href="../reference/wwctl_configure_nfs.html">wwctl configure nfs</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../reference/wwctl_configure_ssh.html">wwctl configure ssh</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../reference/wwctl_configure_tftp.html">wwctl configure tftp</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../reference/wwctl_configure_warewulfd.html">wwctl configure warewulfd</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../reference/wwctl_image.html">wwctl image</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../reference/wwctl_image_build.html">wwctl image build</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../reference/wwctl_image_copy.html">wwctl image copy</a></li>

static/docs/main/contributing/development-environment.html

@@ -113,6 +113,7 @@
 <li class="toctree-l1"><a class="reference internal" href="../reference/wwctl_configure_nfs.html">wwctl configure nfs</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../reference/wwctl_configure_ssh.html">wwctl configure ssh</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../reference/wwctl_configure_tftp.html">wwctl configure tftp</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../reference/wwctl_configure_warewulfd.html">wwctl configure warewulfd</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../reference/wwctl_image.html">wwctl image</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../reference/wwctl_image_build.html">wwctl image build</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../reference/wwctl_image_copy.html">wwctl image copy</a></li>

static/docs/main/contributing/documentation.html

@@ -108,6 +108,7 @@
 <li class="toctree-l1"><a class="reference internal" href="../reference/wwctl_configure_nfs.html">wwctl configure nfs</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../reference/wwctl_configure_ssh.html">wwctl configure ssh</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../reference/wwctl_configure_tftp.html">wwctl configure tftp</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../reference/wwctl_configure_warewulfd.html">wwctl configure warewulfd</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../reference/wwctl_image.html">wwctl image</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../reference/wwctl_image_build.html">wwctl image build</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../reference/wwctl_image_copy.html">wwctl image copy</a></li>

static/docs/main/genindex.html

@@ -105,6 +105,7 @@
 <li class="toctree-l1"><a class="reference internal" href="reference/wwctl_configure_nfs.html">wwctl configure nfs</a></li>
 <li class="toctree-l1"><a class="reference internal" href="reference/wwctl_configure_ssh.html">wwctl configure ssh</a></li>
 <li class="toctree-l1"><a class="reference internal" href="reference/wwctl_configure_tftp.html">wwctl configure tftp</a></li>
+<li class="toctree-l1"><a class="reference internal" href="reference/wwctl_configure_warewulfd.html">wwctl configure warewulfd</a></li>
 <li class="toctree-l1"><a class="reference internal" href="reference/wwctl_image.html">wwctl image</a></li>
 <li class="toctree-l1"><a class="reference internal" href="reference/wwctl_image_build.html">wwctl image build</a></li>
 <li class="toctree-l1"><a class="reference internal" href="reference/wwctl_image_copy.html">wwctl image copy</a></li>

static/docs/main/getting-started/debian-quickstart.html

@@ -119,6 +119,7 @@
 <li class="toctree-l1"><a class="reference internal" href="../reference/wwctl_configure_nfs.html">wwctl configure nfs</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../reference/wwctl_configure_ssh.html">wwctl configure ssh</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../reference/wwctl_configure_tftp.html">wwctl configure tftp</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../reference/wwctl_configure_warewulfd.html">wwctl configure warewulfd</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../reference/wwctl_image.html">wwctl image</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../reference/wwctl_image_build.html">wwctl image build</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../reference/wwctl_image_copy.html">wwctl image copy</a></li>

static/docs/main/getting-started/el-quickstart.html

@@ -123,6 +123,7 @@
 <li class="toctree-l1"><a class="reference internal" href="../reference/wwctl_configure_nfs.html">wwctl configure nfs</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../reference/wwctl_configure_ssh.html">wwctl configure ssh</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../reference/wwctl_configure_tftp.html">wwctl configure tftp</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../reference/wwctl_configure_warewulfd.html">wwctl configure warewulfd</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../reference/wwctl_image.html">wwctl image</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../reference/wwctl_image_build.html">wwctl image build</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../reference/wwctl_image_copy.html">wwctl image copy</a></li>