18
0
Fork 0

Create HowtoNut

This commit is contained in:
gcolpart 2016-09-15 02:09:19 +02:00
parent b2ed4b108f
commit 06c15c3432
1 changed files with 97 additions and 0 deletions

97
HowtoNut.md Normal file
View 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