Cluster Nodes
Warewulf cluster node configuration is persisted in nodes.conf (also known
as the “node registry” or “node database”). Editing this file directly is
supported; but it is often better to manage it using the wwctl command.
Note
The nodes.conf file is YAML document that can be edited directly or
managed with configuation management; but its internal structure is
technically undocumented and subject to change between versions. After
Warewulf v4.6.0, the wwctl upgrade nodes command can be used to update a
nodes.conf from a previous Warewulf v4 version.
Warning
When nodes.conf is edited directly, warewulfd must be restarted to reflect the changes.
systemctl restart warewulfd.service
Adding a Cluster Node
Adding a cluster node is as simple as running wwctl node add.
# wwctl node add n1 --ipaddr=10.0.2.1
Added node: n1
Several nodes can be added with a node range. In this case, the provided IP address is automatically incremented.
# wwctl node add n[2-4] --ipaddr=10.0.2.2
Added node: n2
Added node: n3
Added node: n4
# wwctl node list --net n[1-4]
NODE NETWORK HWADDR IPADDR GATEWAY DEVICE
---- ------- ------ ------ ------- ------
n1 default -- 10.0.2.1 <nil> --
n2 default -- 10.0.2.2 <nil> --
n3 default -- 10.0.2.3 <nil> --
n4 default -- 10.0.2.4 <nil> --
Listing Nodes
Once you have configured one or more nodes, you can list them and their
attributes with wwctl node list.
# wwctl node list n[1-5]
NODE NAME PROFILES NETWORK
--------- -------- -------
n1 default --
n2 default --
n3 default --
n4 default --
n5 default --
You can also see the node’s full attribute list by specifying --all.
# wwctl node list --all n1
NODE FIELD PROFILE VALUE
---- ----- ------- -----
n1 Profiles -- default
n1 Comment default This profile is automatically included for each node
n1 Ipxe default default
n1 RuntimeOverlay default hosts,ssh.authorized_keys
n1 SystemOverlay default wwinit,wwclient,fstab,hostname,ssh.host_keys,issue,resolv,udev.netname,systemd.netname,ifcfg,NetworkManager,debian.interfaces,wicked,ignition
n1 Kernel.Args default quiet,crashkernel=no
n1 Init default /sbin/init
n1 Root default initramfs
n1 Resources[fstab] default [{"file":"/home","mntops":"defaults,nofail","spec":"warewulf:/home","vfstype":"nfs"},{"file":"/opt","mntops":"defaults,noauto,nofail,ro","spec":"warewulf:/opt","vfstype":"nfs"}]
Setting Node Fields
Node fields are set using the wwctl node set command. A list of all
available fields is available with wwctl node set --help.
You can also edit nodes as YAML data in an interactive editor using wwctl node
edit.
List values
Some node fields, such as overlays and kernel aruments, accept a list of values. These may be specified as a comma-separated list or as multiple arguments.
To include an explicit comma in the value, enclose the value in inner-quotes.
wwctl node set n1 \
--kernelargs 'quiet,crashkernel=no,nosplash' \
--kernelargs='"console=ttyS0,115200"'
Un-setting Node Fields
To un-set a field value, set the value to UNDEF.
wwctl node set n1 \
--image=UNDEF
Configuring an Image
One of the main things to configure for a cluster node is the image that it should provision.
wwctl node set n1 \
--image=rockylinux-9
Images are covered in more detail in their own section.
Configuring the Network
By default, network configurations are applied to a “default” network interface.
wwctl node set n1 \
--netdev=eno1 \
--hwaddr=00:00:00:00:00:01 \
--ipaddr=10.0.2.1 \
--netmask=255.255.255.0
Network interface configuration is covered in more detail in its own section.
Node Discovery
The MAC / hardware address (--hwaddr) of a cluster node can be automatically
discovered by marking the node --discoverable. If a node attempts to
provision against Warewulf using an interface that is unknown to Warewulf, its
hardware address becomes 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” field is automatically cleared.
Resources
Cluster nodes support generic “resources” that may hold arbitrarily complex YAML data. This data, along with tags, may be used by both distribution and site overlays.
nodeprofiles:
default:
resources:
fstab:
- spec: warewulf:/home
file: /home
vfstype: nfs
mntops: defaults
freq: 0
passno: 0
- spec: warewulf:/opt
file: /opt
vfstype: nfs
mntops: defaults,ro
freq: 0
passno: 0
Resources can only be managed with wwctl node edit.