Cette page décrit la configuration de ''nut'' pour [[Debian/Squeeze]]. = Quelques liens sur nut = * site officiel http://www.networkupstools.org/ * une bonne doc en français pour [[Debian]], claire et précise http://linux.developpez.com/cours/upsusb/ * un portage Windows (uniquement le moniteur, ce qui suffit) http://www.csociety.org/~delpha/winnut/ = 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 : * sur le serveur maître (''master'') qui relié à l'onduleur, on installe le ''controleur'' qui lit les informations via le port série et les propose via le réseau * sur tous les serveurs (''master'' et ''slave'') relié au même onduleur, on installe un ''moniteur'' qui ira chercher, en local ou via le réseau, les informations sur l'état de l'onduleur et agira en fonction (par exemple éteindre le serveur en cas d'autonomie trop faible). ''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 nut`<> 1. 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`. 1. compléter le fichier `/etc/nut/upsd.conf` : {{{ LISTEN 127.0.0.1 3493 LISTEN 10.36.0.254 3493 }}} 1. 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 }}} 1. 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 }}} 1. mettre `MODE=standalone` (unique serveur sur cet UPS) ou bien `MODE=netserver` (plusieurs serveurs sur cet UPS) dans `/etc/nut/nut.conf` 1. ajouter `nut` au groupe `dialout` pour que nut ait accès au port série : {{{ # addgroup nut dialout }}} 1. 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 }}} 1. lancer la surveillance avec `service nut start` 1. 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 1. exemple d'utilisation : `upsrw -s ups.id="AUF_BAN1" -u admin -p admin AUF_BAN1@localhost` 1. 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 '''__ Si vous obtenez un truc du genre : {{{ This APC device (051d:0003) is not (or perhaps not yet) supported by usbhid-ups. Please make sure you have an up-to-date version of NUT. If this does not fix the problem, try running the driver with the '-x productid=0003' option. }}} Voici comment procéder : * modifier `/lib/udev/rules.d/52-nut-usbups.rules` pour ajouter une nouvelle ligne correspondant à votre ups (dans l'extrait ci-dessus APC device (051d:'''0003''')) {{{ # various models - usbhid-ups ATTR{idVendor}=="051d", ATTR{idProduct}=="0002", MODE="664", GROUP="nut" ATTR{idVendor}=="051d", ATTR{idProduct}=="0003", MODE="664", GROUP="nut" }}} * relancer udev : `udevadm control --reload-rules` * configurer `ups.conf` comme suit : {{{ [AUF_MTL1] driver = usbhid-ups productid = 0003 port = auto desc = "APC SmartUPS SMX2200RMLV2U" }}} C'est tout ! N'oubliez pas de relancer Nut. __'''A vérifier en cas de problème'''__ # lsusb {{{ Bus 005 Device 002: ID 051d:0003 American Power Conversion UPS }}} # ls -l /dev/bus/usb/005 {{{ crw-rw-r-- 1 root root 189, 512 27 mars 10:42 001 crw-rw-r-- 1 root nut 189, 513 27 mars 11:12 002 }}} '''Le périphérique 005 doit être associé au groupe nut.''' crw-rw-r-- 1 root '''nut''' 189, 513 27 mars 11:12 002 == 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 nut`<> 1. 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 }}} 1. mettre `MODE=netclient` dans `/etc/nut/nut.conf` 1. 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` 1. 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 : {{{ @IFSUPP ups.temperature@ @UPSTEMP@ @DEGREES@ @ELSE@ @IFSUPP battery.temperature@ @VAR battery.temperature@ @DEGREES@ @ENDIF@ }}} 1. 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" }}} 1. consulter la page http://new-intranet.auf/cgi-bin/nut/upsstats.cgi Pratique, non ? = Configuration des alertes par mail ou IM = ... ----