From 8af74bdb69c27665ec89d0ba7aa3db7d3468f193 Mon Sep 17 00:00:00 2001 From: Stephen Simpson Date: Thu, 2 Jan 2025 11:31:38 -0600 Subject: [PATCH] Add machine-id note This note informs that it may be necessary to remove /etc/machine-id for dracut to properly generate. The nodes will fail to boot otherwise --- CHANGELOG.md | 1 + CONTRIBUTORS.md | 1 + userdocs/contents/boot-management.rst | 6 ++++++ 3 files changed, 8 insertions(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index 41975327..57ed0d22 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -82,6 +82,7 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/). - Bump github.com/containers/storage from 1.53.0 to 1.55.2 #1316, #892 - Process nodes.conf path dynamically from config. #1595, #1596, #1569 - Split overlays into distribution and site overlays. #831 +- Added note to booting userdoc for removing machine-id. #1609 ### Removed diff --git a/CONTRIBUTORS.md b/CONTRIBUTORS.md index eb7b279c..a501faff 100644 --- a/CONTRIBUTORS.md +++ b/CONTRIBUTORS.md @@ -44,3 +44,4 @@ * Nicholas Porter * Ian Kaufman [@iankgt40](https://github.com/iankgt40) * Daniele Colombo [@dacolombo](https://github.com/dacolombo) +* Stephen Simpson [@ssimpson89](https://github.com/ssimpson89) \ No newline at end of file diff --git a/userdocs/contents/boot-management.rst b/userdocs/contents/boot-management.rst index 1ed20ddc..272d5740 100644 --- a/userdocs/contents/boot-management.rst +++ b/userdocs/contents/boot-management.rst @@ -326,6 +326,12 @@ initramfs inside the container. dnf -y install warewulf-dracut dracut --force --no-hostonly --add wwinit --regenerate-all +.. note:: + + In some systems, such as ``rockylinux:8``, it may be + necessary to remove ``/etc/machine-id`` for dracut to properly generate + the initramfs in the location that Warewulf is expecting. + Set the node's iPXE template to ``dracut`` to direct iPXE to fetch the node's initramfs image and boot with dracut semantics, rather than booting the node image directly.