UPSMON(8) NUT UPSMON(8) (NAME) upsmon - UPS (SYNOPSIS) upsmon -h upsmon -c command [-P pid] upsmon [-D] [-F | -B] [-K] [-p] [-u user] (DESCRIPTION) upsmon UPS -- . . upsmon . UPS upsmon.conf(5) (primary secondary) . (OPTIONS) -c command command upsmon. : fsd UPS primary ( ) stop reload upsmon.conf(5). " " . -P pid PID PID. upsmon PID . -D . upsmon stdout . . -F upsmon . -B upsmon . -K . upsmon upsmon EXIT_SUCCESS . upsmon EXIT_FAILURE . upsmon -K upsdrvctl(8) UPS . -p . upsmon . root SHUTDOWNCMD . << root>> . . -u user . -p . user configure --with-user=... . nobody ( ) nut . . upsmon.conf(5) RUN_AS_USER . (COMMON OPTIONS) -h . -V NUT. export NUT_DEBUG_LEVEL=1 . -W secs ( ). NUT_DEFAULT_CONNECT_TIMEOUT . UPS (UPS DEFINITIONS) upsmon.conf(5) UPS . MONITOR : MONITOR 'system' 'powervalue' 'username' 'password' 'type' system upsd(8) upsname[@hostname[:port]]. hostname "localhost" port 3493 . : o "su700@mybox" UPS "su700" "mybox" . . o "fenton@bigbox:5678" UPS "fenton" "bigbox" upsd(8) "5678" . powervalue UPS . 1 . username upsd.users(5) . password . type -- primary secondary ( " upsmon" ). "primary" UPS USB "secondary" UPS . UPS . (NOTIFY EVENTS) upsmon UPS . " " . NOTIFY . ONLINE UPS . ONBATT UPS . LOWBATT UPS ( ). FSD << >> UPS . COMMOK UPS . COMMBAD UPS . SHUTDOWN . REPLBATT UPS . NOCOMM UPS . NOPARENT upsmon - . CAL UPS . NOTCAL UPS . OFF UPS . NOTOFF UPS . BYPASS UPS ( ). NOTBYPASS UPS . ECO UPS ECO ( ) (High Efficiency mode) (Energy Saver System) . Eaton High Efficiency Online ( Line- Interactive ) ( ) . . NOTECO UPS ECO ( ). ALARM UPS ( ups.alarm ). NOTALARM UPS ( ). OVER UPS . NOTOVER UPS . TRIM UPS . NOTTRIM UPS . BOOST UPS . NOTBOOST UPS . OTHER UPS . NOTOTHER UPS . SUSPEND_STARTING sleep/suspend/hibernate . SUSPEND_FINISHED sleep/suspend/hibernate UPS . (NOTIFY COMMAND) upsmon.conf(5) NOTIFYCMD . : NOTIFYCMD "path to program" : o NOTIFYCMD "/usr/local/bin/notifyme" " " . . NOTIFYCMD NOTIFYTYPE UPSNAME UPS . ( ) ( ) . NOTIFYCMD EXEC . (NOTIFY FLAGS) ( ) (wall) syslog . upsmon syslog . NOTIFYFLAG : : NOTIFYFLAG notifytype flags : o NOTIFYFLAG ONLINE SYSLOG o NOTIFYFLAG ONBATT SYSLOG+WALL o NOTIFYFLAG LOWBATT SYSLOG+WALL+EXEC : SYSLOG syslog. WALL wall(1). EXEC NOTIFYCMD. IGNORE . . SYSLOG+WALL+EXEC . (NOTIFY MESSAGES) upsmon NOTIFY . NOTIFYMSG . : NOTIFYMSG type "message" : o NOTIFYMSG ONLINE "UPS %s is getting line power" o NOTIFYMSG ONBATT "Someone pulled the plug on %s" %s UPS . wall upsmon NOTIFYCMD . NOTIFY_ALARM NOTIFY_OTHER %s . (POWER VALUES) << >> UPS upsmon . UPS . UPS ( ) << >> . : MONITOR upsname powervalue username password type << >> MONITOR UPS . o 1 . : o MONITOR myups@myhost 1 username mypassword primary o (redundant) UPS . . UPS ( ): o MONITOR ups-alpha@myhost 2 username mypassword primary o MONITOR ups-beta@myhost 2 username mypassword primary o UPS 0 . upsmon UPS upsmon . "primary" upsmon UPS . : o MONITOR faraway@anotherbox 0 username mypassword secondary << >> upsmon . : MINSUPPLIES value o . : o MINSUPPLIES 1 o . . : o MINSUPPLIES 3 UPS upsmon . . UPS UPSMON (UPS CONNECTION TYPES AND UPSMON ROLES) upsmon upsd(8) . UPS upsmon "primary" upsmon "secondary" . ( ) upsdrvctl shutdown . upsmon secondary UPS . UPS ( ) . . upsd(8) upsmon primary . secondary . upsmon upsd(8) HOSTSYNC . upsmon . ( ). . FINALDELAY . upsmon UPS . . . (TIMED SHUTDOWNS) UPS upssched(8) . upsmon << >> . upssched upsmon . UPS . (REDUNDANT POWER SUPPLIES) UPS . upsmon . UPS MINSUPPLIES . HP NetServer LH4 . . UPS . UPS "alpha" UPS "beta" . alpha beta . MINSUPPLIES . alpha . ( ) . ( beta) . upsmon . beta . . beta . UPS . (MIXED OPERATIONS) UPS upsmon . UPS UPS (primary) (secondary) . USB . UPS . . (FORCED SHUTDOWNS) upsmon "FSD" ( ) UPS primary . secondary primary UPS . upsmon primary -c fsd . upssched(8) . . "FSD" . -- UPS . UPS "FSD" "" ( UPS ). UPS UPS . . upsmon POWERDOWNFLAG UPS . upsmon UPS . ( . RAM .) (SIMULATING POWER FAILURES) UPS (FSD) . upsmon : :; upsmon -c fsd . UPS . SHUTDOWNCMD . NUT tests/NIT NUT ( NUT make check-NIT-sandbox -- nit.sh ). scripts/misc/notifyme-debug upssched ( ) clients/upssched-cmd CMDSCRIPT upssched(8) . NUT upsd "FSD" POWERDOWNFLAG ( /etc/killpower) primary upsmon . (SHUTDOWN ACTIVITY WORKFLOW) clients/upsmon.c . ( upssched(8)) : o upsmon ( ) <<>> / FSD ups.status -- upsd upsmon upsmon -c fsd o upsmon forceshutdown() o UPS primary setfsd() ( FSD ) o UPS -- secondary doshutdown() o primary sync_secondaries() doshutdown() : o (upsd) UPS primary HOSTSYNC o ( ) SHUTDOWN_HOSTSYNC . o doshutdown() : o SHUTDOWN o FINALDELAY o SHUTDOWNEXIT ( upsmon SHUTDOWNCMD -- secondary primary ) o SHUTDOWNCMD ( root ) o SHUTDOWNEXIT o ( root ). upsmon ( sudo ). SHUTDOWNCMD . UPS (DEAD UPSES) upsmon upsd(8) DEADTIME upsmon.conf(5) UPS <<>> . UPS . upsmon "NOCOMM" UPS . NOCOMMWARNTIME . upsmon POLLFREQ ( "Data stale" "Driver not connected") . POLLFAIL_LOG_THROTTLE_MAX syslog . ( max=1 ) ( / ). . UPS (UPS ALARMS) UPS UPS UPS . "ALARM" UPS "ups.alarm" UPS UPS . "ALARM" "NOTALARM" upsmon "ALARM" . UPS upsmon UPS . upsmon UPS / ( HE/ECO) . ALARMCRITICAL upsmon.conf . (RELOADING NUANCES) upsmon root SIGHUP . upsmon.conf(5) upsmon . upsmon . "nobody" ( ) nut ups NUT . RUN_AS_USER upsmon.conf(5) . SHUTDOWNCMD POWERDOWNFLAG . upsmon . upsmon syslog . (ENVIRONMENT VARIABLES) NUT_DEBUG_LEVEL -D . NUT_CONFPATH upsmon.conf . upsmon /usr/local/ups/etc . NUT_QUIET_INIT_UPSNOTIFY=true ( systemd) ( ). NUT_QUIET_INIT_BANNER=true NUT . NUT . (FILES) upsmon.conf(5) (SEE ALSO) : upsd(8) : upsc(8), upscmd(8), upsrw(8), upsmon(8) CGI: upsset.cgi(8), upsstats.cgi(8), upsimage.cgi(8) : NUT (Network UPS Tools): Network UPS Tools 2.8.5 06/21/2026 UPSMON(8)