How to install PowerChute

Network Shutdown 3
3.0.1
0 1 on
VMware vMA 5.0

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.1 is required.
PowerChute Network Shutdown requires VMware Infrastructure
Management Assistant (vMA) 5.0 install on the VMware ESXi host. if you
need help installing vMA please contact VMware support or review KBase
document FA159777
The vMA client requires AMD Opteron, Rev E or later CPU or Intel
processors with EM64T and VT support
You will need VMware vSphere Client installed on your desktop / laptop
to log into the ESXi host system. Review KBase document FA159775 for
vSphere Client installation instructions or contact VMware support.
Communications ports TCP 3052, 6547, 80 and UDP port 3052 need to be
open on the network.
Note: vMA 5.0 is delivered with the firewall inactive.

Schneider Electric - IT Business- SmartWare Tiger Team Leader

To install VMWare vCenter client

review KBase # FA159775 for
instructions

or use the utilityy PuTTY to log

g
onto the vMA.

To load PCNS from the vSphere client click on the shortcut and the
login
g window will launch.

Schneider Electric - IT Business- SmartWare Tiger Team Leader

View of Infrastructure Client

Schneider Electric - IT Business- SmartWare Tiger Team Leader

Next you need to log into the vMA.

To load VMware vMA please review VMware technical support video
provide on youtube http://www.youtube.com/watch?v=J4KdUoToCxM or
review KBase # FA159777

Click here to power the vMA on if it

g
is not running

Once the vMA client has been added select it from the list of available
virtual systems to load PCNS.
Schneider Electric - IT Business- SmartWare Tiger Team Leader

Click on the console tab to log

into the vMA then press the enter
key to go to the log in screen.

Schneider Electric - IT Business- SmartWare Tiger Team Leader

Enter user name and password.

Schneider Electric - IT Business- SmartWare Tiger Team Leader

Install PowerChute Network

Shutdown 3.0.1 on vMA 5.0

Note: if installing from CD review pages

56 - 63

If the install files were downloaded from APC web site you will need to copy the files to a
temporary directory to be uncompressed before the program can be installed.
installed See FA159776 for
instruction on how to copy file to the vMA.
Assuming you copied the downloaded files to /opt/temp the commands are
cd /opt/temp
sudo
d gunzip
i pcns301ESXi.tar.gz
301ESXi t
sudo tar xf pcns301ESXi.tar
There will now be a new directory named ESXi created in /opt/temp
Schneider Electric - IT Business- SmartWare Tiger Team Leader

11

After uncompress the file change directory to /opt/temp/ESXi (caution Linux is case sensitive)
Assuming you are still in the /opt/temp directory the commands are
cd ESXi
ls la (to view the contents of the directory)

Schneider Electric - IT Business- SmartWare Tiger Team Leader

12

After running the command ls la to view the contents of the directory you need change the permissions
of the file install_en.sh to make it executable.
The command is
sudo chmod 777 install_en.sh
install en sh (en indicates the English version)

Schneider Electric - IT Business- SmartWare Tiger Team Leader

13

Next run the installer

The command is
sudo ./install_en.sh

Schneider Electric - IT Business- SmartWare Tiger Team Leader

14

When running the install file view and accept the license and answer the installation questions as they
appear on the console.

Schneider Electric - IT Business- SmartWare Tiger Team Leader

15

Select the default installation path or enter a new path.

Schneider Electric - IT Business- SmartWare Tiger Team Leader

16

Select yes to accept the path.

Schneider Electric - IT Business- SmartWare Tiger Team Leader

17

Select yes to use the bundled java (recommended) or enter the path to a preinstalled java version.

Schneider Electric - IT Business- SmartWare Tiger Team Leader

18

Be sure when asked to enter the host server ipaddress, user name, and password. This enables
communication
i ti between
b t
the
th vMA
MA client
li t and
d the
th host
h t server.

Schneider Electric - IT Business- SmartWare Tiger Team Leader

19

Once the installation is complete open web browser to configure PCNS

Schneider Electric - IT Business- SmartWare Tiger Team Leader

20

PCNS Configuration Wizard

Configuration Wizard
The first time logging into PCNS the configuration wizard is
displa ed automatically.
displayed
a tomaticall This can occur
occ r after a regular
reg lar 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 user
will 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.
Schneider Electric - IT Business- SmartWare Tiger Team Leader

22

Click I
understand the
risk.

Since we use SSL and the browser does not know site a connection warning will appear
appear.
You will need to accept the SSL certificate that is generated by PCNS.
Schneider Electric - IT Business- SmartWare Tiger Team Leader

23

Click Add
Exception

Schneider Electric - IT Business- SmartWare Tiger Team Leader

24

Click Confirm
Security
Exception

After accepting the security exception the customer will be directed to the PCNS
Configuration wizard .
Schneider Electric - IT Business- SmartWare Tiger Team Leader

25

This is the opening window for the configuration Wizard. The

wizard can be accessed at anytime
y
via the web interface and is the
same for all supported OS!

Click next

Schneider Electric - IT Business- SmartWare Tiger Team Leader

26

Click next

Enter the User Name and Password along

g with the Authentication Phrase
The User Name and Authentication Phrase must match the one entered on the NMC
Schneider Electric - IT Business- SmartWare Tiger Team Leader

27

If the server
has multiple
NICs you must
chose the IP
Address that
will be
registered with
the NMC

Schneider Electric - IT Business- SmartWare Tiger Team Leader

28

After choosing
the IP Address
that will be
registered with
the NMC click
next

Schneider Electric - IT Business- SmartWare Tiger Team Leader

29

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

click next.
Schneider Electric - IT Business- SmartWare Tiger Team Leader

30

Single-UPS Configuration

In a Single
Single-UPS
UPS configuration
configuration, each
h computer
t server or group off servers is
i
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
Sil
Silcon
DP3500E and
d Silcon.
Sil

Schneider Electric - IT Business- SmartWare Tiger Team Leader

31

Single-UPS Configuration

Schneider Electric - IT Business- SmartWare Tiger Team Leader

32

Redundant Configuration
In a Redundant-UPS Configuration, PowerChute Network Shutdown
recognizes a group of either two or three UPSs as a single UPS. In this
configuration, one PowerChute Network Shutdown Agent on a server
communicates with two or three NMCs (depending on the number of UPSs in
the configuration). Typically, the servers have multiple (dual or triple) power
cords. Each UPS has its own NMC, which has a unique IP address. In
addition all the NMCs use the same HTTP port and the same administrator
addition,
user name, password, and authentication phrase.
Each UPS has the capacity to supply power to the load on its own. The first
UPS provides
id allll the
h power ffor the
h lload,
d the
h additional
ddi i
l UPS(
UPS(s)) act as reserve.
When the first UPS in unable to supply power, the server switches over to take
power from the next UPS. As a result, if one of the UPSs goes down, for
whatever reason, the other UPS(s) can continue to supply power to the load
and therefore provide redundancy between UPSs. PowerChute Network
Shutdown recognizes that the UPSs are set-up in a Redundant-UPS
configuration and listens to all the UPS NMCs for a shutdown command.

Schneider Electric - IT Business- SmartWare Tiger Team Leader

33

Redundant Configuration

See the updated Applications Note #98 for more information

Schneider Electric - IT Business- SmartWare Tiger Team Leader

34

Redundant Configuration

Schneider Electric - IT Business- SmartWare Tiger Team Leader

35

Parallel Configurations
In a Parallel-UPS
Parallel UPS Configuration, two or more UPSs
UPS s (up to nine depending
on the model) support the load. Each UPS does not need to be capable of
supporting the load on its own as the combined output of all UPSs in the
configuration share the load. However, depending on the size of the load there
may be
b reserve UPS(
UPS(s)) available.
il bl R
Redundancy
d d
iis provided
id d if th
there iis att lleastt
one more UPS than is required to support the load.

See the updated Applications Note #169 for more information

Schneider Electric - IT Business- SmartWare Tiger Team Leader

36

Parallel Configurations

Schneider Electric - IT Business- SmartWare Tiger Team Leader

37

Parallel Configurations

Schneider Electric - IT Business- SmartWare Tiger Team Leader

38

Enter protocol, NMC

communication
port and NMC ip
port,
address then click
next

Schneider Electric - IT Business- SmartWare Tiger Team Leader

39

Select whether to
check for updates,
whether to
shutdown
the UPS then click
next

Schneider Electric - IT Business- SmartWare Tiger Team Leader

40

Click apply after

verifying the
information is
correct.
correct

Schneider Electric - IT Business- SmartWare Tiger Team Leader

41

PCNS will register with the NMC

Schneider Electric - IT Business- SmartWare Tiger Team Leader

42

If the UPS has the

proper firmware
and supports
pp
outlet groups you
can select the
outlet group the
server is plugged
into.

Schneider Electric - IT Business- SmartWare Tiger Team Leader

43

For this example we

selected outlet
group 1 then
clicked apply.

Schneider Electric - IT Business- SmartWare Tiger Team Leader

44

Once registered
Click next

Schneider Electric - IT Business- SmartWare Tiger Team Leader

45

Click Finish

Schneider Electric - IT Business- SmartWare Tiger Team Leader

46

PowerChute Network
Shutdown web interface

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

Schneider Electric - IT Business- SmartWare Tiger Team Leader

48

This is the configure events page for all PCNS clients

To see a full list of configurable and non-configurable event view PCNS help
Schneider Electric - IT Business- SmartWare Tiger Team Leader

49

If the UPS has the

proper firmware
and supports
outlet groups you
can select the
outlet group
g
p
shutdown
behavior.

This is the configure shutdown page for all PCNS clients

Schneider Electric - IT Business- SmartWare Tiger Team Leader

50

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
Schneider Electric - IT Business- SmartWare Tiger Team Leader

51

This is the check for Updates page for all PCNS clients
Schneider Electric - IT Business- SmartWare Tiger Team Leader

52

How to add host servers to the

server list

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 listservers
If the server is not in the list add the server to the list by running the command
sudo vifp addserver 10.218.45.20
Verif the ser
Verify
server
er has been added
vifp listservers
NOTE: The address of the host running the vMA should always be last in the list.
Schneider Electric - IT Business- SmartWare Tiger Team Leader

54

Next you need to add the server to the fasspass list the command is vifptarget s <server name or
ipaddress> NOTE: there is a known issue with this command on vMA 5.1.x
To verify there is communications between the client and the host run the command Vicfg
Vicfg-nics
nics ll (lower
case letter l) should display a list of the host NICs.
Schneider Electric - IT Business- SmartWare Tiger Team Leader

55

Install PCNS 3.0.1 onto vMA

5.0 from CD

If loading PCNS from CD

y that the CD drive is
verify
connected on the client and
the CD is loaded into the host
system CD drive. If installer
was downloaded from
APC.com go to page 11
Schneider Electric - IT Business- SmartWare Tiger Team Leader

57

Note to make any changes to

profile the vMA
the hardware p
will need to be powered down

Schneider Electric - IT Business- SmartWare Tiger Team Leader

58

Click on the console tab to log

into the vMA then press the enter
key to go to the log in screen.

Schneider Electric - IT Business- SmartWare Tiger Team Leader

59

O ce logged
Once
ogged in if one
o e has
as not
ot
been created, create a mount
point for the CD.
sudo mkdir /mnt/cdrom

Schneider Electric - IT Business- SmartWare Tiger Team Leader

60

Change the permissions on the new mount

p
point
sudo chmod 666 /mnt/cdrom

Schneider Electric - IT Business- SmartWare Tiger Team Leader

61

Mount the APC CD and change directory to view

the files in the ESXi directory.

Commands
sudo mount t iso9660 /dev/cdrom /mnt/cdrom
cd /mnt/cdrom/
ls to list the contents of the CD
Schneider Electric - IT Business- SmartWare Tiger Team Leader

62

For this example the CD contains a parent directory of PCNS 3

3.0.1
01
and child directory of ESXi
Change directory to ESXi and copy the contents to /opt/temp
Change directory to /opt/temp
Continue with instruction on page 13
Schneider Electric - IT Business- SmartWare Tiger Team Leader

63

Thank You