From f1c6cf73e7d2da570d6564bf46740f07680c1a1a Mon Sep 17 00:00:00 2001 From: Jonathon Anderson Date: Fri, 21 Apr 2023 16:56:07 -0600 Subject: [PATCH] Document node discovery and order in userdocs Closes #487 Signed-off-by: Jonathon Anderson --- userdocs/contents/nodeconfig.rst | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/userdocs/contents/nodeconfig.rst b/userdocs/contents/nodeconfig.rst index 7441a28d..a0e55863 100644 --- a/userdocs/contents/nodeconfig.rst +++ b/userdocs/contents/nodeconfig.rst @@ -230,6 +230,18 @@ container, kernel, and network: # wwctl node list -a n001 | grep cluster n001 cluster -- cluster01 +Node Discovery +-------------- + +The hwaddr of a node can be automatically discovered by setting +`--discoverable` on a node. If a node attempts to provision against +Warewulf using an interface that is unknown to Warewulf, that address +is associated with the first discoverable node. (Multiple discoverable +nodes are sorted lexically, first by cluster, then by ID.) + +Once a node has been discovered its "discoverable" flag is +automatically cleared. + Un-setting Node Attributes ==========================