Various minor documentation updates
- Document using mock to build RPMs - Clarify installing warewulf-dracut in the image - Fix vestigial references to v4.6.0rc2 - Closes: #1767 - Closes: #1769 Signed-off-by: Jonathon Anderson <janderson@ciq.com>
This commit is contained in:
@@ -294,6 +294,11 @@ If a ``PasswordlessRoot`` tag is set to "true", the overlay will also insert a
|
||||
"passwordless" root entry. This can be particularly useful for accessing a
|
||||
cluster node when its network interface is not properly configured.
|
||||
|
||||
.. warning::
|
||||
|
||||
``PasswordlessRoot`` is not recommended for production; it should only be
|
||||
used during debugging, when normal authentication is not functional.
|
||||
|
||||
ignition
|
||||
--------
|
||||
|
||||
|
||||
@@ -334,13 +334,13 @@ Warewulf provides a dracut module to configure the dracut initramfs to load the
|
||||
image. This module is available in the ``warewulf-dracut`` subpackage, which
|
||||
must be installed in the image.
|
||||
|
||||
With the ``warewulf-dracut`` package installed, you can build an initramfs
|
||||
inside the image.
|
||||
With the ``warewulf-dracut`` package installed in the image, you can then build
|
||||
an initramfs inside the image.
|
||||
|
||||
.. code-block:: shell
|
||||
|
||||
dnf -y install warewulf-dracut
|
||||
dracut --force --no-hostonly --add wwinit --regenerate-all
|
||||
wwctl image exec rockylinux-9 --build=false -- /usr/bin/dnf -y install https://github.com/warewulf/warewulf/releases/download/v4.6.0/warewulf-dracut-4.6.0-1.el9.noarch.rpm
|
||||
wwctl image exec rockylinux-9 -- /usr/bin/dracut --force --no-hostonly --add wwinit --regenerate-all
|
||||
|
||||
.. note::
|
||||
|
||||
|
||||
@@ -18,14 +18,14 @@ Rocky Linux 9
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
# dnf install https://github.com/warewulf/warewulf/releases/download/v4.6.0rc2/warewulf-4.6.0rc2-1.el9.x86_64.rpm
|
||||
# dnf install https://github.com/warewulf/warewulf/releases/download/v4.6.0/warewulf-4.6.0-1.el9.x86_64.rpm
|
||||
|
||||
openSuse Leap
|
||||
-------------
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
# zypper install https://github.com/warewulf/warewulf/releases/download/v4.6.0rc2/warewulf-4.6.0rc2-1.suse.lp155.x86_64.rpm
|
||||
# zypper install https://github.com/warewulf/warewulf/releases/download/v4.6.0/warewulf-4.6.0-1.suse.lp155.x86_64.rpm
|
||||
|
||||
Container images
|
||||
================
|
||||
@@ -97,9 +97,9 @@ appropriate substitutions:
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
curl -LO https://github.com/warewulf/warewulf/releases/download/v4.6.0rc2/warewulf-4.6.0rc2.tar.gz
|
||||
tar -xf warewulf-4.6.0rc2.tar.gz
|
||||
cd warewulf-4.6.0rc2
|
||||
curl -LO https://github.com/warewulf/warewulf/releases/download/v4.6.0/warewulf-4.6.0.tar.gz
|
||||
tar -xf warewulf-4.6.0.tar.gz
|
||||
cd warewulf-4.6.0
|
||||
make all && sudo make install
|
||||
|
||||
Git
|
||||
@@ -118,7 +118,7 @@ from the main site, the GitHub releases page, or from a Git tag.
|
||||
|
||||
git clone https://github.com/warewulf/warewulf.git
|
||||
cd warewulf
|
||||
git checkout main # or switch to a tag like 'v4.6.0rc2'
|
||||
git checkout main # or switch to a tag like 'v4.6.0'
|
||||
make all && sudo make install
|
||||
|
||||
Runtime Dependencies
|
||||
@@ -134,6 +134,22 @@ services. Generally these are provided by your distribution.
|
||||
If you are using an Enterprise Linux compatible distribution you can install
|
||||
them with ``dnf install dhcp-server tftp-server nfs-utils``.
|
||||
|
||||
Building RPM packages from source
|
||||
=================================
|
||||
|
||||
You can also build RPM packages from source.
|
||||
|
||||
.. code-block:: bash
|
||||
|
||||
dnf -y install epel-release
|
||||
dnf -y install make mock
|
||||
git clone git@github.com:warewulf/warewulf.git
|
||||
(
|
||||
cd warewulf
|
||||
make clean && make dist warewulf.spec && mock -r rocky+epel-9-$(arch) --rebuild --spec=warewulf.spec --sources=.
|
||||
)
|
||||
dnf -y install /var/lib/mock/rocky+epel-9-$(arch)/result/warewulf-*.$(arch).rpm
|
||||
|
||||
Starting warewulfd
|
||||
==================
|
||||
|
||||
|
||||
Reference in New Issue
Block a user