1 ## apcupsd.conf v1.1 ##
3 # for apcupsd release 3.14.1 (04 May 2007) - unknown
5 # "apcupsd" POSIX config file
8 # ========= General configuration parameters ============
12 # Use this to give your UPS a name in log files and such. This
13 # is particulary useful if you have multiple UPSes. This does not
14 # set the EEPROM. It should be 8 characters or less.
18 # Defines the type of cable connecting the UPS to your computer.
20 # Possible generic choices for <cable> are:
21 # simple, smart, ether, usb
23 # Or a specific cable model number may be used:
24 # 940-0119A, 940-0127A, 940-0128A, 940-0020B,
25 # 940-0020C, 940-0023A, 940-0024B, 940-0024C,
26 # 940-1524C, 940-0024G, 940-0095A, 940-0095B,
27 # 940-0095C, M-04-02-2000
31 # To get apcupsd to work, in addition to defining the cable
32 # above, you must also define a UPSTYPE, which corresponds to
33 # the type of UPS you have (see the Description for more details).
34 # You must also specify a DEVICE, sometimes referred to as a port.
35 # For USB UPSes, please leave the DEVICE directive blank. For
36 # other UPS types, you must specify an appropriate port or address.
38 # UPSTYPE DEVICE Description
39 # apcsmart /dev/tty** Newer serial character device,
40 # appropriate for SmartUPS models using
41 # a serial cable (not USB).
43 # usb <BLANK> Most new UPSes are USB. A blank DEVICE
44 # setting enables autodetection, which is
45 # the best choice for most installations.
47 # net hostname:port Network link to a master apcupsd
48 # through apcupsd's Network Information
49 # Server. This is used if you don't have
50 # a UPS directly connected to your computer.
52 # snmp hostname:port:vendor:community
53 # SNMP Network link to an SNMP-enabled
54 # UPS device. Vendor is the MIB used by
55 # the UPS device: can be "APC", "APC_NOTRAP"
56 # or "RFC" where APC is the powernet MIB,
57 # "APC_NOTRAP" is powernet with SNMP trap
58 # catching disabled, and RFC is the IETF's
59 # rfc1628 UPS-MIB. You usually want "APC".
60 # Port is usually 161. Community is usually
63 # dumb /dev/tty** Old serial character device for use
64 # with simple-signaling UPSes.
66 # pcnet ipaddr:username:passphrase
67 # PowerChute Network Shutdown protocol
68 # which can be used as an alternative to SNMP
69 # with AP9617 family of smart slot cards.
70 # ipaddr is the IP address of the UPS mgmt
71 # card. username and passphrase are the
72 # credentials for which the card has been
79 # LOCKFILE <path to lockfile>
80 # Path for device lock file. Not used on Win32.
83 # SCRIPTDIR <path to script directory>
84 # Directory in which apccontrol and event scripts are located.
85 SCRIPTDIR /etc/apcupsd
87 # PWRFAILDIR <path to powerfail directory>
88 # Directory in which to write the powerfail flag file. This file
89 # is created when apcupsd initiates a system shutdown and is
90 # checked in the OS halt scripts to determine if a killpower
91 # (turning off UPS output power) is required.
94 # NOLOGINDIR <path to nologin directory>
95 # Directory in which to write the nologin file. The existence
96 # of this flag file tells the OS to disallow new logins.
101 # ======== Configuration parameters used during power failures ==========
104 # The ONBATTERYDELAY is the time in seconds from when a power failure
105 # is detected until we react to it with an onbattery event.
107 # This means that, apccontrol will be called with the powerout argument
108 # immediately when a power failure is detected. However, the
109 # onbattery argument is passed to apccontrol only after the
110 # ONBATTERYDELAY time. If you don't want to be annoyed by short
111 # powerfailures, make sure that apccontrol powerout does nothing
112 # i.e. comment out the wall.
116 # Note: BATTERYLEVEL, MINUTES, and TIMEOUT work in conjunction, so
117 # the first that occurs will cause the initation of a shutdown.
120 # If during a power failure, the remaining battery percentage
121 # (as reported by the UPS) is below or equal to BATTERYLEVEL,
122 # apcupsd will initiate a system shutdown.
125 # If during a power failure, the remaining runtime in minutes
126 # (as calculated internally by the UPS) is below or equal to MINUTES,
127 # apcupsd, will initiate a system shutdown.
130 # If during a power failure, the UPS has run on batteries for TIMEOUT
131 # many seconds or longer, apcupsd will initiate a system shutdown.
132 # A value of 0 disables this timer.
134 # Note, if you have a Smart UPS, you will most likely want to disable
135 # this timer by setting it to zero. That way, you UPS will continue
136 # on batteries until either the % charge remaing drops to or below BATTERYLEVEL,
137 # or the remaining battery runtime drops to or below MINUTES. Of course,
138 # if you are testing, setting this to 60 causes a quick system shutdown
139 # if you pull the power plug.
140 # If you have an older dumb UPS, you will want to set this to less than
141 # the time you know you can run on batteries.
144 # Time in seconds between annoying users to signoff prior to
145 # system shutdown. 0 disables.
148 # Initial delay after power failure before warning users to get
152 # The condition which determines when users are prevented from
153 # logging in during a power failure.
154 # NOLOGON <string> [ disable | timeout | percent | minutes | always ]
157 # If KILLDELAY is non-zero, apcupsd will continue running after a
158 # shutdown has been requested, and after the specified time in
159 # seconds attempt to kill the power. This is for use on systems
160 # where apcupsd cannot regain control after a shutdown.
161 # KILLDELAY <seconds> 0 disables
165 # ==== Configuration statements for Network Information Server ====
168 # NETSERVER [ on | off ] on enables, off disables the network
169 # information server. If netstatus is on, a network information
170 # server process will be started for serving the STATUS and
171 # EVENT data over the network (used by CGI programs).
174 # NISIP <dotted notation ip address>
175 # IP address on which NIS server will listen for incoming connections.
176 # This is useful if your server is multi-homed (has more than one
177 # network interface and IP address). Default value is 0.0.0.0 which
178 # means any incoming request will be serviced. Alternatively, you can
179 # configure this setting to any specific IP address of your server and
180 # NIS will listen for connections only on that interface. Use the
181 # loopback address (127.0.0.1) to accept connections only from the
185 # NISPORT <port> default is 3551 as registered with the IANA
186 # port to use for sending STATUS and EVENTS data over the network.
187 # It is not used unless NETSERVER is on. If you change this port,
188 # you will need to change the corresponding value in the cgi directory
189 # and rebuild the cgi programs.
192 # If you want the last few EVENTS to be available over the network
193 # by the network information server, you must define an EVENTSFILE.
194 EVENTSFILE /var/log/apcupsd.events
196 # EVENTSFILEMAX <kilobytes>
197 # By default, the size of the EVENTSFILE will be not be allowed to exceed
198 # 10 kilobytes. When the file grows beyond this limit, older EVENTS will
199 # be removed from the beginning of the file (first in first out). The
200 # parameter EVENTSFILEMAX can be set to a different kilobyte value, or set
201 # to zero to allow the EVENTSFILE to grow without limit.
205 # ========== Configuration statements used if sharing =============
206 # a UPS with more than one machine
209 # Interval (in seconds) at which the NIS client polls the server.
210 # Used only when this apcupsd is a network client (UPSTYPE net).
214 # Remaining items are for ShareUPS (APC expansion card) ONLY
217 # UPSCLASS [ standalone | shareslave | sharemaster ]
218 # Normally standalone unless you share an UPS using an APC ShareUPS
222 # UPSMODE [ disable | share ]
223 # Normally disable unless you share an UPS using an APC ShareUPS card.
227 # ===== Configuration statements to control apcupsd system logging ========
230 # Time interval in seconds between writing the STATUS file; 0 disables
233 # Location of STATUS file (written to only if STATTIME is non-zero)
234 STATFILE /var/log/apcupsd.status
236 # LOGSTATS [ on | off ] on enables, off disables
237 # Note! This generates a lot of output, so if
238 # you turn this on, be sure that the
239 # file defined in syslog.conf for LOG_NOTICE is a named pipe.
240 # You probably do not want this on.
243 # Time interval in seconds between writing the DATA records to
244 # the log file. 0 disables.
247 # FACILITY defines the logging facility (class) for logging to syslog.
248 # If not specified, it defaults to "daemon". This is useful
249 # if you want to separate the data logged by apcupsd from other
254 # ========== Configuration statements used in updating the UPS EPROM =========
258 # These statements are used only by apctest when choosing "Set EEPROM with conf
259 # file values" from the EEPROM menu. THESE STATEMENTS HAVE NO EFFECT ON APCUPSD.
262 # UPS name, max 8 characters
265 # Battery date - 8 characters
268 # Sensitivity to line voltage quality (H cause faster transfer to batteries)
269 # SENSITIVITY H M L (default = H)
272 # UPS delay after power return (seconds)
273 # WAKEUP 000 060 180 300 (default = 0)
276 # UPS Grace period after request to power off (seconds)
277 # SLEEP 020 180 300 600 (default = 20)
280 # Low line voltage causing transfer to batteries
281 # The permitted values depend on your model as defined by last letter
282 # of FIRMWARE or APCMODEL. Some representative values are:
286 # I 208 204 200 196 (default = 0 => not valid)
289 # High line voltage causing transfer to batteries
290 # The permitted values depend on your model as defined by last letter
291 # of FIRMWARE or APCMODEL. Some representative values are:
295 # I 253 257 261 265 (default = 0 => not valid)
298 # Battery charge needed to restore power
299 # RETURNCHARGE 00 15 50 90 (default = 15)
303 # 0 = zero delay after pwr fail, T = power fail + 30 sec, L = low battery, N = never
304 # BEEPSTATE 0 T L N (default = 0)
307 # Low battery warning delay in minutes
308 # LOWBATT 02 05 07 10 (default = 02)
311 # UPS Output voltage when running on batteries
312 # The permitted values depend on your model as defined by last letter
313 # of FIRMWARE or APCMODEL. Some representative values are:
317 # I 230 240 220 225 (default = 0 => not valid)
320 # Self test interval in hours 336=2 weeks, 168=1 week, ON=at power on
321 # SELFTEST 336 168 ON OFF (default = 336)