Merge pull request #2119 from mslacken/UpdateDoku

document known bug for ignition

CHANGELOG.md

@@ -18,8 +18,7 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 - New --partwipe flag for profile and node set
 - Updated arguments for `ValidString` to match `regexp.MatchString`
 - New `mig` overlay to configure NVIDIA MIG devices. #2102
-- Updated arguments for `ValidString` to match `regexp.MatchString`
-- New `mig` overlay to configure NVIDIA MIG devices. #2102
+- Documented that booting a node twice fixes broken partition tables
 
 ## v4.6.5, 2026-01-12
 

userdocs/nodes/disks.rst

@@ -260,3 +260,13 @@ parameter.
 .. code-block:: shell
 
    wwctl node set wwnode1 --root /dev/disk/by-partlabel/rootfs
+
+
+Known Problems
+--------------
+
+If the partition table on the disk isn't properly readable the command ``sgdisk
+--zap-all`` (which is used by Ignition to wipe the partition table) returns with
+code ``2``. This is interpreted by Ignition < ``2.16.2`` as an error, and no
+partitions or filesystems are created. Since the partition table is still wiped,
+partitioning and formatting should succeed on the next boot.