configuring apcupsd to suspend all running VM and then shutdown the esxi 5.5 u1 host

configure_apcupsd.md

Instructions

Description

these are instructions for automating the suspend and shutdown of ESXi VMs and host in case of a power failure. works with APC/Schneider SmartUPS 750xl and ESXi 5.5u1

Steps

0. make a new VM and install Ubuntu-Server on it

1. install apcupsd

# apt-get install apcupsd

2. configure /etc/apcupsd/apcupsd.conf

3. enable apcupsd

# vim /etc/default/apcupsd
    ISCONFIGURED=yes

4. restart apcupsd # service apcupsd restart

5. enable SSH on ESXi

   configuration-tab - security profile - properties (right upper corner)

6. copy shutdown_esxi.sh on ESXi into datastore e.g. /vmfs/volumes/MyDataStore/scripts

7. make the file executable # chmod +x shutdown_esxi.sh

8. configure passwordless ssh access on ESXi

make keys on ubuntu server (as root, because apcupsd runs under root)

# ssh-keygen -i /root/.ssh/id_rsa-ups -t rsa -b 4096 -N ""

copy key to ESXi server
# cat /root/.ssh/id_rsa-ups.pub | ssh root@TARGET_IP "cat >> /etc/ssh/keys-root/authorized_keys"

now automated, passwordless login should work from the ubuntu server. Test using this command: # ssh root@TARGET_IP /bin/true ; echo $? (the first time it asks to store esxi's key in local database, answer with "yes")

9. configure an apcupsd helper script to run remote script on esxi copy doshutdown to /etc/apcupsd (you mustn't rename it, otherwise apcupsd won't run it automatically) make it executable # chmod +x doshutdown

10. restart apcupsd # service apcupsd restart

doshutdown

#!/bin/sh
WALL=wall

# this script is triggered in case the power fails

echo "suspending all VMs on ESXi..." | ${WALL}

# configured ssh-automatic-access with keys
ssh -i /root/.ssh/id_rsa-ups root@TARGET_IP "nohup /vmfs/volumes/MyDataStore/scripts/shutdown_esxi.sh > /dev/null 2>&1 &"

echo "finished shutting ESXi down..." | ${WALL}

# exit code 99 - apccontrol stops after this script, so no shutdown of this host. this is for testing purposes
# exit code 0 - apccontrol continues with shutdown after this script
exit 99

shutdown_esxi.sh

#/bin/sh
 
##########################################################################################################################
#courtesy of http://www.c-note.dk/2011/12/04/wmware-esxi-suspend-all-guests/
#
#copy this file somewhere to datastore
#e.g. ‘/vmfs/volumes/myDataStore/scripts/’
#
# looks which vm's are running, sends them into suspend, waits until suspending-process is finished, then powers off esxi
# completely
##########################################################################################################################
 
VMS=`vim-cmd vmsvc/getallvms | grep -v Vmid | awk '{print $1}'`
for VM in $VMS ; do
  PWR=`vim-cmd vmsvc/power.getstate $VM | grep -v "Retrieved runtime info"`
  if [ "$PWR" == "Powered on" ] ; then
    name=`vim-cmd vmsvc/get.config $VM | grep -i "name =" | awk '{print $3}' | head -1 | cut -d "\"" -f2`
    echo "Powered on: $name"
    echo "Suspending: $name"
    vim-cmd vmsvc/power.suspend $VM > /dev/null &
  fi
done
 
while true ; do
  RUNNING=0
  for VM in $VMS ; do
    PWR=`vim-cmd vmsvc/power.getstate $VM | grep -v "Retrieved runtime info"`
    if [ "$PWR" == "Powered on" ] ; then
      echo "Waiting..."
      RUNNING=1
    fi
  done
  if [ $RUNNING -eq 0 ] ; then
    echo "Gone..."
    break
  fi
  sleep 1
done
 
echo "Now we shutdown the host..."
/sbin/shutdown.sh && /sbin/poweroff