Create HowtoNut
This commit is contained in:
parent
b2ed4b108f
commit
06c15c3432
97
HowtoNut.md
Normal file
97
HowtoNut.md
Normal file
|
@ -0,0 +1,97 @@
|
||||||
|
# Howto nut
|
||||||
|
|
||||||
|
<http://networkupstools.org/documentation.html>
|
||||||
|
|
||||||
|
## 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*) 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](#configuration-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
|
Loading…
Reference in a new issue