Difference between revisions of "Setting up a NUT Server"

From Da Nerd Mage Wiki
Jump to navigation Jump to search
(Created page with "fffff")
 
Line 1: Line 1:
fffff
 
== Select your hardware ==
* <code>sudo vi /etc/nut/ups.conf</code>
 
[cyberpower]
        driver = usbhid-ups
        port = auto
        desc = "A random surplus UPS"
 
(In my case, I'm setting up a [https://www.cyberpowersystems.com/product/ups/intelligent-lcd/cp1000avrlcd/ 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 [https://networkupstools.org/docs/man/ups.conf.html the ups.conf documentation] for more details.
 
== Start & test ==
* <code>sudo upsdrvctl start</code>
 
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:
* <code>ip a</code>
* <code>sudo vi /etc/nut/upsd.conf</code>
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 [https://networkupstools.org/docs/man/upsd.conf.html the upsd.conf documentation] for more details.
 
== Set up access ==
* <code>sudo vi /etc/nut/upsd.users</code>
[upsmon]
    password = supersecretpassword
    upsmon master
 
See [https://networkupstools.org/docs/man/upsd.users.html the upsd.users documentation] for more details.
 
* <code>sudo vi /etc/nut/upsmon.conf</code>
MONITOR cyberpower@192.168.2.219 1 monuser supersecretpassword master
 
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 =
 
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...
 
[[Category:IT]]
[[Category:Hardware Management]]
[[Category:Linux]]
[[Category:WIP]]

Revision as of 21:52, 9 April 2022

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:

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