ZFS per Svogliati

# Mirror semplice (2 dischi)
zpool create tank mirror /dev/sda /dev/sdb

# RAIDZ1 con 4 dischi
zpool create tank raidz1 /dev/sd{a,b,c,d}

# RAIDZ2 con 6 dischi — il setup consigliato per dischi grossi
zpool create tank raidz2 /dev/sd{a,b,c,d,e,f}

# Due vdev mirror (4 dischi totali, simile a RAID10)
zpool create tank mirror /dev/sda /dev/sdb mirror /dev/sdc /dev/sdd

# IMPORTANTE: usa sempre gli ID persistenti, non sdX
zpool create tank mirror \
  /dev/disk/by-id/ata-WDC_WD40EFRX-001 \
  /dev/disk/by-id/ata-WDC_WD40EFRX-002

zpool create \
  -o ashift=12           # settori 4K (tutti i dischi moderni)
  -o autotrim=on         # TRIM automatico per SSD
  -O compression=lz4     # compressione per tutti i dataset
  -O atime=off           # non aggiornare access time (meno I/O inutile)
  -O xattr=sa            # extended attributes in-inode (Linux)
  -O dnodesize=auto      # dnode più grandi se serve
  -O normalization=formD # normalizzazione Unicode (evita problemi con nomi file)
  -O relatime=on         # alternativa ad atime=off se servono gli atime
  -O mountpoint=/mnt/tank # dove montarlo
  tank raidz2 /dev/disk/by-id/{disco1,disco2,disco3,disco4,disco5,disco6}

# stato del pool
zpool status tank
zpool status -v       # verbose, mostra errori per disco

# spazio usato
zpool list

# I/O in tempo reale (tipo iostat)
zpool iostat tank 2   # refresh ogni 2 secondi

# cronologia operazioni
zpool history tank

# esportare (smonta tutto, prepara per spostamento)
zpool export tank

# importare (su questa macchina o un'altra)
zpool import          # mostra pool disponibili
zpool import tank     # importa "tank"

# distruggere (IRREVERSIBILE)
zpool destroy tank    # addio dati, è stato bello

# crea un dataset
zfs create tank/documenti
zfs create tank/vm
zfs create tank/backup

# dataset con proprietà specifiche
zfs create -o compression=zstd -o quota=500G tank/media

# gerarchia (il figlio eredita le proprietà del padre)
zfs create tank/vm/proxmox
zfs create tank/vm/docker

# elenca tutti i dataset
zfs list
zfs list -r tank        # ricorsivo sotto "tank"

# distruggere
zfs destroy tank/temp   # se ha snapshot, aggiungere -r

# cambia compressione
zfs set compression=zstd tank/backup

# imposta quota
zfs set quota=1T tank/media

# vedi tutte le proprietà di un dataset
zfs get all tank/documenti

# vedi solo compressione e quanto sta risparmiando
zfs get compressratio,compression tank/documenti

# eredita dal padre (rimuove override locale)
zfs inherit compression tank/documenti

# crea snapshot
zfs snapshot tank/documenti@prima-del-casino

# snapshot ricorsivo (tutti i figli)
zfs snapshot -r tank@backup-2024-01-15

# elenca snapshot
zfs list -t snapshot
zfs list -t snapshot -r tank/documenti  # solo di un dataset

# quanto spazio occupa (dati unici non più nel dataset attivo)
zfs list -t snapshot -o name,used,refer

# accedi ai file dello snapshot (senza rollback!)
ls /mnt/tank/documenti/.zfs/snapshot/prima-del-casino/

# ripristina un singolo file
cp /mnt/tank/documenti/.zfs/snapshot/prima-del-casino/report.pdf \
   /mnt/tank/documenti/report.pdf

# rollback — riporta il dataset a quello stato
zfs rollback tank/documenti@prima-del-casino

# rollback a snapshot non più recente (distrugge quelli intermedi)
zfs rollback -r tank/documenti@snapshot-vecchio

# diff tra snapshot e stato attuale
zfs diff tank/documenti@prima-del-casino

# distruggere uno snapshot
zfs destroy tank/documenti@prima-del-casino

# /etc/sanoid/sanoid.conf
[tank/documenti]
  use_template = production
  recursive = yes

[template_production]
  hourly = 24
  daily = 30
  monthly = 12
  yearly = 2
  autosnap = yes
  autoprune = yes

# Sanoid gira via cron/systemd timer
# ogni 15 minuti crea snapshot e pulisce i vecchi

# send completo di uno snapshot (prima volta)
zfs send tank/documenti@snap1 | zfs receive backup/documenti

# send incrementale (solo le differenze tra snap1 e snap2)
zfs send -i tank/documenti@snap1 tank/documenti@snap2 | \
  zfs receive backup/documenti

# send ricorsivo con tutte le proprietà
zfs send -R tank@snap1 | zfs receive -F backup

# send via SSH verso un'altra macchina
zfs send -i tank/documenti@snap1 tank/documenti@snap2 | \
  ssh backupserver zfs receive backup/documenti

# send compresso (risparmia banda su SSH)
zfs send -i @snap1 tank/documenti@snap2 | \
  zstd | ssh backupserver 'zstd -d | zfs receive backup/documenti'

# send con progress bar (perché aspettare alla cieca è ansia)
zfs send -v tank/documenti@snap1 | pv | zfs receive backup/documenti

# replica locale
syncoid tank/documenti backup/documenti

# replica remota via SSH
syncoid tank/documenti root@backupserver:backup/documenti

# replica ricorsiva di tutto il pool
syncoid -r tank root@backupserver:backup

# in un cron job (ogni ora)
# 0 * * * * /usr/sbin/syncoid -r tank root@backup:tank-replica

# aggiungere un SLOG (ZIL separato) — DEVE avere PLP
zpool add tank log mirror /dev/nvme0n1p1 /dev/nvme1n1p1

# aggiungere L2ARC (cache lettura)
zpool add tank cache /dev/nvme2n1

# aggiungere special vdev (metadati) — SEMPRE in mirror
zpool add tank special mirror /dev/nvme3n1 /dev/nvme4n1

# verificare la topologia
zpool status tank

# Debian / Ubuntu
apt install zfsutils-linux

# RHEL / Rocky / Alma (serve EPEL + ZFS repo)
dnf install https://zfsonlinux.org/epel/zfs-release-2-3.el9.noarch.rpm
dnf install zfs
modprobe zfs

# Arch (AUR o archzfs repo)
pacman -S zfs-dkms zfs-utils

# verifica che il modulo sia caricato
lsmod | grep zfs
zfs version

# abilita import e mount automatico
systemctl enable zfs-import-cache.service
systemctl enable zfs-mount.service
systemctl enable zfs-import.target
systemctl enable zfs.target

# aggiorna la cache (dopo aver importato manualmente)
zpool set cachefile=/etc/zfs/zpool.cache tank

# stato ARC
cat /proc/spl/kstat/zfs/arcstats | grep -E 'size|hits|miss'
# oppure in modo leggibile:
arc_summary

# limitare ARC a 8 GB (utile se il server fa anche altro)
# /etc/modprobe.d/zfs.conf
options zfs zfs_arc_max=8589934592

# applica senza reboot
echo 8589934592 > /sys/module/zfs/parameters/zfs_arc_max

# regola base: lascia almeno 1-2 GB liberi per il sistema
# ARC ideale = RAM totale - RAM per app - 2 GB

# stato di tutto
zpool status -v

# spazio reale
zpool list -v
zfs list -o name,used,avail,refer,compressratio

# snapshot ordinati per spazio occupato
zfs list -t snapshot -o name,used -s used

# errori disco con SMART
smartctl -a /dev/sda | grep -E 'Reallocated|Current_Pending|Offline_Uncorrectable'

# I/O in tempo reale
zpool iostat -v tank 2

# eventi ZFS recenti
zpool events -v | tail -50

# chi sta usando spazio? (dataset + snapshot)
zfs list -r -o name,used,usedbysnapshots,usedbydataset tank

# === POOL ===
zpool create tank mirror sda sdb          # crea pool mirror
zpool status                               # stato
zpool list                                 # spazio
zpool scrub tank                           # verifica integrità
zpool replace tank old-disk new-disk       # sostituisci disco
zpool export tank                           # smonta per spostare
zpool import tank                           # monta/importa

# === DATASET ===
zfs create tank/data                        # crea dataset
zfs list                                    # elenca
zfs set compression=lz4 tank/data           # imposta proprietà
zfs get all tank/data                       # vedi proprietà

# === SNAPSHOT ===
zfs snapshot tank/data@oggi                 # scatta
zfs list -t snapshot                        # elenca
zfs rollback tank/data@oggi                 # torna indietro
zfs destroy tank/data@oggi                  # elimina

# === SEND/RECEIVE ===
zfs send tank/data@snap | zfs receive backup/data  # full
zfs send -i @snap1 tank/data@snap2 | zfs receive backup/data  # incr