HP-UX Reference (11i v1 00/12) - 4 File Formats (vol 8)
__________________________________________________________________________________________________________________________________________________________________________________________________
__________________________________________________________________________________________________________________________________________________________________________________________________
STANDARD Printed by: Nora Chuang [nchuang] STANDARD
/build/1111/BRICK/man4/!!!intro.4
________________________________________________________________
___ ___
u
ups_conf(4) ups_conf(4)
(Series 800 Only)
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 pathname 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 interr-
uptions, 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 a Y or N to specify whether the UPS is to come back on, after an AC
line voltage failure (kill_after_shutdown:N), or if the UPS is to stay powered off
(kill_after_shutdown:Y).
upstty The full pathname 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
following 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. It defaults to
SOLA .
EXAMPLES
The following is a sample /etc/ups_conf
file:
shutdown_delay_mins:1
shutdown_timeout_mins:5
upstty:/dev/tty0p1
upstty:/dev/tty0p2:MSG_ONLY
upstty:/dev/tty0p3:SOLA:MSG_ONLY
upstty:/dev/tty0p5:SOLA
FILES
/dev/tty*
/etc/ups_conf
HP-UX Release 11i: December 2000 − 1 − Section 4−−365
___
___