Power Manager User's Guide

UPS Power Manager

User's Guide

Note: Before using this information and the product it supports, read the general information in Appendix I, Notices, on page 97.

First Edition (June 2013) Copyright IBM Corporation 2013.US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contractwith IBM Corp.

ContentsChapter 1. Introduction . . . . . . . . . . . . . . . . . . . . . . 1Notices and statements in this document . . . . . . . . . . . . . . . . 1

Chapter 2. Installing the IBM UPS Power Manager application . . . . . . 3Installation prerequisites . . . . . . . . . . . . . . . . . . . . . . 3

On a system hosting UPS Power Manager . . . . . . . . . . . . . . 3On a system that displays the web-based graphical user interface . . . . . 4

Downloading the UPS Power Manager software . . . . . . . . . . . . . 5Quick start installation . . . . . . . . . . . . . . . . . . . . . . . 5Installation results . . . . . . . . . . . . . . . . . . . . . . . . 8Uninstalling UPS Power Manager . . . . . . . . . . . . . . . . . . 8Installing or uninstalling UPS Power Manager from a command line . . . . . . 8

Chapter 3. Configuring UPS Power Manager . . . . . . . . . . . . . 11Configuring the nodes . . . . . . . . . . . . . . . . . . . . . . 11UPS Power Manager settings . . . . . . . . . . . . . . . . . . . 11

Discovering the nodes connected on the network . . . . . . . . . . . 11Configuring actions . . . . . . . . . . . . . . . . . . . . . . 12Configuring user accounts . . . . . . . . . . . . . . . . . . . . 16Configuring system settings . . . . . . . . . . . . . . . . . . . 17

Chapter 4. Monitoring devices . . . . . . . . . . . . . . . . . . 21Starting the monitoring interface . . . . . . . . . . . . . . . . . . 21

Local access. . . . . . . . . . . . . . . . . . . . . . . . . 21Remote access. . . . . . . . . . . . . . . . . . . . . . . . 21

Node list view . . . . . . . . . . . . . . . . . . . . . . . . . 22Flexible panels view . . . . . . . . . . . . . . . . . . . . . . . 24Panels list. . . . . . . . . . . . . . . . . . . . . . . . . . . 25

Information . . . . . . . . . . . . . . . . . . . . . . . . . 25Status . . . . . . . . . . . . . . . . . . . . . . . . . . . 25Outlets . . . . . . . . . . . . . . . . . . . . . . . . . . . 27Measures . . . . . . . . . . . . . . . . . . . . . . . . . . 27Environment . . . . . . . . . . . . . . . . . . . . . . . . . 27Graph . . . . . . . . . . . . . . . . . . . . . . . . . . . 28Synoptic . . . . . . . . . . . . . . . . . . . . . . . . . . 28Power Source . . . . . . . . . . . . . . . . . . . . . . . . 30Powered applications . . . . . . . . . . . . . . . . . . . . . 30Events . . . . . . . . . . . . . . . . . . . . . . . . . . . 30Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . 31Power Components . . . . . . . . . . . . . . . . . . . . . . 31

Devices supervision . . . . . . . . . . . . . . . . . . . . . . . 32Applications List view . . . . . . . . . . . . . . . . . . . . . . 32Map view . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

Creating a customized Map view . . . . . . . . . . . . . . . . . 34Map examples . . . . . . . . . . . . . . . . . . . . . . . . 35

Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38List representation . . . . . . . . . . . . . . . . . . . . . . 38Calendar representation . . . . . . . . . . . . . . . . . . . . 39Nodes Events list . . . . . . . . . . . . . . . . . . . . . . . 39

Launching the web interface for a device or application . . . . . . . . . . 42Defining subviews . . . . . . . . . . . . . . . . . . . . . . . . 42Sharing subviews . . . . . . . . . . . . . . . . . . . . . . . . 44

Copyright IBM Corp. 2013 iii

Chapter 5. Shutting down UPS Power Manager . . . . . . . . . . . . 47Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . 47Shutdown configuration . . . . . . . . . . . . . . . . . . . . . . 47Power Source view . . . . . . . . . . . . . . . . . . . . . . . 48Shutdown sequence . . . . . . . . . . . . . . . . . . . . . . . 48

Chapter 6. Advanced Management . . . . . . . . . . . . . . . . . 49Nodes settings . . . . . . . . . . . . . . . . . . . . . . . . . 49

Single node configuration display . . . . . . . . . . . . . . . . . 49Single card settings . . . . . . . . . . . . . . . . . . . . . . 50Multiple card configurations synchronization . . . . . . . . . . . . . 50

Nodes upgrade . . . . . . . . . . . . . . . . . . . . . . . . . 51Updating device firmware . . . . . . . . . . . . . . . . . . . . 51Upgrading applications . . . . . . . . . . . . . . . . . . . . . 52

Chapter 7. Virtualization Module . . . . . . . . . . . . . . . . . . 53Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . 53

IBM virtualization solutions for VMware, Microsoft, Citrix and OpensourceXen, KVM . . . . . . . . . . . . . . . . . . . . . . . . . 53

Supported environments . . . . . . . . . . . . . . . . . . . . . 58Enabling the Virtualization Module . . . . . . . . . . . . . . . . . . 59VMware supervisors prerequisites . . . . . . . . . . . . . . . . . . 59Citrix supervisors prerequisites . . . . . . . . . . . . . . . . . . . 59Microsoft supervisor prerequisites . . . . . . . . . . . . . . . . . . 59Adding Manager or Hypervisor List features . . . . . . . . . . . . . . 60

Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 60Adding a vCenter Server Manager. . . . . . . . . . . . . . . . . 60Adding a SCVMM Manager . . . . . . . . . . . . . . . . . . . 61Adding a VMware ESX/ESXi Hypervisor List . . . . . . . . . . . . . 61Adding a Citrix XenServer Hypervisor List . . . . . . . . . . . . . . 62Adding a XenCenter . . . . . . . . . . . . . . . . . . . . . . 62

Configuring Hypervisors (ESX/ESXi Server, XenServer) . . . . . . . . . . 63Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 63Credential configuration for the Hypervisors (ESX/ESXi, XenServer) . . . . 63

Configuring maintenance and shutdown. . . . . . . . . . . . . . . . 64The VMhost has No UPS Power Protector . . . . . . . . . . . . . . 64UPS Power Manager detects UPS Power Protector running on the VMHost 65

Chapter 8. Redundancy . . . . . . . . . . . . . . . . . . . . . 67Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . 67Redundancy configuration . . . . . . . . . . . . . . . . . . . . . 69Redundancy views . . . . . . . . . . . . . . . . . . . . . . . 70

Redundancy view in Node List . . . . . . . . . . . . . . . . . . 70Composite device in Power Source view . . . . . . . . . . . . . . 70Power components subview . . . . . . . . . . . . . . . . . . . 71

Redundancy use cases (if shutdown is activated) . . . . . . . . . . . . 71Redundancy advanced behavior example . . . . . . . . . . . . . . . 74

Chapter 9. Compatibility List . . . . . . . . . . . . . . . . . . . 77Applications on computers. . . . . . . . . . . . . . . . . . . . . 77IBM devices . . . . . . . . . . . . . . . . . . . . . . . . . . 77

Appendix A. Configuring the UPS Power Manager vCenter plug-in . . . . 79Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . 79Registering the UPS Power Manager plug-in in vCenter . . . . . . . . . . 79Events and Alarms . . . . . . . . . . . . . . . . . . . . . . . 80

iv UPS Power Manager: User's Guide

Using UPS Power Manager through vCenter . . . . . . . . . . . . . . 80

Appendix B. Configuring the XenCenter plug-in . . . . . . . . . . . 81Prerequisites. . . . . . . . . . . . . . . . . . . . . . . . . . 81Check XenCenter plug-in installation . . . . . . . . . . . . . . . . . 81

Appendix C. Configuring maintenance mode and vMotion with vCenter 83Prerequisites. . . . . . . . . . . . . . . . . . . . . . . . . . 83Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . 83Maintenance mode . . . . . . . . . . . . . . . . . . . . . . . 83Configuring maintenance mode behavior in vCenter . . . . . . . . . . . 84Configuration Test . . . . . . . . . . . . . . . . . . . . . . . . 84

Appendix D. VMware vCenter high availability . . . . . . . . . . . . 85

Appendix E. Configuring maintenance mode and live migration withSCVMM . . . . . . . . . . . . . . . . . . . . . . . . . . 87

Maintenance Mode . . . . . . . . . . . . . . . . . . . . . . . 87What is live migration . . . . . . . . . . . . . . . . . . . . . . 87Configuration test . . . . . . . . . . . . . . . . . . . . . . . . 87

Appendix F. VMware references . . . . . . . . . . . . . . . . . . 89

Appendix G. Microsoft Hyper-V references . . . . . . . . . . . . . 91

Appendix H. Getting help and technical assistance . . . . . . . . . . 93Before you call . . . . . . . . . . . . . . . . . . . . . . . . . 93Using the documentation . . . . . . . . . . . . . . . . . . . . . 94Getting help and information from the World Wide Web . . . . . . . . . . 94How to send Dynamic System Analysis data to IBM . . . . . . . . . . . 94Creating a personalized support web page. . . . . . . . . . . . . . . 94Software service and support . . . . . . . . . . . . . . . . . . . 94Hardware service and support . . . . . . . . . . . . . . . . . . . 95IBM Taiwan product service . . . . . . . . . . . . . . . . . . . . 95

Appendix I. Notices . . . . . . . . . . . . . . . . . . . . . . . 97Trademarks . . . . . . . . . . . . . . . . . . . . . . . . . . 97Important notes. . . . . . . . . . . . . . . . . . . . . . . . . 98

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101

Contents v

vi UPS Power Manager: User's Guide

Chapter 1. IntroductionThe IBM UPS Power Manager software provides power-management tools for IBMuninterruptible power supplies (UPSs).

The UPS Power Manager software has the following features:v Discovers and supervises IBM UPSs that are connected to the network (either by

a network management card or a shutdown controller). For the detailed list ofcompatible solutions, see Chapter 9, Compatibility List, on page 77.

v Supervises the remote servers that are hosting the IBM UPS Power Protector.v Provides advanced management features (mass configuration and mass upload)

with the IBM Network Management Card.v Provides local computer graceful shutdown through the IBM Network

Management Card.

Notices and statements in this documentThe following notices and statements are used in this document:v Note: These notices provide important tips, guidance, or advice.v Important: These notices provide information or advice that might help you avoid

inconvenient or problem situations.v Attention: These notices indicate potential damage to programs, devices, or

data. An attention notice is placed just before the instruction or situation in whichdamage might occur.

Copyright IBM Corp. 2013 1

2 UPS Power Manager: User's Guide

Chapter 2. Installing the IBM UPS Power Manager applicationThis chapter contains detailed information about accessing, installing, upgradingand uninstalling the IBM UPS Power Manager application.

Installation prerequisitesYou can host the UPS Power Manager software on your system or access itremotely using a web browser. Installation prerequisites depend on which methodyou use to access UPS Power Manager.

On a system hosting UPS Power ManagerIf you are planning to host UPS Power Manager on your system, you can install iton any of the following platforms.

Microsoft Windows:v Microsoft Windows Server 2012v Microsoft Windows Server 2011v Microsoft Windows Server 2008v Microsoft Windows Server 2003v Microsoft Windows 8v Microsoft Windows 7v Microsoft Windows Vistav Microsoft Windows XP

VMware:v vSphere Hypervisor (ESXi) 5.1v vSphere Hypervisor (ESXi) 5.0v vSphere Hypervisor (ESXi) 4.1v vSphere Hypervisor (ESX) 4.0

Microsoft Hyper V:v Windows Hyper-V Server 2012v Windows Hyper-V Server 2008 R2v Windows Hyper-V Server 2008

Xen:v Citrix XenServer 6.0v Citrix XenServer 5.6v OpenSource Xen 2.6 on Red Hat Enterprise Linux 5v OpenSource Xen 3.2 on Debian 5

KVM:v KVM 0.12.1.2 on Red Hat Enterprise Linux 6 and Debian 5Notes:1. For optimum performance with multiple nodes, use a Windows server operating

system that can support more than 10 simultaneous network connections.


2. To prevent network access conflicts, do not install UPS Power Manager on acomputer that also hosts the following hardware and software:v Network Management System (for example, Tivoli NetView)v IBM UPS Power Protectorv IBM Network Management Cardv Network Management Proxy

On a system that displays the web-based graphical user interfaceThe UPS Power Manager graphical interface can be accessed remotely using aweb browser. Access to this interface is secured through an SSL connection (defaultconfiguration), and login and password.

The UPS Power Manager graphical interface is supported on the followingbrowsers:v Google Chromev Mozilla Firefoxv Microsoft Internet Explorer 7 and later


Downloading the UPS Power Manager softwareYou can install the UPS Power Manager software on a mobile computer,workstation, server, or other device that is running one of the supported operatingsystems. For the supported operating systems, see Installation prerequisites onpage 3.

To download the UPS Power Manager software, go to http://www.ibm.com/support/entry/portal/docdisplay?lndocid=EATN-UPMWIN.

Quick start installationTo quickly install UPS Power Manager, complete the following steps:1. On a Windows-based computer, run the UPS Power Manager package under

an administrator account.

A web browser is displayed.2. Enter USERID as the login and passw0rd as the Password. Then click Login.

Chapter 2. Installing the IBM UPS Power Manager application 5

When you start the application, it automatically performs a Quick scan. Usingthe Quick scan operation, you will discover IBM UPS Power Protector and IBMNetwork Management Card within a few seconds through broadcasting. Thediscovered nodes are displayed in Settings-> Auto Discovery.Some nodes might not be discovered by quick scan if they do not support thatfunction or if they are not in the same subnet as UPS Power Manager. Todiscover such nodes, perform the discovery using Range scan based on IPaddress ranges.

Note: Using the Range Scan operation you will discover the nodes that areoutside of the network segment and nodes that are not compatible withthe "Quick scan" feature. To determine if your node supports the Quickscan feature, see Chapter 9, Compatibility List, on page 77.

3. (Optional) Click Settings -> System -> Module Settings and activate theshutdown module.

4. Click Settings -> Shutdown and assign the IP address of the UPS that powersthe local computer.

5. Click Settings -> User List and assign the access rights through login andpassword.

6. (For the silver or gold paid versions only) In the Settings -> System -> EditSystem Information, enter the license product key that is printed on thesoftware CD booklet (inside the CD case):v ref 66925 UPS Power Manager Silver License (11 to 100 device nodes)v ref 66926 UPS Power Manager Gold License (101 to Unlimited devices

nodes)The nodes that are not managed due to license limitation will display with thisicon:

Notes:a. UPS Power Manager monitors up to 10 devices (UPS network management

card or UPS Power Protector shutdown controller) without a license key. Ifthere are more devices to be monitored, an applicable license is required.Also, licenses can be upgraded later without reinstallation.

b. For more information about purchasing a silver or gold license, seehttp://www.ibm.com/support/entry/portal/docdisplay?lndocid=EATN-UPMWIN.

7. Click Views -> Node List to monitor the current state of the compatible powerdevices and applications. Select a line in the list and the panels are updatedwith the selected device information.


Click Views -> Power Source to manage the current state of the UPS thatpowers the server that is running UPS Power Manager. This menu is availablewhen you have enabled the shutdown module in System Settings.Click Events -> Event List to view the device events.You can configure and upgrade multiple network management cards at one timeby using the Management section of UPS Power Manager.


Installation resultsIf you install a new UPS Power Manager release without uninstalling the previouslyinstalled software, you will keep your database and your product information.

At the end of the installation, the following shortcuts are created in the group: Start-> Programs -> IBM -> UPS Power Manager

Name DescriptionOpen IBM UPS Power Manager Starts the main "UPS Power

Manager" graphical interfaceStart IBM UPS Power Manager Starts the serviceStop IBM UPS Power Manager Stops the serviceUninstall IBM UPS Power Manager Uninstalls the program

A service called "IBM UPS Power Manager" is also created for the DatabaseAcquisition Engine. This program continuously polls the status of IBM devices andapplications connected on the network. This service automatically starts when thecomputer is started. This service provides the web interface.

A System Tray icon displays the alarms on the local computer. A right click on thisicon displays the same shortcuts as in the Windows Start menu.

Uninstalling UPS Power ManagerTo uninstall UPS Power Manager if you need to upgrade or reinstall the application,complete the following steps:1. Click Start -> Control Panel -> Add/Remove programs and select IBM UPS

Power Manager Vx.xx.2. You can also uninstall UPS Power Manager from the shortcut. Click Start ->

Programs -> IBM -> UPS Power Manager -> Uninstall IBM UPS PowerManager.This removes the database and the custom files, if you confirm it.

Installing or uninstalling UPS Power Manager from a command lineYou can install or uninstall UPS Power Manager from a command line to deploy thesoftware with or without a graphical interface. This method also provides the abilityto configure protection settings from the command line.

To obtain details of available command options, type the following command: -help

[COMMAND] [OPTION]...

Type the following commands for installing or uninstalling UPS Power Manager:

-install Launches the installation/upgrade process (default).-uninstall Launches the uninstallation process.

The following options are available using the command line:


-debug Displays debugging information on the console.-silent Installs the application silently.

To create an installation folder, type the following command:-dir

For example, the following command installs UPS Power Manager silently in thelocation, C:\Program Files\MyFolder:packageName -install -silent -dir "C:\Program Files\MyFolder"

When the installation has completed, open a web browser with the URL,http://host:4679/, where host is the host name or IP address of the computer that ishosting UPS Power Manager.


Chapter 3. Configuring UPS Power ManagerThis chapter provides configuration instructions for the UPS Power Managersoftware.

Configuring the nodesEach node (Network Management Card, proxy, or application) must have a valid IPaddress or a DNS name in the range that you have entered for auto-discovery. Formore information, see Chapter 9, Compatibility List, on page 77.

Each node (network management card, proxy, or application must have a valid IPaddress (or a DNS name) in the range that you have entered for auto-discovery.Refer to the compatibility list.

UPS Power Manager automatically receives the alarms (through notification orpolling) without specific configuration on the card, proxies or applications.

For SNMP communication, check the community name. To configure the defaultcommunity name, click Settings -> System -> Default Community Name. Todefine a specific community name for each IP range, click Settings -> AutoDiscovery -> Range Scan -> Password.

UPS Power Manager settingsStart the UPS Power Manager main graphical interface from the previously createdshortcut (Start -> Programs -> IBM -> UPS Power Manager -> Open IBM UPSPower Manager) and then click Settings.

Discovering the nodes connected on the networkFrom Settings -> Auto Discovery, the following discovery methods are available:Quick Scan (automatically performed when application starts), Range Scan,Address Scan.


Notes:1. The Quick scan request is a broadcast frame on 4679 Internet Assigned

Numbers Authority (IANA) reserved port and 69 standard TFTP port. Using theQuick scan operation, you will discover the UPS Power Protector or IBMNetwork Management Card through broadcast within a few seconds.

2. For the other nodes, use Range scan to perform the discovery based on IPaddress ranges. Using the Range Scan operation, you will discover the nodesthat are outside of the network segment and nodes that are not compatible withthe Quick scan feature.

3. Address Scan performs a single address scan or several IP addressesseparated by a semicolon (;).

Configuring actionsTo define the way a user is notified when node events happen, complete thefollowing steps:1. Click Settings -> Actions and select from the following notification methods:

v Emailv Execute script/programv Notification to Alarm Box (available through the System Tray icon)


2. Click Create new action to open the Create new action window.

Note: The fields marked with an asterisk (*) are required.The following options are available from the Create new action window:Events filter

You can filter the email notification according to the following criteria:v Event criticality (Critical, Warning, Normal, or Communication Lost)v Category (All Events, Alarms, Shutdown events, Power events,

Measures). Use the pen icon to select and edit the event category

Chapter 3. Configuring UPS Power Manager 13

v View that triggers the event

Note: Use the Event Criticality parameter to filter the notificationaccording to the event level. If you select Critical as a filter, youwill not receive the associated Normal event informing you thatthe device status changes from Critical to Normal. For moreinformation, see Nodes Events list on page 39.

Email To receive email on UPS events, you have to indicate the SMTP serveraddress and recipient email address. Use your login and passwordwhen the SMTP server requests authentication.For advanced use of email:v You can Customize the subject (for example, if you use an

independent service provider to translate emails into SMS).v You can specify that you want to receive a consolidation of the

alarms that occurred during a delay that you can select. If you specifyno delay, each alarm will generate an email. With this setting, you willreceive more email for the same number of events,

Execute script/programTo run a program on UPS Power Manager events, the program path isrequired.

Note: The program is run under the System account.If an action (script or program) cannot run under the System account,you have to modify the execution context before it can be run.To allow a user to run specific tools and programs with permissions thatare different from those assigned to the user account, use the WindowsRunAs command, which allows you to save the password (Windows XPService Pac 2 and later). Use the following Windows command:runas /profile /user: /savecred

When the program is run for the first time, a password is required; it issaved for subsequent executions.

Alarm box notificationThe alarms are displayed on the local computer in an alarm box. Thestatus part of the alarm box is displayed only if a power source isdeclared in the Shutdown configuration.


You can access the alarm notification box from the System Tray icon.Click the icon to open the UPS Power Manager Notifications windowthat displays the alarms on your local computer.A right click on the System Tray icon provides quick access to thefollowing functions:

If no power source is declared, the System Tray icon can have thefollowing states:

(white)

The System Tray icon correctly receives alarms from UPS PowerManager.

(gray)

Communication is lost between the System Tray and UPS PowerManager.

If a power source is declared, the System Tray icon can have thefollowing states:

The System Tray icon correctly receives alarms from UPS PowerManager: AC is present on the power source.

The System Tray icon correctly receives alarms from UPS PowerManager: The power source runs in battery mode.

The System Tray icon correctly receives alarms from UPS PowerManager: A warning event occurred on the power source.

The System Tray icon correctly receives alarms from UPS PowerManager: A critical event occurred on the power source.Communication with the power source has failed.

Advanced events and actions customizationThe UPS Power Manager installation directory contains theconfigs/scripts folder which consists of a sample user-defined actionscript (sample_user_script.js). You can modify this script or create newscripts that define specific events and actions. The sample scriptprovides details about the expected structure and syntax for definingnew actions and triggers.

Advanced sound alarm customizationTo configure sound alarms on events, complete the following steps:a. In C:\Program Files\IBM\UPSPowerManager\configs\config.js,

change the configuration from


systray:{soundAlarm: false,notificationIcon: true,notificationBox: true}

to the following configuration:systray:{soundAlarm: true,notificationIcon: true,notificationBox: true}

b. Close and restart the Windows user session so that thisconfiguration overrides the previous one.

Note: You can change the alarm sound by setting the Windowssound preferences from the Control Panel. The UPS PowerManager alarms are linked to the Low Battery Alarm soundthat you can change by selecting another .wav file.

Configuring user accountsTo configure multiple user accounts in the UPS Power Manager interface, completethe following steps:1. Click Settings -> User List.

2. Click Add user.3. Enter the User Login and User password when prompted.4. Select the Users Profile level. The following levels are available:

v admin - the user can access all the featuresv user - the user can access only the visualization and is not able to set

changes to the system or nodes5. Click Create new user.

UPS Power Manager contains a default Administrator profile with the followingattributes:v USERID as the loginv Passw0rd as password


Change the administrator settings immediately following the installation of UPSPower Manager.

Configuring system settingsYou can configure your system settings in the UPS Power Manager interface.

1. Select one of the items, and then click on the corresponding button on the right.Edit system information

Requires selections for the following fields: Product key, Contact andLocation.

v Product key: Allows you to activate the licenses of UPM with aSilver or Gold license code.

v Contact and Location: Add the system contact or location.Edit language

Allows you to change the user language (Czech, English, French,German, Japanese, Korean, Polish, Portuguese, Russian, SimplifiedChinese, Spanish, Traditional Chinese are currently supported).


Edit scan settingsRequires information for the following fields: Default SNMP communityname and Automatic scan.

v Default SNMP community name: Changes the default SNMPcommunity name for discovery (default community name is public).

v Automatic scan: Automatic discovery of new devices.Edit updates and Check updates

Provides an automatic update feature. This feature gives you access toIBM software updates. UPS Power Manager is always up-to-date if youselect the Check automatically option. When a new software version isdetected, follow the wizard instructions.

Note: You can also go to http://www.ibm.com/support/entry/portal/docdisplay?lndocid=EATN-UPMWIN to obtain information aboutthe latest UPS Power Manager software.


Note: Database information is retained with this operation.Modules settings

Enable or disable the optional modules: Management, Shutdown,Virtualization, or Redundancy.


Chapter 4. Monitoring devicesThis chapter provides information about monitoring features that are available withthe UPS Power Manager software.

Starting the monitoring interfaceTo monitor IBM devices that are already discovered on the network, start the mainUPS Power Manager interface. You can access the UPS Power Manager interfacelocally or remotely.

Local accessFrom the system where the UPS Power Manager software is installed, click Start ->Programs -> IBM -> UPS Power Manager ->Open IBM UPS Power Manager.

Remote accessTo access UPS Power Manager remotely, you can use one of the followingmethods:v From a remote computer, you can type the following address in a web browser

https://name_or_IP_address_of_computer_hosting_UPM:4680/orhttp://name_or_IP_address_of_computer_hosting_UPM:4679/

v In SSL mode, to accept the certificate, click Yes.

For Internet Explorer 7 on the Microsoft Vista operating system only.To install the certificate on Internet Explorer for Microsoft Vista, complete thefollowing steps:1. Run Internet Explorer 7 as an administrator (right-click the desktop icon).2. Go to the web address of the UPS Power Manager software, which is the

name or IP address of the computer that is hosting the UPS Power Managersoftware.

3. Click through the certificate error.4. Click Certificate Error in the address bar.5. Click View Certificate.6. Click Install Certificate.7. Click Place all certificates in the following store and select Trusted Root

Certification Authorities store. If you do not do this, the certificate goes inyour personal store, and it is not trusted by Internet Explorer.


v Enter the login and password.

Node list viewThis sections describes the information that is displayed in the node list.

The following default columns are displayed on this page:Type Graphical icon to differentiate the UPS and the software applications.Status

This icon represents the severity of the most critical events that are activeon the monitored device.

Name The IP address, the DNS name, or user-defined name.Description

The product name or description.Location

The node location.


ContactThe node contact.

Link The link to the device website (if available).

You can click a column title and sort the device list by selecting Sort ascending,Sort descending, or Columns. The following illustration shows an example of thetypes of columns that you can add to the node list window.

Chapter 4. Monitoring devices 23

Flexible panels viewYou can use the following navigation aids in the Selection view of the UPS PowerManager window:v Select one of the devices or applications in the list and detailed Panels is

displayed in the Selection view on the right.v Click the title bar to collapse or expand the panel.

v Click the double-right arrow or double-left arrow to show or hide all theview menus or Selection view menu.

v Click to select which panel you want to add in the Selection view.

The following illustration shows the Select panels window. Some of the panels areavailable for only specific node types.


Panels listThis section describes the panels that are available in the Selection view.

InformationThe Information panel displays information about the device that has been detectedby the UPS Power Manager.

The following node information is displayed in this panel:166.99.xx.yy

The DNS name (or IP address) is displayed near the status icon.Description

The commercial product name.Nominal apparent power

The device load capacity in VA.IP address

The device IP address.Mac address

The device MAC address.Serial number

The device serial number (if available).Class The type of the card.Location

The device location (the value of the syslocation object or it can also beconfigured on the Device page).

ContactThe device contact (the value of the syscontact object or it can also beconfigured on the Device page).

Link The link to the device website (if available).

Note: The information that is displayed on the Information panel depends on thenode capabilities.

StatusThe Status panel displays the status of the device that has been detected by UPSPower Manager.


The following node information is displayed in this panel:Battery state

The states are Charging, Discharging, Default, Floating, or Resting.Power source

The power source is ac power, battery, or on utility.Load level

The output load level of the device.Battery capacity

The battery capacity of the device.Battery run time

The device remaining backup time.Master output

The main output status (On/Off, Internal Failure, On Automatic Bypass,Manual By Pass, or Overload).

Outlet #xThe output outlet status (On/Off).

Note: The information that is displayed on the Status panel depends on the nodecapabilities.


OutletsThe Outlets panel shows the status of the outlets.Table 1. Outlets color codesSymbol Color Description

Green Powered (on)

Red Not powered (off)

MeasuresThe Measures panel displays the selected device electrical parameters (UPS andsingle phase or 3 phases), depending on the node capabilities.

The following illustration shows an example of the Measures panel for a singlephase UPS.

EnvironmentThe Environment panel displays the selected device sensor information as shown inthe following illustration.

The Environment panel displays the following information:Temperature

Sensor temperature (in C)Humidity

Humidity levelInput #1

Status of first contact (open/closed)Input #2

Status of second contact (open/closed)


GraphThe Graph panel displays the graph of the main measures of the selected device.

To maximize the graph window for better visibility, click . To select the data that

you want to display in the graph, click .

SynopticThe Synoptic panel displays the selected device synoptic. A tool tip is displayedwhen the mouse is over one of the functional blocks.

The synoptic color codes are described in the following tables.Table 2. UPS modulesAC/DC DC/AC Bypass Color Description

Green Status OK andActive

Red Internal fault andInactive

Gray Status OK andInactive orUnknown


Table 3. Battery moduleSymbol Color Description

Green Status OK

Orange Battery charge is less than50%

Red Battery fault, End-of-backup,or End-of-battery-service-lifepre-alarm

Gray Battery status unknown

Table 4. Electrical flowsSymbol Color Description

Yellow Current flow through the cableNote: The object animation gives the directionof the current flow.

Gray No current flow through the cable.

Attention: The cable might still havevoltage.

Table 5. Electrical power source at UPS inputSymbol Color Description

Green Source powered. Status OK

Gray Source not powered or status unknown

The following examples show combinations between flow status and power source status.Green/Yellow

The electrical power source is powered andprovides electrical flow.

Green/Gray The electrical power source is powered anddoes not provide electrical flow.


Table 6. Load at UPS output (its status is linked to the UPS output status)Symbol Color Description

Green Load powered and protected. Status OK

Red Load not powered

Gray Load status unknown

The following examples show combinations between flow status and load status.Yellow/Green

Load powered and protected

Gray/Red Load not powered

Power SourceThe Power Source panel displays information about the device that powers theselected application that is running on the server.

Powered applicationsThe Powered applications panel displays information about the softwareapplications (shutdown agents on the servers) that are powered by the selecteddevice.

EventsThe Events panel displays the events list of the selected node.


StatisticsThe Statistics panel displays the statistics of the selected node.

To select the time interval for the statistics, click . To adjust the time interval,click the From and To dates.

The following list shows the statistics computed data information:v Apparent Consumption (or Active Consumption in next release)v Average Apparent Power (or Average Active Power in next release)v Power Failure Countv Power Failure Cumulated Durationv Battery Fault Countv Internal Failure Countv Overload Countv Warning Alarm Countv Critical Alarm Countv Output Off Countv Communication Lost Count

Note: The statistics computed data information depends on the device capabilities.

Power ComponentsThe Power Components panel displays the components of the redundant UPSsystem if the Redundancy feature is activated. (For more information, seeChapter 8, Redundancy, on page 67.


Devices supervisionThe bar that is displayed at the bottom of the UPS Power Manager window showsthe status of the nodes.

The nodes that are displayed in the bar illustration show the following status:v 14 nodes are OKv 4 are in Warning statusv 2 are in Critical statusv 0 are in Unknown status

Applications List viewTo create a subview that filters applications, right-click Node List, click Create asub view from and select Category as the criteria to filter the nodes. You can alsocreate subviews from the following information: Category, Contact, Description, IPaddress, Location, Name, Status, Type, User Note, or User Type.

You can monitor UPS Power Protector or the IBM Network Management Card fromthis view.


The following default information is shown on the Applications List View page:Type ApplicationStatus

The Status icon represents the status criticality of the server.Name

The value that is configured in the Applications window (by default this is anIP address or a DNS name).

DescriptionThe operating system of the detected device.

Power sourceThe UPS that powers the application.

Run timeThe operating time in the event of a utility supply loss.

Shutdown durationThe duration, in seconds, needed by the system to carry out its shutdownprocedure.

Link The link to the web supervision interface of the UPS Power Protector or theIBM Network Management Card.


Map viewThe Map view shows a graphical representation that enables you to organize thesupervision map using the drag and drop feature. When you select a node icon andthe information is updated on the right panel.

Creating a customized Map viewOn the left menu, select Views -> Node Map. The map is automatically generated(the icons are automatically placed on the map and the IP address is assigned). Onthe Node Map title bar, click the contextual tool button ( ) to modify the map.

You can choose the following options:Change theme

You can choose three kinds of icon representations (small icons, largeicons, and rack icons).

Manage backgroundsYou can perform the following actions:v Import a new background image in the supervision tool.v Select a background already in the supervision tool for the map.v Remove the background images.

Regroup nodesYou can rearrange the icon positions on the map.

Add a labelYou can create user-defined text and place it on the map by using the dragand drop feature.

Note: To delete a label, right-click it, then click Delete.


Map examplesThe following illustrations show example map views.

World Map view


Country Map view


Server Room Map view


EventsThe following sections describe the Events menu options.

List representationTo open the alarms list, click Events -> Events List.

All new alarms are stored in this log.

You can sort the alarms according to Status, Date, Name, Message and Ack.

The following functions are available:Acknowledge selected events adds a check box in the Ack column forselected events.Acknowledge all events adds a check box in the Ack column for all events.Export Logs creates a logs.csv file with the following syntax:"Date";"Node";"Type";"Level";"Object";"Value";"Message";"2009/01/27-18:35:20.840";"166.99.250.83";"Measure";"0";"UPS.PowerConverter.Input[1].Frequency";"49";"";

Note: The Export command can take several seconds before allowing adownload to create the logs file.

Select all selects all displayed events.Deselect all deselects all selected events.


Calendar representationTo open the events calendar, click Events -> Events Calendar.

In this matrix representation, each line is a week and each column is a day of theweek. If you select a day or an interval (with the date selector or press Shift andclick), the Events and Statistics panels display the information for the selection andautomatically refresh when new statistics are computed.

Nodes Events listThe tables in this section describe the icons and event status. The icons in thedifferent views represent the event severity.


Table 7. Uninterruptible power supply status iconsIcon Event status

Normal. With this event, the device is returning to a normal status.

Event list (UPSs, applications, generic devices):v Communication with device is restoredv Communication restored with UPSv The system is powered by the utilityv The UPS output is onv Communication restored with UPSv Battery OKv UPS returns to normal loadv UPS OKv Bypass : Return on UPSv End of low battery alarmv The outlet group 1 is onv The outlet group 2 is onv Communication failure with environment sensorv Communication restored with environment sensorv Humidity is in normal rangev Temperature is in normal rangev Input #x onv Input #x offv End of warning alarmv End of critical alarmv Redundancy restoredv Protection restoredWarning. A problem occurred on the device. The application is stillprotected.

Event list (UPSs, applications, generic devices):v The system is powered by the UPS batteryv Output on automatic bypassv Output on manual bypassv Humidity is below low thresholdv Humidity is above high thresholdv Temperature is below low thresholdv Temperature is above high thresholdv Warning Alarm (a generic Warning alarm is active on the device)v The device is under its load alarm thresholdv The device is over its load alarm thresholdv Protection lostv Redundancy lostv Shutdown in {time}v Remote Communication Error (remote communication or configuration

issue is detected)


Table 7. Uninterruptible power supply status icons (continued)Icon Event status

Critical. A serious problem occurred on the device. This problem requiresan immediate action. The application might not be powered anymore.

Event list (UPSs, applications, generic devices):v The UPS output is offv The outlet group 1 is offv The outlet group 2 is offv Battery faultv UPS overloadv UPS faultv Low battery alarmv Applications must stop immediatelyv System shutdown in progressv Critical alarm (a generic Critical alarm is active on the device)Communication lost

Event list:

Communication failure with a device or applicationDevice is not managed

A device is not managed due to a license limitation. Click Settings ->System and enter a Silver or Gold license code.


Launching the web interface for a device or applicationFrom the Status panel, you can access the web interface for the IBM NetworkManagement Card or for an application, including an integrated web server. Clickthe web link associated with this blue icon (http access) or this yellow icon(https access).

Defining subviewsIf you have to monitor large configurations, it is helpful to define several subviewsand then filter the nodes or events in theses categories. You can select manycriteria to organize the tree (for example, geographical, organizational, or by status).


To define a subview, complete the following steps:1. Select a view in the left navigation pane (for example, Devices).2. Right-click the view and the following contextual menu is displayed.

3. Click Create a sub view from and follow the instructions.4. To filter the nodes in this subview, right-click a node in the Node List area and

click Edit filter view.


5. To add a filtering rule, click Add rule, then enter the Object, Operation, andValue. With this filter you can view the devices whose Location field containsthe value Computer Room.

Sharing subviewsA customized subview is attached to the user that created it. It is private (markedwith a person on the icon of the subview). If the owner of the subview wants toallow the use of the subview by the other users, the owner has to share the view.Right-click on a view to open the contextual menu.

The following subview example shows a private (customized and not shared) NodeMap that is customized and not shared.


The following subview example shows a public (customized and shared) Node Mapthat is customized and not shared.


Chapter 5. Shutting down UPS Power ManagerThis chapter provides instructions for shutting down UPS Power Manager correctly.

IntroductionUPS Power Manager provides local computer graceful shutdown through an IBMNetwork Management Card, USB port, or RS-232 port.

The Shutdown feature can be enabled or disabled by clicking Settings > System >Modules Settings. When the Shutdown feature is enabled, the software sends acommunication error until the power source is correctly configured through theShutdown Configuration.

Shutdown configurationTo configure the Shutdown feature, complete the following steps:1. Login with an administrator user profile.2. Click Settings -> Shutdown and select one of the Shutdown items from the

right panel.

3. Click Edit power source.4. In the Power Source Configuration field, select the UPS that powers the

computer that is hosting UPS Power Manager.5. Check the other parameters and click Save.Notes:1. For a detailed description of the shutdown feature, see the UPS Power

Protector User's Guide.2. If the Shutdown through Hibernate is available with your operating system, use

the hibernation feature (available from Windows 2000). When the computer isshutting down, all work in progress and system information are automaticallysaved to the disk. The computer is also de-energized. When mains powerreturns, all the applications open exactly as they were and return to their workenvironment. You must activate the Hibernate function in the operating systemfirst before using it in the future. (In the power options on the Windows ControlPanel, select the Hibernate tab.)

3. If you select hibernate, but your computer does not have this function, UPSPower Manager will still protect the installation by carrying out the normal(default) shutdown.


Power Source viewYou can monitor the information from the power source that powers the UPS PowerManager computer.

After the Shutdown feature is configured, click Views -> Power Source.

You can perform the following tasks using the Power Source view:v Monitor the information from the UPS that powers the UPS Power Manager

computer.v Drag and drop the panels in this window.

Shutdown sequenceUPS Power Manager can receive shutdown alarms from UPS Power Protector if theShutdown Controller is enabled. You cannot enable the Shutdown Controller featurein UPS Power Manager.

For more information about the shutdown sequence and shutdown use cases, seethe UPS Power Protector Users Guide.


Chapter 6. Advanced ManagementThis chapter describes the advanced management capabilities that are available byusing the node configuration feature.

Nodes settingsYou can configure a single node or synchronize multiple nodes with UPS PowerManager.

Single node configuration displayUPS Power Manager can display the IBM Network Management Card, IBM UPSPower Manager, or IBM UPS Power Protector application configuration.

Select one network management card from the list. The Node configuration panel isupdated after a few seconds.

Click Configurations -> Export Configuration file to export this configuration to afile.


Single card settingsUPS Power Manager can configure a single network management card. Toconfigure a single node configuration, complete the following steps:1. Login with an administrator profile.2. Select one network management card from the list.3. Click Node List ( )-> Set Login Parameters and enter the card Login and

Password. The access status changes from Access Denied ( ) to Access OK( ). After a few seconds, the Node configuration panel updates.

4. Click Edit ( ) or load a previously created configuration.5. In the Network Settings Configuration window, check the parameters you want

to change and enter the new values.

6. Click Apply. The parameters that have different values on the networkmanagement cards and on the configuration that needs to be applied aremarked with the symbol.

7. Select the parameters that you want to synchronize and click Synchronize.

Note: Some advanced parameter details are not displayed in the UPS PowerManager node configuration window. You need to change the advancedparameters details directly on one device and then synchronize theconfiguration from this device to other devices.

Multiple card configurations synchronizationUPS Power Manager can synchronize multiple card configurations. To synchronizemultiple cards, complete the following steps:1. Select several cards from the list.2. Click Node List ( )-> Set Login Parameters and enter the card Login and

Password. The access status changes from Access Denied ( ) to Access OK (). After a few seconds, the Node configuration panel is updated.

3. From the combo box, select the configuration that will be the model or click Edit( ).The parameters that have different values on the cards have the symbol.

4. Select the parameters that you want to synchronize and click Synchronize.


Nodes upgradeYou can perform upgrades to your UPS Power Manager nodes.

Updating device firmwareAttention: Installing the wrong firmware or device-driver update might cause thedevice to malfunction. Before you install a firmware or device-driver update, readany readme and change history files that are provided with the downloaded update.These files contain important information about the update and the procedure forinstalling the update, including any special procedure for updating from an earlyfirmware or device-driver version to the latest version.

To update the device firmware, complete the following steps:1. Click Management -> Nodes Upgrade. See the Network cards release notes to

determine the latest firmware release compatible with the hardware revision.

Chapter 6. Advanced Management 51

2. Select the cards in the list.3. Click Node List ( )-> Set Login Parameters and enter the card Login and

Password. The access status changes from Access Denied ( ) to Access OK ().

4. Select Firmware -> Import Firmware File. The uploading window is displayed.5. Click Browse to select the firmware from a disk that is accessible from the

computer.6. Click Import.7. Click Firmware -> Upload Firmware to nodes. The cards will be updated with

the firmware that is selected.

Upgrading applicationsTo update an application, complete the following steps:1. Click Management -> Nodes Upgrade.

2. Select the applications in the Node List.3. Click Node List ( )-> Set Login Parameters and enter the card Login and

Password. The access status changes from Access Denied ( ) to Access OK ().

4. From the Applications update panel, click Update. The versions of theapplications are updated.


Chapter 7. Virtualization ModuleThe UPM Virtualization Module for VMware, Microsoft and Citrix requires a networkshutdown environment. The uninterruptible power supply (UPS) has to beconnected through a network interface (for example, network management card)and the UPS Power Protector software has to be configured to communicate withthis network interface. The UPS Power Manager does not support using theVirtualization Module for peer-to-peer interface (for example, as USB or RS232)between the UPS Power Protector and the UPS.

IntroductionThe UPM Virtualization Module will retrieve information from the Hypervisorsoftware (ESX, ESXi, XenServer, and similar software) or Manager [vSphere,System Center Virtual Machine Manager (SCVMM) and similar cloud operatingsystems].

UPS Power Manager will execute advanced features on UPS power events:v Trigger the move of the Virtual Machines to other servers (put the VM host in

maintenance mode). The data center will benefit with this zero down-time feature.v Trigger Shutdown of the VM Host with VCenter with SCVMM (done by UPS

Power Protector). The data center will benefit from the server graceful shutdown.

IBM virtualization solutions for VMware, Microsoft, Citrix andOpensource Xen, KVM

IBM provides virtualization solutions for a variety of virtual software applications.

IBM solutions for VMwareIBM provides three solutions for VMware as illustrated in the following architecturaldiagram.1. ESXi server graceful shutdown - UPS Power Protector is installed on a

VIMA/vMA (one instance of UPS Power Protector per ESXi). This solution isbest for the following scenarios:v vCenter Server is not available for management of hostsv The number of ESXi servers is limitedThis option is only supported with ESXi versions that were purchased. Freeversion cannot be shutdown because of VMware restrictions. For moreinformation, see UPS Power Protector Installation and Configuration Guide:VMware ESXi virtual architecture.

2. ESX server graceful shutdown - UPS Power Protector is installed on eachESX operating system. This solution is best for the following situations:v vCenter Server is not available for management of hostsv The number of ESX servers is limitedFor more information, see User Manual Extension for VMware ESX 4.0.

3. Multiple ESX and ESXi servers (paid version only) - It provides the followingfeatures:v Remote graceful Shutdown of multiple ESX/ESXi servers and hosted VMsv ESX/ESXi remote maintenance (vMotion)v UPM Plug-in created in vCenterv UPS events are accessible through vCenter


This solution is ideal for the largest infrastructures working through the vCenterserver and is described in detail later in this chapter.

IBM solutions for MicrosoftFor Microsoft, IBM provides two solutions as illustrated in the following architecturaldiagram.

Graceful shutdown for Hyper V server or Hyper V on 2008:UPS Power Protector is installed on each Microsoft operating system. Thissolution doesn't require SCVMM management software. For moreinformation, see User Manual Extension for Hyper-V and HyperV server.

Multiple Hyper V and Hyper-V servers with the following feature:V/Hyper-V server remote maintenance to trigger VM Live Migration. Thissolution is ideal for the largest infrastructures working through SCVMMserver. For more information about this solution, see Appendix G, MicrosoftHyper-V references, on page 91.


IBM solutions for Citrix XenIBM provides two solutions for Citrix that are illustrated in the following architecturaldiagram.

Graceful shutdown for Citrix Xen:UPS Power Protector is installed on each Citrix Xen system. This solutiondoesn't require Xen Center management software. For more information,see Installing and configuring UPS Power Protector On Xen VirtualizedArchitecture.

Multiple Xen servers with the following features:v Xen server Remote maintenance to trigger VM Xen Motionv Xen server Remote shutdownThis solution is ideal for the largest infrastructures working through the XenCenter. This solution is integrated in the UPS Power Manager applicationand is described in the appendix, Appendix B, Configuring the XenCenterplug-in, on page 81.

Chapter 7. Virtualization Module 55

IBM solutions for Open Source XenIBM provides one solution for Open Source Xen that is illustrated in the followingarchitectural diagram.

This solution provides graceful shutdown for Xen. UPS Power Protector is installedon each Xen system. For more information, see Installing and configuring UPSPower Protector On Xen Virtualized Architecture.


IBM solutions for Red Hat KVM or Opensource KVMIBM provides one solution for Red Hat and Open source Kernel-based VirtualMachine (KVM), which is illustrated in the following architectural diagram.

This solution provides graceful shutdown for KVM. UPS Power Protector is installedon each KVM system. For more information, see Installing and configuring UPSPower Protector On KVM Virtualized Architecture.


IBM solutions for Citrix XenClientIBM provides the following solution for Citrix XenClient, which is illustrated in thefollowing architectural diagram.

The Citrix XenClient solution provides graceful shutdown for the XenClient. UPSPower Protector should be installed on each XenClient system or on each VirtualMachine. For more information, see Installing and Configuring UPS Power Protectoron XenClient Virtualized Architecture.

Supported environmentsIBM supports the Virtualization Module in the VMware, Microsoft, and Citrixenvironments.

VMwareVMware is compatible with the following:v vCenter 4.0, 4.1, 5.0 and 5.1v ESXi 4.0, 4.1, 5.0 and 5.1 (remote shutdown from UPS Power Manager

or with UPS Power Protector on vMA)v ESX 4.0 and 4.1 (shutdown with UPS Power Protector on core OS)

MicrosoftMicrosoft is compatible with SCVMM 2008 and 2012 only.

Citrix The Citrix environment has been tested and is compatible with:v XenServer 5.6 and 6.0.0v XenCenter 5.6 and 6.0.0


Enabling the Virtualization ModuleTo enable the virtualization module, click System -> Module Settings and enablethe virtualization module as shown in the following illustration.

VMware supervisors prerequisitesThe virtualization module requires the following prerequisites:v Installation of VMware vCenter and vSphere Client

Note: vCenter and UPS Power Manager can be installed on the same server (oron a VM/Server on the network).

v Installation of the VMware tools on each VM to provide the VM gracefulshutdown

v No requirement for the vSphere SDK for Perl after UPS Power Manager 1.25and later

You must also have knowledge and experience with the UPS Power Managersoftware and VMware Infrastructure.

Citrix supervisors prerequisitesThe virtualization module requires the following prerequisites:v Installation of XenCenter to manage the XenServersv Installation of Xen tools on each VM to provide the VM graceful shutdown

Microsoft supervisor prerequisitesThe virtualization module requires the following prerequisites:v The Powershell Snapin for SCVMM. To obtain Powershell Snapin for SCVMM:

Install the VMM console on the computer that is hosting UPM or Install UPM Power Manager on the computer that is hosting SCVMM

v The server hosting UPS Power Manager on the same Windows domain as theSCVMM Server

v Capability of the server hosting UPS Power Manager to enable the execution ofindependent scripts on the local computer, with the minimum access set to"Remote Signed" (examples: Set-ExecutionPolicy RemoteSigned). The followingillustration shows the parameters after the configuration example.


Adding Manager or Hypervisor List featuresThis section contains detailed information about Manager or Hypervisor Listfeatures that are available through the virtualization module.

IntroductionYou can edit or remove a Manager or a Hypervisor from the UPS Power Managersoftware.1. Enable the virtualization module (see the previous sections for an explanation).

A new Virtualization menu is displayed under the Settings menu.2. Click Virtualization.3. Click Add Manager or Hypervisor List on the right panel.

4. To edit or remove Managers or Hypervisors, select a line in the center panelfirst.

Adding a vCenter Server ManagerTo add a vCenter Server Manager to UPS Power Manager, complete the followingsteps:1. In the Add Manager or Hypervisor List window, complete the applicable fields:


v Product VMware vCenter

v Hostname or IP address VMware vCenter hostname or IP address

v Username vCenter administrator username

v Password VMware vCenter administrator password

v vCenter Plugin Installs and configures the UPS Power Manager Plug-ininto vCenter (For more information, see Appendix A,Configuring the UPS Power Manager vCenter plug-in,on page 79 when using this feature.)

2. Click Save.

Note: When configuring the login and password, use the UPS Power Managerweb interface through https. Using http is also possible, but the passwordis sent to the local or remote server unencrypted. In both cases, thepassword is stored encrypted in UPS Power Manager and never resenton the client side. The encrypted password is stored in the$UPMFolder$\configs\vmconfig.js configuration file.

Adding a SCVMM ManagerTo add a new Microsoft SCVMM, complete the following steps:1. In the Add Manager or Hypervisor List window, select Microsoft SCVMM in the

Product field.

2. Enter the hostname or IP address and click Save.

Adding a VMware ESX/ESXi Hypervisor ListTo add a new VMware ESX/ESXi List, complete the following steps:


1. In the Add Manager or Hypervisor List window, select VMware ESX/ESXi in theProduct field.


Adding a Citrix XenServer Hypervisor ListTo add a new Citrix XenServer Hypervisor List, complete the following steps:1. In the Add Manager or Hypervisor List window, select Citrix XenServer in the

Product field.


Adding a XenCenterThe Citrix XenCenter is a client and not a manager; therefore, you can install aplug-in on the system where XenCenter is installed.

To add a new XenCenter, complete the following steps:1. In the Add Manager or Hypervisor List window, select Citrix XenServer in the

Product field.

2. Select the checkbox for XenCenter Plugin and click Save.

For more information, see Appendix B, Configuring the XenCenter plug-in, onpage 81.


Configuring Hypervisors (ESX/ESXi Server, XenServer)This section provides information about configuring Hypervisors in ESX/ESXi Serverand XenServer.

IntroductionIf you added a manager in UPS Power Manager (as described in Adding Manageror Hypervisor List features on page 60), note the following information:v After you enter the correct information for the manager, UPS Power Manager

connects to the manager (vCenter or SCVMM).v UPS Power Manager automatically retrieves the VMHost information and creates

new nodes in UPS Power Manager for each VMhost.v UPS Power Manager automatically creates two different types of nodes. The

nodes are described in Configuring maintenance and shutdown on page 64(you can see the new node in the Node List).

v Proceed to Configuring maintenance and shutdown on page 64.

If you added a hypervisor list in UPS Power Manager (as described in AddingManager or Hypervisor List features on page 60), note the following information:v After you have added a new list of hypervisors, UPS Power Manager creates

new nodes and waits for the credentials.v To configure the credentials for hypervisors (ESX/ESXi, XenServer), see

Credential configuration for the Hypervisors (ESX/ESXi, XenServer).v UPS Power Manager automatically creates two different types of nodes. The

nodes are described in Configuring maintenance and shutdown on page 64(you can see the new node in the Node List).

Credential configuration for the Hypervisors (ESX/ESXi, XenServer)To configure the node credential in the Node Configuration panel, enter the correctinformation in the System Settings window and UPS Power Manager retrieves theHypervisors information. Then, go to Configuring maintenance and shutdown onpage 64.


Configuring maintenance and shutdownAfter you have entered the correct credential information for the managers andhypervisors, you have to configure the maintenance and shutdown sequencesaccording to the availability needs of your IT infrastructure when power fails. Thereare two types of VMHost nodes as explained in following sections.

The VMhost has No UPS Power ProtectorThere is no UPS Power Protector installed on the server that is hosting theHypervisor (VMHost). The shutdown is remotely performed by UPS PowerManager. This shutdown configuration can be used with only VMware hypervisorsand Citrix XenServer.

In this case, the node has the functions of remote maintenance mode and remoteshutdown. You can configure the node and add a power source in the NodeConfiguration Panel as shown in the following illustration.

After configuration is complete, see Nodes settings on page 49 to use theconfiguration interface.

Table 8. Maintenance and Shutdown parametersParameters Values Description

Remote Maintenance Enabled, Disabled When enabled, it allows the servermanagement tool to move the virtualmachines from this server to another serverin case of "UPS on battery state and"Maintenance Timer elapsed".


Table 8. Maintenance and Shutdown parameters (continued)Parameters Values Description

Maintenance timer User to Type a value Time elapsed on battery state before theUPS Power Manager triggers the state ofthe Hypervisor to change to maintenancemode

Remote Shutdown Enabled, Disabled When enabled, it allows UPS PowerManager to gracefully shutdown this serverin case of UPS on battery state andShutdown criteria reached.

Remote Shutdown of the VirtualMachines

Enabled, Disabled Enables the UPM to shutdown the VirtualMachines before host gets shutdown andrestart the VMs when the host restarts

PowerSource IP address of UPS The UPS powering this server. This node isdisplayed in UPS Power Manager.

Load segment Master, Load Segment1, LoadSegment2

UPS load segment powering the server

Master Shutdown duration User to Type a value This is a Server Shutdown criteria. It is thetime needed for the server to shutdowngracefully.

Master Shutdown after value User to Type a value This is a Server Shutdown criteria. It is thetime elapsed on battery state beforegraceful Shutdown. This timer must begreater than the maintenance timer. -1value means that the timer is disabled.

Notes:1. The Remote Shutdown functionality is reserved for VMware ESX/ESXi and

Citrix XenServer nodes. (Microsoft HyperV benefits from local UPP shutdown.)2. The Remote Shutdown of the Virtual Machines is supported on VMware

ESX/ESXi.3. The Maintenance Timer must be less than the Shutdown after value.

UPS Power Manager detects UPS Power Protector running on theVMHost

If UPS Power Protector is installed on the server that is hosting the Hypervisor(VMHost), the shutdown is performed by this UPS Power Protector.

For this scenario, the node contains both parameter types:v The remote maintenance mode feature parametersv The UPS Power Protector shutdown parameters (as a UPS Power Protector will

perform the shutdown locally).

Note: All the parameters are retrieved from the UPS Power Protector, and youwill configure the UPS Power Protector from UPS Power Manager in thisNode Configuration Panel.

To use the configuration interface, see Nodes settings on page 49.


Table 9. Shutdown parameters (UPS Power Protector)Remote Maintenance Enabled or Disabled (When enabled, it allows the

server management tool to move the virtual machinesfrom this server to another server in case of UPS onbattery state and Maintenance Timer elapsed).

Maintenance timer Time elapsed on battery state before the UPM scriptchanges the state of the Hypervisor to maintenancemode. -1 value means that timer is disabled. For moreinformation, see Appendix C, Configuring maintenancemode and vMotion with vCenter, on page 83 andAppendix E, Configuring maintenance mode and livemigration with SCVMM, on page 87.

PowerSource The UPS powering this server.Load segment UPS load segment powering the server.NMC access) Login/Password The Network Management Card Login/Password that

allows UPP software to control NMC shutdownsequence.

Master Shutdown duration Server Shutdown criteria (time elapsed on batterystate before graceful Shutdown) (This timer must begreater than the maintenance timer).

Master Shutdown after value Server Shutdown criteria (time elapsed on batterystate before graceful Shutdown) (This timer must begreater than the maintenance timer).-1 value means that timer is disabled.

Power source shutoff Disabled (Enabled is used only for server connectedwith UPS though RS232 or USB. Virtualization behaviorrequires Ethernet connectivity (NMC card).

Note: If you install a UPS Power Protector on the VMHost after the UPS PowerManager node has been created:1. Delete the node in UPS Power Manager2. Rediscover the node with the Address Scan in the Auto Discovery

panel3. UPS Power Manager will create the right node type and retrieve both the

VMHost information and the UPS Power Manager information


Chapter 8. RedundancyThis chapter provides information about using the redundancy features of UPSPower Manager.

IntroductionUPS Power Manager can supervise composite devices. Composite devices arevirtual nodes composed of uninterruptible power supplies (UPSs) that are mountedwith specific redundancy topologies (Redundant Supplies, Hot Standby or StaticTransfer Switch for two components and Parallel for two or more components) anda dedicated redundancy level.

The electrical redundancy topologies are described in the following list:v Redundant supplies (dual feed or triple feed)

In this case, the two UPSs provide power onone or several multiple feed servers.

v Hot standby

For Hot Standby mode, when the upstreamUPS powers the load, the downstream UPSis on bypass.

v Static Transfer Switch for two components

For Static Transfer Switch (STS) mode, thereare several cases with a single STS ormultiple STSs.


v Parallel for two or more components

All the UPSs power the load at the sametime.

To enable the redundancy feature, click Settings -> System -> Modules Settings.UPS Power Manager can perform the following tasks:v Supervise composite devices (if the Redundancy feature is activated)v Shutdown the UPS Power Manager computer when powered by several UPSs (if

the shutdown feature is also activated).


Redundancy configurationTo configure redundancy, complete the following steps:1. Login with an administrator user profile.2. Select two or more nodes and click Set composite device from the left menu.

3. In the window, enter the following values:Device name User name of the composite deviceRedundancy mode

To select the correct electrical topology (Parallel / RedundantSupplies / Hot Standby / Static Transfer Switch), seeIntroduction on page 67.

Redundancy LevelThe minimum number of redundant UPSs powering the system.The default is 0.

The new node is created and you can see it in the Auto discovery node list. Youcan perform the following actions:v Select the node as a power source.v Edit the composite device properties by selecting the node in the discovery view

and click Set composite device from the left menu.v If you select components of a composite device and click Set composite device

again, the properties of existing composite devices are shown; no new compositedevice is created; therefore, no composite device duplication is possible.

v The created Virtual Power Source is counted as a node for the licensing nodelimitation.

Chapter 8. Redundancy 69

Redundancy viewsThe Redundancy views are described in the following sections.

Redundancy view in Node ListWhen a composite device is selected in the node list, you can view it in theSelection view, with the following information:v Dedicated states in the Information and Status panels.v The Events panel shows events from the composite devices and all its child

components.v A dedicated Power components panel displays component states including load

level and battery run time.

Composite device in Power Source viewWhen the redundancy and shutdown modules are activated (enabled), a compositedevice can be selected as a power source. You can show this in the Power Sourceview. In this case, Information, Status, Events, and Power components panels aredisplayed with specific data.


Power components subviewWhen redundancy and shutdown module are activated, a new view called Powercomponents is available as a subview of Power source. This view shows a list ofnodes with their properties, but it displays only the components of the selectedpower source, if it is a composite device.

Redundancy use cases (if shutdown is activated)This section provides several typical use cases that can help you configure theredundant shutdown sequence according to your needs.

Use case 1: You want to schedule the longest backup time with the redundantconfiguration.

This use case is the default UPS Power Manager configuration. To view the defaultconfiguration, click Settings -> Shutdown -> Edit Shutdown Configuration.

The following illustration shows the default configuration on the IBM NetworkManagement Card web interface. To open the Shutdown Parameters page, clickUPS -> Shutdown Parameters.


Use Case 2: You want to schedule a shutdown after a predefined time of 10minutes. The shutdown has to occur even if only one UPS is on battery. In thiscase, each server can have its own shutdown timer (for example 10 minutes, 8minutes, or 6 minutes).

The following illustration shows an example shutdown timer of 10 minutes. From theUPS Power Manager window, click Settings -> Shutdown -> Edit ShutdownConfiguration.

Note: This is the default configuration on the network management card.

Use Case 3: You want to schedule a shutdown starting 10 minutes from the lastdetected Utility failure event. For this example, there are two UPSs, one of them isredundant. In this case, all servers shutdown at the same time. This is the defaultconfiguration in UPS Power Manager.

To schedule the same shutdown configuration for the network management card,you have to configure a shutdown timer of 10 minutes in all the networkmanagement cards. In this case, the last UPS sends the shutdown order after 10minutes, if it runs on battery. If the last UPS never runs on battery, the first UPS willsimply shutdown at the end of autonomy and the last UPS takes the load (if it hasthe capacity; otherwise, the shutdown occurs sooner). To open the ShutdownParameters page, click UPS -> Shutdown Parameters. The Shutdown Parameterspage is shown in the following illustration.


Use Case 4: You want to schedule a shutdown when the remaining time of the lastUPS is 10 minutes. In this case, each server can have its own shutdown duration(for example, 10 minutes, 8 minutes, or 3 minutes).

To schedule a shutdown duration of 10 minutes in UPS Power Manager, clickSettings -> Shutdown -> Edit Shutdown Configuration, as shown in thefollowing illustration.

Note: This is the default configuration on the network management card.


Redundancy advanced behavior exampleThis section shows redundancy examples. For each example, there are four parallelUPSs. Each UPS is 20 kW. For this parallel topology, the load can vary between 0and 80 kW.

Redundancy alarm management with four modules

For this example, the user defined redundancy level and load have the followinginformation:v R is the number of redundant UPSsv Status of redundancy lost alarmTable 10. Redundancy alarm management with four modulesLoad /redundancylevel Load < 20 kW

20 kW < Load RedundancyLost active

3 R=3 R=2 ->RedundancyLost active

R=1 ->RedundancyLost active

R=0 ->RedundancyLost active


Protection alarm management with four modules

For this example, the following load and number of failed UPSs are used:v P is the number of UPSs protecting the loadv R is the number of redundant UPSsv Status of protection lost alarmTable 11. Protection alarm management with four modules

Load / failures Load < 20 kW20 KW < Load Protection Lostactive

3 failures P=1; R=0 P=1; R=0 ->Protection Lostactive

P=1; R=0 ->Protection Lostactive


4 failures P=0; R=0 ->Protection Lostactive





Chapter 9. Compatibility ListUPS Power Manager is supported on the devices and applications described in thefollowing sections.

Note: If a device does not support the Quick Scan feature, it can be monitored ifAddress Scan or Range Scan operations are performed.

Applications on computersThe available features are described in this section.

Application Available featuresUPS Power Protector installed on a computer that is running a Windows orLinux operating system

Quick Scan SupervisionManagement

Computers (Windows/Linux/Mac) that are hosting an application for the IBMNetwork Management Card

Quick Scan SupervisionManagement

IBM devicesThe available devices are described in this section.

Equipment designation Card/ proxy FeaturesIBM UPS Network Management Card (46M4110) Network Card Quick Scan Supervision


Appendix A. Configuring the UPS Power Manager vCenterplug-in

The topics in this appendix provide detailed instructions for configuring the UPSPower Manager vCenter plug-in.

IntroductionThe VMware vCenter server platform forms the foundation for virtualizationmanagement. It provides management of hosts and virtual machines from a singleconsole. To further unlock the power of VMwares management system, VMwarehas provided a facility to extend the functionality of VMware vCenter.

Various useful applications can be attached to vCenter to make it more useful. IBMvCenter Plug-in also called vCenter UPS Power Manager Plug-in is a very easy touse and deploy Plug-in to manage UPM from vCenter. This plug-in provides theability to integrate UPS Power Manager with the vCenter environment. After theplug-in is registered, a tab in vCenter opens UPS Power Manager and enables youto configure and manage UPS Power Manager from the vCenter environment.

The VMware plug-in enables you to create a new type of event that can be atrigger-type alarm.

Registering the UPS Power Manager plug-in in vCenterTo register the UPS Power Manager plug-in in vCenter, complete the followingsteps:1. In the vSphere client, click Plug-ins -> Manage Plug-in.

2. UPS Power Manager Plug-in vCenter can be seen in the Plug-in Manager.


Events and AlarmsAfter you have registered the vCenter UPS Power Manager Plug-in, UPS PowerMananger creates a new alarm, the Host UPS PowerFailure (On Battery) that istriggered by a power event.

Using UPS Power Manager through vCenterThe UPS Power Manager tab will now be visible in the vCenter Server Console andin the root folder, . UPS Power Manager is now available and is fully functionalwith the vSphere Client. In the following UPS Power Manager window, the IBMPower Manager tab on the top is selected.


Appendix B. Configuring the XenCenter plug-inThis appendix provides brief instructions for configuring the XenCenter plug-in.

PrerequisitesThe only prerequisite is to have UPS Power Manager installed on the same systemas XenCenter.

Check XenCenter plug-in installationTo install the XenCenter plug-in, check XenCenter Plugin in the virtualizationpanel.

The Options panel displays the plug-in. If the plug-in is not displayed in the list, clickScan Plugins Folder to locate and select the correct plug-in.


After the plug-in is installed, the XenCenter panel the UPS Power Manager tab isdisplayed.


Appendix C. Configuring maintenance mode and vMotion withvCenter

This appendix provides details for configuring a Virtual Machine image inmaintenance mode with vCenter.

PrerequisitesAll Virtual Machine images must be installed and configured on a file server. Formore information, see Appendix F, VMware references, on page 89.

IntroductionThe Dynamic Resource Scheduler (DRS) application from VMware is used toprovide load balancing within the IT network. In particular, DRS is used to be surethat the right resource capacity is available for the data center load. A secondapplication called vMotion in conjunction with DRS will enact movement of virtualmachines from physical server to physical server to provide the best load balance.

The Distributed Power Manager (DPM) application helps maximize data centerelectrical power efficiency by checking DRS for physical server utilization then usingvMotion, will move Virtual machines to servers to fully unload servers then idle themor power them down for maximum power savings.

IBM uses the same vMotion capability when a UPS is in a critical power situation tomove virtual machines from a server that has a critical power situation. UPS PowerManager will now write alarms or alerts into vCenter, which, in turn, triggersvMotion.

VMware uses the term setting a server into Maintenance mode to trigger thevMotion. It is called this because before performing maintenance on server, the datacenter manager needs to clear the Virtual Machines from the server.

Maintenance modeboth stand-alone hosts and hosts within a cluster support the maintenance mode.Only ESX/ESXi Server 3.0 and later supports maintenance mode for standalonehosts.

A host enters or leaves maintenance mode only as the result of a user request. Ifthe host is in a cluster when it enters maintenance mode, the user is given theoption to evacuate powered-off virtual machines. If this option is selected, eachpowered-off virtual machine is migrated to another host, unless there is nocompatible host available for the virtual machine in the cluster. While inmaintenance mode, the host does not allow deployment or power-on of a virtualmachine. Virtual machines that are running on a host entering maintenance modeneed to be either migrated to another host or shut down (either manually orautomatically by DRS).

When no more running virtual machines are on the host, the host icon changes toinclude under maintenance designation and the host Summary panel indicates thenew state. The default automation mode of a virtual machine determines itsbehavior when the host (in a DRS cluster) it is running on enters maintenancemode:


v Any fully automated virtual machine is migrated automatically.v For a partially automated or manual virtual machine, a recommendation for

further user action is generated and displayed.

Configuring maintenance mode behavior in vCenterTo configure the maintenance mode feature behavior, complete the following steps:1. To enable the DRS in Fully Automated automation level, open the vCenter

server in a vSphere client.2. Right-click Cluster, then click Edit Setting -> Turn on VMware DRS.3. Click Next with all default values and then click Finish.

Notes:a. In this example, you have selected to migrate all the virtual machines from

one server to another server of the same cluster.b. You can define other behaviors according to your preferences.

Configuration TestTo test the installation, perform a power failure on the UPS and verify on thevSphere client that the corresponding ESX/ESXi host enters in maintenance modeafter the maintenance mode timer.


Appendix D. VMware vCenter high availabilityAfter enabling the high availability (HA) cluster feature, VMware disables theautomatic startup and shutdown functionality when a Hypervisor is shut down.

Several factors must be taken into consideration after enabling HA mode.v UPS Power Manager continues to move the VM from one server to the others if

all the servers are powered by different UPSs with different power sources (seethe following illustration).

v UPS Power Manager continues to protect the Hypervisor also when power fails.v Due to the deactivation of the automatic startup and shutdown functionality at the

end of the utility failure sequence, all the virtual machines will power off. Toprevent this VM power off, you have two options: Configure the VMware ESX/ESXi nodes in UPS Power Manager to shut down

Documents

Power Manager User's Guide