User Tools

Site Tools


apcupsd

This is an old revision of the document!


APCUPSD

The HPC's head node is connected to an APC battery backup unit which has a USB cable that can be used for monitoring power status. The APC UPS Daemon is configured on the server to monitor for power interuptions and notify the computer of the status. If power is off too long it can instruct the computer to shut down.

We have seen problems with the USB cable not being detected, but switching ports fixed the problem. If you see the apcupsd service failing to start, check the log file to see if something is wrong:

/var/log/messages:

Aug 17 15:08:36 hpc-ilri apcupsd: apcupsd startup succeeded
Aug 17 15:08:46 hpc-ilri apcupsd[3224]: apcupsd FATAL ERROR in linux-usb.c at line 649 Cannot find UPS device -- For a link to detailed USB trouble shooting information, please see <http://www.apcupsd.com/support.html>. 
Aug 17 15:08:46 hpc-ilri apcupsd[3224]: apcupsd error shutdown completed

Configuration

Daemon

After the software is installed, there are two files which need attention:

/etc/apcupsd/hosts.conf

Make sure to list the the localhost and give it a name. This is used for remote monitoring and also for checking the status via the multimon CGI script: http://hpc.ilri.cgiar.org/cgi-bin/multimon.cgi

# Network UPS Tools - hosts.conf
#
# This file does double duty - it lists the systems that multimon will
# monitor, and also specifies the systems that upsstats is allowed to 
# watch.  It keeps people from feeding random addresses to upsstats,
# among other things.  upsimage also uses this file to know who it 
# may speak to. upsfstats too.
#
# Usage: list systems running upsd that you want to monitor
#
# MONITOR <address> "<host description>"
#
# Please note, MONITOR must start in column 1 (no spaces permitted)
#
# Example: 
# MONITOR 10.64.1.1 "Finance department"
# MONITOR 10.78.1.1 "Sierra High School data room #1"
#
MONITOR 127.0.0.1 "ILRI-HPC"

/etc/apcupsd/apcupsd.conf

The defaults are ok, but make sure the daemon is configured to use UPSTYPE usb, and leave the DEVICE blank for auto detection.

UPSTYPE usb
DEVICE

Web monitoring interface

The apcupsd package comes with a web-based frontend to the daemon which monitors battery status and generates graphs. The files need to be placed in the filesystem where Apache has been configured to allow scripts to run. This is usually a cgi-bin folder. Copy the contents of /etc/apcupsd/cgi/ to /var/www/cgi-bin/ and then you can try to check the status by visiting http://hpc.ilri.cgiar.org/cgi-bin/multimon.cgi

apcupsd.1250754444.txt.gz · Last modified: 2010/05/22 14:19 (external edit)