🔌🪫Onduleur 'Eaton Protection Station 800 USB'

Onduleur “Eaton Protection Station 800 USB” sur serveur Debian pour protéger des équipements de coupure de courant et/ou de surtension pouvant intervenir lorsque les appareils sont en fonctionnement.

Onduleur Eaton Protection Station 800 USB

Matériel

No	Eaton Protection Station - 650/800
7	4 prises filtrées.
8	4 prises secourues par batterie.
9	Voyant allumé, protection anti-surtensions active sur les 8 prises.
10	Voyant allumé, défaut de l’Alimentation Sans Interruption.
11	Bouton de mise en service ou d’arrêt des prises secourues.
12	Disjoncteur de protection.

Network UPS Tools (NUT)

Nut (Network UPS Tools) est un logiciel linux de surveillance des onduleurs. Il est disponible sur la majorité des distributions et permet notamment, pour les onduleurs le supportant, d’automatiquement éteindre proprement un serveur lorsque la batterie de l’onduleur arrive à terme. Nous allons voir l’installation sur une distribution debian.

NUT est un ensemble d’outils permettant de monitorer un système relié à un ou des onduleurs.Il se compose de plusieurs éléments :

• le démon nut lancé au démarrage du système
• le démon upsd qui permet d’interroger l’onduleur, il est lancé sur le PC relié à l’onduleur
• le démon upsmon qui permet de monitorer et lancer les commandes nécessaires sur le réseau ondulé (arrêt de machines …)
• différents programmes pour envoyer des commandes manuellement à l’onduleur : upsc, upsdrvctl …

upsd peut communiquer avec plusieurs onduleurs si nécessaire.
upsmon interroge à intervalle régulier la machine du réseau sur laquelle est lancée upsd.

Installer NUT et branchement

Installez nut, les paquets supplémentaires seront automatiquement installés :

sudo apt install nut -y

Paquet virtuel qui dépend de nut-client et nut-server
nut-client contient entre autres les exécutables upsc, upscmd, upsmon
nut-server contient entre autre upsd, upsdrvctl

Connecter un câble USB-B entre l’onduleur et un port USB du serveur
Relever le périphérique:

lsusb

Bus 003 Device 002: ID 0463:ffff MGE UPS Systems UPS

Vérifier que le fichier appartient bien au groupe nut:

ls -l /dev/bus/usb/003/002

crw-rw-r-- 1 root nut 189, 257  5 mai   15:50 /dev/bus/usb/003/002

Pilote de l’onduleur (ups.conf)

Communication avec l’onduleur, choisir le driver et le port , ce qui fait dans le fichier /etc/nut/ups.conf. Chaque onduleur doit être défini sous la forme

[upsname]
       driver = <drivername>
       port = <portname>
       desc = "Commentaire"

On peut mettre auto pour le port et le champ desc pour mettre une description plus complète

Le fichier /usr/share/nut/driver.list contient une liste d’onduleurs et le driver qu’il faut utiliser.

On peut aussi tester la commande sudo nut-scanner -U, qui renvoie un bloc de configuration auto-detecté

Scanning USB bus.
[nutdev1]
	driver = "usbhid-ups"
	port = "auto"
	vendorid = "0463"
	productid = "FFFF"
	product = "Protection Station"
	serial = "AN2E49008"
	vendor = "EATON"
	bus = "003"
	device = "002"
	busport = "001"
	###NOTMATCHED-YET###bcdDevice = "0100"

On ne tient pas compte des erreurs car le service n’est pas lancé

Utilisation du driver “usbhid-ups”

sudo nano /etc/nut/ups.conf

Ajouter ce qui suit en fin de fichier

[eaton]
  driver = usbhid-ups
  port = auto
  vendorid = 0463
  productid = FFFF
  desc = "Onduleur Eaton Protection Station 800"

Configuration daemon

Il sert à mettre les informations de l’onduleur à disposition des clients.

Lancement via un service (nut.conf)

Le fichier nut.conf permet de déterminer le comportement du démon NUT. Il ne contient que le paramètre MODE qui peut prendre les valeurs suivantes :

• none : C’est la valeur par défaut après l’installation du paquet, elle indique que NUT n’a pas été configuré.
• standalone : * Dans ce mode, l’onduleur est relié à la machine actuelle. * Le monitorage de l’onduleur est effectué depuis cette même machine. * Le démon nut doit lancer upsd et upsmon (en mode “master”).
• netserver : * Dans ce mode, l’onduleur est relié à la machine actuelle. * La gestion de l’onduleur est effectuée depuis un poste client sur le réseau. * Le démon nut doit lancer upsd et upsmon (en mode serveur, c’est à dire en tant que “master”).
• netclient :
  • Dans ce mode, l’onduleur n’est pas relié à la machine actuelle.
  • La gestion de l’onduleur est réalisée depuis la machine actuelle vers la machine à laquelle est connectée l’onduleur via le réseau.
  • Le démon nut doit lancer uniquement upsmon (en mode client, c’est à dire en tant que “slave”).

Mode standalone, l’onduleur est relié à la machine actuelle (serveur).

sudo nano /etc/nut/nut.conf

MODE=standalone

On démarre et active le service

sudo systemctl enable nut-server --now

Utilisateurs (upsd.users)

Il faut définir (au moins) les paramètres pour l’administrateur et au moins un utilisateur de type “master” dans upsd car une authentification sera nécessaire pour effectuer certaines commandes, notamment celles d’upscmd qui permettent de contrôler l’onduleur (bip, extinction etc).

sudo nano /etc/nut/upsd.users

[admin]
    password = adminpass
    actions = SET
    instcmds = ALL

[upseaton]
    password  = userpass
    upsmon master

password
Définir le mot de passe pour cet utilisateur.

upsmon
Ajouter les actions nécessaires pour un processus ascendant au travail. C’est soit réglé à “master” ou “slave”.

Moniteur automatique (upsmon.conf)

upsmon est le composant qui va surveiller l’état de l’onduleur, et lancer des actions selon l’état (sur batterie, batterie critique, etc).

La déclaration des différents démons upsmon serveurs à écouter et de la puissance nécessaire au réseau ondulé se fait grâce aux options suivantes :

• MONITOR <system> <powervalue> <username> <password> <type> * <system> : définit le nom d’un onduleur et de la machine qui le contrôle. Par défaut, l’onduleur est supposé accessible depuis la machine actuelle (localhost). * <powervalue> : un entier qui définit le nombre d’onduleurs contrôlés. Sauf cas particulier, la valeur est supposée de 1. * <username> : le nom d’utilisateur utilisé pour interroger upsd. Il doit être définit dans le fichier upsd.users sur la machine qui contrôle l’onduleur. * <password> : le mot de passe associé à l’utilisateur sur la machine qui contrôle l’onduleur. * <type> : le type de monitorage tel que définit dans le fichier upsd.users de la machine qui contrôle l’onduleur.
• MINSUPPLIES : un entier qui définit le nombre d’onduleurs nécessaires pour que le système fonctionne ; en général, 1 onduleur.

On définit au moins 1 onduleur à surveiller :

# On surveille l'onduleur qui est directement relié (master)
MONITOR eaton@localhost 1 upseaton mypass master
# Commande lancée quand quelque chose se passe
NOTIFYCMD /sbin/upssched

Le “1” correspond au nombre d’alims qui sont alimentés par l’onduleur en question ; pour la plupart des pcs standard, qui n’ont qu’une seule alim, ce sera 1.

On peut toutefois entrer “0” si le pc surveille l’onduleur mais n’est pas branché dessus ; il effectuera les actions d’alerte (mail etc.) mais ne s’éteindra pas en cas de batterie critique. En ce cas, il faut aussi définir la variable MINSUPPLIES à 0 (pour déclarer que le poste peut fonctionner sans aucun onduleur).

Lorsque le nombre d’onduleurs nécessaires pour maintenir le système (MINSUPPLIES) devient inférieur au nombre d’onduleurs en statut “sur secteur” (ONLINE) ou “sur batterie” (ONBATT) sans être en statut “batterie faible” (LOWBATT), le réseau ondulé entre dans un état critique. En d’autres termes, le dernier onduleur pour maintenir le système vient de passer en statut "batterie faible" (LOWBATT), et l’alimentation va donc cesser prochainement : le but est donc d’éteindre proprement le système pour éviter une perte de données, il n’y a plus le temps d’attendre que le courant revienne !
À ce moment là, les paramètres suivants seront utilisés :

• FINALDELAY : délai en secondes entre la notification aux utilisateurs et le lancement de la commande d’arrêt du système.
• HOSTSYNC : délai laissé aux autres upsmon sur les postes clients pour s’arrêter correctement, au delà de ce délai l’upsmon serveur est stoppé et ne répond plus aux clients.
• SHUTDOWNCMD : définit la commande qui sera exécutée pour éteindre la machine actuelle.
• POWERDOWNFLAG : définit le fichier qui sera écrit juste avant la procédure d’arrêt. Il est possible de tester la présence de ce fichier dans vos scripts init pour accélérer la phase d’arrêt.

Pour permettre à l’upsmon client d’interroger le démon upsmon serveur ou le démon upsd et obtenir des informations “fraiches” sur l’état de (ou des) l’onduleur(s), il faut vérifier les paramètres suivants, et les adapter en fonction du pilote utilisé :

• POLLFREQ : intervalle de temps avant rafraîchissement des données sur l’état de l’onduleur.
• POLLFREQALERT : intervalle de temps avant rafraichissement une fois l’onduleur en statut “sur batterie” (ONBATT). Doit être inférieur ou égal à POLLFREQ.
• DEADTIME : délai maximal pendant lequel un onduleur peut être déclaré “absent” avant d’être déclaré “mort”. Passé ce délai, si l’onduleur était précédemment en statut “sur batterie” (ONBATT) il sera considéré en statut “batterie faible” (LOWBATT), ce qui peut causer l’arrêt du système. Le délai doit être un multiple de POLLFREQ et POLLFREQALERT.
• NOCOMMWARNTIME : délai d’attente avant notification de la perte de communication avec l’onduleur.
• RBWARNTIME : lorsqu’un onduleur indique un changement de batterie, une notification sera envoyée toutes les RBWARNTIME secondes.
• NOTIFYCMD <command>: upsmon appelle cela pour envoyer des messages lorsque des choses se produisent, vous pouvez utiliser le programme upssched comme votre NOTIFYCMD

Sur le serveur relié à l’onduleur

sudo nano /etc/nut/upsmon.conf 

# On surveille l'onduleur qui est directement relié (master)
MONITOR eaton@localhost 1 upseaton mot_passe_upseaton master
# Notre serveur n'a pas d'alimentation redondante
MINSUPPLIES 1
# Commande lancée quand quelque chose se passe
SHUTDOWNCMD "/sbin/shutdown -h +0"
# Interval entre deux interrogations de upsd
POLLFREQ 5
# Intervalle entre deux interrogations de upsd en mode "batterie"
POLLFREQALERT 5
# Temps d'attente pour la déconnexion des upsmon esclaves
HOSTSYNC 15
# Temps pendant lequel on tolère la non-réponse d'un onduleur, multiple de POLLFREQ
DEADTIME 15
# Fichier d'état
POWERDOWNFLAG "/etc/killpower"
# OFFDURATION - mettre l’état « OFF » en vigueur s’il persiste pendant plusieurs secondes
OFFDURATION 30
# un onduleur indique un changement de batterie, une notification sera envoyée toutes les `RBWARNTIME` secondes.
RBWARNTIME 43200
#  délai d'attente avant notification de la perte de communication avec l'onduleur.
NOCOMMWARNTIME 300
# délai en secondes entre la notification aux utilisateurs et le lancement de la commande d'arrêt du système.
FINALDELAY 5
# Alternativement, vous pouvez utiliser le programme upssched comme votre NOTIFYCMD
# Commande lancée quand quelque chose se passe
NOTIFYCMD /sbin/upssched

On remarque que, à part l’arrêt du système sur fin des batteries qui est géré par upsmon, toutes les notifications le sont par upssched.

Distributeur d’évènements (/etc/nut/upssched.conf)

L’utilitaire upssched permet de « temporiser » les actions liées aux évènements générés par upsmon.
C’est surtout intéressant lorsque des évènements furtifs se produisent (microcoupures) fichier /etc/nut/upssched.conf.

sudo nano /etc/nut/upssched.conf

# Script lancé par upssched pour gérer les évènements et les timers associés
CMDSCRIPT /usr/bin/upssched-cmd
# Fichier pour noter les états internes de upssched
PIPEFN /run/nut/upssched/upssched.pipe
# Fichier de lock pour éviter un conflit en cas de notification de deux évènements simultanés
LOCKFN /run/nut/upssched/upssched.lock

# En cas de perte de communication avec l'onduleur
AT COMMBAD * EXECUTE perte-liaison

# En cas de retour secteur, on stope la minuterie et on notifie
AT ONLINE * CANCEL-TIMER attente-retour-secteur
AT ONLINE * EXECUTE charge-sur-secteur

# En cas de perte de secteur, on se laisse au maximum 20 minutes avant d'agir et on notifie
AT ONBATT * START-TIMER attente-retour-secteur 1200
AT ONBATT * EXECUTE charge-sur-batterie

# En cas de niveau de batteries trop bas
AT LOWBATT * EXECUTE batteries-vides

# En cas de fin de vie des batteries on sera prévenu
AT REPLBATT * EXECUTE batteries-hs

# En cas d'arrêt (fin des 20 minutes  ou fin d'autonomie), on notifie.
AT SHUTDOWN * EXECUTE arret-en-cours

Prise en charge des évènements (script /usr/bin/upssched-cmd)

Fichier /usr/bin/upssched-cmd

sudo nano /usr/bin/upssched-cmd

#! /bin/sh

# Ce script doit être appelé par upssched via la directive CMDSCRIPT.
#
# Analyse argument
#
case $1 in

 	"charge-sur-batterie")
			sujet="L'onduleur a basculé sur les batteries"
			message="L'arrêt système sera demandé si le secteur ne revient pas." 
	;;

	"attente-retour-secteur")
		sujet="Onduleur - Fin d'attente de retour secteur"
		message="Cela fait trop longtemps que le secteur est absent...Un arrêt forcé est en cours !"

		# Demande d'arrêt forcé (force shut down)
		/sbin/upsmon -c fsd
	;;

	"charge-sur-secteur")
		sujet="Onduleur - retour secteur"
		message="L'onduleur est revenu sur secteur."
	;;

	"batteries-vide")
		sujet="Onduleur - Batteries vides"
		message="Les batteries sont vides, l'arrêt est imminent."
	;;

	"arret-en-cours")
		sujet="Onduleur - Arrêt en cours du serveur"
		message="Le système est en cours d'arrêt."
	;;

	"perte-liaison")
                sujet="Onduleur - Perte de liaison avec l'onduleur"
                message="La communication avec l'onduleur est interrompue."
         ;;


	"batteries-hs")
                sujet="Onduleur - URGENT - batteries HS"
                message="Les batteries sont à remplacer d'urgence."
	;;

	*)
		sujet="Onduleur - Commande inconnue : $1" 
		message="Une commande inconnue a été envoyée par l'onduleur..."
	;;

esac


# Envoi d'une notification
curl  --ipv4 \
-H "X-Email: ntfy@cinay.eu" \
-H "Title: $sujet" \
-H "Authorization: Bearer tk_xxxxxxxxxxxxxxxxxxxxxxxxx" \
-H "Priority: high" \
-H "Tags: red_circle,warning" \
-d "$message" \
https://ntfy.rnmkcy.eu/yan_infos

Redémarrer les services

sudo systemctl restart nut-server

vérifier si les daemons sont lancés

ps auxf |grep ^nut

nut         2586  0.0  0.0  14200  2152 ?        Ss   15:59   0:03 /usr/lib/nut/usbhid-ups -a eaton
nut         5068  0.0  0.0   7572  3720 ?        Ss   17:48   0:00 /lib/nut/upsd -F

Onduleur connecté ?

upsc permet de s’adresser à un démon upsd.

# pour lister tous les onduleurs détectés sur host ; si l’host n’est pas spécifié, c’est localhost.
upsc -L

Liste

Init SSL without certificate database
eaton: Onduleur Eaton Protection Station 800

Liste des paramètres

upsc eaton@localhost

Pour éviter l’affichage du message “Init SSL without certificate database”, ajouter 2>&1 | grep -v '^Init SSL' à la commande
Exemple: upsc eaton@localhost 2>&1 | grep -v '^Init SSL'

Les paramètres

Etendre Réduire...

battery.charge: 100
battery.charge.low: 20
battery.runtime: 1082
battery.type: PbAc
device.mfr: EATON
device.model: Protection Station 800
device.serial: AN2E49008
device.type: ups
driver.debug: 0
driver.flag.allow_killpower: 0
driver.name: usbhid-ups
driver.parameter.pollfreq: 30
driver.parameter.pollinterval: 2
driver.parameter.port: auto
driver.parameter.productid: FFFF
driver.parameter.synchronous: auto
driver.parameter.vendorid: 0463
driver.state: updateinfo
driver.version: 2.8.1
driver.version.data: MGE HID 1.46
driver.version.internal: 0.52
driver.version.usb: libusb-1.0.28 (API: 0x100010a)
input.transfer.high: 264
input.transfer.low: 184
outlet.1.desc: PowerShare Outlet 1
outlet.1.id: 2
outlet.1.status: on
outlet.1.switchable: no
outlet.2.desc: PowerShare Outlet 2
outlet.2.id: 3
outlet.2.status: on
outlet.2.switchable: no
outlet.desc: Main Outlet
outlet.id: 1
outlet.power: 25
outlet.switchable: no
output.frequency.nominal: 50
output.voltage: 230.0
output.voltage.nominal: 230
ups.beeper.status: enabled
ups.delay.shutdown: 20
ups.delay.start: 30
ups.firmware: 1.13
ups.load: 14
ups.mfr: EATON
ups.model: Protection Station 800
ups.power.nominal: 800
ups.productid: ffff
ups.realpower: 90
ups.serial: AN2E49008
ups.status: OL
ups.timer.shutdown: -1
ups.timer.start: -1
ups.vendorid: 0463

Pour afficher un paramètre

upsc eaton@localhost ups.status 2>&1 | grep -v '^Init SSL'

Définitions des codes renvoyés par ups.status

Abrégé	Définition
OL	En ligne (pas de coupure de courant) (à l’opposé de OB - sur batterie)
LB	Batterie faible
SD	Shutdown load, arrêt en cours
CP	Câble d’alimentation
CTS	Clear to Send. Reçu de l’UPS.
RTS	Ready to Send. Envoyé par le PC.
DCD	Détection de porteuse de données. Reçu de l’UPS.
RNG	Ring indicateur. Reçu de l’UPS.
DTR	Terminal de données prêt. Envoyé par le PC.
ST	Envoyer un BREAK sur la ligne de données d’émission

Tester l’envoi notification

Le plus simple est de débrancher la liaison USB entre l’onduleur et le serveur, puis de le rebrancher
Un message devrait parvenir au destinataire de la notification…

Envoyer une commande

Liste des commandes disponibles

upscmd -l eaton@localhost

Etendre Réduire...

Commandes instantanées prises en charge sur l’onduleur [eaton] :

beeper.disable - Désactiver l’avertisseur UPS
beeper.enable - Activez le beeper UPS
beeper.mute - Couper temporairement le bip UPS
beeper.off - Obsolète (utilisez beeper.disable ou beeper.mute)
beeper.on - Obsolète (utilisez beeper.enable)
driver.killpower - Dites au démon du conducteur de lancer l’arrêt de l’onduleur ; il doit être déverrouillé avec l’option driver.flag.allow_killpower ou un paramètre variable
driver.reload - Recharger la configuration du pilote en cours d’exécution à partir du système de fichiers (ne fonctionne que pour les modifications dans certaines options)
driver.reload-or-error - Recharger la configuration du pilote en cours d’exécution à partir du système de fichiers (ne fonctionne que pour les modifications dans certaines options) ; renvoyer une erreur si quelque chose a changé et n’a pas pu être appliqué en direct (afin que l’appelant puisse le redémarrer avec de nouvelles options)
driver.reload-or-exit - Recharger la configuration du pilote en cours d’exécution à partir du système de fichiers (ne fonctionne que pour les modifications dans certaines options) ; quitter le pilote en cours si quelque chose a changé et n’a pas pu être appliqué en direct (afin que l’infrastructure de gestion des services puisse la redémarrer avec de nouvelles options)
load.off - Éteignez immédiatement la charge
load.off.delay - Arrêtez la charge avec un délai (secondes)
load.on - Allumez immédiatement la charge
load.on.delay - Active la charge avec un délai (secondes)
shutdown.return - Éteignez la charge et revenez lorsque le courant est de retour
shutdown.stayoff - Éteignez la charge et restez éteint
shutdown.stop - Arrêter un arrêt en cours

Envoyer une commande

upscmd -u <username> -p <password> <system> <command>

Liens

• Eaton Protection Station - 650/800 - Manuel d’installation et d’utilisation
• Network UPS Tools (NUT)