08 jan

Vmware Esxi 5 (Free) UPS shutdown

De API’s / CLI van ESXi Free 5.x zijn read-only, gevolg hier van is dat UPS shutdown software niet in staat is om je Vmware ESXi omgeving down te brengen.

Zowel Eaton als APC ondersteunen de shutdown van een Vmware host, door gebruik te maken van de  vSphere Management Assistant (vMA). Echter deze blijken niet te werken omdat de Api’s dit in de Free version van ESXi niet toestaan.
SOAP-Fault

Current license or ESXi version prohibits execution of the requested operation.

De recente documentatie van zowel APC als Eaton vermeld dit overigens ook netjes, echter bij oudere versies van Vmware ESXi werkte dit wel gewoon.

Omdat ik me hier niet bij neer kon leggen, ben ik op zoek gegaan naar een oplossing.
Uiteindelijk werkte de onderstaande oplossing voor mij:

Gebruik de handleiding van je UPS leverancier: (lees deze goed)
Voor Eaton: http://pqsoftware.eaton.com/install/linux/ipp/IPP_how_to_vmware_esxi_en_5.pdf
Voor APC: http://www2.schneider-electric.com/

De meegeleverde shutdown scripts werkte niet bij mij, daarom heb ik het volgende script gebruikt: shutdownHostViaSOAPAPICall.pl Deze werkt wel prima.

Ja kan dus gewoon de handleiding van Eaton of APC volgen, alleen het shutdown script moet dus aangepast worden.

Kort samengevat bestaat de installatie uit de volgende onderdelen.

  1. Configureer Virtual Machine Startup / Shutdown.
    Als eerste moeten alle vm’s automatisch afgesloten worden als de UPS batterij leeg begint te raken. In mijn geval werkt dit in eerste instantie niet goed, dit is een probleem wat opgelost is in latere versies van ESXi, zorg er voor dat je de laatste patches hebt geïnstalleerd.
    Test de shutdown en startup van de vm’s voordat je verder gaat.(vsphere client, rechtsklik esxi machine en kies voor shutdown)  Voor het netjes kunnen afsluiten van de virtuele machines moeten de vmware tools geïnstalleerd zijn. Hoe je startup en shutdown moet instellen staat duidelijk uitgelegd in de documentatie van de UPS leverancier. (zie links hierboven)
  2. Installeer en configureer de vSphere Management Assistant (vMA)
    Je kan de handleiding en de software downloaden op: www.vmware.com/go/vma
    In de handleidingen van Eaton en APC staat beschreven hoe je de VMA moet installeren.
  3. Installeer en configureer de tools van de UPS leverancier.
    Voor een APC configuratie kan je het beste dit artikel gebruiken: http://blog.rebelit.net/?p=295
    Gebruik voor een Eaton configuratie gewoon de handleiding van Eaton.
  4. Eaton configuratie:
    Download het shutdown script, en pas deze aan.
    Het gebruikte script kan hier: http://communities.vmware.com/docs/DOC-11623 gedownload worden. Zet dit over naar de vma.Tip: gebruik
    wget http://communities.vmware.com/servlet/JiveServlet/download/11623-3-32693/shutdownHostViaSOAPAPICall.pl
    Hernoem het script naar: shutdown.pl en maak een file aan met daarin het ip adres van je ESXi server.  # echo <esxi-ip> > hostfile
    Controleer of het script uitvoerbaar is, pas dit indien nodig aan met chmod 744.
    In het script shutdown.pl moet je nog de gebruikersnaam en wachtwoord aanpassen.
    #vi shutdown.plVoeg het volgende toe bovenaan in het script, om certificaat errors te voorkomen.
    $ENV{PERL_LWP_SSL_VERIFY_HOSTNAME} = 0;Pas het volgende aan:
    my $host_username = ‘fillmein’;
    my $host_password = ‘fillmein’;Test of het script werkt! (let op, als het werkt gaat je omgeving down, test dit dus eerst op een test machine of buitenkantoor uren) Login op de vma, en voer het script uit:
    #perl shutdown.pl hostfile
    Als het script werkt, moet het nog aangeroepen worden door de ups shutdown software. Verplaats het script en de hostfile naar de map:
    /usr/local/Eaton/IntelligentPowerProtector/bin/virt_tools/Ga met je webbrowser naar: https://ip-of-vma:4680/ en login met admin.
    Ga naar Settings / Shutdown en klik edit shutdown configuration.
    En vul het volgende in bij shutdown script:  perl bin/virt_tools/shutdown.pl bin/virt_tools/hostfile
    Als dit gelukt is, kan je de werking testen door op TEST shutdown te klikken.IPP-shutdown-config
  5. APC configuratie:
    De configuratie voor APC is nagenoeg het zelfde.
    Ik verwijs naar een zeer behulpzaam artikel van Rebel IT: http://blog.rebelit.net/?p=295 APC gebruikt een batch script met de naam shutdown, welke weer het genoemde perl script aanroept. Het batch script is ook te downloaden op de site van Rebel IT.Zowel het batch en perl script moeten geplaatst worden in de directory:
    /opt/APC/PowerChute/group1/bin
    Let op: het volgende dient bovenaan in het shutdown.pl script worden toegevoegd, om certificaat foutmeldingen te voorkomen.
    $ENV{PERL_LWP_SSL_VERIFY_HOSTNAME} = 0;Test de configuratie altijd uitvoerig voor je dit in productie neemt.
Delen