UPSMON PRO for Linux

Users' Guide

===============================================================

This application aims to monitor the UPS via RS232, USB, or SNMP agent. Basically it executes the script to shutdown the Linux when the power failure occurs. And it further displays the condition of the UPS, records UPS events, sends out the e-mail notification, and commits Battery test ...etc.

1. UPSMON-PRO Installation¡G
i. Log in as the super-user ( root )
ii. Place the CD into the CD-ROM or DVD-ROM
iii. Copy and Untar the package "UPSMON_PRO_for_Linux.tar" into the directory "/ home / user " or elsewhere
ex : > cp¡@UPSMON_PRO_for_Linux.tar ¡@/ home / user
ex : > tar¡@-xvf ¡@UPSMON_PRO_for_Linux.tar
ex : > cd ¡@UPSMON_PRO_for_Linux

2. Start UPSMON-PRO

¡@i. Execute the command
ex¡G¡Ö./upsmon
ii. Answer below initial questions
¡@¡@a. What is the UPS connection : ¡@¡@¡@¡@¡@1. RS232¡@¡@2. USB¡@¡@3 . SNMP-Card ¡@¡@4. UPSMON-PRO
¡@¡@1¡GFill in the path and name of the serial port (b) if your connection is RS232
¡@¡@ ¡@ The name and path of the serial port¡@¡@¡@(ex : / dev / ttyS0 )
¡@¡@
¡@¡@3¡GFill in that SNMPCard's IP address (c) if your connection is SNMP-Card
¡@¡@ ¡@ The IP address of this SNMPCard ¡@¡@¡@ (ex : 192.168.1.254)
¡@¡@4¡GFill in that SNMPCard's IP address (c) if your connection is UPSMON-PRO
¡@¡@ ¡@ The IP address of UPSMON-PRO¡@¡@¡@¡@(ex : 10.192.136.231)
¡@¡@
¡@¡@b. Seconds of OS shutdown delay ¡@ ¡@¡@¡@(ex : 120 )
¡@¡@c. Minutes of UPS shutdown delay ¡@ ¡@¡@¡@(ex : 3)
¡@¡@d. Would you need to reset ¡@ ¡@ ¡@ ¡@ ¡@¡@ (N or y )

ii. If you get below message, it means the connection have established
==> UPSMON : UPSMON Start
==> UPSMON : Start Monitor

iii. To have a daemon start every time Linux reboot, you must add below script into the Linux beginning procedures. This script is typically located in the /etc/rc.d/rc or /etc/rc.d/rc.local or /etc/init.d/rc.local. However the name and location vary by the distributions.
ex : ¡Ö/ usr / UPSMON_PRO_for_Linux / service
iv. If you want to stop the background service, you can follow below ways :
ex : ¡Öps -aux | grep "Connect"
ex : ¡Ökill ¡@PID ¡@number

3. Display and Definintion¡G

To view real time UPS status and information, execute the following command :
ex : > ./display

Indicator | Definition
| Power Source : Utility Normal Power and battery is charging
| Power Source : Utility Power Failed and battery is discharging
| Battery Capacity : 100% full and healthy
| Battery Capacity : 75% full
| Battery Capacity : 50% remains
| Battery Capacity : 25 % battery capacity and it's almost exhausted
| Load Level : Balance load
| Load Level : Half percent load
| Load Level: Full load
Electrical Power supplied | AC Utility Power / Battery Power
Voltage Supplied (V) | Output voltage from UPS outlets
UPS State | ON-Line / Bypass / Normal / Boost / Buck
Battery Capacity | The percentage of batteries remaining capacity
Battery Status | Normal / Testing / Failed
UPS Load | The percentage of UPS load
Est. Backup Time (Min) | The estimated battery supplies time (minutes)

4. Shutdown Regulation

¡@Once the power failure occurs, it helps you to gracefully shutdown the Linux and UPS :

¡@ i. Click button : Backup Time
¡@
¡@ ii. (a) There are 3 options for this reaction
¡@¡@¡@2. 1 Hibernate : power-saving state and puts your open documents and programs on your hard disk
¡@¡@¡@2. 2 Shut Down : completely running out of the procedures to save the programs to the hard disk
¡@¡@¡@2. 3 None : no any reaction for the Linux
¡@ iii. (b) "Power Failure Windows Shutdown Delay" : after this period of time, it starts to execute the shutdown shell "DOWN" - (1)
¡@ iv. (c) "Low battery shutdown" : if the status of the battery is declining to low level,it immediately commits shutdown - (1)
¡@ v. (d) "Execute Command File" : it acts your designate command whenever blackout occurs - (1)
¡@¡@¡@¡@¡@Kindly edit with your shell scripts within the file "EXT / Execute / User-Cmd"
¡@ vi. (e) "UPS shutdown Delay" : this duration is affording the power to completely shutdown the PC - (2)

¡@¡@¡@---------------------------------------------------------------------------------------------------------------------------------------------------------------
¡@¡@¡@NOTE : The total time span between Power Failure, PC Shutdown, and UPS OFF depends on UPS load, battery capacity, ...etc
¡@¡@¡@---------------------------------------------------------------------------------------------------------------------------------------------------------------

¡@¡@

5. E-Mail Notification

¡@i. Click button¡GNotification
ii. Enable
iii. Enter your SMTP server's essential fields (eg : SMTP Server, User Name, Port, Authentication, Sender's mail, Receiver's mail)
iv. Save
-----------------------------------------------------------------------------------------------------------------------
NOTE : This feature requires your e-mail account support simple mail transfer protocol (SMTP)
-----------------------------------------------------------------------------------------------------------------------

6. UPS Historical Event

It records and shows you all the UPS events which took place

7. UPS Data Log

It records and shows you the data of the UPS

8. UPS Control

¡@Battery Test / Deep Battery Test / Green Mode / Sound / Outlet Control / Reboot UPS

1. Battery Test / Deep Battery Test : the UPS output will change to exhaust the battery power for a brief period

2. Sound

- ¡@Click the button : Enable Power Failure UPS Sound Control
- ¡@Sound ON : it beeps when power failure occurs
- ¡@Sound OFF : it keeps silence even power failure occurs

3. Green Mode

- ¡@Green Mode ON : Once the blackout occurs and load is low, the UPS automatically turn its off in a specific time
- ¡@Green Mode OFF : UPS will sustain the power to its limit

4. Outlets Control

- ¡@Outlet Group1 ON / OFF : After your executation, it will turn ON/OFF the outlet group1
  ¡@(Be sure the Linux power is not sourced from outlet group1)
- ¡@Outlet Group2 ON / OFF : After your executation, it will turn ON/OFF the outlet group2
  ¡@(Be sure the Linux power is not sourced from outlet group¢±)

5. Reboot UPS after XX minutes : UPS output power would turn its off after specific time
   ---------------------------------------------------------------------
   NOTE : Control functions are varied by the UPS model
   ---------------------------------------------------------------------
   ¡@

9. UPS Web Connect

¡@Remotely monitoring the UPS condition

¡@i. Click button¡GWEB Connect
¡@ii. Enable
¡@iii. Enter your User Name / Password / Port number
¡@iv. Save

¡@

¡@Example : Google Chrome

¡@

¡@
------------------------------------------------------------------------------
NOTE : This feature requires your Linux have a connectable IP
------------------------------------------------------------------------------

10. Multi-OS Connect¡G
The UPSMON can play the role as Master or Slave

1. UPSMON-PRO Master

- ¡@The PC who physically connects to UPS via RS232/USB plays the role as Master
- ¡@Master can share the UPS status to the other Slaves
- ¡@Ex : 10.192.136.231 (Master's PC IP address)

2. UPSMON-PRO Slave

- ¡@By ways of the Internet / Intranet and UPSMON-PRO Master
- ¡@All the other PC get the connection from UPSMON-PRO Master
- ¡@And the UPSMON-PRO Slaves can do any behavior like Master (Ex : Shutodwn Slave-PC)
- ¡@Choose UPSMON-PRO with Master IP address

¡@

¡@And then you would get the status of UPS

¡@

3. UPSMON-PRO-for-Linux Slave

- ¡@By ways of the Internet / Intranet and UPSMON-PRO Master
- ¡@All the other PC get the connection from UPSMON-PRO Master
- ¡@Execute the UPSMON-PRO-for-Linux application : ./upsmon
- ¡@Choose UPSMON-PRO with Master IP address
- ¡@UPSMON : Start Monitor ==> It means the connetion is successful

¡@

- ¡@You can check the UPS status with X-Windows by executing display application : ./display

¡@

4. Schedule : UPSMON-PRO-for-Linux Slave

- ¡@UPSMON-PRO-for-Linux will help you to shutdown itself on time if UPSMON-PRO Master sets up the schedule

11. Customizing Linux Shutdown¡G

After AC Fail Timer (Seconds of OS shutdown delay value) expiration, there are 2 choices¡G
i. Shutdown : It will run the specific shell script "DOWN", which is located in the installation folder and under the directory "/EXT/Execute/". Certainly you can edit this shutdown script by your commands and parameters.
ex : > chmod¡@+x¡@DOWN
ii. Hibernate : It aims to reserve the status of the Linux and suspend to disk. When the power is restored, it would recover the status of your Linux. The daemon will run the specific DOWN2 shell script, which is located in the installation folder and under the driectory "/EXT/Execute/". Before using this function, please be sure that your Linux support the function "Hibernate" ( Linux contain these 2 files "disk" and "state" and both are in the directory "/sys/power/" ).
ex : > chmod¡@+x¡@DOWN2 ¡@
-------------------------------------------------------------------------------------------------------------
NOTE : Please be sure that your Linux is fully Hibernate support before you select this
-------------------------------------------------------------------------------------------------------------

12. Setting the PC BIOS to enable UPS startups :

Your PC BIOS needs to be set up to a Power-On-state to support the UPSMON-UPS to start PC up automatically. Basically, you need to enter the PC BIOS Setup screen and then select the Power On setting to be the default.

To change your BIOS setting :

i. Restart your PC

ii. When the PC brand logo screen appears, press the correct key on your keyboard to open the BIOS setup window. For general PCs, press the delete key

iii. Use your arrow keys on the keyboard to select the correct power option

iv. Select the correct setting to enable PC power always on. For general PCs, use arrow key to enable "Restore on AC Power Loss"

v. Save your changes

---------------------------------------------------------------------------------------------------

Note : Each PC varies in how to enter and make changes to the BIOS settings

---------------------------------------------------------------------------------------------------

Touble Shooting¡GUSB connection error with Linux 64 bit
==> sudo apt-get install lib32bz2-1.0 (Debian)
==> sudo apt-get install lib32z1 (Ubuntu / Mint)
==> yum install glibc.i686 (Fedora)