Skip to main content

Machine Provisioning Process

Each node goes through the same 4-step lifecycle in MAAS.


Step 1 β€” Enlist​

βœ” Boot node via PXE (F12 β†’ Network Boot in BIOS)
βœ” Machine sends hardware info to MAAS
βœ” Node appears in MAAS with status: New

At this point MAAS knows the machine exists but has not inspected it.


Step 2 β€” Commission​

βœ” MAAS boots a commissioning image
βœ” Hardware detection (CPU, RAM, disks)
βœ” Network interface validation
βœ” Disk layout detection

After commissioning, status changes to Ready.


Step 3 β€” Fix Network (Critical)​

Before deploying, verify the machine's network configuration in MAAS:

βœ” Use ONLY the 10.0.0.0/24 subnet
βœ” Remove any IPv6 addresses or subnets
βœ” Remove alias interfaces (e.g. enp0s31f6:1)
βœ” Keep a single interface with a clean IP

Alias interfaces or IPv6 entries cause deployment failures or incorrect IP assignment.


Step 4 β€” Deploy​

βœ” Select Ubuntu 24.04 LTS
βœ” (Optional) Add cloud-init user-data
βœ” Click Deploy
βœ” MAAS installs OS, injects SSH key
βœ” Machine becomes Deployed β†’ SSH accessible

Lifecycle Summary​

New β†’ Commission β†’ Ready β†’ Deploy β†’ Deployed

Verify All Nodes​

After deployment, the MAAS dashboard should show all 3 machines as Deployed:

MAAS machines overview