3 |
- |
1 |
## apcupsd.conf v1.1 ##
|
|
|
2 |
#
|
|
|
3 |
# for apcupsd release 3.14.10 (13 September 2011) - redhat
|
|
|
4 |
#
|
|
|
5 |
# "apcupsd" POSIX config file
|
|
|
6 |
|
|
|
7 |
#
|
|
|
8 |
# ========= General configuration parameters ============
|
|
|
9 |
#
|
|
|
10 |
|
|
|
11 |
# UPSNAME xxx
|
|
|
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.
|
|
|
15 |
#UPSNAME
|
|
|
16 |
|
|
|
17 |
# UPSCABLE <cable>
|
|
|
18 |
# Defines the type of cable connecting the UPS to your computer.
|
|
|
19 |
#
|
|
|
20 |
# Possible generic choices for <cable> are:
|
|
|
21 |
# simple, smart, ether, usb
|
|
|
22 |
#
|
|
|
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
|
|
|
28 |
#
|
|
|
29 |
UPSCABLE smart
|
|
|
30 |
|
|
|
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.
|
|
|
37 |
#
|
|
|
38 |
# UPSTYPE DEVICE Description
|
|
|
39 |
# apcsmart /dev/tty** Newer serial character device, appropriate for
|
|
|
40 |
# SmartUPS models using a serial cable (not USB).
|
|
|
41 |
#
|
|
|
42 |
# usb <BLANK> Most new UPSes are USB. A blank DEVICE
|
|
|
43 |
# setting enables autodetection, which is
|
|
|
44 |
# the best choice for most installations.
|
|
|
45 |
#
|
|
|
46 |
# net hostname:port Network link to a master apcupsd through apcupsd's
|
|
|
47 |
# Network Information Server. This is used if the
|
|
|
48 |
# UPS powering your computer is connected to a
|
|
|
49 |
# different computer for monitoring.
|
|
|
50 |
#
|
|
|
51 |
# snmp hostname:port:vendor:community
|
|
|
52 |
# SNMP network link to an SNMP-enabled UPS device.
|
|
|
53 |
# Hostname is the ip address or hostname of the UPS
|
|
|
54 |
# on the network. Vendor can be can be "APC" or
|
|
|
55 |
# "APC_NOTRAP". "APC_NOTRAP" will disable SNMP trap
|
|
|
56 |
# catching; you usually want "APC". Port is usually
|
|
|
57 |
# 161. Community is usually "private".
|
|
|
58 |
#
|
|
|
59 |
# netsnmp hostname:port:vendor:community
|
|
|
60 |
# OBSOLETE
|
|
|
61 |
# Same as SNMP above but requires use of the
|
|
|
62 |
# net-snmp library. Unless you have a specific need
|
|
|
63 |
# for this old driver, you should use 'snmp' instead.
|
|
|
64 |
#
|
|
|
65 |
# dumb /dev/tty** Old serial character device for use with
|
|
|
66 |
# simple-signaling UPSes.
|
|
|
67 |
#
|
|
|
68 |
# pcnet ipaddr:username:passphrase:port
|
|
|
69 |
# PowerChute Network Shutdown protocol which can be
|
|
|
70 |
# used as an alternative to SNMP with the AP9617
|
|
|
71 |
# family of smart slot cards. ipaddr is the IP
|
|
|
72 |
# address of the UPS management card. username and
|
|
|
73 |
# passphrase are the credentials for which the card
|
|
|
74 |
# has been configured. port is the port number on
|
|
|
75 |
# which to listen for messages from the UPS, normally
|
|
|
76 |
# 3052. If this parameter is empty or missing, the
|
|
|
77 |
# default of 3052 will be used.
|
|
|
78 |
#
|
|
|
79 |
UPSTYPE net
|
136 |
- |
80 |
DEVICE 10.192.25.240:3551
|
3 |
- |
81 |
|
|
|
82 |
# POLLTIME <int>
|
|
|
83 |
# Interval (in seconds) at which apcupsd polls the UPS for status. This
|
|
|
84 |
# setting applies both to directly-attached UPSes (UPSTYPE apcsmart, usb,
|
|
|
85 |
# dumb) and networked UPSes (UPSTYPE net, snmp). Lowering this setting
|
|
|
86 |
# will improve apcupsd's responsiveness to certain events at the cost of
|
|
|
87 |
# higher CPU utilization. The default of 60 is appropriate for most
|
|
|
88 |
# situations.
|
|
|
89 |
#POLLTIME 60
|
|
|
90 |
|
|
|
91 |
# LOCKFILE <path to lockfile>
|
|
|
92 |
# Path for device lock file. Not used on Win32.
|
|
|
93 |
LOCKFILE /var/lock
|
|
|
94 |
|
|
|
95 |
# SCRIPTDIR <path to script directory>
|
|
|
96 |
# Directory in which apccontrol and event scripts are located.
|
|
|
97 |
SCRIPTDIR /etc/apcupsd
|
|
|
98 |
|
|
|
99 |
# PWRFAILDIR <path to powerfail directory>
|
|
|
100 |
# Directory in which to write the powerfail flag file. This file
|
|
|
101 |
# is created when apcupsd initiates a system shutdown and is
|
|
|
102 |
# checked in the OS halt scripts to determine if a killpower
|
|
|
103 |
# (turning off UPS output power) is required.
|
|
|
104 |
PWRFAILDIR /etc/apcupsd
|
|
|
105 |
|
|
|
106 |
# NOLOGINDIR <path to nologin directory>
|
|
|
107 |
# Directory in which to write the nologin file. The existence
|
|
|
108 |
# of this flag file tells the OS to disallow new logins.
|
|
|
109 |
NOLOGINDIR /etc
|
|
|
110 |
|
|
|
111 |
|
|
|
112 |
#
|
|
|
113 |
# ======== Configuration parameters used during power failures ==========
|
|
|
114 |
#
|
|
|
115 |
|
|
|
116 |
# The ONBATTERYDELAY is the time in seconds from when a power failure
|
|
|
117 |
# is detected until we react to it with an onbattery event.
|
|
|
118 |
#
|
|
|
119 |
# This means that, apccontrol will be called with the powerout argument
|
|
|
120 |
# immediately when a power failure is detected. However, the
|
|
|
121 |
# onbattery argument is passed to apccontrol only after the
|
|
|
122 |
# ONBATTERYDELAY time. If you don't want to be annoyed by short
|
|
|
123 |
# powerfailures, make sure that apccontrol powerout does nothing
|
|
|
124 |
# i.e. comment out the wall.
|
|
|
125 |
ONBATTERYDELAY 6
|
|
|
126 |
|
|
|
127 |
#
|
|
|
128 |
# Note: BATTERYLEVEL, MINUTES, and TIMEOUT work in conjunction, so
|
|
|
129 |
# the first that occurs will cause the initation of a shutdown.
|
|
|
130 |
#
|
|
|
131 |
|
|
|
132 |
# If during a power failure, the remaining battery percentage
|
|
|
133 |
# (as reported by the UPS) is below or equal to BATTERYLEVEL,
|
|
|
134 |
# apcupsd will initiate a system shutdown.
|
|
|
135 |
BATTERYLEVEL 5
|
|
|
136 |
|
|
|
137 |
# If during a power failure, the remaining runtime in minutes
|
|
|
138 |
# (as calculated internally by the UPS) is below or equal to MINUTES,
|
|
|
139 |
# apcupsd, will initiate a system shutdown.
|
|
|
140 |
MINUTES 3
|
|
|
141 |
|
|
|
142 |
# If during a power failure, the UPS has run on batteries for TIMEOUT
|
|
|
143 |
# many seconds or longer, apcupsd will initiate a system shutdown.
|
|
|
144 |
# A value of 0 disables this timer.
|
|
|
145 |
#
|
|
|
146 |
# Note, if you have a Smart UPS, you will most likely want to disable
|
|
|
147 |
# this timer by setting it to zero. That way, you UPS will continue
|
|
|
148 |
# on batteries until either the % charge remaing drops to or below BATTERYLEVEL,
|
|
|
149 |
# or the remaining battery runtime drops to or below MINUTES. Of course,
|
|
|
150 |
# if you are testing, setting this to 60 causes a quick system shutdown
|
|
|
151 |
# if you pull the power plug.
|
|
|
152 |
# If you have an older dumb UPS, you will want to set this to less than
|
|
|
153 |
# the time you know you can run on batteries.
|
|
|
154 |
TIMEOUT 0
|
|
|
155 |
|
|
|
156 |
# Time in seconds between annoying users to signoff prior to
|
|
|
157 |
# system shutdown. 0 disables.
|
|
|
158 |
ANNOY 300
|
|
|
159 |
|
|
|
160 |
# Initial delay after power failure before warning users to get
|
|
|
161 |
# off the system.
|
|
|
162 |
ANNOYDELAY 60
|
|
|
163 |
|
|
|
164 |
# The condition which determines when users are prevented from
|
|
|
165 |
# logging in during a power failure.
|
|
|
166 |
# NOLOGON <string> [ disable | timeout | percent | minutes | always ]
|
|
|
167 |
NOLOGON disable
|
|
|
168 |
|
|
|
169 |
# If KILLDELAY is non-zero, apcupsd will continue running after a
|
|
|
170 |
# shutdown has been requested, and after the specified time in
|
|
|
171 |
# seconds attempt to kill the power. This is for use on systems
|
|
|
172 |
# where apcupsd cannot regain control after a shutdown.
|
|
|
173 |
# KILLDELAY <seconds> 0 disables
|
|
|
174 |
KILLDELAY 0
|
|
|
175 |
|
|
|
176 |
#
|
|
|
177 |
# ==== Configuration statements for Network Information Server ====
|
|
|
178 |
#
|
|
|
179 |
|
|
|
180 |
# NETSERVER [ on | off ] on enables, off disables the network
|
|
|
181 |
# information server. If netstatus is on, a network information
|
|
|
182 |
# server process will be started for serving the STATUS and
|
|
|
183 |
# EVENT data over the network (used by CGI programs).
|
|
|
184 |
NETSERVER on
|
|
|
185 |
|
|
|
186 |
# NISIP <dotted notation ip address>
|
|
|
187 |
# IP address on which NIS server will listen for incoming connections.
|
|
|
188 |
# This is useful if your server is multi-homed (has more than one
|
|
|
189 |
# network interface and IP address). Default value is 0.0.0.0 which
|
|
|
190 |
# means any incoming request will be serviced. Alternatively, you can
|
|
|
191 |
# configure this setting to any specific IP address of your server and
|
|
|
192 |
# NIS will listen for connections only on that interface. Use the
|
|
|
193 |
# loopback address (127.0.0.1) to accept connections only from the
|
|
|
194 |
# local machine.
|
|
|
195 |
NISIP 0.0.0.0
|
|
|
196 |
|
|
|
197 |
# NISPORT <port> default is 3551 as registered with the IANA
|
|
|
198 |
# port to use for sending STATUS and EVENTS data over the network.
|
|
|
199 |
# It is not used unless NETSERVER is on. If you change this port,
|
|
|
200 |
# you will need to change the corresponding value in the cgi directory
|
|
|
201 |
# and rebuild the cgi programs.
|
|
|
202 |
NISPORT 3551
|
|
|
203 |
|
|
|
204 |
# If you want the last few EVENTS to be available over the network
|
|
|
205 |
# by the network information server, you must define an EVENTSFILE.
|
|
|
206 |
EVENTSFILE /var/log/apcupsd.events
|
|
|
207 |
|
|
|
208 |
# EVENTSFILEMAX <kilobytes>
|
|
|
209 |
# By default, the size of the EVENTSFILE will be not be allowed to exceed
|
|
|
210 |
# 10 kilobytes. When the file grows beyond this limit, older EVENTS will
|
|
|
211 |
# be removed from the beginning of the file (first in first out). The
|
|
|
212 |
# parameter EVENTSFILEMAX can be set to a different kilobyte value, or set
|
|
|
213 |
# to zero to allow the EVENTSFILE to grow without limit.
|
|
|
214 |
EVENTSFILEMAX 10
|
|
|
215 |
|
|
|
216 |
#
|
|
|
217 |
# ========== Configuration statements used if sharing =============
|
|
|
218 |
# a UPS with more than one machine
|
|
|
219 |
|
|
|
220 |
#
|
|
|
221 |
# Remaining items are for ShareUPS (APC expansion card) ONLY
|
|
|
222 |
#
|
|
|
223 |
|
|
|
224 |
# UPSCLASS [ standalone | shareslave | sharemaster ]
|
|
|
225 |
# Normally standalone unless you share an UPS using an APC ShareUPS
|
|
|
226 |
# card.
|
|
|
227 |
UPSCLASS standalone
|
|
|
228 |
|
|
|
229 |
# UPSMODE [ disable | share ]
|
|
|
230 |
# Normally disable unless you share an UPS using an APC ShareUPS card.
|
|
|
231 |
UPSMODE disable
|
|
|
232 |
|
|
|
233 |
#
|
|
|
234 |
# ===== Configuration statements to control apcupsd system logging ========
|
|
|
235 |
#
|
|
|
236 |
|
|
|
237 |
# Time interval in seconds between writing the STATUS file; 0 disables
|
|
|
238 |
STATTIME 0
|
|
|
239 |
|
|
|
240 |
# Location of STATUS file (written to only if STATTIME is non-zero)
|
|
|
241 |
STATFILE /var/log/apcupsd.status
|
|
|
242 |
|
|
|
243 |
# LOGSTATS [ on | off ] on enables, off disables
|
|
|
244 |
# Note! This generates a lot of output, so if
|
|
|
245 |
# you turn this on, be sure that the
|
|
|
246 |
# file defined in syslog.conf for LOG_NOTICE is a named pipe.
|
|
|
247 |
# You probably do not want this on.
|
|
|
248 |
LOGSTATS off
|
|
|
249 |
|
|
|
250 |
# Time interval in seconds between writing the DATA records to
|
|
|
251 |
# the log file. 0 disables.
|
|
|
252 |
DATATIME 0
|
|
|
253 |
|
|
|
254 |
# FACILITY defines the logging facility (class) for logging to syslog.
|
|
|
255 |
# If not specified, it defaults to "daemon". This is useful
|
|
|
256 |
# if you want to separate the data logged by apcupsd from other
|
|
|
257 |
# programs.
|
|
|
258 |
#FACILITY DAEMON
|
|
|
259 |
|
|
|
260 |
#
|
|
|
261 |
# ========== Configuration statements used in updating the UPS EPROM =========
|
|
|
262 |
#
|
|
|
263 |
|
|
|
264 |
#
|
|
|
265 |
# These statements are used only by apctest when choosing "Set EEPROM with conf
|
|
|
266 |
# file values" from the EEPROM menu. THESE STATEMENTS HAVE NO EFFECT ON APCUPSD.
|
|
|
267 |
#
|
|
|
268 |
|
|
|
269 |
# UPS name, max 8 characters
|
|
|
270 |
#UPSNAME UPS_IDEN
|
|
|
271 |
|
|
|
272 |
# Battery date - 8 characters
|
|
|
273 |
#BATTDATE mm/dd/yy
|
|
|
274 |
|
|
|
275 |
# Sensitivity to line voltage quality (H cause faster transfer to batteries)
|
|
|
276 |
# SENSITIVITY H M L (default = H)
|
|
|
277 |
#SENSITIVITY H
|
|
|
278 |
|
|
|
279 |
# UPS delay after power return (seconds)
|
|
|
280 |
# WAKEUP 000 060 180 300 (default = 0)
|
|
|
281 |
#WAKEUP 60
|
|
|
282 |
|
|
|
283 |
# UPS Grace period after request to power off (seconds)
|
|
|
284 |
# SLEEP 020 180 300 600 (default = 20)
|
|
|
285 |
#SLEEP 180
|
|
|
286 |
|
|
|
287 |
# Low line voltage causing transfer to batteries
|
|
|
288 |
# The permitted values depend on your model as defined by last letter
|
|
|
289 |
# of FIRMWARE or APCMODEL. Some representative values are:
|
|
|
290 |
# D 106 103 100 097
|
|
|
291 |
# M 177 172 168 182
|
|
|
292 |
# A 092 090 088 086
|
|
|
293 |
# I 208 204 200 196 (default = 0 => not valid)
|
|
|
294 |
#LOTRANSFER 208
|
|
|
295 |
|
|
|
296 |
# High line voltage causing transfer to batteries
|
|
|
297 |
# The permitted values depend on your model as defined by last letter
|
|
|
298 |
# of FIRMWARE or APCMODEL. Some representative values are:
|
|
|
299 |
# D 127 130 133 136
|
|
|
300 |
# M 229 234 239 224
|
|
|
301 |
# A 108 110 112 114
|
|
|
302 |
# I 253 257 261 265 (default = 0 => not valid)
|
|
|
303 |
#HITRANSFER 253
|
|
|
304 |
|
|
|
305 |
# Battery charge needed to restore power
|
|
|
306 |
# RETURNCHARGE 00 15 50 90 (default = 15)
|
|
|
307 |
#RETURNCHARGE 15
|
|
|
308 |
|
|
|
309 |
# Alarm delay
|
|
|
310 |
# 0 = zero delay after pwr fail, T = power fail + 30 sec, L = low battery, N = never
|
|
|
311 |
# BEEPSTATE 0 T L N (default = 0)
|
|
|
312 |
#BEEPSTATE T
|
|
|
313 |
|
|
|
314 |
# Low battery warning delay in minutes
|
|
|
315 |
# LOWBATT 02 05 07 10 (default = 02)
|
|
|
316 |
#LOWBATT 2
|
|
|
317 |
|
|
|
318 |
# UPS Output voltage when running on batteries
|
|
|
319 |
# The permitted values depend on your model as defined by last letter
|
|
|
320 |
# of FIRMWARE or APCMODEL. Some representative values are:
|
|
|
321 |
# D 115
|
|
|
322 |
# M 208
|
|
|
323 |
# A 100
|
|
|
324 |
# I 230 240 220 225 (default = 0 => not valid)
|
|
|
325 |
#OUTPUTVOLTS 230
|
|
|
326 |
|
|
|
327 |
# Self test interval in hours 336=2 weeks, 168=1 week, ON=at power on
|
|
|
328 |
# SELFTEST 336 168 ON OFF (default = 336)
|
|
|
329 |
#SELFTEST 336
|