v4.6.3 release

Signed-off-by: Jonathon Anderson <janderson@ciq.com>
2025-08-01 16:42:47 -06:00
parent e63f313c6f
commit 70eb60bd2c
10 changed files with 92 additions and 19 deletions
--- a/.github/releases/v4.6.3.md
+++ b/.github/releases/v4.6.3.md
@@ -0,0 +1,13 @@
+Warewulf v4.6.3 is a regularly-scheduled minor release in the v4.6.x series.
+
+- additions to the REST API
+- improved IPv6 support
+- overlay auto(re)build during node discovery
+- automated Warewulf server daemon management
+- improved netplan support
+- other misc. documentation and bug fixes
+
+Significant changes are detailed in the [release
+notes](https://warewulf.org/docs/v4.6.x/release/v4.6.3.html). Additional changes
+may be listed in the
+[CHANGELOG](https://github.com/warewulf/warewulf/blob/main/CHANGELOG.md).
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -4,14 +4,13 @@ All notable changes to this project will be documented in this file.

 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).

-## Unreleased
+## v4.6.3, 2025-08-01

 ### Added

 - Added system and runtime overlay built time to REST API.
 - Support If-None-Match header in `PUT /api/nodes/{id}`
 - Added `PUT|DELETE /api/overlays/{name}/file?path={path}`
- Added `DELETE /api/overlays/{name}/file?path={path}`
 - Added `wwctl configure warewulfd`
 - Added troubleshooting documentation regarding NUMA and tmpfs
 - Added support for IPv6 when booting with iPXE. #1852
@@ -21,9 +20,6 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 - Restore default idempotency of `PUT /api/nodes/{id}`
 - `DELETE /api/overlays/{name}?force=true` can delete overlays that are in use
 - `warewulfd` overlay autobuild rebuilds overlays after node discovery. #1468
-
-### Fixed
-
 - Improved netplan support. #1873

 ### Fixed
--- a/RELEASE.md
+++ b/RELEASE.md
@@ -1,7 +1,7 @@
 # Release procedure

 Major versions (e.g., v4.6.0) are tagged directly on the main branch. Minor
-versions (e.g., v4.6.1) are tagged on a separate release branch.
+versions (e.g., v4.6.3) are tagged on a separate release branch.

 1. Update `CHANGELOG.md`.

@@ -29,7 +29,7 @@ versions (e.g., v4.6.1) are tagged on a separate release branch.
 6. Create a signed tag for the release of the format v4.MINOR.PATCH, following
   the format specified in <MAINTAINING.md>.
   
-       git tag --sign v4.6.2; git push origin v4.6.2
+       git tag --sign v4.6.3; git push origin v4.6.3

 7. Monitor the release action associated with the pushed tag at
   https://github.com/warewulf/warewulf/actions, and verify the generated draft
--- a/userdocs/getting-started/debian-quickstart.rst
+++ b/userdocs/getting-started/debian-quickstart.rst
@@ -31,7 +31,7 @@ Install Warewulf and dependencies
   cd ~/git
   git clone https://github.com/warewulf/warewulf.git
   cd warewulf
-   git checkout main # or switch to a tag like 'v4.6.2'
+   git checkout main # or switch to a tag like 'v4.6.3'
   make all && sudo make install

 Configure firewalld
--- a/userdocs/getting-started/el-quickstart.rst
+++ b/userdocs/getting-started/el-quickstart.rst
@@ -10,11 +10,11 @@ Install Warewulf

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

 .. code-block:: bash

-   dnf install https://github.com/warewulf/warewulf/releases/download/v4.6.2/warewulf-4.6.2-1.el9.x86_64.rpm
+   dnf install https://github.com/warewulf/warewulf/releases/download/v4.6.3/warewulf-4.6.3-1.el9.x86_64.rpm

 Packages are available for el8 and el9.

--- a/userdocs/index.rst
+++ b/userdocs/index.rst
@@ -92,3 +92,4 @@ Welcome to the Warewulf User Guide!
   v4.6.0 <release/v4.6.0>
   v4.6.1 <release/v4.6.1>
   v4.6.2 <release/v4.6.2>
+   v4.6.3 <release/v4.6.3>
--- a/userdocs/release/v4.6.0.rst
+++ b/userdocs/release/v4.6.0.rst
@@ -327,7 +327,7 @@ script.

 Utilizing the new iPXE menu, specifying an ``IPXEMenuEntry`` tag on a cluster
 node now selects the boot method to use, similar to the previously-existing
-``GRUBMenuEntry``. The ``dracut.ipxe`` script has now been merged into the
+``GrubMenuEntry``. The ``dracut.ipxe`` script has now been merged into the
 default iPXE script, and specifying ``IPXEMenuEntry=dracut`` now replaces
 specifying a discrete ``dracut`` iPXE template.

--- a/userdocs/release/v4.6.3.rst
+++ b/userdocs/release/v4.6.3.rst
@@ -0,0 +1,63 @@
+====================
+v4.6.3 Release Notes
+====================
+
+v4.6.3 is a regularly-scheduled minor release in the v4.6.x series.
+
+Significant changes are described below. Additional changes are listed in the
+`CHANGELOG`_.
+
+.. _CHANGELOG: https://github.com/warewulf/warewulf/blob/main/CHANGELOG.md
+
+REST API
+========
+
+v4.6.3 continues development of the REST API, adding support for the
+``If-None-Match: *`` header to prevent overwriting an existing entity.
+
+Other new functionality in the REST API includes:
+
+- ``GET /api/nodes/{id}/overlays`` returns built time metadata for a node's
+  system and runtime overlay images.
+- ``PUT /api/overlays/{name}/file?path={path}`` creates files in overlays.
+- ``DELETE /api/overlays/{name}/file?path={path}`` delete files in overlays.
+- ``DELETE /api/overlays/{name}?force=true`` deletes overlays that are in use.
+
+IPv6 Support
+============
+
+IPv6 is now supported during the iPXE network boot process, one step towards
+improving overall IPv6 support.
+
+Overlay Autobuild
+=================
+
+The Warewulf server (when "autobuild overlays" is enabled) now automatically
+rebuilds overlays after node discovery, which resolves an issue where overlays
+were out-of-sync with the newly-discovered configuration. This is one step in a
+more general effort to imrpove overlay autobuild so that manual overlay builds
+are less often required.
+
+Warewulf server configuration
+=============================
+
+The ``wwctl configure`` command can now enable and (re)start the warewulf server
+daemon itself to apply updated configuration, either as part of ``wwctl
+configure -a`` or ``wwctl configure warewulfd``.
+
+Ubuntu and Debian Support
+=========================
+
+The ``netplan`` overlay is now much more feature-complete, with relative parity
+to the other network configuration overlays. This is one step in a more general
+effort to support Wareewulf in Ubuntu and Debian environments.
+
+Other fixes
+===========
+
+- Fixed ``wwctl upgrade nodes`` to properly handle kernel argument lists.
+- Fixed a panic during ``wwctl overlay edit`` due to missing ``reexec.Init()``.
+- Fixed handling of comma-separated mount options in ``fstab`` and ``ignition``
+  overlays.
+- Fixed a race condition in ``wwctl overlay edit`` that led to changes not being
+  properly detected and applied.
--- a/userdocs/server/bootloaders.rst
+++ b/userdocs/server/bootloaders.rst
@@ -340,11 +340,11 @@ an initramfs inside the image.
 .. code-block:: shell

   # Enterprise Linux
-   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
+   wwctl image exec rockylinux-9 --build=false -- /usr/bin/dnf -y install https://github.com/warewulf/warewulf/releases/download/v4.6.3/warewulf-dracut-4.6.3-1.el9.noarch.rpm
   wwctl image exec rockylinux-9 -- /usr/bin/dracut --force --no-hostonly --add wwinit --regenerate-all

   # SUSE
-   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
+   wwctl image exec leap-15 --build=false -- /usr/bin/zypper -y install https://github.com/warewulf/warewulf/releases/download/v4.6.3/warewulf-dracut-4.6.3-1.suse.lp155.noarch.rpm
   wwctl image exec leap-15 -- /usr/bin/dracut --force --no-hostonly --add wwinit --regenerate-all

 .. note::
--- a/userdocs/server/installation.rst
+++ b/userdocs/server/installation.rst
@@ -18,14 +18,14 @@ Rocky Linux 9

 .. code-block:: console

-   # dnf install https://github.com/warewulf/warewulf/releases/download/v4.6.2/warewulf-4.6.2-1.el9.x86_64.rpm
+   # dnf install https://github.com/warewulf/warewulf/releases/download/v4.6.3/warewulf-4.6.3-1.el9.x86_64.rpm

 openSuse Leap
 -------------

 .. code-block:: console

-   # zypper install https://github.com/warewulf/warewulf/releases/download/v4.6.2/warewulf-4.6.2-1.suse.lp155.x86_64.rpm
+   # zypper install https://github.com/warewulf/warewulf/releases/download/v4.6.3/warewulf-4.6.3-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.2/warewulf-4.6.2.tar.gz
-   tar -xf warewulf-4.6.2.tar.gz
-   cd warewulf-4.6.2
+   curl -LO https://github.com/warewulf/warewulf/releases/download/v4.6.3/warewulf-4.6.3.tar.gz
+   tar -xf warewulf-4.6.3.tar.gz
+   cd warewulf-4.6.3
   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.2'
+   git checkout main # or switch to a tag like 'v4.6.3'
   make all && sudo make install

 Runtime Dependencies