Difference between revisions of "Setting up a NUT Server"

From Da Nerd Mage Wiki
Jump to navigation Jump to search
Line 53: Line 53:


See [https://networkupstools.org/docs/man/upsmon.conf.html the upsmon.conf documentation] for more details.
See [https://networkupstools.org/docs/man/upsmon.conf.html the upsmon.conf documentation] for more details.
= Managing NUT =
The usual:
* <code>sudo service nut-server ['''start'''{{!}}'''stop'''{{!}}'''restart'''{{!}}'''status''']</code>
Client commands:
* <code>upsc '''cyberpower'''</code>
** [https://networkupstools.org/docs/man/upsc.html man page]
* <code>upscmd -l '''cyberpower'''</code>
** [https://networkupstools.org/docs/man/upscmd.html man page]
* <code>upsrw '''cyberpower'''</code>
** [https://networkupstools.org/docs/man/upsrw.html man page]
* <code>nut-scanner</code>
** [https://networkupstools.org/docs/man/upsrw.html man page]


= further Usage Concepts =
= further Usage Concepts =

Revision as of 22:41, 9 April 2022

Select your mode

  • sudo vi /etc/nut/nut.conf

(In my case, I've installed NUT on a VM and it'll be managing the UPS for the whole server...)

MODE=netserver

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.

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...