Aller au contenu

Tutoriel : Centralisation et Ordonnancement NUT (Network UPS Tools)

Ce guide détaille la configuration d'un cluster de serveurs protégés par un onduleur unique. Le maître gère la liaison USB et informe les esclaves via le réseau afin d'exécuter une extinction propre et ordonnancée en cascade.

🔋 1. Architecture et matériel

Matériel

  • Onduleur : Eaton 3S 850 (Pilote usbhid-ups)
  • Maître (Primary) : Raspberry Pi 5 (Nom d'hôte : primidi)
  • Esclave 1 (Secondary) : Raspberry Pi 5 (Nom d'hôte : quartidi)
  • Esclave 2 (Secondary) : Netgear ReadyNAS OS6 (Nom d'hôte : netgear)
  • Modem/Routeur : Box principale SFR
  • Terminaison Optique : Boîtier ONT / Boîtier Fibre SFR
  • Réseau : Switch Gigabit 8 ports Netis

Adressage IP

  • primidi (Maître) : 192.168.1.101
  • quartidi (Esclave 1) : 192.168.1.104
  • netgear (Esclave 2) : 192.168.1.100

⚙️ 2. Principes de fonctionnement et limites

Protocole de communication

Le Raspberry Pi maître (primidi) est relié en USB à l'onduleur. Il fait tourner le démon upsd (serveur) qui expose l'état de la batterie sur le port 3493. Les esclaves font tourner le démon upsmon (moniteur) qui interroge primidi en continu via le réseau.

Scénario d'extinction en cascade (Seuil 20%)

Dès que la batterie passe sous le seuil critique des 20%, la chorégraphie suivante se déclenche :

  1. T = 0s : primidi lève l'alerte critique. Les esclaves et le maître enclenchent leurs sabliers respectifs. primidi active son compteur de sécurité HOSTSYNC (150s).
  2. T = 5s : quartidi atteint son FINALDELAY (5s). Il lance son shutdown immédiatement et se coupe.
  3. T = 60s : Le Netgear atteint son FINALDELAY (60s). Il lance son shutdown (fermeture propre du RAID) et se coupe.
  4. A l'extinction du Netgear (vers T = 80s/90s) : primidi détecte que la liste des esclaves connectés est tombée à zéro. Il interrompt son attente HOSTSYNC et déclenche son propre FINALDELAY (60s).
  5. T ≈ 140s : primidi a fini de couper proprement ses conteneurs Docker et son système. Dans ses dernières millisecondes de vie, il envoie l'ordre d'extinction à l'onduleur (ups.delay.shutdown). L'onduleur coupe le courant général.

Autonomie et vieillissement de la batterie

Avec une charge comprenant deux Raspberry Pi 5, un ReadyNAS à disques mécaniques, une box et un switch, la consommation globale reste modérée (estimée autour de 50-70W).

  • Autonomie initiale : Sur un Eaton 3S 850 neuf, cette charge permet de tenir environ 35 à 45 minutes avant d'atteindre le seuil critique des 20%. La marge est donc très confortable pour absorber les coupures de courant ordinaires (souvent inférieures à 5 ou 10 minutes) sans déclencher la moindre extinction.
  • Vieillissement et perte de performances : Les batteries d'onduleurs grand public (Plomb-Acide / PbAc) ont une durée de vie moyenne de 3 à 5 ans dans des conditions normales de température (idéalement 20°C).
  • La perte d'autonomie au fil du temps : Au fil des mois et des cycles de décharge, la résistance interne de la batterie augmente, ce qui réduit sa capacité utile. Une batterie en fin de vie (après 4 ans par exemple) verra son autonomie s'effondrer de moitié, voire plus. Le seuil des 20% sera alors atteint beaucoup plus rapidement (parfois en moins de 10 minutes). Il est recommandé de surveiller la valeur battery.runtime via la commande upsc ou de planifier un remplacement préventif dès que l'autonomie estimée chute drastiquement.

Limites matérielles importantes

  • Pas d'ordonnancement au rallumage : L'Eaton 3S est un onduleur grand public. Au retour du courant, il alimente toutes ses prises en même temps. Il est impossible de séquencer logiciellement le réveil des machines (ex: forcer le NAS à démarrer avant les Pi).
  • Le piège du retour secteur "Yoyo" : Si le courant revient pendant les minutes où les machines s'éteignent (pendant le décompte des délais), l'onduleur ne coupera jamais le jus (puisqu'il a retrouvé le secteur). Les machines finiront leur extinction et resteront éteintes.

🛠️ 3. Configuration du maître (primidi)

Installation des paquets

Sur le système maître, il est nécessaire d'installer l'ensemble des outils NUT (le serveur, le client et les pilotes matériels).

sudo apt update
sudo apt install nut nut-server nut-client

/etc/nut/ups.conf

Contient la déclaration du pilote matériel USB.

[eaton3s]
    driver = usbhid-ups
    port = auto
    vendorid = 0463
    desc = "Eaton 3S 850"

/etc/nut/upsd.conf

Configure le serveur pour écouter sur toutes les interfaces réseau (0.0.0.0).

LISTEN 0.0.0.0 3493

/etc/nut/upsd.users

Définition des comptes de connexion (les mots de passe doivent être forts).

[monmaster]
    password = mdp_master_nut_en_clair
    upsmon primary

[monuser]
    password = mdp_user_en_clair
    upsmon secondary

/etc/nut/upsmon.conf

Configuration du moniteur local et des règles de synchronisation des esclaves.

MONITOR eaton3s@192.168.1.101 1 monmaster mdp_master_nut_en_clair primary

# Paramètres d'ordonnancement
HOSTSYNC 150
FINALDELAY 60

  • HOSTSYNC 150 : Temps max (en secondes) alloué aux esclaves pour s'éteindre et se déconnecter avant que le maître n'abandonne l'attente.
  • FINALDELAY 60 : Temps laissé à primidi pour couper proprement Linux et Docker avant la coupure physique de l'onduleur.

📡 4. Configuration de l'esclave 1 (quartidi)

Installation des paquets

Sur les machines esclaves, seul le client de surveillance réseau est nécessaire (pas besoin des pilotes matériels ni du serveur complet).

sudo apt update
sudo apt install nut-client

/etc/nut/upsmon.conf

MONITOR eaton3s@192.168.1.101 1 monuser mdp_user_en_clair secondary

# Extinction immédiate
FINALDELAY 5

💾 5. Configuration de l'esclave 2 (Netgear ReadyNAS)

⚠️ NOTE IMPORTANTE : Sur ReadyNAS OS6, l'interface graphique gère mal les configurations avancées et l'utilisation de comptes universels. La configuration doit être injectée directement en CLI (Root SSH).

/etc/nut/nut.conf

Obligatoire pour que le système accepte de démarrer le service en mode client réseau.

MODE=netclient

/etc/nut/upsmon.conf

MINSUPPLIES 1
SHUTDOWNCMD "/sbin/shutdown -h +0"
POLLFREQ 5
POLLFREQALERT 5
HOSTSYNC 15
DEADTIME 15
POWERDOWNFLAG /etc/killpower
RBWARNTIME 43200
NOCOMMWARNTIME 300
FINALDELAY 60
MONITOR eaton3s@192.168.1.101 1 monuser mdp_user_en_clair secondary
  • FINALDELAY 60 : Laisse 1 minute au NAS pour parquer ses têtes de disques et démonter le volume RAID.

Persistance au redémarrage du NAS

Pour éviter que ReadyNAS OS6 n'éteigne le service au reboot, il faut forcer son activation dans systemd :

systemctl enable nut-monitor.service
systemctl start nut-monitor.service


🔧 6. Commandes utiles pour la maintenance

Vérifier les connexions actives (Depuis primidi)

Permet de s'assurer en un coup d'œil que quartidi (.104) et le Netgear (.100) maintiennent le lien ESTAB :

sudo ss -tun | grep 3493

Interroger l'état de la batterie (Depuis n'importe quelle machine)

upsc eaton3s@192.168.1.101