Nut

Cette page décrit la configuration de nut pour Debian/Squeeze.

Quelques liens sur nut

Principes de base

La plupart du temps, un onduleur alimente plusieurs serveurs, typiquement 2 à 4 pour un 1500VA. Mais un seul serveur est relié à l'onduleur par un port série, c'est donc ce serveur qui sait quand le courant est coupé, quand l'onduleur n'a plus assez d'autonomie, quand le courant revient, etc. Cependant les autres serveurs doivent aussi être informés de ces évenements, ne serait-ce que pour effectuer un shutdown propre en fin d'autonomie de l'onduleur.

nut permet cela via différents composant :

nut propose aussi des outils pour programmer l'onduleur (notamment les délais de redémarrage), pour se connecter à un onduleur SNMP, pour diffuser les infos sur le web, etc.

Configuration d'un serveur master

À faire sur chaque serveur relié à un onduleur par port série ou USB. C'est ce serveur qui préviendra les autres (slaves).

  1. installer le contrôleur et le moniteur avec aptitude install nut1

  2. compléter le fichier /etc/nut/ups.conf :

    • exemple pour le cas où l'onduleur est relié au serveur via un port RS-232 : 

      [AUF_BAN1]
  driver = apcsmart
  port = /dev/ttyS0
  desc = "APC SmartUPS SU3000 RM"

    • exemple pour le cas où l'onduleur est relié au serveur via un port USB : 

      [AUF_VN42]
  driver = usbhid-ups # pour Etch, utiliser hidups (support incomplet et bogué)
  port = auto
  desc = "APC SmartUPS SUA1500 RMI 2U"

    • /!\ Le pilote USB a besoin des droits accès au périphérique USB dans /dev/bus/usb/VVV/NNN (cf lsusb pour trouver les valeurs) ; ces droits sont donnés dynamiquement via des règles pour udev, mais cela réclame au minimum un redémarrage du serveur juste après l'installation du paquet nut.

  3. compléter le fichier /etc/nut/upsd.conf : 

    LISTEN 127.0.0.1 3493
LISTEN 10.36.0.254 3493

  4. compléter le fichier /etc/nut/upsd.users : 

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

[localhost]
  password = localhost
  upsmon master

[dmzpub]
  password = dmzpub
  upsmon slave

  5. vérifier le fichier /etc/nut/upsmon.conf : 

    # /etc/nut/upsmon.conf
MONITOR AUF_BAN1@localhost 1 localhost localhost master
MINSUPPLIES 1
SHUTDOWNCMD "/sbin/shutdown -h +0"
# NOTIFYCMD /usr/local/ups/bin/notifyme
POLLFREQ 5
POLLFREQALERT 5
HOSTSYNC 15
DEADTIME 15
POWERDOWNFLAG /etc/killpower
FINALDELAY 5

  6. mettre MODE=standalone (unique serveur sur cet UPS) ou bien MODE=netserver (plusieurs serveurs sur cet UPS) dans /etc/nut/nut.conf

  7. ajouter nut au groupe dialout pour que nut ait accès au port série : 

    # addgroup nut dialout

  8. et pour qu'il puisse lire les configurations : 

    # chown root:nut /etc/nut/upsd.* /etc/nut/upsmon.conf
# chmod u=rw,g=r,o= /etc/nut/upsd.* /etc/nut/upsmon.conf

  9. lancer la surveillance avec service nut start

  10. tester si nut peut bien communiquer avec l'onduleur : 

    # upsc AUF_BAN1
battery.alarm.threshold: 0
battery.charge: 100.0
battery.charge.restart: 15
battery.date: 12/09/99
battery.packs: 000
battery.runtime: 16740
...

Mais il ne faut pas oublier de programmer l'onduleur quand c'est possible (et avec les APC justement ça l'est) ! Il faut par exemple signifier à l'onduleur qu'il ne doit redémarrer après une coupure que si les batteries sont chargées à 15%. Voici comment faire avec un APC :

  1. lancer la commande upsrw AUF_BAN1@localhost pour voir les programmations possibles

  2. exemple d'utilisation : upsrw -s ups.id="AUF_BAN1" -u admin -p admin AUF_BAN1@localhost

  3. j'ai mis en place les paramètres suivants :

    • ups.id="AUF_BAN1" (identifiant **interne** de l'onduleur, au cas où on ne l'aurait pas étiqueté ;-))

    • battery.runtime.low="120" (point critique quand il ne reste que 2 min de fonctionnement sur batterie)

    • battery.charge.restart="15" (on attend que la batterie soit rechargée au minimum à 15% avant de relancer)

    • ups.delay.shutdown="120" (on attend 2 min après la demande de shutdown avant de couper effectivement)

    • ups.delay.start="060" (on attend 1 min après le retour du courant avant de démarrer)

    • ups.test.interval="604800" (on effectue des auto-tests de l'onduleur toutes les semaines)

NB : onduleur relié au serveur via un port USB

C'est tout ! N'oubliez pas de relancer Nut.

Cas d'un onduleur joignable via SNMP (merci TsvetanPetkov)

Si votre onduleur dispose d'une surveillance par SNMP :

  1. aptitude install nut-snmp

  2. ajouter dans le fichier /etc/nut/ups.conf : 

    [MGE_EX30]
         driver = snmp-ups
         port = 168.8.26.116
         community = public
         snmp_version = v1
         mibs = ietf
         pollfreq = 15
         desc = "MGE EX30 - 1950W"

  3. relancer le service avec /etc/init.d/nut restart

  4. utiliser la commande: upsc MGE_EX30@localhost pour voir si l'onduleur est bien configuré

Configuration d'un slave

  1. installer le moniteur avec aptitude install nut2

  2. compléter le fichier /etc/nut/upsmon.conf : 

    # /etc/nut/upsmon.conf
MONITOR AUF_BAN1@zeus.auf.org 1 dmzpub dmzpub slave
MINSUPPLIES 1
SHUTDOWNCMD "/sbin/shutdown -h +0"
# NOTIFYCMD /usr/local/ups/bin/notifyme
POLLFREQ 5
POLLFREQALERT 5
HOSTSYNC 15
DEADTIME 15
POWERDOWNFLAG /etc/killpower
FINALDELAY 5

  3. mettre MODE=netclient dans /etc/nut/nut.conf

  4. lancer la surveillance (connexion avec le master) avec service nut start

/!\ Les serveurs slaves utilisent le port 3493/TCP pour communiquer avec le serveur master.

Configuration de l'interface web

(!) Il est déconseillé d'installer l'interface web au même endroit que le service nut lui-même. Le service nut sera typiquement installé dans la partie hôte OpenVZ, alors que l'interface web nut-cgi sera installée dans un conteneur OpenVZ dédié au web.

  1. installer le script avec aptitude install nut-cgi

  2. si l'onduleur est relié au serveur via un port USB il faut également ajuster la colonne de température dans le squelette /etc/nut/upsstats.html comme suit : 

    <td BGCOLOR="#00FF00">
@IFSUPP ups.temperature@
@UPSTEMP@
@DEGREES@
@ELSE@
@IFSUPP battery.temperature@
@VAR battery.temperature@
@DEGREES@
@ENDIF@
</td>

  3. compléter le fichier /etc/nut/hosts.conf : 

    # /etc/nut/hosts.conf
MONITOR AUF_BAN1@zeus.auf "AUF_BAN1 : local technique 3032"
MONITOR AUF_BAN5@db.auf "AUF_BAN5 : local technique 3032"
MONITOR AUF_BAN6@backup.auf "AUF_BAN6 : local technique 3034"

  4. consulter la page http://new-intranet.auf/cgi-bin/nut/upsstats.cgi Pratique, non ?

Configuration des alertes par mail ou IM

...

  1. ou nut-server depuis wheezy (1)

  2. A partir de wheezy le paquet pour le moniteur s'appelle nut-client (2)

Nut (dernière édition le 2013-09-08 12:40:29 par WillyManga)