system/nut: Added (Network UPS Tools)

Signed-off-by: Robby Workman <rworkman@slackbuilds.org>

1 files changed, 43 insertions, 0 deletions

diff --git a/system/nut/README.SLACKWARE b/system/nut/README.SLACKWARE
new file mode 100644
index 0000000000..a73275956c
--- /dev/null
+++ b/system/nut/README.SLACKWARE
@@ -0,0 +1,43 @@
+README.SLACKWARE
+Written by V'yacheslav Stetskevych <slava18 dont_spam_me gmail com>
+
+In order to configure Network UPS tools on Slackware you need to rename
+or make copies of the sample config files in /etc/nut and edit them
+to suit your needs.  See documentation in /usr/doc/nut-* for reference.
+As you make your new config files, don't forget to secure them:
+	chown root:nut /etc/nut/*.conf /etc/nut/*.users
+	chmod 640 /etc/nut/*.conf /etc/nut/*.users
+
+If you are using a serial-connected UPS, be sure to add the nut user to
+the 'dialout' group:
+	usermod -a -G dialout nut
+
+A startup script /etc/rc.d/rc.ups is provided with this build.
+You can add these lines to /etc/rc.d/rc.local to launch it on system start:
+	if [ -x /etc/rc.d/rc.ups ]; then
+		/etc/rc.d/rc.ups start
+	fi
+
+If you have more than one box sitting on the same UPS, you should only use
+'start' on the one box that is connected to the device using a signal cable.
+On the other boxes, start rc.ups with the 'start_upsmon' parameter to only
+monitor the power status (client mode). Configure access permissions on the
+server box accordingly.
+
+If you wish for your UPS to turn off it's power during an extended power outage
+in order not to drain it's battery completely, you should make two simple edits
+to the Slackware shutdown script /etc/rc.d/rc.6 near the end of it.
+These are only needed on the server box, one that is connected to the UPS:
+1) Insert after the rootfs has been remounted read-only:
+	if [ -x /usr/libexec/nut/nut_restart_udev ]; then
+		. /usr/libexec/nut/nut_restart_udev
+	fi
+2) Insert after the genpowerd block and before the actual halt:
+	if [ -x /usr/libexec/nut/nut_kill_inverter ]; then
+		. /usr/libexec/nut/nut_kill_inverter
+	fi
+
+Don't forget to set your motherboard BIOS to automatically turn the machine on
+when the power comes back.
+
+Have fun!