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

For more details on STATUS logging, see the Status (see
apcupsd Status Logging) section of the Technical Reference.
Logging
Events logging consists of logging events as they happen. For example,
successful startup, power fail, battery failure, system shutdown, ...
See the manual section on customizing event handling (see
Customizing Event Handling) for more details.
Implementation Details
In order to ensure that the data logged to syslog() can be directed to different
files, I have assigned syslog() levels to each of our four types of data as
follows:
1. 1. DEBUG logging has level LOG
DEBUG
2. 2. DATA logging has level LOG
INFO
3. 3. STATUS logging has level LOG
NOTICE
4. 4. EVENTS logging has levels LOG WARNING, LOG ERR,
LOG CRIT, and LOG ALERT
It should be noted that more work needs to be done on the precise definitions
of each of the levels for EVENTS logging. Currently, it is roughly broken
down as follows:
LOG WARNING general information such as startup, etc.
LOG ERR an error condition detected, e.g. communications problem with
the UPS.
LOG CRIT a serious problem has occurred such as power failure, running
on UPS batteries, ...
LOG ALERT a condition that needs immediate attention such as pending
system shutdown, ...
The default Facility for syslog() logging is DAEMON, although this can be
changed with the FACILITY directive in apcupsd.conf. In the following
example, we should the facility as local0.
119










