diff options
| author | Craig Jennings <c@cjennings.net> | 2026-01-23 15:28:16 -0600 |
|---|---|---|
| committer | Craig Jennings <c@cjennings.net> | 2026-01-23 15:28:16 -0600 |
| commit | 1027eb07dd7b9ff9e2ae0909e5004b853f4c6032 (patch) | |
| tree | 9387d3439307ae17e0684a06084a59d8c98cf34d /docs | |
| parent | a8050d28706776076230c393a8558b0242918bbf (diff) | |
| download | archangel-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.org | 99 |
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 |
