Aggiunta al NAS RAIDZ1: come scrub e trim vengono davvero pianificati — e l'alert che non c'era

Illustrazione della pianificazione di scrub e trim in OpenZFS

🌐 Anche in: English · Deutsch · Français · Español · Português · Nederlands · Polski

Un breve seguito della costruzione del NAS RAIDZ1. Il cheatsheet di quel post ti dava zpool scrub storage come comando che puoi lanciare. Ciò a cui non rispondeva è se qualcosa lo lancia per te — e, visto che uno scrub è utile solo se scopri davvero quando trova qualcosa, se il sistema te lo dice quando succede. Entrambe le domande si sono rivelate avere risposte più interessanti di “sì, ovvio”.

Indice

🔍 Scrub e trim, un paragrafo ciascuno

zpool scrub legge ogni blocco allocato nel pool e lo confronta con il suo checksum salvato. Una discrepanza — un bit che si è girato in silenzio da qualche parte sul supporto fisico — viene ricostruita dalla parità RAIDZ e riscritta automaticamente. Questo è l’intero meccanismo che rende ZFS immune al problema del bit-rot silenzioso a cui il post originale ha dedicato diversi paragrafi: non è che la corruzione non possa avvenire, è che lo scrub trasforma “corruzione che nessuno noterà mai” in “corruzione che viene sistemata prima che qualcuno la noti”. zpool trim è specifico per gli SSD. Dice al firmware del disco quali blocchi ZFS ha smesso di usare (file cancellati, dati sovrascritti), così l’SSD può cancellare e preparare quello spazio in anticipo invece di affannarsi a farlo durante una scrittura. Saltalo abbastanza a lungo e le prestazioni in scrittura calano in silenzio, man mano che il disco esaurisce i blocchi pre-cancellati — l’equivalente SSD di non portare mai fuori la spazzatura e chiedersi perché in cucina si lavori sempre più lentamente. Nessuno dei due serve come operazione una tantum. Il senso è proprio che girino a calendario.

📅 Chi preme davvero il grilletto

Sono andato a cercare la risposta invece di presumerla, ed è stato un bene — il posto ovvio in cui guardare era quello sbagliato. OpenZFS su Debian fornisce due meccanismi di pianificazione uno accanto all’altro, e solo uno dei due faceva qualcosa:

$ systemctl list-unit-files | grep zfs-scrub
zfs-scrub-monthly@.timer   disabled   enabled
zfs-scrub-weekly@.timer    disabled   enabled

Entrambi disabilitati. Se mi fossi fermato qui, la risposta onesta sarebbe stata “no, non lo lancia niente”. Ma zfsutils-linux deposita anche un semplice file cron, indipendente da quei timer, e quello è attivo:

# /etc/cron.d/zfsutils-linux

# TRIM the first Sunday of every month.
24 0 1-7 * * root if [ $(date +\%w) -eq 0 ] && [ -x /usr/lib/zfs-linux/trim ]; then /usr/lib/zfs-linux/trim; fi

# Scrub the second Sunday of every month.
24 0 8-14 * * root if [ $(date +\%w) -eq 0 ] && [ -x /usr/lib/zfs-linux/scrub ]; then /usr/lib/zfs-linux/scrub; fi

Trim la prima domenica, scrub la seconda, entrambi alle 00:24. Lo script /usr/lib/zfs-linux/scrub che richiama non è nemmeno un cieco zpool scrub $everything — passa in rassegna ogni pool, controlla che la sua salute sia ONLINE, e legge per ogni pool una proprietà definita dall’utente chiamata org.debian:periodic-scrub per decidere se includerlo:

$ zfs get -H -o value org.debian:periodic-scrub storage
-

- significa non impostata, che lo script tratta come auto — lo scrub procede. Impostarla a disable su un certo pool escluderebbe quel pool senza toccare il cron job stesso, una manopola più ordinata che modificare lo script. Il punto: sono installati due sistemi di pianificazione, è acceso solo il più vecchio basato su cron, e la vera decisione per pool è una proprietà, non un nome di pool scritto a mano. Niente di tutto questo si scopre da zpool status — devi andare a controllare direttamente systemctl, /etc/cron.d e la proprietà, che è esattamente quello che ho finito per fare dopo che mi è stata posta la domanda molto ragionevole “ma è davvero automatizzato, o mi hai solo mostrato il comando manuale?” Mensile è anche l’intervallo giusto da volere qui, per quel che vale — sono SSD, e una cadenza di scrub settimanale è più un default dell’era degli HDD che sulla flash aggiunge soprattutto usura senza alcun beneficio in più.

🔔 Qualcosa ti avvisa quando lo scrub trova un problema?

Questa è la parte che mi ha davvero sorpreso. L’infrastruttura per avvisarti esiste, è installata e sta girando:

$ systemctl status zfs-zed
● zfs-zed.service - ZFS Event Daemon (zed)
     Active: active (running)

ZED (lo ZFS Event Daemon) osserva gli eventi del pool — uno scrub che finisce, un resilver che si completa, un dispositivo che cambia stato — e la sua configurazione nomina perfino un destinatario:

# /etc/zfs/zed.d/zed.rc
ZED_EMAIL_ADDR="root"
ZED_NOTIFY_INTERVAL_SECS=3600

Sembra configurato. Ed è configurato — per quanto riguarda ZED stesso. Ma il vero meccanismo di consegna, sepolto in zed-functions.sh, è poco glamour:

: "${ZED_EMAIL_PROG:="mail"}"

zed_notify_email chiama un binario che si chiama letteralmente mail. E su questa macchina:

$ which mail mailx msmtp
$

Niente. Nessun mailutils, nessun msmtp, nessun MTA di alcun tipo installato. zpool create non ne tira mai dentro uno come dipendenza, quindi se non pensi separatamente a installare la consegna della posta, ZED ha un destinatario e nessun modo per raggiungerlo. Lo zedlet scrub_finish-notify.sh scatterebbe correttamente al prossimo scrub, costruirebbe il suo messaggio, lo passerebbe a zed_notify_email, che proverebbe a lanciare mail, riceverebbe “command not found” e fallirebbe — in silenzio, dal punto di vista di chiunque aspetti che arrivi davvero una mail. journalctl -u zed conterrà il fallimento se vai a cercarlo. Niente lo farà emergere se non lo fai. Voglio soffermarmi un attimo su questo, perché è una battuta finale davvero bella: l’intero primo post parlava di un filesystem che si rifiuta di lasciar passare inosservata la corruzione — checksum invece di fiducia cieca, autoriparazione invece di guasto silenzioso. E lo strato che gli sta sopra, il cui unico compito è dire a un essere umano quando quel meccanismo fa il suo lavoro, stava a sua volta fallendo esattamente nel modo silenzioso che ZFS è stato costruito per impedire. La lezione dell’ultimo post si generalizza più di quanto mi aspettassi: “sembra OK in silenzio” è una proprietà dell’infrastruttura, non solo dei dischi.

🛠️ Sistemarlo, sul serio

La lacuna è solo un MTA mancante, non una configurazione errata di ZED, quindi la correzione è davvero in tre passi: installare un client di posta, puntarlo verso un relay, dire a ZED a chi scrivere.

apt-get install -y msmtp msmtp-mta bsd-mailx

msmtp-mta crea un symlink di msmtp come /usr/sbin/sendmail, che è esattamente ciò che mail/mailx — e quindi ZED — chiamano dietro le quinte. Questo homelab ha già un relay in uscita funzionante (Strato, usato altrove per altre notifiche degli host), quindi ho puntato /etc/msmtprc sullo stesso account invece di mettere in piedi qualcosa di nuovo:

# /etc/msmtprc — root-owned, chmod 600 (it holds a password)
defaults
auth           on
tls            on
tls_starttls   on
logfile        /var/log/msmtp.log

account        homelab
host           smtp.strato.de
port           587
from           homelab@apt-upgrade.me
user           homelab@apt-upgrade.me
password       ██████████████████

account default : homelab

chown root:root /etc/msmtprc && chmod 600 /etc/msmtprc subito dopo — quel file contiene una password in chiaro, e zfs-zed.service gira comunque come root, quindi solo-root è sia corretto sia sufficiente. Stesso trattamento per il file di log. Poi il vero punto di tutto questo esercizio — dire a ZED di smettere di indirizzare la posta a un account root locale che nessuno leggerà mai, e di mandarla da qualche parte dove la vedrò davvero:

sed -i 's/^ZED_EMAIL_ADDR=.*/ZED_EMAIL_ADDR="you@example.com"/' /etc/zfs/zed.d/zed.rc
systemctl restart zfs-zed

Niente alias, niente spool di posta locale, nessuna regola di inoltro da tenere sotto controllo — ZED_EMAIL_ADDR è letteralmente il destinatario con cui viene invocato mail, quindi puntarlo direttamente su una vera casella è più semplice che far funzionare prima la consegna locale e aggiungerci sopra un inoltro.

✅ Confermato funzionante

Invece di aspettare la seconda domenica del mese per scoprire se tutto questo funziona davvero, ho mandato un test manuale attraverso esattamente lo stesso percorso usato da ZED — mail, che si risolve in msmtp, che si autentica presso Strato:

$ echo "This is a test message from the storage NAS (192.168.10.x) confirming that
msmtp + ZED mail delivery is now working via the Strato relay." | 
\
  mail -s "ZFS ZED delivery check - storage NAS" you@example.com

$ tail -1 /var/log/msmtp.log
host=smtp.strato.de tls=on auth=on user=homelab@apt-upgrade.me from=homelab@apt-upgrade.me
recipients=you@example.com mailsize=436 smtpstatus=250
smtpmsg='250 2.0.0 OK queued with id 990330282JJ9ENX' exitcode=EX_OK

smtpstatus=250 / exitcode=EX_OK significa che Strato ha accettato il messaggio per la consegna — questa è la versione di msmtp. Il lato della casella di posta l’ha confermato qualche secondo dopo:

From:    homelab@apt-upgrade.me
To:      you@example.com
Subject: ZFS ZED delivery check - storage NAS
Date:    Wed, 2 Sep 2026 21:19

This is a test message from the storage NAS (192.168.10.x) confirming that
msmtp + ZED mail delivery is now working via the Strato relay.

Da un capo all’altro, dal relay alla casella, più o meno nel tempo che ci è voluto a leggere la riga di log. Questa è l’intera correzione verificata — non “ora dovrebbe funzionare”, ma una vera mail arrivata davvero. Cosa piccola, ma vale la pena dirla chiaramente: la correzione qui non è davvero “installare msmtp”. È accorgersi che un componente il cui unico compito è dare l’allarme può fallire esattamente in silenzio quanto la cosa che dovrebbe sorvegliare — e che l’unico modo per sapere che funziona davvero è farlo scattare e controllare, non leggere la configurazione e dare per scontato.


📚 Altro in questa serie: il NAS RAIDZ1

Alcuni testi e immagini di questo sito sono creati con l’aiuto dell’IA o generati dall’IA. Dettagli