APCUPSD

ScreenshotThis 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:

1U4200XXX, N2310, N2800, 1U4500, N4310, N4510U, 1U4600, N4510UPRO, M3800, N4800, N0503, N4800Eco, N2200XXX, N5550, N2520, N2560, N3200PRO, N6850, N3200XXX, N7510, N4100PRO, N7700PROv2, N4200, N8800PROv2, N4200Eco, N8900, N4200PRO, N8850, N4520, N8900V, N10850, N4560, N12000, N5200, N12000PRO, N5200PRO, N12000V, N5200XXX, N16000, N5500, N16000PRO, N7700, N16000V, N7700+, N7700PRO, N7700SAS, N8200XXX, N8800, N8800+, N8800PRO, N8800SAS

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:

  • the Thecus UPS feature is disabled
  • the SERGETTY module is not installed
  • no other application uses the serial port

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.

Type Model Firmware Driver/Type Cable
Back-UPS Pro280N/AAPC Smart940-0095B on /dev/ttyS0
Back-UPS Pro420N/AAPC Smart940-0095B on /dev/ttyS0
Back-UPS650N/ADUMB940-0020B
Back-UPSBR 800
Back-UPS700 ES829.D2 .I USB FW:D2USBUSB
Back-UPSES 725802.n5.D USB FW:n5USBUSB
Back-UPSCS 500808.q8.I USB FW:q8USBUSB
Back-UPSCS 650817.v4.I USB FW:v4USBUSB
Back-UPSCS 1500N/AUSBUSB
Back-UPSRS 8009.o5 .I USB FW:o5USBUSB
Back-UPSRS 10007.g3 .D USB FW:g3USBUSB
Back-UPSRS 10007.g9a.I USB FW:g9aUSBUSB
Back-UPSRS 15008.g7 .I USB FW:g7USBUSB
Smart-UPS750 XL630.3.D USB FW:1.5USBUSB
Smart-UPS100060.11.1APC Smart940-0024C on /dev/ttyS0
Smart-UPS1400N/ADUMB940-0020B on /dev/ttyS0
(through AP9607 Interface Expander)
Smart-UPSX 1500COM 03.0 / UPS 03.1USBUSB

 

Feature Requests

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

Further Reading

Attachments

AttachmentSize
[file] APCUPSD 1.07.00
MD5: 9274ed6db0a4461efb2c85ba5312ab06
1.55 MB
[file] APCUPSD 1.06.00
MD5: 0b3d68988440ef32eeca3e5c53968d18
710.26 KB