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
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)
or ON
(kill_after_shutdown:N)
upon AC line voltage failures respectively. Default is
kill_after_shutdown:N.
- 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. 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
Printable version
