Subversion Repositories configs

Rev

Details | Last modification | View Log | RSS feed

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