Installation

# apt install nut

Configuration upsd

upsd est un démon qui gère la connexion avec un onduleur branché en port série ou USB à la machine. Il permet à des clients (upsc, upsmon, check_ups) de consulter l’état de l’onduleur.

Onduleur branché en USB

$ lsusb

/etc/nut/ups.conf :

[onduleur]
    driver = usbhid-ups
    port = auto

Onduleur branché sur port série

/etc/nut/ups.conf :

[onduleur]
    driver = apcsmart
    port = /dev/ttyS0

Ajouter un utilisateur

Obligatoire si vous voulez gérer une extinction automatique via upsmon.

/etc/nut/upsd.users :

[upsmon]
   password = XXXX
   upsmon master

Vérification

Vous devez avoir deux process : upsd (qui écoute par défaut sur TCP/3493) et le process qui correspond à votre driver.

# /etc/init.d/nut-server restart
# ps auwx | egrep '(ups|nut)' | grep -v grep
2921  0.0  0.0   9032   684 ?        Ss   01:30   0:00 /lib/nut/usbhid-ups -a onduleur
2924  0.0  0.0  10960   712 ?        Ss   01:30   0:00 /sbin/upsd
# netstat -taupen | grep upsd | grep LISTEN
tcp        0      0 127.0.0.1:3493          0.0.0.0:*               LISTEN      0          28828609    2924/upsd       
tcp6       0      0 ::1:3493                :::*                    LISTEN      0          28828611    2924/upsd

Pour accéder aux infos de l’onduleur en ligne de commande, on peut utiliser upsc :

$ upsc -l
onduleur
$ upsc onduleur@localhost
battery.charge: 100
battery.charge.low: 10
battery.charge.warning: 50
[...]

Configuration upsmon

upsmon est un démon qui va surveiller en permanence l’état de l’onduleur en se connectant à upsd. Il va permettre l’arrêt automatique de la machine si l’état de l’onduleur est en battery.charge.low

upsmon peut tourner sur la même machine que upsd ou sur une machine distante (on peut alors avoir plusieurs machines connectées à un onduleur qui vont s’éteindre automatiquement).

/etc/nut/upsmon.conf :

MONITOR onduleur@localhost 1 upsmon XXXX master

On peut le lancer, on doit avoir deux process : l’un en root et l’autre en nut (connecté en réseau à upsd) :

# /etc/init.d/ups-monitor start
[ ok ] Starting NUT - power device monitor and shutdown controller: nut-client.
$ ps auwx | egrep upsmon | grep -v grep
root      3003  0.0  0.0   8568   432 ?        Ss   01:31   0:00 /sbin/upsmon
nut       3005  0.0  0.0   8992   596 ?        S    01:31   0:00 /sbin/upsmon
# netstat -taupen | grep upsmon
tcp        0      0 127.0.0.1:54108         127.0.0.1:3493          ESTABLISHED 115        28832727    3005/upsmon

Check Nagios

Un check Nagios est inclus dans les plugins de base :

$ /usr/lib/nagios/plugins/check_ups -u onduleur
UPS OK - Status=Online Utility=241.0V Batt=100.0% Load=21.0% |voltage=241000mV;;;0 battery=100%;;;0;100 load=21%;;;0;100

Howto nut