aboutsummaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorCraig Jennings <c@cjennings.net>2026-01-23 15:28:16 -0600
committerCraig Jennings <c@cjennings.net>2026-01-23 15:28:16 -0600
commit1027eb07dd7b9ff9e2ae0909e5004b853f4c6032 (patch)
tree9387d3439307ae17e0684a06084a59d8c98cf34d /docs
parenta8050d28706776076230c393a8558b0242918bbf (diff)
downloadarchangel-1027eb07dd7b9ff9e2ae0909e5004b853f4c6032.tar.gz
archangel-1027eb07dd7b9ff9e2ae0909e5004b853f4c6032.zip
Expand testing validation checks in btrfs research
- Add reboot survival checks (catches misconfigured services) - Rollback tests must include reboot for full validation - Document ZFSBootMenu rollback bug (needs filing) - Expand failure recovery and encryption checks
Diffstat (limited to 'docs')
-rw-r--r--docs/research-btrfs-expansion.org99
1 files changed, 71 insertions, 28 deletions
diff --git a/docs/research-btrfs-expansion.org b/docs/research-btrfs-expansion.org
index 300f5cd..8a6c1a6 100644
--- a/docs/research-btrfs-expansion.org
+++ b/docs/research-btrfs-expansion.org
@@ -286,34 +286,77 @@ install-archsnap
** VM Test Matrix
-| Config | Disks | Filesystem | RAID | Test |
-|--------+-------+------------+------+------|
-| Single ZFS | 1 | ZFS | - | Install, boot, rollback |
-| Single Btrfs | 1 | Btrfs | - | Install, boot, rollback |
-| Mirror ZFS | 2 | ZFS | mirror | Install, fail disk, recover |
-| Mirror Btrfs | 2 | Btrfs | raid1 | Install, fail disk, recover |
-| RAIDZ1 ZFS | 3 | ZFS | raidz1 | Install, fail disk, recover |
-
-** Test Scenarios
-
-1. *Fresh Install*
- - Single disk, multi-disk
- - Interactive and config-file modes
-
-2. *Snapshot Operations*
- - Manual snapshot creation
- - Automatic pre-pacman snapshots
- - Boot into snapshot
- - Rollback to snapshot
-
-3. *Failure Recovery*
- - Single disk failure (mirror/raidz)
- - Corrupt boot
- - Kernel update breaks system
-
-4. *Encryption*
- - ZFS native encryption
- - LUKS + Btrfs encryption
+- Single ZFS (1 disk): Install, boot, reboot, rollback+reboot
+- Single Btrfs (1 disk): Install, boot, reboot, rollback+reboot
+- Mirror ZFS (2 disk): Install, fail disk, recover
+- Mirror Btrfs (2 disk, raid1): Install, fail disk, recover
+- RAIDZ1 ZFS (3 disk): Install, fail disk, recover
+
+** Validation Checks
+
+*** Fresh Install (all configs)
+- Partitions created correctly (EFI + root)
+- Filesystem created (pool/subvols)
+- All mount points accessible
+- Packages installed (pacman -Q zfs-dkms or btrfs-progs)
+- Services enabled (zfs.target or snapper-timeline.timer)
+- Bootloader installed (ZFSBootMenu or GRUB + grub-btrfs)
+- fstab correct (no subvolid for btrfs)
+- Can boot without ISO
+
+*** Reboot Survival
+Critical: Verify system survives reboot cleanly. Catches:
+- Misconfigured services slamming CPU/network
+- Services that fail to start properly
+- ZFS import issues
+- fstab mount failures
+
+Checks after reboot:
+- System reaches login prompt
+- All filesystems mounted (findmnt)
+- No failed services (systemctl --failed)
+- CPU/memory/network normal (no runaway processes)
+- Can SSH in (if network configured)
+
+*** Snapshot Operations
+- Manual snapshot creates successfully
+- Snapshot appears in list (zfs list -t snap / snapper list)
+- Pre-pacman snapshot created automatically (install package, verify)
+- Snapshot visible in boot menu (ZFSBootMenu / GRUB)
+- Can boot into snapshot
+
+*** Rollback + Reboot
+Important: Rollback MUST include reboot to validate fully.
+Do NOT use ZFSBootMenu's built-in rollback (known bug, needs filing).
+Use zfsrollback script or snapper rollback instead.
+
+Checks:
+- Rollback command completes without error
+- Reboot completes successfully
+- System state matches snapshot after reboot
+- Previously installed test package is gone
+- No orphaned/broken state
+
+*** Failure Recovery (multi-disk only)
+- Pool/volume shows correct redundancy (zpool status / btrfs fi show)
+- Survives single disk removal (zpool offline / btrfs device delete)
+- Boots with degraded array
+- Warnings displayed about degraded state
+- Can resilver/rebuild after disk replaced (zpool replace / btrfs replace)
+- Pool returns to healthy state
+
+*** Encryption
+- Passphrase prompt appears at boot
+- Correct unlock with right passphrase
+- Fails gracefully with wrong passphrase (retry prompt, not panic)
+- Data unreadable when mounted elsewhere without key
+- Pool/volume not auto-imported without passphrase
+
+** Known Issues
+
+*** ZFSBootMenu Rollback Bug
+ZFSBootMenu's built-in rollback feature has issues (to be filed).
+Workaround: Use zfsrollback script from installed system or live ISO.
** Test Scripts