Differences

This shows you the differences between two versions of the page.

--- software:nut:master [2025/04/14 18:14] – rodolico
+++ software:nut:master [2025/04/14 22:32] (current) – rodolico
@@ Line 9: / Line 9: @@
   * One opnSense firewall/router with the UPS module installed
   * One FreeBSD NAS
+**Note:** a Raspberry Pi works very well as a stand alone NUT server. See https://www.jeffgeerling.com/blog/2025/nut-on-my-pi-so-my-servers-dont-die for full instructions.
 ===== Set up UPS =====
@@ Line 97: / Line 99: @@
 CMDSCRIPT /bin/upssched-cmd
 </file>
+==== Test ====
+First, restart the service. On Devuan, it is called nut-server
+<code bash>
+service nut-server restart
+</code>
+Test to make sure you have a connection and the server is correctly reading the UPS. You do not have to put in the @localhost; that is the default.
+<code bash>
+# get list of all UPS' defined on localhost
+upsc -L localhost
+# get list of all values on one particular UPS (ups1)
+upsc ups1@localhost
+</code>
+==== NUT ups commands ====
+  * upsc - lightweight UPS client. Really, set up to be an example of what you can create, but very useful. <code bash>upsc -c upsname</code> will show the clients which are monitoring a particular ups.
+  * upscmd - send commands to UPS if it will accept. Try <code bash>upscmd -l <upsname></code>
+  * upsd - This is the primary daemon that should always run to provide information about one or more UPS'. Generally auto started by the init system
+  * upsdrvctl - standard interface to the UPS drivers. Not generally needed unless you are writing/debugging a particular driver.
+  * upslog - A tool designed to read one or more UPS' and log the readings. Very useful for upssched if you want a nice log of how your UPS is working.
+  * upsmon - A daemon which monitors all UPS' defined in upsmon.conf
+  * upsrw - allows you to change some variables //on the ups itself// if the ups allows it.
+  * upssched - scheduler to run commands listed in upssched.conf. This is called by upsmon and should not be used directly.
+  * upssched-cmd - A sample upssched file. A simple shell script that performs commands in response to upssched.
+===== Links =====
+  * https://www.jeffgeerling.com/blog/2025/nut-on-my-pi-so-my-servers-dont-die
+  * https://technotim.live/posts/NUT-server-guide/
+  * https://networkupstools.org/docs/man/snmp-ups.html
+  *