ESXi-PCNS 3 installaton

All content in this presentation is protected – © 2011 American Power Conversion Corporation

How to install PowerChute

Network Shutdown 3.0 on

VMware ESXi – vMA 4.0 and 4.1


� Basic knowledge of Linux commands and Linux administration is needed before user should attempt the installation of the software.

� PowerChute Network Shutdown (PCNS) 3.0 is required.

� PowerChute Network Shutdown requires VMware Infrastructure Management Assistant (vMA) 4.0 or 4.1 install on the VMware ESXi host.

� If you need help installing vMA please contact VMware support or go to this site http://www.vmware.com/support/developer/vima/

� The vMA client requires AMD Opteron, Rev E or later CPU or Intel processors with EM64T and VT support

� You will need VMware Infrastructure Client installed on your desktop / laptop to log into the ESXi host system. You can load the client by logging into the ESXi host via a web browser.

� Communications ports TCP 3052, 6547, 80 and UDP port 3052 need to be open.


Installing VMWare Infrastructure

client


Download the

desktop client

Enter IPaddress

To load VMware desktop Infrastructure client log into the ESXi host using a web browser and the host systems IPaddress and download the client.


Once the client

has been installed a shortcut to the

client will be placed on the

desktop


Log into the host

server

Double click on the client and the login screen will launch.


View of Infrastructure Client


Installing vMA on host and

configuring CDROM


If the vMA has not been loaded go to File – Virtual Appliances - Import.If you need help installing vMA please contact VMware support or go to this site http://www.vmware.com/support/developer/vima/


Import from the VMware Market place: download from http://www.vmware.com/support/developer/vima/ and navigate / browse to where you downloaded the file to and import from there. Import from URL To download any files from VMware you are required to create a user account.


Once the vMA client has been added select it from the list of available

virtual systems to load PCNS on.


If loading PCNS from CD verify that

the CD drive is

connected on the client and the CD

is loaded into the host system CD

drive.



From the console tab log into

the client.


If one has not been created, create a mount point for the CD.

sudo mkdir /mnt/cdrom


Change the permissions on the new mount point

sudo chmod 666 /mnt/cdrom


Mount the APC CD and change directory to view

the files in the ESXi directory.

sudo mount –t iso9660 /dev/cdrom /mnt/cdromcd /mnt/cdrom/ESXi

Line CommandsLine 1 sudo mount –t iso9660 /dev/cdrom /mnt/cdromLine 2 cd /mnt/cdrom/ESXi


Install PowerChute Network

Shutdown 3.0 on vMA


From within the ESXi directory on the

APC CD run the installation script.

sudo ./install_en.sh (for English version)

NOTE: If the install files were downloaded from APC web site you will need to copy the files to atemporary directory to be uncompressed before the program can be installed. Assuming you are copying

to /tmp the commands are

sudo cp pcns30esxi.tar.gz /tmpcd /tmpsudo gunzip pcns30esxi.tar.gzsudo tar –xvf pcns30esxi.tarsudo ./install_en.sh


When running the install file accept the license and answer

the installation questions as they appear on the console.


When installing be sure when asked to enter the host server ipaddress, user

name, and password. This enables communication between the vMA client and the host server.


Once the installation is complete open web browser to configure PCNS


PCNS Configuration Wizard


Configuration Wizard

• The first time logging into PCNS the configuration wizard is displayed automatically. This can occur after a regular install or a silent install which failed to register PCNS with a Network Management Card.

• Post install, the user will be redirected to the PCNS web user interface. If PCNS has not previously been configured, the userwill be automatically logged in and directed to configure PCNS to ensure server protection. Once the first time wizard completes, the session ends and the user will be redirected to the login screen.

• If PCNS has been configured by this wizard or by a successful registration during a silent install, a visitor to the PCNS web user interface will be welcomed by the log in screen.


Since we use SSL and the browser does not know site a connection warning will appear.

You will need to accept the SSL certificate that is generated by PCNS.

Click I understand the

risk.


Click Add

Exception


Click Confirm

Security Exception

After accepting the security exception the customer will be directed to the PCNS

Configuration wizard .


Click next

This is the opening window for the configuration Wizard. The wizard can be accessed at anytime via the web interface and is

the same for all supported OS!


Enter the User Name and Password along with the Authentication PhraseThe User Name and Authentication Phrase must match the one entered on the NMCThe password can only include alpha numeric characters 0-9, a-z, A-Z

Click next


If the server

has multiple

NICs you must

chose the IP

Address that

will be registered with

the NMC


After choosing

the IP Address that will be

registered with

the NMC click

next


Select if the configuration is Single, Redundant, or Parallel UPS then

click next.


In a Single-UPS configuration, each computer server or group of servers is

protected by a single UPS. That is, each server has one PCNS agent

communicating with a single NMC installed on a UPS.

Supported UPS devices: The entire Smart-UPS range of UPS devices,

including Smart-UPS VT and MGE Galaxy 3500 1- and 3-phase, Galaxy 7000,

Galaxy 300; the Symmetra 1-Phase and 3-Phase, the Symmetra PX, and the Silcon DP3500E and Silcon.

UPS

Server

Single-UPS Configuration


Two or more UPSs that support a load. Each UPS must be able to support the

load on its own. The additional UPSs act as reserve.

The first UPS provides all the power for the load, the others are in reserve. When the first UPS in unable to supply power, the server switches over to take

load from the next UPS

Supported UPS devices:

Smart-UPS range of UPS’s, including SUVT & G3500 (1&3-ph)

Symmetra 1-Ph & Symmetra 3-Ph.

See the updated Applications Note #98

Server

UPS

Redundant Configuration


Server

UPS in parallel

The combined output of several UPSs support the load. Depending on the

capacity of the load there may be reserve UPS(s) available.

Each UPS is in a Parallel-UPS configuration & must be of the same UPS

family.Supported UPS devices: SUVT,G3500(3-Ph), G7000, G300, Silcon

DP3500E&Silcon BC3.

SUVT & G3500(3-Ph) consists of 2–4 UPS’s.

Silcon, consists of 2–9 UPS’s.

See the updated Applications Note #98

Parallel Configurations


Enter protocol,

NMC

communication

port, and NMC ip

address then click next


Select whether to

check for updates,whether to

shutdown

the UPS then click

next


Click apply after

verifying the information is

correct.


PCNS will register with the NMC


If the UPS has the

proper firmware and supports outlet

groups you can

select the outlet group the server is

plugged into.


For this example we selected outlet

group 1 then

clicked apply.


Once registered

Click next


Click Finish


PowerChute Network Shutdown

web interface


After the configuration is complete you will be logged into the PCNS clientThis is the opening page for PCNS client on all supported OS.


This is the configure events page for all PCNS clients

To see a full list of configurable and non-configurable event view PCNS help


If the UPS has the

proper firmware and supports outlet

groups you can

select the outlet group shutdown

behavior.

This is the configure shutdown page for all PCNS clients


If the UPS has the proper firmware

and supports outlet

groups you can select the outlet

group the PCNS

client is attached

to.

This is the Set Up Communications page for all PCNS clients


This is the check for Updates page for all PCNS clients


How to verify communication

ports are open in the vMA and

how to add host servers to the

server list


To verify the needed communications ports are open run this command

sudo /sbin/iptables –L

To open all ports – stop the firewall temporally run the command

sudo service iptables stop

To restart the firewall run the command sudo service iptables start


If you would like to add additional host server to the server list (this will allow for the shutdown of multiple host by a single vMA) first check to be sure the server is not already in the list by running the command vifp listserversIf the server is not in the list add the server to the list by running the commandsudo vifp addserver 10.218.45.20 Verify the server has been addedvifp listservers

NOTE: The address of the host running the vMA should always be last in the list.


Next you need to add the server to the fasspass list the command is vifptarget –s <server name or ipaddress> To verify there is communications between the cleint and the host run the command Vicfg-nics –l (lower case letter l) should display a list of the host NICs.

Documents

ESXi-PCNS 3 installaton