PowerSoft for ESXi - installation and configuration
PowerSoft for ESXi - installation and
Release 2.3.5
September 10, 2015
Required software and components
VMA installation and configuration
ESXi configuration
PowerSoft installation on vMA
Connection of UPS to vMA
PowerSoft configuration
7.1 Remote configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
7.2 Editing a configuration file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1 Introduction
PowerSoft Professional can operate together with ESXi servers developed by VMware (version 5.x and 6.x) (commercial and noncommercial editions). Download and launch Virtual vMA (vSphere Management Assistant) on ESXi
server before PowerSoft is installed. vMA is a 64–bit operating system based on SUSE Linux Enterprise Server. vMA
system allows the user to install services and run scripts which manage ESXi servers.
2 Required software and components
Configuration settings of the virtual environment presented in this manual require the following components:
• VMware ESXi Server,
• vSphere Client,
• vSphere Management Assistant (vMA),
• PowerSoft Professional for ESXi
• WinSCP
3 VMA installation and configuration
System vSphere Management Assistant (vMA) is available in the website of the developer, at
http://www.vmware.com/support/developer/vima/. Downloaded file should be decompressed. In order to import downloaded vMA image into ESXi server, select option File->Deploy OVF Template and then show the path to
.ovf file, to the previously downloaded vMA.
Then, instructions of the import wizard should be followed. If the import is successful, vMA system is visible in the
window of vSphere client.
4 ESXi configuration
ESXi server should be configured so that order virtual machines shut down automatically when the server shuts down
and they turn on when the system server is launched. Safe shut-down of virtual systems (Guest Shutdown option)
requires installation of VMware Tools in each virtual system to be shut down. To install VMware Tools in the virtual
system, click PPM in vSphere client window on the virtual system and then select Guest->Install/Upgrade VMware
In the case of Linux OS, VMWare Tools CD with archive file tar.gz will be mounted. The archive file should be decompressed using the following command: tar zxf archive file_name.tar.gz. Next, launch installer by using ./vmware-toolsdistrib command. In Windows family, if the autostart option is turned on, the installer in the mounted disk will launch
automatically. In the opposite case, the location of the mounted disk should be entered and setup.exe or setup64.exe
launched (depending on the OS version). Status of the installation of VMware Tools can be verified in Summary tab
of the virtual machine.
In order to define parameters for automatic launching and shutting down of virtual system, Configuration tab of ESXi
server should be opened and Virtual Machine Startup/Shutdown option selected. Then, click Properties tab. In Virtual
Machine Startup and Shutdown window the following should be defined: sequence of the automatic start-up of virtual
systems, type of system shut down as Guest Shutdown) (safe shut-down) and delay time for system shut-down and
start-up. Entered settings should be confirmed by clicking OK button.
5 PowerSoft installation on vMA
By using WinSCP program, PowerSoft installer should be copied to vMA (e.g. to /home/vi-admin folder) and then
move to the location of the copied installer. Software can be installed by using the command line:
chmod +x nazwa_pliku_PowerSoft.bin
./nazwa_pliku_PowerSoft.bin lub sh nazwa_pliku_PowerSoft.bin
After the command is executed and language version selected, the license agreement should be accepted. The user
must have administer privileges (root) to install the software. Installed application is in /usr/share/powersoft folder.
To uninstall the application, the following command should be entered in /usr/share/powersoft folder:
6 Connection of UPS to vMA
To ensure communication between between the UPS and PowerSoft software, click PPM for vMA system and select
Edit Settings option. Clicking Add button in the option window adds an USB device. In this case it is ECO Pro CDS
UPS with USB communication port. USB Controller is necessary for adding USB devices to the system.
Warning: To ensure proper communication with Sinline RT and Sinline RT XL series UPS units, the USB xHCI
controller must be activated.
In case of Sinline RT and Sinline RT XL series UPS units, the USB xHCI controller must be present in the vMA
system to ensure proper communication through USB. To add an xHCI controller, click the Add key in the vMA
system options window and then select USB Controller from the list of available devices. Select xHCI as the type of
Warning: If a xHCI USB controller is unavailable for the vMA system, the system’s hardware version must be
updated. To do this, click PPM in the vMA system and select the Upgrade Virtual Hardware option. Once the
changes are confirmed, the controller will be available.
If UPS has an RS-232 port, Serial Port device should be added to the virtual system.
7 PowerSoft configuration
PowerSoft service launched in vMA can be configured in two ways:
1. remote service configuration,
2. direct edition of the configuration file.
Before configuring in /usr/share/powersoft folder, create a new file named hostlist containing the list of ESXi servers
which should be closed. In this case, there is one address: It is necessary to enter the name of the
user and the password in /usr/share/powersoft/shutdownHostViaSOAPAPICall.pl file, which was created by PowerSoft
# Please fill out the
# username and password
# for your ESX(i) host
my $host_username = 'user_ESXi';
my $host_password = 'plain_text_password';
Warning: Make sure that ports TCP 12321 and 12323 are open in vMA firewall. These ports are used by
7.1 Remote configuration
To configure the service remotely, install PowerSoft Professional in any computer with a graphical interface operating
system. The computer must have a network connection with the vMA system. Next, launch the control panel of
PowerSoft software and establish communication by the service launched in vMA system by using the “Connect with
the service” option. Write IP address of vMA machine where PowerSoft is installed.
In the next step, log on into in the application as the Administrator (“Administrator” is the default password) to unlock
the application configuration.
PowerSoft installed in vMA system in the default configuration has a predefined UPS model. This model should be
switch to a machine which is connected with vMA system via a communication interface (USB, RS-232 or SNMP). To
this end, right click the predefined UPS located in the liste of monitored devices and option “Edit” should be selected.
In the UPS edition window the correct model of connected device should be indicated and the relevant communication
interface should be configured.
Then, responses of PowerSoft to power supply events occurring in the mains are defined in the event configuration.
PowerSoft will be configured to launch the script closing ESXi if UPS switches to battery mode. To this end, the event
“Operation in the battery mode” should be marked in the event configuration window; then select “System command”
option and click “Configure” button.
Enter the relevant command in the command line window. Enter /usr/share/powersoft/shutdownHostViaSOAPAPICall.pl
in “Command” field and next /usr/share/powersoft/hostlist in “Options” field should be indicated. Confirm entered
parameters clicking “OK” button and save the event configuration.
Note: Additionally, there is a checkbox in the configuration window “Turn off UPS after the execution of the UPS”.
Checking this field causes switching to standby mode (for returning power supply from the mains) after execution of
the command. After restoring power the computer will start up again if a respective BIOS option is selected.
System command (script) can be delayed by entering the value in the field “Timeout for executing a command”.
Entering non-zero value in this field causes a delay of the execution of the script by a set number of seconds. The
application of the delay of the command causes starting a time counter which will be cleared if the power event event
to which this command is assigned will be deactivated or an opposite event occurs (e.g. battery operation switches to
the mains operation).
7.2 Editing a configuration file
Configuration of PowerSoft software is stored in the config.ini file. The configuration can be altered by editing config.ini file in any text editor. The Hosts file stores information with addresses of ESXi servers which will be stored by
name=Komputer z UPS
expressionIn=stateBatteryBackup, ON, "=="
expressionOut=stateNormal, ON, "=="
Event [event.0.0] has defined behavior of PowerSoft software if ECO Pro UPS switches to battery mode. In response
to the event, PowerSoft will run shutdown ESXiHost.pl script which shuts down ESXi server and all working virtual
Was this manual useful for you? yes no
Thank you for your participation!

* Your assessment is very important for improving the work of artificial intelligence, which forms the content of this project

Download PDF