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