Network UPS Tools User Manual

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.