APC Linux Monitor

[branx86]

https://srbu.se/articles/linux-et-al/configure-apcupsd-for-use-with-centos-6-and-apc-back-ups-es-700

Getting the source and installing (compiling) it
Go here; https://sourceforge.net/projects/apcupsd/?source=directory and download the latest version.

Go to your Downloads folder and untar the archive, then start compiling the source for your system.

cd ~/Downloads
tar -xvf apcupsd-3.14.14.tar.gz
cd apcupsd-3.14.14
./configure --enable-usb
If the above configure step fails, you may want to check that your system has the needed dev tools installed.

yum groupinstall "Development Tools"
When installed, rerun the configure.

./configure --enable-usb
make
make install


Configure the daemon
The config file is in /etc/apcupsd/apcupsd.conf. Edit it with eg nano.

nano /etc/apcupsd/apcupsd.conf
Change the following lines to your specification.

UPSNAME ups1
UPSCABLE usb
UPSTYPE usb
DEVICE <blank>
Please note, the DEVICE line must not be commented. It must be there but the device should be blanked.

The below lines can be left with their default settings, or changed to suit your situation.

ONBATTERYDELAY 6
BATTERYLEVEL 5
MINUTES 3
TIMEOUT 0
NETSERVER on
The NETSERVER must be on in order to check the UPS status with apcaccess. Check any of the sources below to find out what the settings do!

Testing the UPS
Stop the apcupsd(aemon) if started.

service apcupsd stop
apctest

Enable the daemon
chkconfig --list | grep apc
apcupsd 0:off 1:off 2:off 3:off 4:off 5:off 6:off
chkconfig apcupsd on
chkconfig --list | grep apc
apcupsd 0:off 1:off 2:on 3:on 4:on 5:on 6:off
 

Control apcupsd
service apcupsd start
service apcupsd stop
service apcupsd restart
apcaccess status


Enable CGI
Earlier we just used the --enable usb parameter to tell the installer we had a USB-type UPS. If we want to also enable CGI, we need to run the below.

It doesn't matter if you already have a working apcupsd install, you can run this without breaking anything.

./configure --enable-usb --enable-cgi --with-cgi-bin=/var/www/cgi-bin/apcupsd-cgi

What the above does is

Enable USB, because we have a USB-type UPS.
Enable the CGI bits.
Tells the installer where to save the cgi-scripts. The default is /etc/apcupsd, which may not be optimal.
 

If you get this error after running ./configure..., you need to install libgd.

configure:
error: Your system lacks the GD library which is needed for compiling the apcupsd CGI programs.
Please install libgd and re-run the ./configure script. Alternatively you can disable the CGI support.
 

For CentOS 6 it couldn't be found in the usual repos, but a Google search later revealed where to find it; https://centos.pkgs.org/6/centos-x86_64/gd-devel-2.0.35-11.el6.x86_64.rpm.html.

Therefore;

yum install http://mirror.centos.org/centos/6/os/x86_64/Packages/gd-devel-2.0.35-11.el6.x86_64.rpm
 

Install it and re-run the ./configure as above.

On a successful run, you should now see the below

Configuration complete: Run 'make' to build apcuspd.
 

Run make and make install as earlier.

When done, you should see new contents in /var/www/cgi-bin/apcupsd-cgi.

root@cyndane2:/var/www/cgi-bin/apcupsd-cgi # ll
total 384
drwxr-xr-x 2 root root 4096 Nov 30 15:53 .
drwxr-xr-x. 3 root root 4096 Nov 30 15:39 ..
-rwxr-xr-x 1 root root 99256 Nov 30 15:53 multimon.cgi
-rwxr-xr-x 1 root root 83746 Nov 30 15:53 upsfstats.cgi
-rwxr-xr-x 1 root root 96980 Nov 30 15:53 upsimage.cgi
-rwxr-xr-x 1 root root 94399 Nov 30 15:53 upsstats.cgi