
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 -
| Zvol | Taille | Rôle |
| boot-pool/swap | 3,1 Go | Swap du pool système |
| vmpool/swap | 27,7 Go | Swap 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 :
- primarycache=metadata — le contenu du swap ne doit pas résider dans l'ARC. C'est précisément ce qui prévient la spirale de la mort.
- compression=zle (ou off) — surtout pas lz4. La charge CPU de la compression lz4 aggrave la situation en stress mémoire, au moment précis où l'on cherche à en économiser.
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