virtual machine virtual machine virtual machine -...

www.eaton.com

Network Shutdown Module V3 User manual extension for VMware ESX 3, 3.5 virtual architecture

Network Shutdown Module V3 – Extension for VMWare ESX Server 3

Virtual machine Virtual machine Virtual machine

VMware ESX Network

Shutdown Module

www.eaton.com

Network Shutdown Module V3 – Extension for VMWare ESX Server 3 VMware is a registered trademark of VMware, Inc. /8

Index

1 Introduction..........................................................................................................................................3 2 Installation ...........................................................................................................................................4

2.1 Pre-requisites.................................................................................................................................4 2.1.1 VMware ESX Server 3, 3.5 configuration .............................................................................4 2.1.2 EATON hardware architecture..............................................................................................5 2.1.3 Network architecture .............................................................................................................5 2.1.4 Installation .............................................................................................................................6

3 Appendix..............................................................................................................................................8 3.1 References ....................................................................................................................................8 3.2 Complementary information ..........................................................................................................8

www.eaton.com


1 Introduction

EATON is a world first class supplier of hardware and software to optimize business continuity on your VMware virtual platforms. It means controlling proper boot and shutdown of the virtual machines hosted on a same physical machine, assuring data integrity on each virtual machine.

Network Shutdown Module is EATON’ solution to automate various data security functions. It:

� Continuously waits for information from the Mgt. Proxy or Mgt. Card connected to the EATON UPS.

� Warns administrators and users if AC power fails � Proceeds system shutdown before the end of battery backup power is reached. � Restarts machines when AC power restarts.

VMware ESX controls shutdown and restart functions directly from the administration console, or from an application hosted on the ESX layer. We offer to install into VMware layer our protection server component, Network Shutdown Module v3.

Each of those components will use electrical redundancy, consolidating information from UPS which are supplying the VMware server.

Installing our protection software into VMware layer will offer these advantages:

� Only one deployment of Network Shutdown v3 on physical machine, to manage all virtual machines.

� Silent and personalized deployment using Command Line Interface of Network Shutdown Module.

� Dynamic management of virtual machines configuration, with a personalized script.

This booklet will guide you through the installation and configuration process of Network Shutdown Module on VMware ESX platform.

EATON tested virtualization security in a redundant power supply configuration, for system shutdown, electrical shutdown, and reboot.

www.eaton.com


2 Installation

Those recommendations will guide you through the installation process of Network Shutdown Module on VMware ESX architecture to allow electric continuity.

2.1 Pre-requisites

EATON validated this how-to on an ESX Server 3.0 (or ESX Server 3.5 u2 or u3) with a Network Shutdown Module v3, and a distant administration workstation with Virtual Infrastructure Client (VIC) 2.0.

2.1.1 VMware ESX Server 3, 3.5 configuration

� For the automatic OS boot on start-up: you must configure physical machine to allow automatic OS boot on start-up. This is effective in your machine’s BIOS. For further information, see specific documentation.

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

� (optional) Check that libgcrypt.so is installed on your ESX. If the library is not installed you will get a Warning message during NSM Installation. First of all, this is only a warning message. Installation will be completed and the NSM will work correctly except the NSM mass-configuration operations. To be sure of that, just open a web browser on the following URL: http://<@linux-IP-address>:4679 You will find the NSM settings web page. If you need this missing feature, you can add the following library: http://rpm.pbone.net/index.php3/stat/4/idpl/5722115/com/libgcrypt-1.4.0-15.el5.i386.rpm.html If the library is missing, during NSM installation into a VMWare system 3.5 (and probably 3.0 too), the following Warning message appears: + + + start Warning message + + PHP Warning: Unknown(): Unable to load dynamic libr ary > './php_domxml.so' - libgcrypt.so.11: cannot open shared object file: > No such file or directory in Unknown on line 0 + + + end Warning message message + + +

� For the automatic virtual machine boot on VMware ESX 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

www.eaton.com


This configuration is illustrated on the following screenshot:

2.1.2 EATON hardware architecture

The prerequisites for Network Shutdown Module V3 installation are described in the "Network Shutdown Module V3 – User Manual" chapter: “Installation Prerequisites“. (http://download.eaton.com/) For UPS systems compatibility, please refer to the chapter “Appendix -> Compatibility List”

2.1.3 Network architecture

All hardware elements must have an operational network configuration that allows them to dialog freely with each other. Make sure in particular that ESX firewall authorises:

� connections on tcp port 4679 and 4680 to enable a remote access for supervision and configuration through Web Browser. These ports are reserved at IANA (http://www.iana.org).

� connections through TCP port 80. It must be opened as a destination port (for output) on the machine hosting Network Shutdown Module. (To enable communication between Network Shutdown Module and Network Management Card)

� Example: esxcfg-firewall -o 4679,tcp,in,EATONhttp esxcfg-firewall -o 4680,tcp,in,EATONhttps esxcfg-firewall -o 80,tcp,out,http esxcfg-firewall –o 5000,tcp,out,EATONinit

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

www.eaton.com


2.1.4 Installation

Download on EATON’s website the latest version of Network Shutdown Module Command Line Interface version. It will automatically detect ESX Server, and will generate shutdown command script (available in the appendix). This shutdown.sh script will be installed in <installation folder>/bin/tools, by default /usr/local/EATON/NetworkShutdownModule/bin/tools.

� Download the latest version of Network Shutdown Module v3, available on EATON’s website, in downloads section “EATON Power Management Software Suite (Solution-Pac 2)”: http://download.eaton.com/ Then: > select “Network solution”. > select Linux as Operating System > download Linux CLI version, known as: « Network Shutdown Module Linux x86 Console «Network Shutdown Module Linux x86 Console», named «nsm_linux_cli_3_xx_xx.run».

� Upload the package on your VMware ESX environment, with a SCP Client (Example under windows environment : WinSCP)

� Connect with SSH to the VMware server (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.

� In the upload folder, add execution right to the package, by typing : chmod 755 nsm_linux_cli_3_xx_xx.run.

Note: If you store the installation file on the shared vmfs resources in a SAN. When you start the installer you could have an error messages "./nsm_linux_cli_3_xx.run: cannot execute binary fil e". Solution: copy the installation source onto the local drive of the ESX server

� Install Network Shutdown Module by typing : ./nsm_linux_cli_3_xx_xx.run -install –silent To configure a personalized package, please refer to Network Shutdown Module v3 manual.

� At the end, connect to Network Shutdown Module using your web browser by typing : http://<@IP-or-name-of-ESX>:4679/eaton/ (for a HTTP access) https://<@ IP-or-name-of-ESX>:4680/eaton/ (For a HTTPS access)

� You are now in front of Network Shutdown Module v3 interface:

www.eaton.com


� In the menu, click on the Configuration �� Power devices item,

Enter the default Login «admin» and default Password «admin»

� Then click on the Add button and Enter the IP address of the Network Management Card (or Proxy).

� Save your configuration

� Configure your password (recommended)

� In Configuration -> System, select the option: Enable only TCP mode Save your configuration

� For the multi ups configurations, please refer Network Shutdown Module manual.

www.eaton.com


3 Appendix

3.1 References

� « Network Shutdown Module v3 user manual » : downloadable from www.eaton.com, « download » section � « Software » � « Solution-Pac 2 » � « Network solution »

� References documents for VMware ESX Server are available on VMware website : 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”

3.2 Complementary information

The script automatically installed with the Network Shutdown Module detects available virtual machines, and shutdowns them. To shutdown virtual machines in the order detailed in VIC, you have to edit and customize shutdown.sh and the “stopVMWare” function :

# Customisable Vmware ESX shutdown stopVMWare() { # Test if we have a Vmware ESX v3 setup if [ -x /usr/bin/vmware ] then ESXV3=`/usr/bin/vmware -v | grep "ESX Server 3" ` if [ -n "$ESXV3" ] then # Get the VM list VMLIST=`/usr/bin/vmware-cmd -l` for VM in $VMLIST do # Get the VM state VMSTATE=`/usr/bin/vmware-cmd "$VM" getstate -q` # Guest OS shutdown if VMSTATE is equal to "on" if [ "$VMSTATE" == "on" ] then /usr/bin/vmware-cmd $VM stop trysoft # delay a bit the next sequence sleep 2 fi done fi fi }

virtual machine virtual machine virtual machine -...

Documents