715 réflexions sur « Client NUT pour ESXi 5, 6, 7 et 8 »

1. Thanks so much for the client and guide, René. Both this and the one for ESXi 4 work great. I used Google Translate, as I don’t speak French, but had no trouble following the guide anyway.

   I have two notes:
   1. Unfortunately the client isn’t compiled with SSL. This would be a great feature to have for security.
   2. NUT is released under the GPL, so remember that any redistribution requires you to also redistribute the source code.

   Thanks again!

   Répondre ↓

   • 1. I’ve tried to compile nut client with SSL support but unfortunately it needs much more libraries than only SSL. ESXi Hypervisor is a very light OS, I would need to provide all those missing libraries. This would make the NUT VIB very thick.
     2. NUT source code has not been modified. It’s a « vanilla » nut client with no patch. I am using a CentOS 5 32bit linux with only CentOS packages to compile nut from official sources. The only changes are the parameters passed to the configure script to match the ESXi filesystem organization. If someone needs source code just download it from official NUT repository. I may write a « howto » text file to explain step by step how to create VIB package from scratch.

     Répondre ↓

     • Thanks for the great answers, René!
       I was not aware that SSL support required so many libraries; I figured it would only need OpenSSL. If it requires many more, I suppose that it is sensible to leave it out.

       Répondre ↓

2. Bonjour René,

   Tout d’abord un grand merci pour cet article.
   Nous avons quelque serveur virtuel sous esxi 5.0 en license free.
   Est-ce qu’il est possible de créer une vm sur laquelle on installera le serveur nut ou faut-il obligatoirement avoir une machine physique?

   Cordialement,

   Répondre ↓

   • Le serveur NUT doit avoir un accès direct à l’onduleur. Il est tout à fait possible d’utiliser un USB ou un RS232 physique depuis une machine virtuelle toutefois s’il donne l’ordre au serveur ESXi sur lequel il est installé de s’arrêter il faudra bien s’assurer que le servuer NUT pourra aller jusau’au terme de son processus d’arrêt car habituellement il ordonne à l’onduleur de couper le courant d’alimentation des serveurs quelques minutes après l’extinction du serveur NUT. Ceci permet le redémarrage automatique des serveurs lors du retour du courant sur secteur.
     En imaginant que la procédure d’arrêt ESXi est configurée pour figer les machines virtuelles, le serveur NUT n’ira pas jusqu’à son terme. Pire, il pourrait, lors de sa remise en route, continuer la procédure d’arrêt et ordonner l’extinction de l’onduleur alors que le secteur est redevenu opérationnel.

     Pour résumer : techniquement, oui c’est faisable. Fonctionnellement, attention à ne pas se retrouver sur la branche que l’on est en train de scier.

     Répondre ↓

3. Bonjour René,

   thanks for your ESXi-package.
   I tried with ESXi 5.1 and it installed without problems. I have not tested all functionality yet.

   2 questions:
   -can i add more then 1 ups for monitoring? How?
   -can you add upssched to your package and provide a way to store user created skripts for upssched that survive a reboot?

   Thanks!

   Répondre ↓

   • For several nut servers you will need as many MONITOR lines as UPSes and a configurable MINSUPPLIES entry.
     This is not possible for the moment.
     UPSsched is a binary not provided in the package. I don’t know if it can be used in the hypervisor since only a limited number of libraries are available. Then, to survive a reboot script has to be stored in a permanent storage (a datastore ?). Actually, configuration files are recreated each time service is started. I use a template in firmware and some patterns are replaced with named values from the userValues database.
     Old style nut client for ESXi 4.x allowed to install anything you want but you can’t easily modify configuration files.

     Répondre ↓

4. J’ai installé le VIB et selon upsc ma configuration fonctionne. Mais, le serveur ne s’arrète pas lors d’une coupure.

   Je vois dans /etc/ups:
   
notify.conf.template
notify.sh
upsmon.conf.template

   Alors, ils me manquent les fichiers de configuration, non?

   Quand je les ajoute (upsmon.conf et notify.conf) ils sont supprimés lors d’un redémarrage du service. Comment résoudre mon problème?

   Note: Mon UPS est un APC connecté a un NAS de Synology.

   Thomas

   Répondre ↓

   • Si les fichiers .conf sont absents alors cela signifie que le service n’est pas lancé. Vous devez activer le service comme décrit dans l’article.

     Répondre ↓

     • J’ai fait ça. vSphere Client indique que le service est actif. Si j’essaie de démarrer upsmon manuellement il indique que le service est déjà lancé.
       Est-ce qu’il y a autre moyen pour vérifier le fonctionnement du service?

       Répondre ↓

       • Pour tester sur l’hyperviseur : service démarré, éditer le fichier /etc/ups/upsmon.conf et modifier les 2 premiers notifyflag de cette façon :
         NOTIFYFLAG ONLINE SYSLOG+EXEC
         NOTIFYFLAG ONBATT SYSLOG+EXEC
         Forcer upsmon à relire sa configuration :
         upsmon -c reload
         Sur l’onduleur appuyer sur le bouton de test batterie pour provoquer un message de basculement sur batterie.
         Si tout est ok, dans la log système de l’hyperviseur vous devriez voir des lignes de ce type :
         tail /var/log/syslog.log
         2012-11-13T21:14:07Z upsmon[639263]: Reloading configuration
         2012-11-13T21:14:42Z upsmon[639263]: UPS onduleur@serveur on battery
         2012-11-13T21:14:52Z upsmon[639263]: UPS onduleur@serveur on line power
         

         Répondre ↓

5. Rene,

   Thank you for your effort this is quite good!
   I would like to see the NUT server also as a VIB.
   This would be very useful in a single server / single UPS environment.

   At present, I use a VMWare VMA on which I install the NUT server, monitor and client. The VMA has the tools available to trigger the shutdown of the ESXi host, which in turn shuts down the virtual machines (in the configured order).

   Répondre ↓

   • I have no plan to add nut server to run on hypervisor. USB and RS232 ports can’t be easily reached from hypervisor.

     Répondre ↓

6. Hello

   J’ai installé le client sans encombre … Par contre REBOOT obligatoire pour voir le settings dans vsphere.

   Pour info, en branchant un UPS compatible avec le NAS Synology … le NAS devient un serveur NUT 🙂

   le nom de l’ups est ups
   ce qui donne ups@ip_du_syno
   login pass d’un admin …

   Bref GENIAL

   Répondre ↓

   • Le reboot ne me semblait pas obligatoire. Un refresh ne suffisait pas ? Attention maintenant car avec ce package présent dans ESXi il faut passer l’option -f (force) pour chaque prochaine mise à jour de ESXi (ou alors désinstaller le package nut avant la mise à jour et le réinstaller après, les paramètres ne sont pas perdus). C’est toujours à cause du non respect des regles de securité car le paquet n’est pas signé par vmware.

     Répondre ↓

     • Je le garde en tete …. dans mon tuto evernote 😉

       Répondre ↓

7. D’ailleurs comment fait on un refresh ????

   Répondre ↓

   • Dans vSphere client, sélection du host dans la liste à droite, onglet configuration, rubrique profil de sécurité puis Actualiser en haut à droite. Pour les paramètres avancés fermer et réouvrir la fenêtre si elle était ouverte lors de l’installation du package. Je viens de faire le test avec une instance ESXi 5.1 vierge et je n’ai pas eu besoin de rebooter.

     Répondre ↓

     • bon j’ai appris un truc
       Et en web interface … pareil ?

       Répondre ↓

       • Aucune idée, désolé, je n’ai pas l’interface web. Je n’ai pas de vCenter Server mais uniquement vSphere Hypervisor.

         Répondre ↓

8. bonjour

   merci pour votre article ,
   je suis en train de tester votre solution
   je voudrais modifier le script notify.sh
   pour l’adapter ,surtout pour spécifier le serveur SMTP pour l’envoi de mails ,
   j’ ai reussi à la modifier avec vi ( avec difficulté . meme en changeant les droits du fichier , je n’avais toujours pas les droits d’écritures , j’ai pas compris … )
   mais le script est réécrit ,

   donc j’ai fait un autre script et mofifié upsmon.conf pour le spécifier d’appeler mon script ,
   mais tous les changement que je fais sont ecrasés ….
   si j’ai bien compris les fichiers de conf sont generes à partir des .templates mais meme ces templates sont réécrits ..

   comment puis je faire ? Merci

   Répondre ↓

   • Considérez que le système est chargé dans un ramdisk à partir d’un ensemble d’archives stockés dans la partition de boot. A chaque reboot le système est entièrement recréé à partir de ces archives. Seuls les paramètres sont sauvegardés dans une base qui résiste au reboot.
     Pour ce qui est de la protection contre la modification c’est une conséquence du ViB. La liste des fichiers qui composent le package est décrit dans un XML. Les fichiers faisant partie d’un package ont une super-protection qui interdit toute modification.
     Pour modifier de façon permanente un fichier il faut extraire le contenu le ViB, modifier le fichier souhaité et refaire le ViB (puis réinstaller le ViB dans ESXi).

     Pour extraire ou recréer le ViB utilisez la commande ar sous Linux (3 fichiers seront extraits : descriptor.xml sig.pkcs7 upsmon):
     ar xo upsmon-2.6.5-1.1.0vmw.500.x86_64.vib

     Le fichier upsmon est un fichier au format tar.gz. Vous pouvez extraire/modifier/recréer cette archive a votre convenance mais sans ajouter/suppriemr de fichiers (ou alors il faut le répercuter dans descriptor.xml).

     Avant de recréer le ViB vous devrez calculer le checksum du tar avec la commande suivante et le reporter dans le fichier descriptor.xml :
     openssl sha256 < upsmon

     Recréez le ViB :
     ar r mon-package.vib descriptor.xml sig.pkcs7 upsmon

     Répondre ↓

     • super .. grace a vos explications tres claires j’ai reussi a creer un nouveau paquet .vib plus adapté a mes besoins

       un grand MERCI ! ! !

       Répondre ↓

9. Awesome work Rene!

   There are some minor problems with the notify.sh script, mostly the fact that the message produces is not strickly RFC2822 compliant (the Date header was missing for example).

   I took the liberty to modify it. Feel free to include it in your distribution. Hopefully you could include the capability for the user to specify:
   * the mail server and
   * the message sender (From) ?

   
#!/bin/sh
# Rene GARCIA (rene@margar.fr)
# Script executed on ups event

   . /etc/ups/notify.conf
   [ "${SEND_MAIL}" = 1 ] || exit 0

   DOMAIN="$(hostname -d)"
   FROM="$(hostname -s)@${DOMAIN}"
   FROM_BODY="\"VMWare ESXi on $(hostname -s)\" "

   [ -z "${TO}" ] && TO="root@${DOMAIN}"
   [ -z "${NOTIFYTYPE}" ] && NOTIFYTYPE="TEST"

   HOSTNAME="`hostname`"
   MESSAGE="$1"
   DATE="`date +"%Y/%m/%d %k:%M:%S %Z"`"
   DATE_SMTP="`date --rfc-2822`"
   echo "${TO}"
   (
   echo "From: ${FROM_BODY}"
   echo "Date: ${DATE_SMTP}"
   echo "To: \"Admin\" "
   echo "Subject: UPS Notification ${NOTIFYTYPE}"
   echo ""
   echo "$DATE - UPS event on ${HOSTNAME} : ${MESSAGE}"
   ) | \
   /bin/smtpblast -f "${FROM}" -t "${TO}"

   exit 0


   Once more, thank you for an awesome piece of work!

   Répondre ↓

   • I am sorry, but for some reason the code pasted is not complete!

     I will send you notify.sh by mail.

     Répondre ↓

   • Sending the code again:
     
#!/bin/sh
# Rene GARCIA (rene@margar.fr)
# Script executed on ups event

     . /etc/ups/notify.conf
     [ "${SEND_MAIL}" = 1 ] || exit 0

     DOMAIN="$(hostname -d)"
     FROM="$(hostname -s)@${DOMAIN}"
     FROM_BODY="\"VMWare ESXi on $(hostname -s)\" "

     [ -z "${TO}" ] && TO="root@${DOMAIN}"
     [ -z "${NOTIFYTYPE}" ] && NOTIFYTYPE="TEST"

     HOSTNAME="`hostname`"
     MESSAGE="$1"
     DATE="`date +"%Y/%m/%d %k:%M:%S %Z"`"
     DATE_SMTP="`date --rfc-2822`"
     echo "${TO}"
     (
     echo "From: ${FROM_BODY}"
     echo "Date: ${DATE_SMTP}"
     echo "To: \"Admin\" "
     echo "Subject: UPS Notification ${NOTIFYTYPE}"
     echo ""
     echo "$DATE - UPS event on ${HOSTNAME} : ${MESSAGE}"
     ) | \
     /bin/smtpblast -f "${FROM}" -t "${TO}"

     exit 0


     Répondre ↓

   • I will check this piece of code and I may add it in a future release. Thank you for your contribution.

     Répondre ↓

10. Bonjour,
    Merci pour ce tuto mais j’ai quelque question a posé avant de me lancer tête baisser 🙂
    1. concernant la compatibilité, est-ce que ça fonctionne aussi sur la version free de ESXi 5.1 ?
    2. Si oui cette méthode fonctionne avec n’importe quels ups ? ou en fonction de l’ups il faudra changé le software (par exemple hp power protector pour des ups hp ?)

    Répondre ↓

    • Compatible 5.0 et 5.1 oui.
      C’est un client nut. Cela signifie qu’il doit pouvoir se connecter par le reseau à un serveur nut. C’est le serveur nut qui surveille l’état de l’UPS (par port série, USB ou en réseau par SNMP). Il faudra veiller à utiliser un UPS compatible. Le client nut ne communique pas directement avec l’UPS.

      Répondre ↓

      • Hum je croit que j’ai besoin d’une petite confirmation, j’ai pas tout saisie -.-

        1. j’installe mon serveur nut sur une machine virtuelle (hppp dans mon cas)
        2. j’installe le client nut proposer plus haut sur le esxi
        3. je fais le tuto pour le client nut
        4. en cas de power failure il faut que je configure le serveur pour qu’il ordonne au client de tout éteindre ? Ou alors

        Est-ce qu’il y as un endroit ou je peux trouer la liste des compatibilité du client nut avec les différents serveur ? (Le client est fournir par vmware ?)

        Merci d’avance

        Répondre ↓

        • Non, mon opinion est que le serveur nut doit être installé en dehors de l’ESXi. L’installer dans une machine virtuelle est risqué car il va donner l’ordre à l’hyperviseur qui l’héberge de s’arrêter : ça revient à scier la branche sur laquelle il est. Ce n’est pas impossible à faire mais il faut bien savoir et comprendre ce que l’on fait. Le retour à la normale est alors un peu plus délicat.

          En cas de power failure le serveur donnera l’ordre aux clients de s’arrêter quand le niveau de la batterie deviendra critique.

          Pour plus d’information sur NUT visitez le site web officiel : http://www.networkupstools.org

          Répondre ↓

          • ok Merci beaucoup et encore une fois beau travail pour le tuto 🙂

          • Hum un dernière précision 😉 : je conseille préciser à la fin dans la partie astuce qu’avec VMtools installé on peut arrêter proprement les os sans faire un power off des VMs