Network UPS Tools User Manual

Recommendations

Info

Network UPS Tools User Manual 25 / 84 • generate a NOTIFY_SHUTDOWN event • wait FINALDELAY seconds - typically 5 • call their SHUTDOWNCMD • disconnect from upsd 5. The upsmon master system waits up to HOSTSYNC seconds (typically 15) for the slaves to disconnect from upsd. If any are connected after this time, upsmon stops waiting and proceeds with the shutdown process. 6. The upsmon master: • generates a NOTIFY_SHUTDOWN event • waits FINALDELAY seconds - typically 5 • creates the POWERDOWNFLAG file - usually /etc/killpower • calls the SHUTDOWNCMD 7. On most systems, init takes over, kills your processes, syncs and unmounts some filesystems, and remounts some read-only. 8. init then runs your shutdown script. This checks for the POWERDOWNFLAG, finds it, and tells the UPS driver(s) to power off the load. 9. The system loses power. 10. Time passes. The power returns, and the UPS switches back on. 11. All systems reboot and go back to work. 6.3.2 How you set it up NUT user creation Create a upsd user for upsmon to use while monitoring this UPS. Edit upsd.users and create a new section. upsmon will connect to upsd and use this user name (in brackets) and password to authenticate. This example is for a user called "monuser": [monuser] password = mypass upsmon master # or upsmon slave References: upsd(8), upsd.users(5) Reloading the data server Reload upsd. Depending on your configuration, you may be able to do this without stopping upsd: /usr/local/ups/sbin/upsd -c reload If that doesn’t work (check the syslog), just restart it: /usr/local/ups/sbin/upsd -c stop /usr/local/ups/sbin/upsd Note if you want to make reloading work later, see the entry in the FAQ about starting upsd as a different user.
Network UPS Tools User Manual 26 / 84 Power Off flag file Set the POWERDOWNFLAG location for upsmon. In upsmon.conf, add a POWERDOWNFLAG directive with a filename. upsmon will create this file when the UPS needs to be powered off during a power failure when low battery is reached. We will test for the presence of this file in a later step. POWERDOWNFLAG /etc/killpower References: man pages: upsmon(8), upsmon.conf(5) Securing upsmon.conf The recommended setting is to have it owned by root:nut, then make it readable by the group and not world. This file contains passwords that could be used by an attacker to start a shutdown, so keep it secure. chown root:nut upsmon.conf chmod 0640 upsmon.conf This step has been placed early in the process so you secure this file before adding sensitive data in the next step. Create a MONITOR directive for upsmon Edit upsmon.conf and create a MONITOR line with the UPS definition (@), username and password from the NUT user creation step, and the master or slave setting. If it’s the master (i.e., it’s connected to this UPS directly): MONITOR myupsname@mybox 1 monuser mypass master If it’s just monitoring this UPS over the network, and some other system is the master: MONITOR myupsname@mybox 1 monuser mypass slave The number "1" here is the power value. This should always be set to 1 unless you have a very special (read: expensive) system with redundant power supplies. In such cases, refer to the User Manual: • typical setups for big servers, • typical setups for data rooms. References: upsmon(8), upsmon.conf(5) Define a SHUTDOWNCMD for upsmon Still in upsmon.conf, add a directive that tells upsmon how to shut down your system. This example seems to work on most systems: SHUTDOWNCMD "/sbin/shutdown -h +0" Notice the presence of "quotes" here to keep it together. If your system has special needs, you may want to set this to a script which does local shutdown tasks before calling init. Start upsmon /usr/local/ups/sbin/upsmon If it complains about something, then check your configuration.
Page 1 and 2: Network UPS Tools User Manual i Net
Page 3 and 4: Network UPS Tools User Manual iii C
Page 5 and 6: Network UPS Tools User Manual v Ins
Page 7 and 8: Network UPS Tools User Manual vii 9
Page 9 and 10: Network UPS Tools User Manual ix F
Page 11 and 12: Network UPS Tools User Manual xi J.
Page 13 and 14: Network UPS Tools User Manual 2 / 8
Page 21 and 22: Network UPS Tools User Manual 10 /
Page 35: Network UPS Tools User Manual 24 /
Page 87 and 88:
Network UPS Tools User Manual 76 /
Page 89 and 90:
Page 91 and 92:
Page 93 and 94:
Page 95:
show all

Network UPS Tools User Manual

Create successful ePaper yourself

Delete template?

Save as template?