Differences

This shows you the differences between two versions of the page.

--- apcupsd [2009/08/18 09:19] – alan
+++ apcupsd [2011/09/02 12:42] (current) – aorth
@@ Line 1: / Line 1: @@
 ===== APCUPSD =====
-The [[http://www.apcupsd.org|APC UPS Daemon]] used to work, but now the daemon refuses to start.  Attempts to start fail, and this is printed in the system log:
+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 [[http://www.apcupsd.org|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.
-<file>Aug 17 15:08:36 hpc-ilri apcupsd: apcupsd startup succeeded
+===== Installation (RPM) =====
-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>.
+Download pre-compiled RPMs for Enterprise Linux 5 from the EPEL project: http://download.fedora.redhat.com/pub/epel/5/x86_64/repoview/apcupsd.html
-Aug 17 15:08:46 hpc-ilri apcupsd[3224]: apcupsd error shutdown completed</file>
-I haven't been to the server room yet to check out the problem.
+===== Installation (manual) =====
+Download source from: http://www.apcupsd.com/
-==== Configuration ====
+<code>tar zxf apcupsd-3.14.7.tar.gz
+cd apcupsd-3.14.7
+./configure --enable-usb --enable-cgi
+make
+sudo make install</code>
-After the daemon is installed, there are two files which need attention:
+===== Configuration ======
-=== /etc/apcupsd/hosts.conf ===
+==== Daemon ====
-<file>[alan@hpc-ilri: /etc/apcupsd]$ cat hosts.conf
+After the software is installed, there are two files which need attention:
-# Network UPS Tools - hosts.conf
+==== /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:
+<file># Network UPS Tools - hosts.conf
 #
 # This file does double duty - it lists the systems that multimon will
@@ Line 36: / Line 43: @@
 MONITOR 127.0.0.1 "ILRI-HPC"</file>
-=== /etc/apcupsd/apcupsd.conf ===
+==== /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.
+The defaults are ok, but make sure the daemon is configured to use the following settings (leave ''DEVICE'' blank for auto detection):
-<file>UPSTYPE usb
+<file>UPSCABLE usb
+UPSTYPE usb
 DEVICE</file>
+==== Web monitoring interface (optional) ====
+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.
+Copy the CGI scripts:
+<code>$ cd /etc/apcupsd
+$ sudo cp multimon.cgi upsimage.cgi upsstats.cgi /var/www/cgi-bin/</code>
+Check the status by visiting http://hpc.ilri.cgiar.org/cgi-bin/multimon.cgi
+===== Startup =====
+Add the daemon to the default runlevels:
+<code>sudo chkconfig --level 2345 apcupsd on</code>
+===== Testing =====
+Make sure the daemon is stopped, then run:
+===== Troubleshooting =====
+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**:
+<file>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</file>