Differences
This shows you the differences between the selected revision and the current version of the page.
howto:nut_ups 2008/12/19 00:42 | howto:nut_ups 2023/09/07 21:19 current | ||
---|---|---|---|
Line 1: | Line 1: | ||
====== NUT (Network UPS Tool) ====== | ====== NUT (Network UPS Tool) ====== | ||
Instruction for installation of Network UPS Tools (NUT) on fun_plug v 0.5. These instructions are based on information found at the Network UPS Tool website ([[http://networkupstools.org/doc/2.2.0/INSTALL.html]]). | Instruction for installation of Network UPS Tools (NUT) on fun_plug v 0.5. These instructions are based on information found at the Network UPS Tool website ([[http://networkupstools.org/doc/2.2.0/INSTALL.html]]). | ||
+ | |||
+ | ====== Summary ====== | ||
+ | The primary goal of the Network UPS Tools (NUT) project is to provide reliable monitoring of UPS and PDU hardware and ensure safe shutdowns of the systems which are connected. | ||
+ | We attempt to monitor every kind of UPS and PDU, given sufficient interest. Summary from [[http://networkupstools.org|NUT project page]]. | ||
+ | |||
===== Getting Started ===== | ===== Getting Started ===== | ||
- | ==== What's Needed ==== | ||
- | A DNS323 with Fun_Plug 0.5 installed. | ||
- | A functional telnet connection. | ||
+ | ==== What's Needed ==== | ||
Successful installation of NUT requires three packages from fonz's website ([[http://www.inreto.de/dns323/fun-plug/0.5/packages/]]). They are; | Successful installation of NUT requires three packages from fonz's website ([[http://www.inreto.de/dns323/fun-plug/0.5/packages/]]). They are; | ||
* libusb-0.1.12-1.tgz; | * libusb-0.1.12-1.tgz; | ||
* neon-0.25.5-1.tgz and; | * neon-0.25.5-1.tgz and; | ||
* nut-2.2.2-3.tgz | * nut-2.2.2-3.tgz | ||
+ | |||
+ | |||
+ | === Assumptions === | ||
+ | DNS323 is operating with Firmware version 1.05 or 1.06 (Installation has not been tested with other firmware versions). | ||
+ | |||
+ | Fun_Plug 0.5 installed and operable. | ||
+ | |||
+ | A functional telnet connection. | ||
+ | |||
+ | |||
+ | |||
Line 76: | Line 90: | ||
cp /ffp/etc/examples/nut/ups.conf.sample /ffp/etc/ups.conf | cp /ffp/etc/examples/nut/ups.conf.sample /ffp/etc/ups.conf | ||
+ | |||
==== Add Driver Configuration Detail ==== | ==== Add Driver Configuration Detail ==== | ||
- | Prior to modifying the ups.conf file you'll need to determine which driver is used with your specific UPS. A UPS hardware compatibility list is located on the [[http://www.networkupstools.org/compat/stable.html|Network UPS Tools]] website. Review this list to determine which driver is required for your specific application. Please note these instructions pertain specifically to USB connected UPS. | + | Prior to modifying the ups.conf file you'll need to determine which driver is used with your specific UPS. A UPS hardware compatibility list is located on the [[https://networkupstools.org/stable-hcl.html]] website. Review this list to determine which driver is required for your specific application. Please note these instructions pertain specifically to USB connected UPS. |
Use your favourite editor (I use Notepad++) to open the ups.conf file, enter and subsequently save your specific settings. | Use your favourite editor (I use Notepad++) to open the ups.conf file, enter and subsequently save your specific settings. | ||
Line 149: | Line 164: | ||
The Network Server can be stopped by issuing an ''upsd -c stop'' command. | The Network Server can be stopped by issuing an ''upsd -c stop'' command. | ||
+ | |||
+ | |||
==== UPS and Server Status Check ==== | ==== UPS and Server Status Check ==== | ||
Line 169: | Line 186: | ||
battery.date: 2001/09/25 | battery.date: 2001/09/25 | ||
battery.mfr.date: 2008/06/05 | battery.mfr.date: 2008/06/05 | ||
- | battery.runtime: 2025 | + | battery.runtime: 2535 |
battery.runtime.low: 120 | battery.runtime.low: 120 | ||
- | battery.temperature: 3022999999999998800 | + | battery.temperature: 29.2 |
battery.type: PbAc | battery.type: PbAc | ||
battery.voltage: 27.8 | battery.voltage: 27.8 | ||
battery.voltage.nominal: 24.0 | battery.voltage.nominal: 24.0 | ||
+ | device.mfr: American Power Conversion | ||
+ | device.model: Back-UPS RS 900 | ||
+ | device.serial: 5B0743U08220 | ||
+ | device.type: ups | ||
driver.name: usbhid-ups | driver.name: usbhid-ups | ||
driver.parameter.pollfreq: 30 | driver.parameter.pollfreq: 30 | ||
driver.parameter.pollinterval: 2 | driver.parameter.pollinterval: 2 | ||
- | driver.parameter.port: auto | + | driver.parameter.port: AUTO |
- | driver.version: 2.2.2 | + | driver.version: 2.4.1 |
- | driver.version.data: APC HID 0.92 | + | driver.version.data: APC HID 0.93 |
- | driver.version.internal: 0.33 | + | driver.version.internal: 0.34 |
input.voltage: 122.0 | input.voltage: 122.0 | ||
input.voltage.nominal: 120 | input.voltage.nominal: 120 | ||
Line 188: | Line 209: | ||
ups.beeper.status: enabled | ups.beeper.status: enabled | ||
ups.delay.shutdown: 20 | ups.delay.shutdown: 20 | ||
- | ups.delay.start: 30 | ||
ups.firmware: 9.o2 .D | ups.firmware: 9.o2 .D | ||
ups.firmware.aux: o2 | ups.firmware.aux: o2 | ||
- | ups.load:22999999999999994 | + | ups.load: 18.0 |
ups.mfr: American Power Conversion | ups.mfr: American Power Conversion | ||
ups.mfr.date: 2007/10/24 | ups.mfr.date: 2007/10/24 | ||
Line 247: | Line 267: | ||
chown root:nut /ffp/var/state/ups | chown root:nut /ffp/var/state/ups | ||
chmod 0770 /ffp/var/state/ups | chmod 0770 /ffp/var/state/ups | ||
+ | |||
+ | |||
Line 252: | Line 274: | ||
====== Automating the Startup Process ====== | ====== Automating the Startup Process ====== | ||
You can Telnet to the DNS323 each time you want to start NUT or use a startup script. The following can be added to a nut.sh script file and stored in the /ffp/start directory by copying the content of the code box into your favourite editor then saving the resultant file as /ffp/start/nut.sh. | You can Telnet to the DNS323 each time you want to start NUT or use a startup script. The following can be added to a nut.sh script file and stored in the /ffp/start directory by copying the content of the code box into your favourite editor then saving the resultant file as /ffp/start/nut.sh. | ||
+ | |||
+ | Use this script for DNS323 firmware versions prior to 1.07. | ||
#!/ffp/bin/sh | #!/ffp/bin/sh | ||
Line 289: | Line 313: | ||
run_rc_command "$1" | run_rc_command "$1" | ||
+ | |||
+ | Use this script for DNS323 firmware version 1.07. | ||
+ | |||
+ | #!/ffp/bin/sh | ||
+ | |||
+ | # PROVIDE: nut | ||
+ | |||
+ | . /ffp/etc/ffp.subr | ||
+ | |||
+ | name="nut" | ||
+ | start_cmd="nut_start" | ||
+ | stop_cmd="nut_stop" | ||
+ | |||
+ | nut_start() | ||
+ | { | ||
+ | ##################### | ||
+ | # We're using NUT UPS from ffp; # | ||
+ | ##################### | ||
+ | |||
+ | ############################################ | ||
+ | # Stop built in NUT UPS deamons in preparation for starting ffp NUT UPS # | ||
+ | ############################################ | ||
+ | if ps | grep /usr/local/ups/bin/usbhid-ups | grep -v grep | ||
+ | then | ||
+ | echo "* Stopping Default UPS Services" | ||
+ | # Stop NUT Network Server | ||
+ | /sys/crfs/sbin/upsd -c stop | ||
+ | |||
+ | # Stop NUT driver for UPS hardware. | ||
+ | /sys/crfs/sbin/upsdrvctl stop | ||
+ | fi | ||
+ | |||
+ | sleep 2 | ||
+ | |||
+ | ############## | ||
+ | # Start ffp NUT UPS # | ||
+ | ############## | ||
+ | # Start NUT driver for UPS hardware. | ||
+ | /ffp/bin/upsdrvctl start | ||
+ | |||
+ | # Start NUT Network Server | ||
+ | /ffp/sbin/upsd | ||
+ | |||
+ | # Start NUT monitor agent | ||
+ | /ffp/sbin/upsmon -u monuser | ||
+ | } | ||
+ | |||
+ | nut_stop() | ||
+ | { | ||
+ | # Stop NUT monitor agent | ||
+ | /ffp/sbin/upsmon -c stop | ||
+ | |||
+ | # Stop NUT Network Server | ||
+ | /ffp/sbin/upsd -c stop | ||
+ | |||
+ | # Stop NUT driver for UPS hardware. | ||
+ | /ffp/bin/upsdrvctl stop | ||
+ | } | ||
+ | |||
+ | run_rc_command "$1" | ||
+ | |||
+ | Don't forget to make it runnable: | ||
+ | |||
+ | chmod a+x /ffp/start/nut.sh | ||
====== Add UPS Monitoring and Shut Down Capability to A Remote Windows Machine ====== | ====== Add UPS Monitoring and Shut Down Capability to A Remote Windows Machine ====== |