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

🌐 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
- Costruire un NAS RAIDZ1 su Debian 13 con OpenZFS: dataset, compressione e le bugie che mi ha raccontato dd
- Sorridete tutti — facciamo uno snapshot! Da rdiff-backup a ZFS sul NAS RAIDZ1
- Seconda aggiunta: ZED controlla la salute del mio pool, non il suo girovita
- Due cose che mancavano ai miei SSD: TRIM dopo BitLocker e una write cache che il mio server HPE aveva spento di nascosto
