From 7551127ec0df5e7cac65d15acebc1698ca75ca42 Mon Sep 17 00:00:00 2001 From: Christian Goll Date: Wed, 25 Feb 2026 11:44:04 +0100 Subject: [PATCH 1/2] document known bug for ignition --- CHANGELOG.md | 3 +-- userdocs/nodes/disks.rst | 10 ++++++++++ 2 files changed, 11 insertions(+), 2 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 831002e6..7fa4c173 100644 --- a/CHANGELOG.md +++ b/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 diff --git a/userdocs/nodes/disks.rst b/userdocs/nodes/disks.rst index 74428cbb..778673cc 100644 --- a/userdocs/nodes/disks.rst +++ b/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 of disk isn't properly readable the command `sgdisk --zap-all` +which is used by ignition to wipe the partition returns with `2` which is handled by +ignition prior version `2.16.2` as an error and no paritions nor filesystems are created. +As the partition is wiped during that step a reboot of the node will lead to correct partitions +and file systems. From 6a24c45b9210a5651960618cdb471b7b74d8c89e Mon Sep 17 00:00:00 2001 From: Jonathon Anderson Date: Wed, 25 Feb 2026 13:24:37 -0700 Subject: [PATCH 2/2] Copyediting for new documentation advisement Signed-off-by: Jonathon Anderson --- userdocs/nodes/disks.rst | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/userdocs/nodes/disks.rst b/userdocs/nodes/disks.rst index 778673cc..2e14e3a3 100644 --- a/userdocs/nodes/disks.rst +++ b/userdocs/nodes/disks.rst @@ -265,8 +265,8 @@ parameter. Known Problems -------------- -If the partition table of disk isn't properly readable the command `sgdisk --zap-all` -which is used by ignition to wipe the partition returns with `2` which is handled by -ignition prior version `2.16.2` as an error and no paritions nor filesystems are created. -As the partition is wiped during that step a reboot of the node will lead to correct partitions -and file systems. +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.