ups_conf(4)                                                     ups_conf(4)




 NAME    [Toc]    [Back]
      ups_conf - HP PowerTrust Uninterruptible Power System (UPS) monitor
      configuration file

 DESCRIPTION    [Toc]    [Back]
      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 powercycling,
 even if AC power is restored sooner.



 Hewlett-Packard Company            - 1 -   HP-UX 11i Version 2: August 2003






 ups_conf(4)                                                     ups_conf(4)




      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    [Toc]    [Back]
      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

 FILES    [Toc]    [Back]
      /dev/tty*
      /etc/ups_conf

 SEE ALSO    [Toc]    [Back]
      ups_mond(1M).


 Hewlett-Packard Company            - 2 -   HP-UX 11i Version 2: August 2003