User Guide

Welcome to the Warewulf User Guide!

Contents

Introduction
- The Warewulf Vision
- About Warewulf
- Features
Background
Stateless Provisioning
- Why is Provisioning Important
- Provisioning Overview
- Why Stateless Provisioning
Control Server Setup
- Operating System Installation
- Network
- Addressing
- Multiple networks
Warewulf Installation
- Binary RPMs
- Container images
- Compiled Source code
Warewulf Configuration
- warewulf.conf
- nodes.conf
- Upgrades
- Directories
- FirewallD
- nftables
Controlling Warewulf (wwctl)
- Hostlists
Warewulf Initialization
- System Services
- Warewulf Service
Container Management
- Container Tools
- Importing Containers
- Syncuser
- Listing All Imported Containers
- Making Changes To Containers
- Creating Containers From Scratch
- Container Size Considerations
- Duplicating a container
- Multi-arch container management
- Read-only containers
Kernel Management
- Kernel Version
Boot Management
- Booting with iPXE
- Booting with GRUB
- Booting with dracut
Node Configuration
- The Node Configuration DB
- Adding a New Node
- Listing Nodes
- Setting Node Attributes
- Configuring the Node’s Container Image
- Un-setting Node Attributes
Node Profiles
- An Introduction To Profiles
- Multiple Profiles
- Cascading Profiles
- Overriding Profiles
- How To Use Profiles Effectively
Warewulf Overlays
- System and runtime overlays
- Distribution and site overlays
- Combining and overriding overlays
- Templates
- Managing overlays
Node Provisioning
- Node Hardware Setup
- The Provisioning Process
- Node status
IPMI
- IPMI Settings
- Reviewing Settings
- Power Commands
- Console
- Ipmi template
Disk Management
- Requirements
- Storage objects
- Ignition Implementation
- Example disk configuration
- Wiping disks
- Troubleshooting
Security
- SELinux
- Provisioning Security
- Summary
Templating
- Examples
dnsmasq
- Usage
Troubleshooting
- iPXE
- GRUB
Known issues
- SELinux and IPMI write not working when using two-stage boot
- Containers are read-only

Quickstart