Aller au contenu
RZRenZan BlogHomelab · IA · Domotique
Illustration abstraite de blocs de mémoire de hauteurs variables éclairés sur un fond bleu et orange, évoquant le swap et le cache d'un NASStockage · ZFS · 7 septembre 2026

Le swap sur TrueNAS Scale : la spirale de la mort et le redémarrage sans trace

Un NAS n'a pas besoin de swap tant qu'il dispose de la mémoire qu'il faut, mais il en a besoin dès qu'elle vient à manquer. Sur TrueNAS Scale, des zvols de swap existent souvent sans jamais être activés. Résultat : un stress mémoire peut se terminer en crash dur, réinitialisé par le watchdog sans une seule ligne de log. Et activer le swap sur un pool ZFS n'a rien d'anodin — voici la spirale de la mort, et le bon moyen de l'activer.

Le constat : des zvols de swap qui dorment

Tout commence par un diagnostic de routine. swapon --show ne renvoie rien, et free -h annonce une ligne que l'on ne voit pas souvent sur un serveur :

swapon --show
(rien)

free -h | grep Swap
Swap:          0B          0B          0B

Pourtant, le système possède bien des volumes de swap. La commande zfs list -t volume les révèle :

NAME             USED  AVAIL  REFER  MOUNTPOINT
boot-pool/swap   3.11G  256G   3.11G  -
vmpool/swap      27.7G  327G   11.4G  -
ZvolTailleRôle
boot-pool/swap3,1 GoSwap du pool système
vmpool/swap27,7 GoSwap du pool de données et des VM

Les zvols existent, mais aucun n'est monté en swap. C'est le cas par défaut sur TrueNAS Scale, dont la base Debian n'active pas le swap même quand ces volumes sont déjà créés. On a donc un NAS en mémoire uniquement : tant que la RAM suffit, tout va bien.

Pourquoi c'est risqué : le crash silencieux

Sans swap, quand la mémoire vive s'épuise, le noyau n'a aucune soupape pour dégorger. Le scénario redouté n'est pas tant un OOM killer propre, avec ses lignes de log et ses processus gentiment tués. C'est un gel complet, sans écriture de journal.

Sur ce type de matériel, le hardware watchdog — iTCO_wdt avec un délai de 30 secondes sur TrueNAS — détecte que le système ne répond plus et le redémarre. Résultat : des logs qui s'arrêtent net, aucune panic, aucun message d'OOM, et un reboot qui surgit quelques minutes après. On se demande pourquoi la machine s'est éteinte, et la réponse n'est nulle part dans le journal.

La détection passe justement par là : le redémarrage par watchdog laisse une trace dans le journal du cycle précédent.

dmesg | grep -i wdt
journalctl -k -b -1 | grep -i watchdog

Si -b -1 (le boot précédent) contient une ligne watchdog, on tient la cause : la machine a été réinitialisée, pas éteinte proprement. Un swap correctement activé aurait donné au noyau de la marge avant d'en arriver là.

La spirale de la mort du swap ZFS

Voici le piège qui rend l'activation délicate. Un zvol swap est un volume stocké sur le pool ZFS. Or ZFS a besoin de RAM — l'ARC — pour pouvoir écrire sur ce volume. Pendant un stress mémoire, on entre dans une boucle infernale :

Le noyau veut swapuer des pages vers le zvol. Mais pour écrire sur le zvol, ZFS requiert de la RAM pour son cache. L'ARC évince donc d'autres données afin de libérer de la mémoire, ce qui génère plus d'entrées-sorties disque, lesquelles consomment elles-mêmes plus de RAM en buffers. La boucle s'emballe jusqu'à ce que la machine gèle complètement — bien plus vite que si le swap n'existait pas.

La leçon est double. D'abord, ne pas cacher le contenu du swap dans l'ARC. Ensuite, choisir la bonne compression. Ce sont ces deux propriétés qui font la différence.

Activer correctement : les propriétés ZFS

La première règle tient en une ligne : le contenu d'un swap ne doit jamais être mis en cache. On limite donc l'ARC à la métadonnée seule, pas aux données.

zfs set primarycache=metadata vmpool/swap
zfs set compression=zle vmpool/swap
zfs set sync=standard vmpool/swap
sudo swapon /dev/zvol/vmpool/swap

Deux choix sont non négociables :

Si le zvol doit être créé de zéro, on le taille en 4K, adapté au swapping :

zfs create -V 16G -b 4k -o primarycache=metadata -o compression=zle -o sync=standard vmpool/swap
mkswap /dev/zvol/vmpool/swap
sudo swapon /dev/zvol/vmpool/swap

La persistance via systemd : le grand piège

Ajouter une ligne à /etc/fstab semble naturel, mais c'est justement la voie fragile. Au démarrage, systemd tente d'activer le swap avant que ZFS n'ait présenté le device : le service attend le volume qui n'existe pas encore et finit en délai dépassé. Sur ce matériel, un service qui échoue après cinq minutes est presque invisible.

La bonne méthode consiste à faire dépendre l'activation de ZFS lui-même. La cible zfs-volumes.target attend zfs-volume-wait.service, qui garantit que les zvols existent dans /dev. En la déclarant comme dépendance, on s'assure que le swap n'est activé qu'une fois le volume réellement présent.

[Unit]
Description=Activate ZFS zvol swap
DefaultDependencies=no
Before=local-fs.target swap.target
After=zfs-import.target zfs-volumes.target
Requires=zfs-import.target zfs-volumes.target

[Service]
Type=oneshot
RemainAfterExit=yes
ExecStart=/sbin/swapon /dev/zvol/vmpool/swap
ExecStop=/sbin/swapoff /dev/zvol/vmpool/swap
TimeoutStartSec=30

[Install]
WantedBy=swap.target

On active le service, on recharge la configuration :

sudo systemctl daemon-reload
sudo systemctl enable --now zvol-swap.service
swapon --show

Dernier détail, et non des moindres : toujours utiliser le chemin stable /dev/zvol/vmpool/swap, jamais /dev/zd*. Les noms de device /dev/zd* changent à chaque redémarrage, là où le symlink de zvol reste constant. Une ligne de fstab ou de service qui pointe sur un device qui bouge est une ligne qui casse au prochain boot.

Ce qu'on retient

Des zvols de swap qui existent ne veulent pas dire qu'un swap est actif — sur TrueNAS Scale, il faut l'activer soi-même. Sans swap, un stress mémoire ne finit pas en joli message d'OOM : il finit en gel complet, réinitialisé par le watchdog sans qu'aucun log n'en rende compte. Et quand on active le swap ZFS, la technique ne pardonne pas : primarycache=metadata et zle (ou off) sont indispensables pour éviter la spirale de la mort. Enfin, la persistance passe par systemd et sa dépendance à zfs-volumes.target, pas par fstab. Un swap bien posé ne se voit pas au quotidien, mais c'est lui qui transforme un crash muet en simple ralentissement sous pression.

← Retour aux articles