Skip to content

Commit 95da076

Browse files
committed
Update v4.6.x docs
1 parent 6e98a83 commit 95da076

File tree

110 files changed

+479
-23
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

110 files changed

+479
-23
lines changed

static/docs/v4.6.x/_sources/getting-started/debian-quickstart.rst.txt

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -31,7 +31,7 @@ Install Warewulf and dependencies
3131
cd ~/git
3232
git clone https://github.com/warewulf/warewulf.git
3333
cd warewulf
34-
git checkout main # or switch to a tag like 'v4.6.1'
34+
git checkout main # or switch to a tag like 'v4.6.2'
3535
make all && sudo make install
3636
3737
Configure firewalld

static/docs/v4.6.x/_sources/getting-started/el-quickstart.rst.txt

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -10,11 +10,11 @@ Install Warewulf
1010

1111
The preferred way to install Warewulf on Enterprise Linux is using the
1212
the RPMs published in `GitHub releases`_. For example, to install the
13-
v4.6.1 release on Enterprise Linux 9:
13+
v4.6.2 release on Enterprise Linux 9:
1414

1515
.. code-block:: bash
1616
17-
dnf install https://github.com/warewulf/warewulf/releases/download/v4.6.1/warewulf-4.6.1-1.el9.x86_64.rpm
17+
dnf install https://github.com/warewulf/warewulf/releases/download/v4.6.2/warewulf-4.6.2-1.el9.x86_64.rpm
1818
1919
Packages are available for el8 and el9.
2020

static/docs/v4.6.x/_sources/index.rst.txt

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -91,3 +91,4 @@ Welcome to the Warewulf User Guide!
9191

9292
v4.6.0 <release/v4.6.0>
9393
v4.6.1 <release/v4.6.1>
94+
v4.6.2 <release/v4.6.2>

static/docs/v4.6.x/_sources/nodes/nodes.rst.txt

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -206,6 +206,12 @@ Importing Nodes From a File
206206
You can import nodes into Warewulf by using the ``wwctl node import`` command.
207207
The file used must be in YAML format.
208208

209+
.. warning::
210+
Importing a node configuration will fully overwrite the existing settings,
211+
including any customizations not present in the import file. If the node
212+
already exists and you wish to update it, ensure that the import file
213+
includes all the options you want to retain.
214+
209215
The YAML file must be a mapping of node names to their attributes, where each
210216
node is represented as a dictionary of attributes. To simplify the creation of
211217
the YAML file, you can use the wwctl node export command to export the current
Lines changed: 56 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,56 @@
1+
====================
2+
v4.6.2 Release Notes
3+
====================
4+
5+
v4.6.2 is a regularly-scheduled minor release in the v4.6.x series. It also
6+
includes a preview implementation of the ability to provision the node image to
7+
a local disk.
8+
9+
Significant changes are described below. Additional changes are listed in the
10+
`CHANGELOG`_.
11+
12+
.. _CHANGELOG: https://github.com/warewulf/warewulf/blob/main/CHANGELOG.md
13+
14+
Provisioning to disk
15+
====================
16+
17+
v4.6.2 includes a preview implementation of the ability to provision the node
18+
image to a local disk. This includes the ability to provision disks earlier in
19+
the boot process, primarily during the first phase of a two-phase boot using
20+
dracut.
21+
22+
Disks may be provisioned using ``ignition``, as before; but may now also be
23+
provisioned using new ``sfdisk``, ``mkfs``, and ``mkswap`` overlays, and to
24+
mount configured file systems using ``systemd.mount`` and ``systemd.swap``
25+
overlays. These overlays may also each be configured using overlay-specific
26+
"resources", which may additional control compared to Warewulf's built-in disk,
27+
partition, and file system configuration.
28+
29+
To support more complext partition layouts, ``wwctl <node|partition> set
30+
--parttype`` has been added to specify non-default partition types. This is
31+
particularly useful when creating an EFI partition, which may be used in a
32+
future release to configure serverless local booting.
33+
34+
Finally, ``wwctl profile set`` has been fixed to now properly support
35+
configuration of disks, partitions and file systems.
36+
37+
For more information, see the :ref:`provision to disk` section.
38+
39+
REST API
40+
========
41+
42+
v4.6.2 continues development of the REST API, properly handling attempts to
43+
create a node that already exists, and fetching uid, gid, and mode permissions
44+
for overlay files. The previous gRPC-based API servers and client have also been
45+
removed.
46+
47+
Other fixes
48+
===========
49+
50+
- NetworkManager now waits for interfaces to come online before provisioning with Dracut.
51+
- The ``udev.netname`` overlay now properly handles InfiniBand interfaces in more cases.
52+
- Fixed a regression in SELinux support by restoring the ``/run`` mount during wwinit.
53+
- GRUB now properly reports errors and reboots when an error occurs.
54+
- Fixed IPMI VLAN configuration.
55+
- Preserve existing permissions during ``wwctl overlay edit``.
56+
- Fix CSV processing during ``wwctl node import --csv``.

static/docs/v4.6.x/_sources/server/bootloaders.rst.txt

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -340,11 +340,11 @@ an initramfs inside the image.
340340
.. code-block:: shell
341341
342342
# Enterprise Linux
343-
wwctl image exec rockylinux-9 --build=false -- /usr/bin/dnf -y install https://github.com/warewulf/warewulf/releases/download/v4.6.1/warewulf-dracut-4.6.1-1.el9.noarch.rpm
343+
wwctl image exec rockylinux-9 --build=false -- /usr/bin/dnf -y install https://github.com/warewulf/warewulf/releases/download/v4.6.2/warewulf-dracut-4.6.2-1.el9.noarch.rpm
344344
wwctl image exec rockylinux-9 -- /usr/bin/dracut --force --no-hostonly --add wwinit --regenerate-all
345345
346346
# SUSE
347-
wwctl image exec leap-15 --build=false -- /usr/bin/zypper -y install https://github.com/warewulf/warewulf/releases/download/v4.6.1/warewulf-dracut-4.6.1-1.suse.lp155.noarch.rpm
347+
wwctl image exec leap-15 --build=false -- /usr/bin/zypper -y install https://github.com/warewulf/warewulf/releases/download/v4.6.2/warewulf-dracut-4.6.2-1.suse.lp155.noarch.rpm
348348
wwctl image exec leap-15 -- /usr/bin/dracut --force --no-hostonly --add wwinit --regenerate-all
349349
350350
.. note::

static/docs/v4.6.x/_sources/server/installation.rst.txt

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -18,14 +18,14 @@ Rocky Linux 9
1818

1919
.. code-block:: console
2020
21-
# dnf install https://github.com/warewulf/warewulf/releases/download/v4.6.1/warewulf-4.6.1-1.el9.x86_64.rpm
21+
# dnf install https://github.com/warewulf/warewulf/releases/download/v4.6.2/warewulf-4.6.2-1.el9.x86_64.rpm
2222
2323
openSuse Leap
2424
-------------
2525

2626
.. code-block:: console
2727
28-
# zypper install https://github.com/warewulf/warewulf/releases/download/v4.6.1/warewulf-4.6.1-1.suse.lp155.x86_64.rpm
28+
# zypper install https://github.com/warewulf/warewulf/releases/download/v4.6.2/warewulf-4.6.2-1.suse.lp155.x86_64.rpm
2929
3030
Container images
3131
================
@@ -97,9 +97,9 @@ appropriate substitutions:
9797

9898
.. code-block:: bash
9999
100-
curl -LO https://github.com/warewulf/warewulf/releases/download/v4.6.1/warewulf-4.6.1.tar.gz
101-
tar -xf warewulf-4.6.1.tar.gz
102-
cd warewulf-4.6.1
100+
curl -LO https://github.com/warewulf/warewulf/releases/download/v4.6.2/warewulf-4.6.2.tar.gz
101+
tar -xf warewulf-4.6.2.tar.gz
102+
cd warewulf-4.6.2
103103
make all && sudo make install
104104
105105
Git
@@ -118,7 +118,7 @@ from the main site, the GitHub releases page, or from a Git tag.
118118
119119
git clone https://github.com/warewulf/warewulf.git
120120
cd warewulf
121-
git checkout main # or switch to a tag like 'v4.6.1'
121+
git checkout main # or switch to a tag like 'v4.6.2'
122122
make all && sudo make install
123123
124124
Runtime Dependencies

static/docs/v4.6.x/contributing/contributing.html

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -180,6 +180,7 @@
180180
<ul>
181181
<li class="toctree-l1"><a class="reference internal" href="../release/v4.6.0.html">v4.6.0</a></li>
182182
<li class="toctree-l1"><a class="reference internal" href="../release/v4.6.1.html">v4.6.1</a></li>
183+
<li class="toctree-l1"><a class="reference internal" href="../release/v4.6.2.html">v4.6.2</a></li>
183184
</ul>
184185

185186
</div>

static/docs/v4.6.x/contributing/debugging.html

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -175,6 +175,7 @@
175175
<ul>
176176
<li class="toctree-l1"><a class="reference internal" href="../release/v4.6.0.html">v4.6.0</a></li>
177177
<li class="toctree-l1"><a class="reference internal" href="../release/v4.6.1.html">v4.6.1</a></li>
178+
<li class="toctree-l1"><a class="reference internal" href="../release/v4.6.2.html">v4.6.2</a></li>
178179
</ul>
179180

180181
</div>

static/docs/v4.6.x/contributing/development-environment.html

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -176,6 +176,7 @@
176176
<ul>
177177
<li class="toctree-l1"><a class="reference internal" href="../release/v4.6.0.html">v4.6.0</a></li>
178178
<li class="toctree-l1"><a class="reference internal" href="../release/v4.6.1.html">v4.6.1</a></li>
179+
<li class="toctree-l1"><a class="reference internal" href="../release/v4.6.2.html">v4.6.2</a></li>
179180
</ul>
180181

181182
</div>

0 commit comments

Comments
 (0)