user guide eaton load shedding module for vmware...

www.eaton.com/virtualization

Eaton Load Shedding Module for VMware vCenter Page | 1

User Guide

Eaton Load Shedding Module for VMware vCenter

Version: 1.02

http://www.eaton.com/virtualization



Contents

1. Introduction .......................................................................................................................................... 4

2. VMware/IPM architecture .................................................................................................................... 5

3. Installation ............................................................................................................................................ 7

2.1 Supported Operating Systems: ................................................................................................. 7

2.2 Pre-requisites ............................................................................................................................ 7

2.3 Installing Eaton Load Shedding Package ................................................................................... 7

4. Configuring Load Shedding ................................................................................................................... 9

4.1 Login Information .......................................................................................................................... 9

4.2 Set Priorities of Virtual Machines ............................................................................................... 10

4.3 Power Source Configuration ....................................................................................................... 12

4.3.1 UPS Configuration ................................................................................................................... 13

4.3.2 VPS Configuration ................................................................................................................... 16

5. User Scenarios ..................................................................................................................................... 21

6. Event Logging ...................................................................................................................................... 23

7. Known Limitation ................................................................................................................................ 25

8. References .......................................................................................................................................... 26




Table of Figures

No. Name of Figure

1 Traditional VMware IPM Architecture

2 Load Shedding Architecture

3 Login User Interface in Load Shedding

4 Configure Priority UI in Load Shedding

5 Setting Priority to More than one VM in Load Shedding

6 Configure UPS and Shutdown Type in Load Shedding

7 Configure TimeToShutdown in Load Shedding

8 Configure Low Battery in Load Shedding

9 ConnectUPS MS Shutdown Parameters 10 ConnectUPS MS Shutdown Parameters 11 IPM VPS Name 12 Configure VPS and Shutdown Type in Load Shedding 13 Configure Shutdown Type in Load Shedding 14 Configure Time to Shutdown 15 VPS redundancy or protection selection 16 Shutdown Timing Diagram




1. Introduction

The purpose of this document is to give introduction to Eaton Load Shedding Module and guide to configure and usage of it. This Module is used for shutting down/suspend of virtual machines as per the priority.

Acronyms

IPM Eaton’s Intelligent Power Manager

DPM Distributed Power Management

UPS Uninterruptible Power Supply

VPS Virtual Power Source, for more information about VPS refer Redundancy chapter of IPM user guide.

Virtualization is an emerging technology which provides various benefits including reduced cost, ease of administration etc. This technology is mainly used in data centers which are powered by UPSs. UPS provide power to an entire environment during utility failure with the help of power stored in batteries. With increase of virtual machines, increase load on the servers and effectively utilizes most of the power. But during utility failure, it can reduce the effective runtime of highly critical machines as battery capacity is limited. This can be overcome by Load Shedding. Load Shedding is a process of closing or shutting down less critical load so that remaining capacity can be used for highly critical loads.

Eaton Load Shedding Module Features:

• This module is designed for a single Eaton UPS/VPS powering a cluster of multiple servers in a datacenter.

• A simple GUI for user to set priorities to the virtual machines as per user’s needs. • Provides flexibility to the user to configure the time to shutdown /suspend the virtual machines

of every priority. • In case of utility failure, module automatically performs the shutdown of virtual machines as per

the configurations made by user. In turn, it provides more power for critical loads. • Low battery feature provides shutdown of remaining virtual machines as well as shutting down

of hosts when the UPS battery level reaches to low. It also enables user to specify battery runtime value.

• In case of utility restore, module will power on all the virtual machines which were down. • Facility to shutdown of virtual machine in case of Redundancy or Protection loss of Virtual

Power Source. • Facility to start of virtual machines in case Redundancy or Protection restored of Virtual Power

Source.




2. VMware/IPM architecture

Load Shedding module will be suitable for single rack, containing 3-4 DPM Enabled ESXi servers powered by a single Eaton UPS. This module can be configured and work with only with one cluster at a time. Figure 1 shows a traditional block diagram of this implementation. For more information about DPM, please refer the links provided in the references.

Below is an example of a traditional rack:

• As shown in Figure 1, ESXi Hosts named, ESXi a to ESXi d, are powered by Eaton UPS. vCenter and IPM are installed on one of the servers in the same network.

• vCenter has 2 clusters. Cluster 1 is created with 3 ESXi (ESXi a to ESXi c) with 6 virtual machines running on it and cluster 2 is created with 1 ESXi (ESXi d) having 2 virtual machines running on it.

ESXi b (60% load

3 VMs running) On Cluster1

ESXi a (50% load


EatonUPS / VPS

Cluster1

VM8

VM7

VM4

VM3

VM6

VM5

VM2

VM1

vCenter Logical Group vCenter IPM

ESXi c (25% load


ESXi d (40% load

2 VMs running) On Cluser2

Clustr2

Figure 1: Traditional VMware IPM Architecture




Eaton Load Shedding Module provides a feature to create a group of virtual machines based on priority as shown in figure 2.

ESXi b (60% load


ESXi a (50% load


UPS Cluster1

VM8

VM7

VM4

VM3

Priority3

VM6

VM5

Priority2

VM2

VM1

Priority1

vCenter Logical Group

vCenter IPM

Network

ESXi c (25% load


ESXi d

(40% load 2 VMs running)

On Cluster2

Cluter2

Figure 2: Load Shedding Architecture




3. Installation

Load Shedding Module uses vCenter and vSphere API to communicate with VMware architecture

2.1 Supported Operating Systems:

1. VMware ESXi Operating System – 5.0 and above

2. Load shedding Module can be installed on following windows operating systems.

1. Windows XP with Service Pack 3 2. Windows 7 (32 bit and 64 bit) 3. Windows Server 2003 (32 bit and 64 bit) 4. Windows Server 2008 (32 bit and 64 bit) 5. Windows Server 2008 R2

2.2 Pre-requisites

1. vCenter server configured with Cluster of hosts and virtual machines. 2. DPM should be enabled on the servers used for Load Shedding purpose. 3. IPM version 1.27 or above with following softwares installed on the same machine.

a. vSphere PowerCLI b. Microsoft Access Database Engine 2010

1. For 32 bit OS - AccessDatabaseEngine.exe 2. For 64 bit OS - AccessDatabaseEngine_x64.exe

c. Microsoft .Net Framework 2.0 Service Pack 1 –(usually all machines are having this) or above

i. For 32bit ii. For 64 bit

d. PowerShell version 2.0 Note: - For more specific configuration related to IPM and Virtualization refer “Virtualization” section of IPM user guide.

2.3 Installing Eaton Load Shedding Package

• Download IPM and Load Shedding Package from http://pqsoftware.eaton.com/explore/eng/network/net_sol.htm

• Install IPM. • Extract load shedding package on any directory. Copy the following files in root directory of IPM.

e.g. C:\ProgramFiles\EATON\IntelligentPowerManager. o callShutdownVMs.ps1 o callShutdownVMs_LowBattery.ps1 o CallShutdownVMs_proxy.ps1 o CallShutdownVMs_proxy_VPS.ps1 o callShutdownVMs_VPS.ps1 o CompilePreReq.ps1 o List-VM-Mdb.ps1 o LoadShedding.exe


http://www.microsoft.com/en-us/download/details.aspx?id=13255




http://pqsoftware.eaton.com/explore/eng/network/net_sol.htm



o PowerOff_VMs.ps1 o PowerState.exe o PowerStateVPS.exe o Shutdown_VMHosts.ps1 o Shutdown_VMs.ps1 o Start_VMs.ps1 o Start_VMs_VPS.ps1 o template.mdb o UpdateProfile.ps1

• It is recommended that before configuring loadshedidng.exe , execute CompilePreReq.ps1

PowerShell script to speed up the execution of the module. For more information about this refer following link

http://rvdnieuwendijk.com/2012/02/18/function-to-speed-up-the-execution-of-the-first-powercli-cmdlet

• Run and Configure LoadShedding.exe (Refer section 4 for more information)






4. Configuring Load Shedding

Once Load Shedding Package is installed we are ready to configure Load Shedding. Go to IPM directory for example C:\Program Files\EATON\IntelligentPowerManager Double click on Load Shedding.exe file and the screen shown below will be displayed.

4.1 Login Information

vCenter Server Name : Provide IP address or host name of vCenter Server for Load Shedding.

User Name : User name along with domain name (if any) for vCenter

Password : Password for above mentioned vCenter

Save Password : By default “vCenter Server Name” and “Username” values get saved. If password needs to be saved, click on “Save Password” check box.

Once all above mentioned parameters are provided, click on Next Button. Once clicked, this module will connect to vCenter Server and will retrieve latest information from vCenter Server and will display the information on the screen as shown below in Figure 4.

Figure 3: Login User Interface in Load Shedding




4.2 Set Priorities of Virtual Machines

The above Figure 4 shows the list of datacenters, clusters and virtual machines present in vCenter. Select the Data Center and the Cluster which needs to be configured for Load Shedding of virtual machines in order to display as shown in above screenshot. To set priority, select one or more virtual machines and assign the priority as shown in Figure 5.

Figure 4: Configure Priority UI in Load Shedding




Once all Priorities are set, click on “Next” Button. It will move to screen as shown in Figure 6.

Figure 5: Setting Priority to More than one VM in Load Shedding




4.3 Power Source Configuration

In this configuration screen priorities that are configured in previous screen can be linked with UPS or VPS to shutdown/suspend VMs. User can select UPS or VPS based on power source. If UPS is selected, events from UPS like power fail, power restore and low battery will be considered for shutdown or start of virtual machines. If VPS is selected, events from VPS like redundancy lost, protection lost, redundancy restored or protection restored will be considered for shutdown or start of virtual machines.

Figure 6: Configure UPS/VPS and Shutdown Type in Load Shedding




4.3.1 UPS Configuration Select UPS option when UPS is powering the virtual environment. Enter UPS IP or hostname that is powering to cluster of hosts.

a. Shutdown Type This can be either Shutdown or Suspend.

1. Shutdown - When Shutdown is selected, virtual machines in this priority group will go down when it reaches to TimeToShutdown value.

2. Suspend - When Suspend is selected, virtual machines in this priority group will get suspended when it reaches to TimeToShutdown value.

Figure 7: Configure TimeToShutdown in Load Shedding




b. TimeToShutdown – This is the time duration to initiate the shutdown of virtual machines. This value is in Minutes from 2 to 60.The module will use this value for shutdown/suspend of virtual machine when time reaches to TimeToShutdown value. When blank value is selected for any priority, virtual machines in that priority will not be considered for shutdown or suspend. The VMs in that priority will shutdown once low battery occurs, if Low Battery option is selected.

c. Low Battery – Low battery is critical condition where there is less battery remaining and need to take action to shutdown all remaining running VMs and running hosts. There are two situations by which Load Shedding application can consider Low Battery.

1. Shutdown all Virtual Machines when battery reaches to low battery level: If this checkbox is selected, all the remaining virtual machines will shutdown along with the hosts once UPS battery reaches to low level.

This condition of Low Battery occurs based on configuration made in “Shutdown Parameter” of ConnectUPS MS card. Here is example of ConnectUPS MS card.

Figure 8: Configure Low Battery in Load Shedding




UPS will send low battery signal when any one of following condition become true. Load Shedding Module will consider this signal as Low Battery to initiate shutdown of VMs and Hosts.

1. If UPS Battery remaining time is below 120 seconds 2. If UPS Battery remaining capacity goes below 80%

Values of only Master load segment will be considered for Low battery in Load Shedding Module.

Note: If “Shutdown After” value is selected, NMC will shutdown Master outlet after time specified. This value is currently not considered in Load Shedding application as Low battery to shutdown of VMs.

2. Shutdown all Virtual Machines when battery runtime level below user specified minutes:

Figure 9: ConnectUPS MS Shutdown Parameters




If “remaining backup time “ value of UPS goes below value specified in “Shutdown all Virtual Machines when battery runtime level go below user specified minutes” Load Shedding application will initiate shutdown of Virtual machines and hosts.

If both conditions of Low battery are selected, Load Shedding will consider the condition whichever occur first. Click on save button to enable load shedding module. Now the load shedding module is ready to use. Note: NMC shutdown parameter settings should be considered for setting of all priories and Low battery. Do not configure Load Shedding on multiple server to Load shedding of same cluster, there will be unpredictable result of this configurations.

4.3.2 VPS Configuration

Select this option when a Virtual power source (VPS) is powering virtual environment. For more information about configuring Virtual Power source refer redundancy chapter of IPM user guide.

Once VPS is configured in IPM, enter this VPS name in Load Shedding configuration screen as shown below.

Figure 10: ConnectUPS MS Shutdown Parameters

Figure 11: IPM VPS Name




Following section will provide information about each field.

a. Shutdown Type – This can be either Shutdown or Suspend. 3. Shutdown - When Shutdown is selected, virtual machines in this priority group

will go down when it reaches to TimeToShutdown value. 4. Suspend - When Suspend is selected, virtual machines in this priority group will

get suspended when it reaches to TimeToShutdown value.

Figure 12: Configure VPS and Shutdown Type in Load Shedding




Figure 13: Configure Shutdown Type in Load Shedding




b. TimeToShutdown – This is the time duration to initiate the shutdown of virtual machines. This value is in Minutes from 2 to 60.The module will use this value for shutdown/suspend of virtual machine when time reaches to TimeToShutdown value. When blank value is selected for any priority, virtual machines in that priority will not be considered for shutdown or suspend. The VMs in that priority will shutdown once low battery occurs, if Low Battery option is selected.

Figure 14: Configure Time to Shutdown

Figure 15: VPS redundancy or protection selection




c. Shutdown VMs when Redundancy of Virtual Power Source lost - When this option is selected, following action will be taken by Load Shedding.

Event from VPS Action from Load Shedding Redundancy loss Shutdown Virtual Machines based on priority Redundancy Restored Power on all Virtual Machines Protection Loss No action will be taken Protection Restored No action will be taken

a. Shutdown VMs when Protection of Virtual Power Source lost - When this option is selected, following action will be taken by Load Shedding.

Event from VPS Action from Load Shedding Redundancy loss No action will be taken Redundancy Restored No action will be taken Protection Loss Shutdown Virtual Machines based on priority Protection Restored Power on all Virtual Machines




5. User Scenarios

To illustrate functionality of Load Shedding below are example scenarios for UPS. Load Shedding Settings

VM Priority Shutdown Type Time To Shutdown

Priority 1 Shutdown 6 Priority 2 Suspend 4 Priority 3 Shutdown 3 Priority 4 Shutdown 2 Priority 5 Shutdown No Value set

Low Battery Conditions is enabled To explain working of Load shedding below are examples

1. Power Fail and power restored after 4 minutes 2. Power Fail and power restored after 7 minutes 3. Power Fail and Low Battery occurs after 8 minutes, UPS goes down after 10 minutes and Power

restored after 11 minutes. Following Figure 16 will show the various scenarios in details.




If VPS is selected instead of UPS, Load Shedding will work in similar way as UPS. Only difference is Load Shedding will initiate shutdown and start of VM based on redundancy lost and redundancy restored (or protection lost and protection restored) events from VPS instead of power failure and power restore. As VPS does have not low battery condition, example 3 is not applicable for VPS.

Figure 16: Shutdown timing diagram




6. Event Logging

Load Shedding Logs events in Windows Event viewer under Application. It will log event with application name as “Load Shedding”. Here is list of events Load Shedding application logs.

Event Id Event Message

1001 Power fail signal received from UPS which is powering the cluster - CLUSTERNAME of datacenter - DATACENTERNAME in vCenter server - vCENTERIP/HOSTNAME

1002 Power restored signal received from UPS which is powering the cluster - CLUSTERNAME of datacenter - DATACENTERNAME in vCenter server - vCENTERIP/HOSTNAME

1003 Started Shutting Down/Suspending of virtual machines of PRIORITY from cluster CLUSTERNAME of datacenter DATACENTERNAME in vCenter server vCENTERIP/HOSTNAME

1004 Completed Shutting Down/Suspending of virtual machines of PRIORITY from cluster CLUSTERNAME of datacenter DATACENTERNAME in vCenter server vCENTERIP/HOSTNAME

1005 Completed Shutdown/Suspend of virtual machine(s) of all priorities from cluster CLUSTERNAME of datacenter DATACENTERNAME in vCenter server vCENTERIP/HOSTNAME

1006 Power Restore - Sending start signal to Virtual Machines present in cluster CLUSTERNAME of datacenter DATACENTERNAME in vCenter server vCENTERIP/HOSTNAME.

1007 Power Restore - Completed start of all Virtual Machines present in cluster CLUSTERNAME of datacenter DATACENTERNAME in vCenter server vCENTERIP/HOSTNAME.

1008 Low battery signal received from UPS which is powering the cluster - CLUSTERNAME of datacenter - DATACENTERNAME in vCenter server - vCENTERIP/HOSTNAME

1009 Low Battery - Shutting down all virtual machines of all priorities from cluster CLUSTERNAME of datacenter DATACENTERNAME in vCenter server vCENTERIP/HOSTNAME

1010 Low Battery - Completed Shutdown of virtual machine(s) of all priorities from cluster CLUSTERNAME of datacenter DATACENTERNAME in vCenter server vCENTERIP/HOSTNAME

1011 Low Battery - Sending Power off signal to virtual machines from cluster CLUSTERNAME of datacenter DATACENTERNAME in vCenter server vCENTERIP/HOSTNAME.

1012 Low Battery - Completed Power off of virtual machines from cluster CLUSTERNAME of datacenter DATACENTERNAME in vCenter server vCENTERIP/HOSTNAME

1013 Power Restore - Checking state of hosts present in cluster CLUSTERNAME of datacenter DATACENTERNAME in vCenter server vCENTERIP/HOSTNAME to power on

1014 Power Restore - All hosts present in cluster CLUSTERNAME of datacenter DATACENTERNAME in vCenter server vCENTERIP/HOSTNAME are powered on

1015 Low Battery - Sending Maintenance Mode and shutdown signal to all servers present in cluster CLUSTERNAME of datacenter DATACENTERNAME in vCenter server vCENTERIP/HOSTNAME

1016 Low Battery - Completed Maintenance Mode of all Servers present in cluster CLUSTERNAME of datacenter DATACENTERNAME in vCenter server vCENTERIP/HOSTNAME

1017 Low Battery - Sending shutdown signal to all servers present in cluster CLUSTERNAME of datacenter DATACENTERNAME in vCenter server vCENTERIP/HOSTNAME




1018 Low Battery - Completed shutdown of all servers present in cluster CLUSTERNAME of datacenter DATACENTERNAME in vCenter server vCENTERIP/HOSTNAME

VPS Events

Event Id Event Message

1101 Power fail signal received from UPS which is powering the cluster - CLUSTERNAME of datacenter - DATACENTERNAME in vCenter server - vCENTERIP/HOSTNAME

1002 Redundancy/Protection restored received from UPS which is powering the cluster - CLUSTERNAME of datacenter - DATACENTERNAME in vCenter server - vCENTERIP/HOSTNAME

1103 Started Shutting Down/Suspending of virtual machines of PRIORITY from cluster CLUSTERNAME of datacenter DATACENTERNAME in vCenter server vCENTERIP/HOSTNAME

1104 Completed Shutting Down/Suspending of virtual machines of PRIORITY from cluster CLUSTERNAME of datacenter DATACENTERNAME in vCenter server vCENTERIP/HOSTNAME

1104 Completed Shutdown/Suspend of virtual machine(s) of all priorities from cluster CLUSTERNAME of datacenter DATACENTERNAME in vCenter server vCENTERIP/HOSTNAME

1106 Redundancy/Protection restored- Sending start signal to Virtual Machines present in cluster CLUSTERNAME of datacenter DATACENTERNAME in vCenter server vCENTERIP/HOSTNAME.

1107 Redundancy/Protection restored- Completed start of all Virtual Machines present in cluster CLUSTERNAME of datacenter DATACENTERNAME in vCenter server vCENTERIP/HOSTNAME.

1113 Redundancy/Protection restored- Checking state of hosts present in cluster CLUSTERNAME of datacenter DATACENTERNAME in vCenter server vCENTERIP/HOSTNAME to power on

1114 Redundancy/Protection restored - All hosts present in cluster CLUSTERNAME of datacenter DATACENTERNAME in vCenter server vCENTERIP/HOSTNAME are powered on




7. Known Limitation

1. During Low battery, Load Shedding module initiates the shutdown of all virtual machines

after around 2 minutes once IPM gets Low Battery signal. This is because of architecture of Power CLI to connect to VMware vCenter Server. Make shutdown duration settings in Connect UPS MS card to give enough time to shut down all Virtual Machines, put hosts in in Maintenance mode and to shutdown hosts

2. When HA is enabled, during low battery Load Shedding application will put hosts in maintenance mode but will not shutdown the hosts. This is because of restriction of VMware.

3. Password and user credentials needs to be update in Load Shedding application when it is changed in vCenter.

4. Data is not stored on vCenter or on ESXi host but will keep on IPM machine.




8. References

Eaton and Virtualization Please visit http://www.eaton.com/virtualization

Intelligent Power Manager (Eaton Power Supervisor) Please visit http://pqsoftware.eaton.com for more information about download and installation of IPM.



http://pqsoftware.eaton.com/

user guide eaton load shedding module for vmware...

Documents