User's Manual UPS control system
Table Of Contents
- Apcupsd User's Manual
- Release Notes
- How To Use This Manual
- Basic User's Guide
- Planning Your Installation
- Building and Installing apcupsd
- After Installation
- Configuration Examples
- Testing Apcupsd
- Troubleshooting Your Installation
- Monitoring and Tuning your UPS
- Maintaining Your UPS
- Frequently-Asked Questions
- Apcupsd Bugs
- Advanced topics
- Customizing Event Handling
- Master/Slave Configurations
- Controlling Multiple UPSes on one Machine
- Support for SNMP UPSes
- Alternate Ways To Run The Network Information Server
- apcupsd System Logging
- Installation: Windows
- Windows Version of apcupsd
- Installation: Serial-Line UPSes
- Overview of Serial-Interface UPSes
- Connecting a Serial-Line UPS to a USB Port
- Connecting a APC USB UPS to either a PC USB or Serial Port
- Cables
- Smart-Custom Cable for SmartUPSes
- Smart Signalling Cable for BackUPS CS Models
- Voltage-Signalling Cable for "dumb" UPSes
- Other APC Cables that apcupsd Supports
- Voltage Signalling Features Supported by Apcupsd for Various Cables
- Voltage Signalling
- Back-UPS Office 500 signals
- Analyses of APC Cables
- Win32 Implementation Restrictions for Simple UPSes
- Internal Apcupsd Actions for Simple Cables
- RS232 Wiring and Signal Conventions
- Pin Assignment for the Serial Port (RS-232C), 25-pin and 9-pin, Female End
- Ioctl to RS232 Correspondence
- Testing Serial-Line UPSes
- Troubleshooting Serial Line communications
- Recalibrating the UPS Runtime
- DATA Logging
- Technical Reference
- Configuration Directive Reference
- apcupsd Status Logging
- Shutown Sequence and its Discontents
- APC smart protocol
- Apcupsd --- RPM Packaging FAQ
- Credits
- Kernel Config
Email Notification of Events
On Win95/98 systems, it is possible to receive notification of apcupsd events
that are passed to apccontrol. This is possible using a simple email program
that unfortunately is not functioning 100% correctly. In addition, I (Kern)
was not able to make this program work on WinNT while apcupsd is running
as a service under the system account (it works fine with any user account).
If you wish to try this program on Win95/98 systems, look at the files
named changeme, commfailure, commok, onbattery, and mains-
back in the directory c:\apcupsd\examples. To use them, you must modify
the SYSADMIN variable to have a valid email address, then copy the files
into the directory c:\apcupsd\etc\apcupsd.
Killpower under Windows
If your batteries become exhausted during a power failure and you want your
machine to automatically reboot when the power comes back, it is useful to
implement the killpower feature of the UPS where apcupsd sends the UPS
the command to shut off the power. In doing so, the power will be cut to
your PC and if your BIOS is properly setup, the machine will automatically
reboot when the power comes back. This is important for servers.
This feature is implemented on Unix systems by first requesting a system
shutdown. As a part of the shutdown, apcupsd is terminated by the system,
but the shutdown process executes a script where apcupsd is recalled after
the disks are synced and the machine is idle. Apcupsd then requests the
UPS to shut off the power (killpower).
Unfortunately on Windows, there is no such shutdown script that we are
aware of and no way for apcupsd to get control after the machine is idled.
If this feature is important to you, it is possible to do it by telling apcupsd
to immediately issue the killpower command after issuing the shutdown
request. The danger in doing so is that if the machine is not sufficiently
idled when the killpower takes place, the disks will need to be rescanned
(and there is a possibility of lost data however small). Generally, UPSes
have a shutdown grace period which gives sufficient time for the OS to
shutdown before the power is cut.
To implement this feature, you need to add the -p option to the apcupsd
command line that is executed by the system. Currently the procedure is
manual. You do so by editing the registry and changing the line:
132










