Provisioning disks
As a tech preview, Warewulf provides structures to define disks, partitions, and file systems. These structures can generate a configuration for Ignition to provision partitions and file systems dynamically on cluster nodes, or with sfdisk, mkfs, and mkswap during boot.
Ignition can, for example, create swap
partitions or /scratch
file
systems.
Note
Warewulf is not currently able to provision the node image onto an explicitly provisioned root file system.
Requirements
Partition and file system creation requires both ignition
and sgdisk
to
be installed in the image.
Rocky Linux
dnf install ignition gdisk
Note
Packages for Ignition are not currently available for Rocky Linux 8, but it is available for Rocky Linux 9 as part of “appstream.”
openSuse Leap
zypper install ignition gptfdisk
Disks and partitions
A node or profile can have several disks. Each disk is identified by the path to
its block device. Each disk holds a map to its partitions and a bool
switch
to indicate if an existing, non-matching partition table should be overwritten.
Each partition is identified by its label. The partition number can be omitted,
but specifying it is recommended as Ignition may fail without it. Partition
sizes should also be set (specified in MiB), except for the last partition: if
no size is given, the maximum available size is used. Each partition has the
switches should_exist
and wipe_partition_entry
which control the
partition creation process. When omitting a partition number the
wipe_partition_entry should be true, as this allows ignition to replace the
existing partition.
wwctl node set n1 \
--diskname /dev/vda --diskwipe \
--partname scratch --partcreate --partnumber 1
File systems
File systems are identified by their underlying block device, preferably using
the /dev/by-partlabel
format. Except for a swap
partition, an absolute
path for the mount point must be specified for each file system. Depending on
the image used, valid formats are btrfs
, ext3
, ext4
, and xfs
.
Each file system has the switch wipe_filesystem
to control whether an
existing file system is wiped.
wwctl node set n1 \
--diskname /dev/vda --partname scratch \
--fsname scratch --fsformat btrfs --fspath /scratch
Boot-time configuration
Ignition uses systemd, as the underlying sgdisk
command relies on dbus
notifications.
ignition-disks-ww4.service
uses Ignition to create the specified partitions and file systems.ww4-disks.target
depends on a matching.mount
unit for each mounted file system.Each
.mount
creates the necessary mount points in the root file system and mounts the provisioned file systems during boot.
These services and mount units are generated by the ignition
overlay and
depend on the existence of the file /warewulf/ignition.json
, also generated
by the ignition
overlay.
Example disk configurations
This command formats a btrfs file system on a “scratch” partion of
“vda” and mounts it at /scratch
.
wwctl node set n1 \
--diskname /dev/vda --diskwipe \
--partname scratch --partcreate --partnumber 1 \
--fsname scratch --fsformat btrfs --fspath /scratch
This command adds a swap partition to the “vda” disk.
wwctl node set n1 \
--diskname /dev/vda \
--partname swap --partsize=1024 --partnumber 2 \
--fsname swap --fsformat swap --fspath swap
Re-using or wiping disks
For empty disks the desired configuration is created and the filesystems are
mounted. If partitions or file systems already exist on the disk, ignition
tries to reuse existing file systems by default.
To ignore existing file systems and provision fresh file systems on each boot,
specify the --fswipe`
flag for that filesystem, and --diskwipe
for the
disk, as necessary.
If you would like to re-use existing partitions but want to replace existing file systems once, you may
wipe the existing data with tools like
wipefs
or dd [1]; orset the
--fswipe
flag and remove it after one reboot.
See the upstream ignition documentation for additional information.
Provision to disk
New in Warewulf v4.6.2
As a tech preview, the Warewulf two-stage boot process can provision the node image to local storage.
Warning
This functionality is a technology preview and should be used with care. Pay
specific attention to wipeFilesytem
and similar settings.
Note
Warewulf doesn’t install a bootloader to the disk or add UEFI entries. Nodes still request an image and configuration from the Warewulf server on every boot.
Note
While provisioning to disk should be possible during a single-stage boot, not all features are available:
Warewulf does not perform hardware detection to ensure that necessary kernel modules are loaded prior to init.
Warewulf does not load udev to ensure that
/dev/disk/by-*
symlinks are available prior to init.
With Ignition
Warewulf needs a prepared file system to deploy the image to. Warewulf can
provision this file system using Ignition. To use Ignition, include ignition
in your system overlay. The ignition overlay provisions disks during init and,
optionally, during the first stage of a two-stage boot. This allows the
root file system to be provisioned before the image is loaded.
wwctl node set wwnode1 \
--diskname /dev/vda --diskwipe \
--partname rootfs --partcreate --partnumber 1 \
--fsname rootfs --fsformat ext4 --fspath /
In order to allow Dracut to provision the disk, partition, and file system, Ignition must be included in the Dracut image.
wwctl image exec rockylinux-9 -- /usr/bin/dracut --force --no-hostonly --add wwinit --add ignition --regenerate-all
The necessary file system may alternatively be prepared out-of-band.
With sfdisk and mkfs
Systems that do not have access to Ignition (e.g., Rocky Linux 8) can provision
the root file system using a combination of sfdisk
and mkfs
. To use
them, include sfdisk
and mkfs
in your system overlay. The sfdisk
and
mkfs
overlays provision disk and file systems during the first stage of a
two-stage boot. This allows the root file system to be provisioned before the
image is loaded.
Configure the sfdisk
and mkfs
overlays using resources:
wwctl node set wwnode1 \
--diskname /dev/vda --diskwipe \
--partname rootfs --partcreate --partnumber 1 \
--fsname rootfs --fsformat ext4 --fspath /
In order to allow Dracut to provision the disk, partition, and file system, some additional commands must be included in the Dracut image, depending on which functionality is used:
sfdisk: writes the partition table
blockdev: used to re-read the partition table after writing
udevadm: used to trigger udev events after writing the partition table
mkfs: formats file systems (may also require file-system-specific commands like mkfs.ext4)
mkfs.ext4, mkfs.btrfs, etc: used by mkfs to format specific file systems
wipefs: used to determine if a file system already exists
wwctl image exec rockylinux-8 -- /usr/bin/dracut --force --no-hostonly \
--add wwinit \
--install sfdisk \
--install blockdev \
--install udevadm \
--install mkfs \
--install mkfs.ext4 \
--install wipefs \
--regenerate-all
Configuring the root device
Set the desired storage device for the node image using the --root
parameter.
wwctl node set wwnode1 --root /dev/disk/by-partlabel/rootfs