HP-UX Reference (11i v2 03/08) - 1M System Administration Commands N-Z (vol 4)

u
ups_mond(1M) ups_mond(1M)
NAME
ups_mond - HP PowerTrust Uninterruptible Power System monitor daemon
SYNOPSIS
/usr/lbin/ups_mond
[-f configfile ][
-s ][-t ]
DESCRIPTION
When it detects a loss of AC power for a period of time exceeding a configured limit,
ups_mond ensures
file system integrity by shutting down
HP-UX.
To do this, ups_mond uses the device special files
specified in its configuration file (
/etc/ups_conf by default) to monitor the state of each HP Power-
Trust Uninterruptible Power System (UPS) attached to the system.
Use the
-f option to specify a configuration file other than
/etc/ups_conf
. See ups_conf(4) for a
description of the configuration file format.
By default,
ups_mond is locked into memory (see plock(2)). That is,
ups_mond is not swappable.
Although extreme caution is required, you can make
ups_mond swappable if all swap disks are powered
by an uninterruptible power system (assured to have power when the primary power source fails). To
make
ups_mond swappable, use the -s option.
When
ups_mond is forced to shutdown the system, it executes the
/sbin/shutdown
command with
real-time priority (default behavior).
ups_mond can be configured to execute /sbin/shutdown
com-
mand with a timeshare (non-real-time) priority by using the
-t option.
ups_mond is started by init (see init(1M)) by means of an entry in the file
/etc/inittab (see init-
tab(4)). The
inittab entry uses the respawn option to automatically restart
ups_mond if
ups_mond is terminated by the kill command (see kill(1)). This entry should follow the entry:
sqnc::wait:/sbin/rc </dev/console >/dev/console 2>&1
# system initialization
so that ups_mond is started after the system logging daemon (syslogd). It should also be run with
real-time priority to assure its execution (see rtprio (1)).
ups_mond logs messages, and when appropriate invokes /sbin/shutdown
using the -h option, or
/usr/sbin/reboot. For each configured UPS,
ups_mond can be instructed (in /etc/ups_conf)
to log messages only, without taking
shutdown or reboot action. See MSG_ONLY
in ups_conf(4). By
default
ups_mond performs the shutdown and reboot actions.
Note that when the shutdown is performed, UPSs that have lost AC line voltage will be turned off once
the shutdown_timeout_mins time has expired (see ups_conf (4)). By default the system will power on
when the AC line voltage is restored. The kill_after_shutdown line can be added to
ups_conf to tell the
UPS not to come back up when AC line voltage is restored (see ups_conf(4)).
ups_mond uses the syslog message logging facility to log these occurrences (see syslog(3C)). Mes-
sages are written to the console if ups_mond is unable to send them to syslogd. Critical messages
(see DIAGNOSTICS section) are also sent to the console.
RETURN VALUE
ups_mond returns the following values:
zero (0) Successful Completion
non-zero Error encountered. See ERRORS below.
EXAMPLES
The entry in /etc/inittab should be similar to this:
ups::respawn:rtprio 0 /usr/lbin/ups_mond -f /etc/ups_conf
DIAGNOSTICS
Messages resulting from normal operation:
UPS Monitor daemon starting; using configuration file <configfilename>.
UPS <tty special file name> OK: AC Power back on.
AC Power to all recognized, system critical UPS’s OK! System will not
shutdown.
Section 1M−−820 Hewlett-Packard Company − 1 − HP-UX 11i Version 2: August 2003