unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Page:
Section:
Apropos / Subsearch:
optional field

 @(#) ups_conf.4 $Date: 2001/09/25 17:51:18 $Revision: r11.11/2	 PATCH_11.11
 (PHCO_24173)




























































				    - 1 -	  Formatted:  August 2, 2006






 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 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.



				    - 1 -	  Formatted:  August 2, 2006






 ups_conf(4)							 ups_conf(4)




      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).	The 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

 FILES
      /dev/tty*
      /etc/ups_conf

 SEE ALSO
      ups_mond(1M).










				    - 2 -	  Formatted:  August 2, 2006