Intégrations

Onduleur (NUT, apcupsd)

Afficher un onduleur lu par Network UPS Tools ou apcupsd, y compris les modèles sans écran.

Le widget Onduleur indique si la charge est alimentée par le secteur ou par la batterie, la charge de la batterie et l’autonomie qu’elle laisse, le temps avant l’arrêt automatique, la consommation en watts et la tension du secteur. Il dit clairement quand la batterie doit être remplacée, quand l’onduleur est en surcharge ou quand le serveur l’a perdu. Beaucoup d’onduleurs n’ont ni écran ni interface de gestion : dès qu’un serveur les lit en USB, le widget montre ce qu’ils n’affichent jamais.

Sources

SourceOù elle tournePort
Network UPS Tools (NUT)Synology, QNAP, TrueNAS, Unraid (extension), Proxmox, tout Linux, ou un conteneur NUT. Des milliers de modèles USB avec le pilote usbhid-ups3493
apcupsdOnduleurs APC, réglages onduleur intégrés d’Unraid, Linux3551

La lecture est en lecture seule : NasDash n’envoie jamais de commande à l’onduleur.

NUT sous Linux

Installez le paquet nut sur la machine où l’onduleur est branché, puis décrivez l’onduleur, laissez le serveur écouter le réseau et passez en mode réseau :

/etc/nut/ups.conf
[ups]
  driver = usbhid-ups
  port = auto
  desc = "Rack UPS"
/etc/nut/upsd.conf
LISTEN 0.0.0.0 3493
/etc/nut/nut.conf
MODE=netserver

Redémarrez NUT, vérifiez que l’onduleur répond, et autorisez le port TCP 3493 depuis l’adresse de NasDash dans le pare-feu :

upsc ups

Un outil du fabricant qui lit déjà l’onduleur en USB (par exemple CyberPower PowerPanel) doit d’abord être arrêté : un seul programme peut tenir le lien USB. Si cet outil éteignait la machine en batterie faible, reprenez les mêmes seuils dans NUT (override.battery.charge.low, override.battery.runtime.low avec ignorelb) et laissez upsmon de NUT l’éteindre.

Sur un NAS, activez plutôt son serveur UPS réseau et ajoutez l’adresse de NasDash aux appareils autorisés.

Le connecter

  1. Ouvrez Réglages → Intégrations → Onduleur.
  2. Choisissez Network UPS Tools ou apcupsd et saisissez l’adresse du serveur, par exemple nas.example.com ; laissez le port vide pour la valeur par défaut.
  3. Enregistrez et testez la connexion.

NUT ne demande pas de compte pour lire : il autorise les lecteurs par adresse. Quand un serveur NUT surveille plusieurs onduleurs, chaque widget en choisit un dans ses réglages.

NasDash 0.3.6 permet d’enregistrer plusieurs connexions NUT et apcupsd. Donnez à chacune un nom distinct dans Paramètres → Intégrations, puis choisissez la connexion dans les réglages de chaque widget Onduleur. Pour NUT, choisissez séparément l’onduleur sur ce serveur ; choisir un autre onduleur ne crée pas de connexion à un autre serveur.

Arrêt automatique

Quand le serveur donne ses seuils d’arrêt (NUT battery.charge.low et battery.runtime.low, apcupsd MBATTCHG et MINTIMEL), le widget estime le temps avant l’arrêt des machines à la consommation actuelle : sur secteur, ce que laisserait une coupure ; sur batterie, un compte à rebours. C’est une estimation : une batterie se vide plus vite en fin de charge.

Affichage

Complet montre les chiffres ; Compact tient sur une ligne. En Complet, chaque élément peut être masqué : barre de batterie, autonomie, arrêt automatique, consommation, tension secteur et coupures. Détails ajoute la tension de sortie et de la batterie, la fréquence du secteur et la température quand l’onduleur les donne. Certains onduleurs renvoient une tension de sortie aberrante via NUT ; elle est écartée.

Accès

Les visiteurs ont besoin de la permission Onduleur (Réglages → Utilisateurs et accès). L’adresse du serveur ne quitte jamais le serveur NasDash. La démo publique montre un onduleur fictif.