APCUPSD User ManualAdam KropelinKern SibbaldApcupsd is a UPS control system that permits orderly shutdown of your computer in the event ofa power fail
This is the keyword to specify if you are using your UPS in Slave mode (i.e. the machine is notdirectly connected to the UPS, but to another machine w
Windows ConsiderationsPlease see the Killpower under Windows chapter of this manual for considerations pertaining to shutdownand killpower on Windows.
C InternalTemperature036.0 Units are degrees CD Runtimecalibration!, then $ Runs until battery is below 25% (35% for Matrix)Updates the 'j'
R Turn dumb BYE Only on 3rd gen SmartUPS, SmartUPS v/s,BackUPS Pro. Must send enter smart modecommand to resume comms.S SoftshutdownOK Command execute
f Battery level%099.0 Percentage of battery charge remainingg Nominalbatteryvoltage024 The battery voltage that's expected to be presentin the UP
t Measure-UPSambienttemperature80.5 Degrees C. Only works on models with theMeasure-UPS SmartSlot card.u Uppertransfervoltage132 Writable variable. UP
[ Measure-UPSUpper templimitNO,NO Degrees C. Writable Variable. Possible values: 55,50, 45, ..., 05. Use +/- to change values.] Measure-UPSlower templ
Dip switch infoBit Switch Option when bit=10 4 Low battery alarm changed from 2 to 5 mins. Autostartup disabled on SU370ci and 4001 3 Audible alarm de
= Return fromabnormalconditionSent when the UPS returns from an abnormal condition where ? wassent, but not a turn-on. Not implemented on SmartUPS v/s
Register 3All bits are valid on the Matrix UPS and 3rd generation SmartUPS models. SmartUPS v/s and BackUPSPro models report bits 0-5. All others repo
Interpretation of the New Firmware RevisionNew Firmware revision and model ID String in NN.M.L is the format where NN == UPS ID Code. 12 ==
CMD DFO RSP FSZ FVLu D 4 3 127 130 133 136u M 4 3 229 234 239 224u A 4 3 108 110 112 114u I 4 3 253 257 261 265l D
p The Shutdown Grace Delayq The Low Battery Warning Delayk The Alarm Delayr The Wakeup DelayE The Automatic Self Test IntervalThe first two cases (Ide
package find the line in the spec file which reads%define rh7 0and edit it to read%define rh7 1Alternately you may pass the define on the command line
Yes, there are tools provided for contributors to supply rpm packages for platforms for which supportis provided in the spec file but for which the de
Serial CommunicationsAndre Hedrick ([email protected])2.0 User's ManualEric S. Raymond ([email protected])Alpha PortKern Sibbald ([email protected]
modification, are permitted provided that the following conditionsare met:1. Redistributions of source code must retain the above copyright notice,
If you decide to set up one of these more complex configurations, see the dedicated section on thatparticular configuration.USB ConfigurationApcupsd s
Verifying Device Detection and DriverTo make sure that your USB subsystem can see the UPS, just do this from a shell prompt:cat /proc/bus/usb/devicesT
usbdevfs hub96-111: hiddev hidOn Linux-2.6.x, make sure the sysfs filesystem is mounted on /sys and do:ls -l /sys/bus/usb/driver
Modern Linux distributions using the 2.6 kernel create device nodes dynamically on the fly as they areneeded. It is basically a hotplug system, giving
533 ? S 0:00 devfsd /devWhat complicates the situation much more on Mandrake kernels is their security level sinceCONFIG_DYNAMIC_USB_MINOR
Enable: ugenThis is the default configuration for a GENERIC kernel on many platforms so you most likely will notneed to recompile.NetBSD (v3.x and bel
# usbdevs -daddr 1: UHCI root hub, VIA uhub0 addr 2: Back-UPS RS 1500 FW:8.g6 .D USB FW:g6, American Power Conversion ugen0Device NodesApcupsd comm
You also should build using the gcc compiler and ccs make, not Sun's compiler. The appropriate makeutility can be found in /usr/ccs/bin. gcc can
Device Nodes 18Windows USB Configuration 18Platforms and Versions 18USB Driver Installation 18Verifying Device Detection and Driver 18Solaris USB Conf
After building, install Apcupsd as root using 'make install' and then reboot. During installation,Apcupsd will automatically install a simpl
apcupsd requires gcc and g++ compilers as well as GNU make. Other compilers or BSD make will notwork. GNU make is sometimes installed as gmake. The co
Verifying a Source InstallationThere are a number of things that you can do to check if the installation (make install) went well. The fist isto check
varies from system to system. Other systems such as Solaris require you the make the changes manually,which has the advantage that you won't have
--enable-snmpTurns on generation of the SNMP driver. Thisdriver accesses the UPS over the network usingSNMP. This is compatible only with UPSesequippe
--with-pwrfail-dir=pathThis option allows you to specify where apcupsdwill create the powerfail file when a power failureoccurs. The default is system
For most systems, we recommend the following options:./configure --prefix=/usr --sbindir=/sbin --enable-usband you can optionally build and install th
• SUSE (see SUSE)• Solaris (see Sun Solaris)• unknown (see Unknown System)• Win32 (see Windows Systems)DebianThis port is complete and is being used b
SlackwareSlackware systems are fully supported, and by following the standard installation instructions given above,you should experience few or no pr
At the very end of the /sbin/rc0 script, you should find lines just like the following:# unmount file systems. /usr, /var and /var/adm are not unmount
Arranging for Reboot on Power-Up 30Making sure apcupsd Is Running 31Configuration Examples 32A Simple USB Configuration 32A Simple Configuration for a
depending on which com port your UPS is attached to. Then sync and shutdown the system normally,reattach the UPS, and reboot. This should solve the pr
This is not the normal behavior of most computers as shipped from the factory. Normally after the power iscut and restored, you must explicitly press
To stop apcupsd you can do the following:On Red Hat systems:/etc/rc.d/init.d/apcupsd stopOn SUSE systems:/etc/rc.d/apcupsd stopPlease see the Testing
computer will be immediately shutdown. This is an unfortunate consequence of the dumb signaling mode.To avoid this, first replace /etc/apcupsd/apccont
server decides to shutdown and the time it no longer responds. Your slave must poll during this interval.Any client run using the Net driver will shut
behavior.You may need to take steps to ensure networking stays active during your OS's shutdown sequence inorder for the PCNET driver to power of
Testing ApcupsdThe following testing procedures apply for the most part to SmartUPSes, whether USB or serial. If youhave a dumb voltage-signalling UPS
apcaccess statusDepending on the type of UPS you have, you will get slightly different output, but an example For aSmart-UPS is as follows:APC :
APC : 001,012,0319DATE : Mon Feb 18 09:11:50 CST 2002RELEASE : 3.8.5UPSNAME : UPS_IDENCABLE : APC Cable 940-0128AMODEL : BackUPSUPSMO
Plug the serial port plug back into your computer, and within about 12 seconds, apcupsd shouldreestablish communications and broadcast and log the fol
Battery Life 49Flashing Battery Charge Graph LEDs 50Battery Replacement 50Battery Installation 51"Soft" Runtime Calibration 51"Manual&q
If you do not observe the above messages, please correct the situation before proceeding. The most likelycause of problems are:• apcupsd doesn't
apctestapctest is a program that allows you to talk directly to your UPS and run certain low-level tests, adjustvarious settings such as the battery i
Item 5 is used to program the EEPROM. Please see the Configuration Directives Used to Set the UPSEEPROM chapter of this manual for the details.Item 6
DATE : Fri Dec 03 12:34:26 CET 1999HOSTNAME : matouRELEASE : 3.7.0-beta-1CABLE : Custom Cable SmartMODEL : SMART-UPS 1000UPSMODE : Stand A
When a major event is generated within apcupsd, control is passed to the script apccontrol normally foundin /etc/apcupsd/apccontrol. The event name, a
./multimon.cgiIf everything is set up correctly, it will print a bunch of HTML with the values of the machines that you haveput in the hosts.conf file
to relocate hosts.conf and apcupsd.css from the apcupsd install location to\apcupsd\etc\apcupsd on the appropriate drive.multimon.cgiThis program moni
LINEFREQ : 50.0 HzOUTPUTV : 223.6 VoltsLOADPCT : 6.2 Percent Load CapacityBATTV : 27.9 VoltsBCHARGE : 100.0 PercentMBATTCHG : 5 PercentTIMELEF
Security Issues:• apcupsd runs as root.• If you have NETSERVER ON in your apcupsd.conf file (which is the default), be aware that anyoneon the network
appropriate.AGM has became the preferred VRLA technology for use in standby or float applications and is used inUPSes in the telecommunications, power
Email Notification of Events 71Killpower under Windows 71Power Down During Shutdown 71Command Line Options Specific to the Windows Version 72Installat
In the event of a RMS voltage-out-of-tolerance disturbances(High/Low/No) in the line voltage, theUPS will transfer to battery power and watch the AC l
• Use of a third party battery may void UL, CSA, VDE, and other safety certifications (according toAPC)If you do decide to use third party replacement
4. Matrix-UPS and Smart-UPS recalculate the runtime-related parameters every time the UPS goes onbattery.When doing a runtime calibration with "o
The unit will then go to battery power until the capacity is 25%. After this run time has beencompleted, the original Estimated Run Time is compared w
SU1400RM 28 ED FA 89SU1400R2IBX135 08 B4 10 A3SU1400RMXLI3U 45 F6 F4 80 73.x.ISU1400RMXLI3U 20 F3 FD 81 73.x.ISU
5. Enter 1 (one, not el; wait 4 seconds);6. Enter 1 (one, not el; UPS should respond PROG);7. Enter 0 (zero, not oh; UPS should respond with current c
Question: What language is apcupsd written in?Answer: It is written in C and C++.Question: To test apcupsd, I unplugged the UPS to simulate a power ou
Customizing Event HandlingWhen apcupsd detects anomalies from your UPS device, it will make some decisions that usually result inone or more calls to
changemeWhen apcupsd detects that the mains are on, but the battery is not functioning correctly, this event isgenerated. It is repeated every x hours
This event is generated on a slave machine when it detects either that the master has shutdown, orthat a onbattery situation exists and the communicat
Configuration Directives used to Control System Logging 91Configuration Directives for Sharing a UPS 91Configuration Directives Used to Set the UPS EE
I have two apcupsd.conf files (this is for a 2 UPS setup, easily expandable to N):[adk0212@mail apcupsd]$ ls -l /etc/apcupsd/*.conf-rw-r--r-- 1 root r
generate status email from NISPORT 3552 instead of 3551.I also have a custom init.d start/stop script to manage multiple instances. The start, stop, a
sleep 15 $0 start ;; reload) echo "$0: reload not implemented" exit 3 ;; status) for conf i
The Network Management Card (AP9617, AP9618, AP9619) must beconfigured with network settings before it can communicate on thenetwork. Once the cards h
------- Control Console ------------------------------------------------------- 1- Device Manager 2- Network 3- System 4- Logout &
By default, APCUPSD will poll the SNMP UPS card once per minute. In this case, server notification ofUPS alarms could potentially be delayed one minut
SNMP Trap Catchingapcupsd-3.11.14 introduces support for SNMP trap catching. Previous versions polled the UPS statusonce per minute, leading to signif
4. EVENTSDebug logging consists of debug messages. Normally these are turned on only by developers, andcurrently there exist very few of these debug m
The default Facility for syslog() logging is DAEMON, although this can be changed with the FACILITYdirective in apcupsd.conf. In the following example
(apcsmart, dumb, net, snmp, pcnet) and can be used simply by editing the configuration file UPSCABLE,UPSTYPE, and DEVICE settings as described elsewhe
No person should rely on the contents of the APCUPSD Manual ("the manual") without first obtainingadvice from APC Technical Support.The manu
Starting with version 3.14.2, the tray icon is provided by a separate program called 'apctray'. This cleanlyseparates the user interface fro
Regardless of which Windows system you are running, apcupsd logs most error messages toc:\apcupsd\etc\apcupsd\apcupsd.events. This type error messages
advantage that in a power fail situation, if the killpower function described above does not work, thecomputer will continue to draw down the batterie
pointing this out to me.)The device that Joe Acosta and Kern are using is IOgear GUC232A USB 2 serial adapter. Bill Marrinforms us that it also works
• Make sure you are doing your testing as root otherwise, you may have permissions problemsaccessing the serial port.• You may have cabling problems,
In one case, a user reported that he received random incorrect values from the UPS in the status output. Itturned out that gpm, the mouse control prog
CTS 8 ----------*--------- 5 Low Battery GND 5 -------------------- 4 Ground DCD 1 -------------------- 2 On Battery RTS 7
APCUPSD SIMPLE-CUSTOM CABLEComputer Side | Description of Cable | UPS SideDB9f | DB25f | | DB9m |
| . . . . . . . . . . || |----------------------- |____|For the serial port DB9F connector, the pin numbers are stamped in t
Apparently, all APC voltage-signalling UPSes with DB9 serial ports have the same signals on the outputpins of the UPS. The difference at the computer
subsystem is working (see USB Configuration); if so, you can go to the build and install step.5. If you have a UPS designed to communicate via SNMP ov
Contributedby:Lazar M. FleysherAlthough we do not know what the black box semiconductor contains, we believe that we understand itsoperation (many tha
following diagram is correct.This diagram is for informational purposes and may not be complete. We don't recommend that use it tobuild you build
47k 47kBATTERY-LOW (5) >----R1----*----R2----*----< DTR,DSR,CTS (4,6,8) | |
This diagram is for informational purposes and may not be complete. We don't recommend that use it tobuild you build one yourself.APC Part# - 940
6 DTR -> 6 --+---->|----/\/\/\---o kill power 1 DCD <- 1 --+ | 2 RxD <- 2 --+-------
| +--/\/\/\--+ | | | | 8 RI <-|----+----------------+--o
+---vvvv---+--[>|------<(3)LowBatt | | +--- C | \|___| /| BDCD(1)<----
If you wish to have the UPS recalibrate the remaining runtime calculations, you can do so manually as thecurrent version of apcupsd does not support t
Specify which device is used for UPS communications. For serial ports, it is usually something like/dev/ttyS0. For USB ports, you may leave the name o
apcevents.c and changing the appropriate defines. Be aware that if you set these values to very largenumbers, apcupsd may make excessive memory demand
• Gentoo 3WINDOWS• Windows NT 4 2 4• Windows 98/ME/2000 2 4• Windows XP/Vista (including 64 bit) 1 2• Windows Server 2003/2008 (including 64 bit) 2• W
is reset when the power returns. The default is 60 seconds. Thus, the first warning to log off thesystem occurs after 60 seconds on batteries, assumin
When apcupsd shuts down your system, it creates a temporary "flag file" which is used by theoperating system halt scripts to know if this sh
BATTDATE [ mm/dd/yy | dd/mm/yy ]Last battery replacement date. Maximum of 8 characters.SENSITIVITY [ H | M | L ]H : High (most sensitive setting) M :
UPS nominal output voltage when running on battery. Allowable values depend on the last letter ofthe firmware or APCMODEL. Typical values are:D 115M
VERSION : 3.14.2 (10 September 2007) redhatUPSNAME : ups0CABLE : USB CableMODEL : Back-UPS RS 1500UPSMODE : Stand AloneSTARTTIME: Sun Apr 26
The UPS model as derived from information from the UPS.UPSMODEThe mode in which apcupsd is operating as specified in the configuration file (UPSMODE)S
RETPCTThe percentage charge that the batteries must have after a power off condition before the UPS willrestore power to your equipment.ITEMPInternal
The UPS serial number.BATTDATEThe date that batteries were last replaced.NOMOUTVThe output voltage that the UPS will attempt to supply when on battery
The shutdown sequence is as follows:• apcupsd detects that there is a power problem and it calls /etc/apcupsd/apccontrolpowerout. By default this even
The above code must be inserted as late as possible in the halt script. On many systems, such as RedHat, all the disk drives were unmounted, then remo
Comments to this Manuals