Eaton NetWatch

NetWatch installation and configuration guide

VMware ESXi 3 Virtual architecture




VMware ESXi server host and guest operating systems architecture

Eaton NetWatch on VMware Installation Guide December 16, 2008









Network
VMw ar e Ser ver ESXi Hyper vi sor
Vima 1.0 or
vMA


Virtual/
Guest OS 2
(Linux)
Applications,
Services, etc.
Virtual/
Guest OS n
(Solaris)
Applications,
Services, etc.

Netwatch
client

Eaton UPS from the
Pulsar series

Eaton UPS from the
Powerware series








Eaton NetWatch on VMware Installation Guide Page 2/10
Index


1 Introduction ...................................................................................................................................... 3
2 Installation........................................................................................................................................ 4
2.1 Prerequisites .............................................................................................................................. 4
2.1.1 VIMA/vMA installation .......................................................................................................... 4
2.1.2 VMware ESXi Server configuration...................................................................................... 4
2.1.3 Network architecture ............................................................................................................ 6
2.2 Installation of Netwatch on VIMA/vMA....................................................................................... 7
2.2.1 VIMA/vMA configuration....................................................................................................... 7
2.2.2 Netwatch Installation ............................................................................................................ 7
2.2.3 Netwatch configuration for VMware ESXi ............................................................................ 8
3 Appendix.......................................................................................................................................... 9
3.1 References................................................................................................................................. 9









Eaton NetWatch on VMware Installation Guide Page 3/10
1 Introduction


This section will give you brief introduction to the NetWatch software. For more detailed
information about NetWatch, please refer the release notes and help documents.

Eaton

Net Watch shutdown agent allo ws you to co nnect server o r workstation to ConnectUPS
SNMP/Web card or NMC based UPS via network c onnection. The server or workstation on which
NetWatch is installed will become a cli ent of the SNMP/WEB adapter or the Net work Management
Card. The NetWatch client will be notified of power events or UPS alerts. The NetWatch client can be
configured to allow only messaging for i nformation purposes, or t o begin an orderly shutdown of the
client computer to avoid a crash in the event of power failures, which could extend beyond the normal
runtime of the UPS batteries.

VMware

ESXi does not have administrative console for hypervisor and hence we cannot install
Netwatch shutdown agent on hypervisor system. However we can install Netwatch on VMware
Infrastructure Management Assistant (VIMA 1.0) or on vSphere Management Assistant(vMA 4.0) to
manage shut down of the VMware ESXi in case of UPS and/or power anomalies. We can also
configure ESXi to safely suspend or shutdown guest operat ing system by proper ly configuri ng ESXi
hypervisor. This way we can have only one Net Watch shutdown agent on one guest operating
system (VIMA/vMA).


There are various benefits to Installing NetWatch client on the VIMA/vMA instead of each client
machine:

Only one binary of NetWatch client on the one guest machine to manage all virtual
machines.
Dynamic management of virtual machines configuration with a personalized script.

This guide will help to install and configure NetWatch client on VIMA/vMA.

NetWatch client is tested on VMware virtualization server with four guest operating systems for
electrical power events, shutdown, low battery and reboot.








Eaton NetWatch on VMware Installation Guide Page 4/10
2 Installation
This guide provides information about i nstalling and configuring NetWatch cli ent on VIMA or vMA.
These recommendations will guide you through the inst allation process of NetWatch as a shutdown
agent for VMware ESXi architecture to allow electric continuity.

2.1 Prerequisites
The following are prerequisites:
1. VMware ESXi Server Machine
2. VMware Infrastructure Management Assistant VIMA 1.0 or on vSphere Management
Assistant(vMA 4.0) installed as guest.
3. VMware Infrastructure client installed on different machine to VMware ESXi Server
configuration.
4. NetWatch 5.0 Installer
5. SSH client like putty for installation and configuration
6. SCP Client like WinSCP to upload packages to VMware ESXi server


2.1.1 VIMA/vMA installation
Please visit http://www.vmware.com/support/developer/vima/ for more information about
download and installation of VIMA or vMA on ESX/ESXi host machines.

2.1.2 VMware ESXi Server configuration
For th e automatic OS b oot on sta rtup: you must configure the physical machine to allow
automatic OS boot on startup. This setting is present in your machines BI OS. For further
information, see specific technical hardware documentation.

To allow interactions between physical and virtual machines, VMware tools have to be
installed on each virtual machine. For further information, see VMware ESXi Server
documentation.

You can configure the automatic startup and shutdown properties of guest operating systems
as suspended. But to work Netwatch properly VIMA/vMA needs to configure as
o Automatic Shutdown of guest(VIMA/vMA) when ESXi host is going down and
o Automatic Startup of guest(VIMA/vMA) when ESXi host is starting
Following procedure will explain about configuration of VIMA/vMA shutdown and
startup properties

From the Virtual Infrastructure Client interface select topmost item ESXi host server from left
hand side tree hierarchy, go in the











Eaton NetWatch on VMware Installation Guide Page 5/10

1. Select Configuration tab
2. Select Virtual machine startup / shutdown menu -> Click Properties present in right
hand corner





Following window will appear on screen,



Select VIMA/vMA guest machine and click on edit button and configure as shown above

Startup Settings
Click Use specified settings
Startup Delay 10 Seconds

Shutdown Settings
Click Use specified settings
Shutdown delay 30 seconds













Eaton NetWatch on VMware Installation Guide Page 6/10
For the automatic boot of guest machines on VMware ESXi on start-up:
From the Virtual Infrastructure Client interface, go in the
Virtual machine startup / shutdown menu Configuration Properties Start and
stop VMs with the system, and tick enable.

Note: In the Properties page, you also have the possibility to define the Startup
Order of your virtual Machines.
Start and Stop VMs with the system : Enabled
Default Startup Delay : x Seconds
Default Shutdown Delay : x Seconds
Startup Order : Automatic Startup

This configuration is illustrated on the following screenshot:




2.1.3 Network architecture
All hardware elements must have an operational network configuration that allows them to dialog
freely with each other. NetWatch client use UDP for communication with UPS.
Please make sure that following UDP ports need to be enabled on VIMA/vMA Firewall
For Eaton UPSs from the Powerware

series, open ports 2844, 2845 if you want to go

with default Eaton Port or Port. For more information see the Advanced Port Setting
option in NetWatch help file
For Eaton UPSs from the Pulsar series, UPS Connections on
udp port 4679 and 4680 need to be to open for NetWatch communication with UPS
Example:
For NMC Cards
sudo iptables -I INPUT -p udp --dport 4679 -j ACCEPT
sudo iptables -I INPUT -p udp --dport 4680 -j ACCEPT
sudo iptables -I OUTPUT -p udp --dport 4679 -j ACCEPT
sudo iptables -I OUTPUT -p udp --dport 4680 -j ACCEPT


For ConnectUPS SNMP Cards
sudo iptables -I INPUT -p udp --dport 2844 -j ACCEPT








Eaton NetWatch on VMware Installation Guide Page 7/10
sudo iptables -I INPUT -p udp --dport 2845 -j ACCEPT
sudo iptables -I OUTPUT -p udp --dport 2844 -j ACCEPT
sudo iptables -I OUTPUT -p udp --dport 2845 -j ACCEPT

After this save the iptables configuration by running following command
sudo service iptables save

To configure your VMware ESXi Server for the network, please refer to the VMWare ESXi user
manual.

2.2 Installation of Netwatch on VIMA/vMA
2.2.1 VIMA/vMA configuration

You can get more information about configuration of VIMA or vMA at ,

To install Netwatch on VIMA/vMA needs administrative privilege of VIMA/vMA
Transfer Netwatch tar file to VIMA/vMA machine using ssh or download it using ftp.
Before installing Netwatch VIMA/vMA machines needs to be configured for target servers. For
more information about adding target servers, refer Adding Target Servers to VIMA present
in VIMA user guide.

Command to add target server is

sudo vi f p addser ver <ser ver name>

it will ask to root password of target server. After that we need initialize vifastpass for use of
Netwatch scripts on the target server, as follows

sudo vi f pi ni t <ser ver name>

Now you can start Netwatch installation on VIMA/vMA.

Following steps will guide you to install and configure Netwatch on VIMA/vMA
2.2.2 Netwatch Installation
The following steps will explain about obtaining the latest version of NetWatch from the Eaton Web
site. Installation and provide information about the shutdown script.

1. For more information about VIMA/vMA please visit
http://www.vmware.com/support/developer/vima/.

2. Download tar file for Linux from the Eaton Web site NetWatch from following location:
http://www.powerware.com/Software/NetWatch_Client_Shutdown.asp

3. Upload the package on your VIMA/vMA, with a SCP Client (Example under windows
environment : WinSCP)

4. Download or get Netwatch tar (Netwatch_501_ESXi.tar) file on VIMA/vMA

5. Connect with SSH to the VIMA/vMA (Example under Windows environment: Putty). You
must have corresponding rights to execute and install programs on VMware ESX. Refer
to VMware ESX for further information.

6. In the upload folder, add execution right to the package, by typing:
sudo chmod 755 NetWatch_501_ESXi.tar.









Eaton NetWatch on VMware Installation Guide Page 8/10
7. Extract install.sh from tar file using following command

t ar xvf Net wat ch_501_ESXi . t ar i nst al l . sh

8. Start installation of Netwatch using following command

sudo . / i nst al l . sh

9. Follow steps of installation (More information about Netwatch installation can be found on
Netwatch help file)

10. It will finish installation and Netwatch will start monitoring UPS.

11. If you want more Netwatch configuration options by following command

a. Go to Netwatch directory and run

sudo . / net wat ch - h

2.2.3 Netwatch configuration for VMware ESXi
To shutdown ESX/ESXi servers from VIMA/vMA needs to provide server list of ESXi servers.
To update server list please follow the following procedure.

1. Go to Netwatch installation directory(eg /usr/Powerware/NetWatch/)
2. Update VMwareESXHosts to add ESXi host server list


sudo vi VMwar eESXHost s

Add all ESXi server hostbane separated by space. Please note to add ESXi server
on which VIMA/vMA is installed to be at the last of the entry. Like example
below

ESXi.linxserverHost1.com 166.99.230.22 166.99.230.5

here in above we have added 3 servers to manage by Netwatch and 166.99.230.5 is
the VIMA/vMA guest operating system on which Netwatch is installed.





























Eaton NetWatch on VMware Installation Guide Page 9/10
VMware is a registered trademark of VMware, Inc.
3 Appendix
3.1 References

For installation of NetWatch please refer to the following link:
http://www.powerware.com/software/NetWatch_help/index.htm

References documents for VMware ESX Server are available on VMware Web site:
http://www.VMware.com/support/pubs/vi_pubs.html

References documents for VMware tools are available in Installation des VMware tools :
Basic System Administration ESX Server 3.0.1 and Virtual Center 2.0.1 manual, chapter
Installing and Upgrading WMWare Tools

Please visit http://www.vmware.com/support/developer/vima/ for more information about
download and installation of VIMA or vMA on ESXi host machines.















































Eaton NetWatch on VMware Installation Guide Page 10/10
Eaton, Powerware and Pulsar are trade names, trademarks, and/or service marks of Eaton Corporation or
its subsidiaries and affiliates. All other trademarks are property of their respective owners.