HP-UX Reference (11i v1 05/09) - 4 File Formats (vol 8)

u
ups_conf(4) ups_conf(4)
NAME
ups_conf - HP PowerTrust Uninterruptible Power System (UPS) monitor configuration file
DESCRIPTION
The default configuration file for the HP PowerTrust UPS monitor daemon (
ups_mond
). Another file can
be used as long as it complies with the specified format, and the monitor daemon is configured to use the
alternate file (see the description of the
-f option in ups_mond(1M)).
Lines in the configuration file can contain a maximum of 256 characters, and the full path name of a UPS-
tty device file can contain a maximum of 100 characters.
Only one entry per line is allowed in the configuration file. Each line begins with a keyword. All fields in
configuration file entries are delimited by colons (:). Entries in the configuration file end with the first
space encountered (as specified by the library function,
isspace(); see isspace(3C)). Characters beyond
the first space on each line are treated as comments.
The shutdown delay and timeout values should be the first lines in the file.
Entries in this file begin with keywords that must appear exactly as shown below. The terminating colon
separates the keyword from the value of its parameter.
ups_mond recognizes the following keywords:
shutdown_delay_mins
The number of minutes following notification by the first upstty that its corresponding UPS is
operating on internal (battery) power, before ups_mond initiates shutdown -h. The default
is one minute. This value should be set to account for transient power interruptions, if they are
common to the site.
shutdown_timeout_mins
The number of minutes to monitor the shutdown -h operation before initiating reboot with
the halt option (RB_HALT; see reboot(2)). The default is five minutes. This value should be
longer than the longest time the system requires to execute shutdown(1M). Note that after the
value of shutdown_timeout_mins
has elapsed, a UPS lacking AC line voltage will power
off. When AC line voltage is restored, the UPS will restore power to its output. This timeout
value should not be so much longer than
shutdown that an observer may become impatient. It
is important to note that this value is the period for which the UPS will delay its power-cycling,
even if AC power is restored sooner.
kill_after_shutdown
This line is followed by either Y or N, which indicates if the UPS needs to be turned OFF
(kill_after_shutdown:Y
)orON(kill_after_shutdown:N) upon AC line voltage
failures respectively. Default is
kill_after_shutdown:N.
upstty The full path name of the tty device special file through which the UPS is configured. Include
one entry for each UPS. upstty entries are handled in the order they appear in
/etc/ups_conf . Therefore, it is important to list your uninterruptible power systems in
order of priority (for example, UPS protecting the SPU listed first).
upstty entries can contain following optional parameters, which can appear in any order fol-
lowing the upstty device special file name:
MSG_ONLY This upstty will not cause shutdown or reboot to be initiated.
SOLA The type of uninterruptible power supply. Currently, this is the only type
defined and supports the entire HP UPS family, including PowerTrust. It
defaults to SOLA.
EXAMPLES
The following is a sample /etc/ups_conf file:
shutdown_delay_mins:1
shutdown_timeout_mins:5
kill_after_shutdown:Y
upstty:/dev/tty0p1
upstty:/dev/tty0p2:MSG_ONLY
upstty:/dev/tty0p3:SOLA:MSG_ONLY
upstty:/dev/tty0p5:SOLA
HP-UX 11i Version 1: September 2005 1 Hewlett-Packard Company Section 4369