POWERCOM UPSMON PRO V1.4 UPS Monitoring Software User Manual

POWERCOM UPSMON PRO V1.4 UPS Monitoring Software

Product Information

The UPSMON PRO V1.4 is a UPS monitoring software designed to monitor, configure, and control your uninterruptible power supply (UPS).
It provides real-time information about the UPS status, battery health, events, and more. With UPSMON PRO, you can ensure the proper functioning of your UPS system and receive email notifications for UPS events.

Key Features:

• UPS monitoring, configuration, and control
• Real-time UPS status updates
• Battery health testing
• Email notifications for UPS events
• UPS data logging
• UPS event listing
• UPS alarm for warning conditions

Product Usage Instructions

AA. UPSMON PRO Install

1. Copy the UPSMON_PRO_Linux.tar file to /home/user directory using the command: cp UPSMON_PRO_Linux.tar/home/user
2. Extract the contents of the UPSMON_PRO_Linux.tar file using the command: tar -xvf UPSMON_PRO_Linux.tar
3. Navigate to the extracted UPSMON_PRO_Linux directory using the command: cd UPSMON_PRO_Linux

BB. UPSMON PRO Start

To start the UPS monitoring service:

1. Run the command: upsmon-pro-start
2. Provide the required information when prompted
3. The UPSMON program will start monitoring the UPS and establish a connection

CC. UPSMON PRO Status

To check the UPS status:

1. Run the command: upsmon-pro-status
2. The UPS status will be displayed

DD. UPSMON PRO Config

To configure email notifications for UPS events:

1. Run the command: upsmon-pro-mail
2. Follow the instructions to set up email notification

EE. UPSMON PRO Set

To perform battery health tests:

1. Run the command: upsmon-pro-test to check the battery health
2. Run the command: upsmon-pro-test-deep to simulate battery capability
3. Run the command: upsmon-pro-test-cancel to stop the deep battery power test

FF. Other Commands

There are additional commands available for controlling and managing UPSMON PRO:

• upsmon-pro-stop: Stops the UPS monitoring service
• upsmon-pro-service: Starts the UPS monitoring service directly without any information query
• upsmon-pro-restart: Restarts the UPS monitoring service
• upsmon-pro-start-config: Resets UPS connection and shutdown condition
• upsmon-pro-info: Displays UPS service, devices information, and configuration
• upsmon-pro-log: Lists the UPS data log
• upsmon-pro-log-erase: Erases the UPS data log
• upsmon-pro-event: Lists the UPS event log
• upsmon-pro-log-erase: Erases the UPS event log
• upsmon-pro-beeper-on: Enables UPS alarm for warning conditions
• upsmon-pro-beeper-off: Disables UPS alarm for warning conditions

Note: Make sure to execute certain commands without the UPSMON PRO service running to avoid data conflict.

UPSMON PRO Install

• Command : cp UPSMON_PRO_Linux.tar /home/user
• Command : tar -xvf UPSMON_PRO_Linux.tar
• Command : cd UPSMON_PRO_Linux
• These command will copy and uncompressed this ups monitoring software
• And the package contains executable files about ups monitoring, configuration, and control

UPSMON PRO Start

• Command : upsmon-pro-start
• It will ask you the basic information and then auto start ups monitoring service
• a. UPS Connection : 1.RS232 2.USB 3.SNMP-Card 4.UPSMON-PRO
• b. Linux shutdown delay seconds : When power failure occurs, Linux will act shutdown after this count down seconds
• c. Linux shutdown if battery capacity : Linux act shutdown at once if battery descend to this level
• d. Linux shutdown if battery backup minutes : Linux act shutdown at once if battery estimated backup time descend to this minutes
• e. Ups shutdown delay minutes : Once Linux commit shutdown, ups will sustain power for these minutes
• UPSMON : UPSMON Start
• It means the program successfully execute
• UPSMON : Start Monitor
• It means the program successfully get ups connection
• After you get the description “UPSMON:Start Monitor”, please command immediately with “upsmon-pro-status” to make sure the connection and ups condition is all right
• Command : upsmon-pro-stop
• It will stop ups monitoring service
• Command : upsmon-pro-service
• This command directly start ups monitoring without any information query (Add this within start daemon)
• Command : upsmon-pro-restart
• This command will restart the ups monitoring
• Command : upsmon-pro-start-config
• This command will reset ups connection and shutdown condition
• Polling Interval : The application query interval to ups (second)

UPSMON PRO Status

• Command : upsmon-pro-status
• It will repeatedly poll you current ups status until Ctrl-C pressing
• Power Status : Battery Power / Utility Power
• Input Voltage : To display utility power voltage
• Input Frequency : To display utility power frequency
• Output Voltage : To display ups output voltage
• Output Power : To display ups output power
• UPS Status : Normal / Bypass / AVR Boost / AVR Buck / UPS Failed
• UPS Load : To display total capacity of loads
• UPS Temperature : To display ups inside temperature
• UPS Beeper : ON / OFF
• Battery Status: Normal/ Charge/ Discharge / Battery Test / Low Battery / Battery Failed
• Battery Capacity : To display battery percentage level
• Battery Voltage : To display battery its voltage
• Battery Backup Time : To display battery estimated backup time in battery mode
• Battery Test Times : Accumulated times that ups made battery test
• Battery Last Test : The last time this ups made battery test
• Battery Test Result : Normal / Battery Failed / Low Battery
• Battery Power Times : Accumulated times that ups output power supply from batteries
• Battery Power Start : The last time ups switch power from its battery
• Battery Power End : The last time ups switch power to utility
• Battery Age : The age of ups batteries have used
• Ambient Temperature : The sense of environmental temperature
• Ambient Humidity : The sense of environmental humidity
• Upsmon Pro Linux : This ups monitoring software version
• Upsmon Pro Status : Monitoring / Disconnect
• Upsmon Pro Data Update : The data update time
• Upsmon Pro is going to shutdown after XXX seconds : Blackout and shutdown mode
• Command : upsmon-pro-info
• To display ups service / devices information / and configuration.
• Ups Company : The manufacture of the ups
• Ups Model : The ups model name
• Ups Firmware : The ups firmware version
• Rating Input Volt : Ratting Input Voltage
• Rating Output Volt : Ratting Output Voltage
• Upsmon Pro Connect : RS232 / USB / SNMP-Card / UPSMON-PRO
• Upsmon Pro RS232 Port Name and Path : Serial port path (ex : /dev/ttyS0)
• Upsmon Pro Master IP : The IP address of Upsmon Pro Master (RS232 or USB)
• Snmp Card IP : The IP address of snmp card
• Snmp Card firmware : The firmware version of snmp card
• Snmp Card Community : The community of snmp card
• Upsmon Pro Usb VID & PID : Usb vendor ID and Usb product ID
• Upsmon Pro Usb Type : Driver for usb/hid ups equipment
• Polling Interval : The query interval to ups
• Linux shutdown delay seconds : When power failure occurs, Linux will act shutdown after this count down seconds
• Linux shutdown if battery capacity : Linux act shutdown at once if battery descend to this level
• Linux shutdown if battery backup minutes : Linux act shutdown at once if ups estimated battery backup time descend to this minutes
• Ups shutdown delay minutes : Once Linux commit shutdown, ups will sustain power for these minutes
• Command : upsmon-pro-log
• To list the ups data log
• Command : upsmon-pro-log-erase
• To erase the ups data log
• To avoid data conflict, please execute this command without upsmon pro service running
• Command : upsmon-pro-event
• To list the ups event
• Command : upsmon-pro-log-erase
• To erase the ups event
• To avoid data conflict, please execute this command without upsmon pro service running

UPSMON PRO Config

• Command : upsmon-pro-mail
• This configuration will help you to get email notification once ups events occurs
• a. E-Mail Server Enable : Y / n
• b. E-Mail Server Name or IP : Email server address
• c. E-Mail Server Port : 25 (default)
• d. E-Mail Account : The account of this email server
• e. E-Mail Password : The password of this email account
• f. SSL Requires : This mail server requires an secure connection
• g. E-Mail Sender : The email address of this account
• h. E-Mail Recipient : The recipient who needs to get email notification
• Command : upsmon-pro-mail-test
• This command will send a test mail to make sure your configuration is success or not

UPSMON PRO Set

• Command : upsmon-pro-test
• To check the battery health, ups will supply the power shortly from its battery E.2 Command : upsmon-pro-test-deep
• To simulate battery capability, ups will supply battery power for its limits E.3 Command : upsmon-pro-test-cancel
• With this command, it will cease deep battery power test
• Command : upsmon-pro-beeper-on
• Ups alarm for ups warning condition
• Command : upsmon-pro-beeper-off
• Ups silence for ups warning condition
• Command : upsmon-pro-ups-reboot
• Description : Shutdown Linux and reboot ups after XX minutes
• a. Ups reboot after minutes
• b. Commit ups reboot
• Ups reboot its power after 1 minute (Y / n) :
• Command : upsmon-pro-outlet1-off
• It will turn ups outlet1 OFF at once
• Command : upsmon-pro-outlet1-on
• It will turn ups outlet1 ON at once
• Command : upsmon-pro-outlet2-off
• It will turn ups outlet2 OFF at once
• Command : upsmon-pro-outlet2-on
• It will turn ups outlet2 ON at once
• ups outlets control is specific for certain ups

UPSMON PRO Multi-Connect

• The UPSMON PRO can play the role as Master or Slave

UPSMON PRO Master

• UPSMON PRO Master : The Linux who physically connects UPS via RS232 or USB
• UPSMON PRO Master : It can share UPS status to the other UPSMON PRO Slaves
• EX : UPSMON PRO Master : 10.192.136.231 (IP Address)

UPSMON PRO Linux Slave

• UPSMON PRO Slave : The Linux who connect to UPSMON PRO Master via net
• UPSMON PRO Slave : Execute upsmon-pro-start with 4 upsmon-pro parameter

UPSMON PRO Windows Slave

• UPSMON PRO Slave : The Windows who connect to UPSMON PRO Master via net
• UPSMON PRO Slave : Connect : Choose UPSMON PRO

UPSMON PRO Auto Start

• Command : / path / UPSMON_PRO_Linux / upsmon-pro-service
• To have a daemon start every time Linux reboot, please add above script into beginning procedures. Typically this script locate in “/etc/rc.d/” or “/etc/rc.d/rc.local” or“/etc/init.d/rc.local”. However the name and path vary by the distribution

VMWare Support

Get ups monitoring on vm-linux

1. UPSMON PRO installed on vm-linux (Refer AA)
2. UPSMON PRO get ups monitoring via usb-port or com-port
3. UPSMON PRO now play the role as master

VMA Install (vSphere Management Assistent)

1. VMWare web site ==> https://www.vmware.com/support/developer/vima/
2. Download the VMA
3. Start the VMware vSphere Client
4. Select “File” > “Deploy OVF Template”. Click the browse button and select the OVF document.
5. Execute VMA and the default user name is vi-admin. Set the password before first login

UPSMON PRO Install and start monitoring on VMA

1. Command : cp UPSMON_PRO_Linux.tar /home/user
2. Command : tar -xvf UPSMON_PRO_Linux.tar
3. Command : cd UPSMON_PRO_Linux
4. Command : ./upsmon-pro-start
5. UPSMON-PRO : 4
6. UPSMON-PRO-Master IP Address
7. Count down seconds
8. Command : ./upsmon-pro-status

UPSMON PRO VMWare shutdown configuration

1. Command : upsmon-pro-vmware
2. Filled in your Vmware Esxi IP / root (administrator) / password

Configure startup/shutdown automatically with VMware ESXi

1. Vmware host >> Software >> Virtual Machine Startup / Shutdown >> Properties
2. This windows is allowed you to setup : shutdown type / shutdown delay / shutdown order / startup order

Ex : In above example : Win7Eng shutdown first / Win2016Eng shutdown last

Power failure and the vmware shutdown as sequence

Configuration to auto start up VMwareESXi

• Command : / path / UPSMON_PRO_Linux / upsmon-pro-service
• To have a daemon start every time vma reboot, please add above script into beginning procedures. Typically this script locate in “/etc/rc.d/rc3.d” and “/etc/rc.d/rc5.d/”. However the name and path vary by the distribution

Q and A

Supported Operating Systems

• CentOS
• Debian
• Fedora
• RedHat
• Suse
• OpenSuse
• Ubuntu
• Mint

Linux usb connect Fail :

• Command : sudo apt-get install lib32bz2-1.0 (Debian)
• Command : sudo apt-get install lib32z1 (Ubuntu / Mint)
• Command : yum install glibc.i686 (Fedora / CentOS)

Linux Display Fail :

• Command : sudo apt-get install default-jre
• Command : cd UPSMON_PRO_Linux / EXT
• Command : java Display

Stop the service with command

• Command : ps -aux | grep “noverify”
• Command : PID

Former ups and its usb connection :

• Command : cd Class/EXT
• Command : vi UPS_USB_2400.txt ./UPS_USB_1200.txt

References

• Home - VMware {code}

Read User Manual Online (PDF format)

Download This Manual (PDF format)

Download this manual  >>