FaJo.de

This module monitors APC^® UPS devices and will shutdown the system on specific thresholds if configured to do so and if supported by the UPS. In contrast to the Thecus integrated UPS solution (based on Network UPS Tools (NUT)) this module supports APC^® devices connected through the USB port. Further, if the UPS is not directly connected to this system the module can be used in client mode. In client mode a apcupsd server will be queried for UPS status information. If the UPS is connected directly this system can act as server for other apcupsd clients.

Supported Models

This module should work for the following models:

Installation

Extract the module binary package (.mod) from the archive and install it. If you have an older version of the module installed, uninstall the old version before you install the new one.

Note: Up to version 1.03.00 the module configuration was not backed up when the module was uninstalled. If you upgrade from a version prior to 1.04.00 please write your current configuation down before uninstalling the old version of the module.

Configuration

After enabling the module the module configuration page can be accessed. All configuration parameters are explained when selected.

When using a serial cable make sure that:

Note: When enabled for the first time, the UPS daemon will be started with the USB driver and cable selected and all shutdown thresholds disabled.

apctest Command line utility

The module distribution contains a command line utility called apctest which can be used to display/change certain UPS EEPROM parameters such as battery date or UPS name. To use this utility the apcupsd daemon must not be running - it can be stopped through the WebUI or by issuing:

/raid/data/module/APCUPSD/system/etc/rc.d/apcupsd stop

on the command line ( SSHD / SYSUSER modules required).

You can start the apctest command by issuing:

/raid/data/module/APCUPSD/system/sbin/apctest

on the command line.

Restriction: The apctest utility will not work on DUMP UPS models. Not all UPS models will allow changes of all supported parameters. This is a restriction of the UPS rather than one of the apctest utility.

Confirmed Configurations

This module should work for almost all APC^® UPS devices. The following APC^® UPS devices have been tested and confirmed to work with this module. Please drop me a note with the information required to update this table if you use a different configuration.

Feature Requests

• SNMP monitoring (related to NETSNMPD)
• make notifications configurable (enable/disable)

Further Reading

• APCUPSD / Changelog
• Official apcupsd website (link)