APC UPS Setup

How to set up UPS monitoring via USB, for APC UPS models.

Plug in the USB cable (dur)

Edit the UPS service in TrueNas:

2.1: Choose USB driver with closest match to APC UPS model, and choose correct USB device (usually something like /dev/ugenX.X) and set UPS name to simply ups

2.2: DO NOT check Remote Monitor

2.3: Add Monitor user and password, copy same info into the extra users section in this format (note brackets!):

[{username}]
	password = {password}
	actions = set
	actions = fsd
	instcmds = all

2.4: Set shutdown to "UPS Reaches Low Battery", set command to: shutdown -p +1 "System is shutting down due to low UPS battery!"

2.5: DO NOT set up email alerts! (otherwise you get two sets for each event due to system alerting!)

2.6: Add MAXAGE 25 to the "Auxilary Parameters (upsd.conf)" box (prevents occasional 'connection to UPS lost' errors)

Enable the service!

Check box to auto-start service.

Checking UPS status and changing parameters remotely:

Check status of UPS (get all stats):

upsc ups@localhost

List commands that can be run from the terminal for a particular UPS:

upscmd -u [username] -p [password] -l ups@localhost

Run a command on a UPS:

upscmd -u [username] -p [password] ups@localhost command.name.here

Typical commands:

test.start.battery.quick test.start.battery.deep test.start.battery.stop beeper.disable beeper.enable