UPS Handling with NUT

Proven on:

11 (bullseye)

As always...
Start with:	sudo apt update sudo apt upgrade

Network UPS Tools

Install NUT

• sudo apt install nut

Configure NUT

Select your mode

MODE options:

none	Disable automatic startup of NUT
standalone	This MODE is for local only configuration
netserver	This MODE is open to the network. (A NUT server)
netclient	This MODE is for client machines that will access a NUT server

See the nut.conf documentation for more details.

• Setting up a NUT Server
• Setting up a NUT Client
• Using NUT to gracefully shut down ESXi

Select your hardware

• sudo vi /etc/nut/ups.conf

[cyberpower]
       driver = usbhid-ups
       port = auto
       desc = "A random surplus UPS"

(In my case, I'm setting up a CyberPower 1000AVR & connecting it by passing USB through to the VM...)

If your UPS isn't handled natively by the usbhid-ups driver, or you need to set options, start with the ups.conf documentation for more details.

Start & test

• sudo upsdrvctl start

You should see:

Network UPS Tools - UPS driver controller 2.7.4
Network UPS Tools - Generic HID driver 0.41 (2.7.4)
USB communication driver 0.33

Possibly followed by a bit of information about your UPS

Set up communications

(needed if you've set up as MODE = netserver...)

You can determine your servers IP address using:

• ip a
• sudo vi /etc/nut/upsd.conf

LISTEN 192.168.2.219
LISTEN 127.0.0.1 3493
LISTEN ::1 3493

Where 192.168.2.219 should be replaced with the actual IP of the machine.

See the upsd.conf documentation for more details.

Set up access

• sudo vi /etc/nut/upsd.users

[upsmon]
    password = supersecretpassword
    upsmon master

See the upsd.users documentation for more details.

• sudo vi /etc/nut/upsmon.conf

MONITOR cyberpower@192.168.2.219 1 monuser supersecretpassword master

See the upsmon.conf documentation for more details.

Managing NUT

The usual:

• sudo service nut-server [start|stop|restart|status]

Client commands:

• upsc cyberpower
  • man page
• upscmd -l cyberpower
  • man page
• upsrw cyberpower
  • man page
• nut-scanner
  • man page

further Usage Concepts

NUT gives lots of options.

Things like:

• Cleanly shutting down all of the VMs on a server & the server itself too.
• Sending notifications about power issues.
• Managing redundant UPSs on your system.
• etc...