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
Technical Reference
Configuration Directive Reference
Configuration directives in /etc/apcupsd/apcupsd.conf control the behavior
of the apcupsd daemon. For most installations it is only necessary to set a
handful of general directives. The rest can be left at their defaults unless
you have an exotic configuration.
General Configuration Directives
In general, each of these directives is required (ecept that the DEVICE
directive is ignored for UPSCABLE ether).
UPSTYPE <type of APC UPS you have> The name of a driver.
Should be one of dumb, apcsmart, net, usb, snmp, or test. This de-
scribes your interface type.
The UPSTYPE directive can be defined during installation by using
the --with-upstype= option of the ./configure program.
UPSCABLE <type of cable you are using>>
[ simple | 940-0020B | 940-0023A ]
[ smart | 940-0024B | 940-0024C ]
[ 940-1524C | 940-0024G | 940-0095A | 940-0095B | 940-0095C | 940-0119A]
[ ether | usb ]
The --with-upscable= option of ./configure can be used to set a
default for this directive during the your build.
DEVICE <name of device> Specify which device is used for UPS com-
munications. For serial ports, it is usually something like /dev/ttyS0.
For USB ports, you may leave the name of the device blank (no speci-
fication) and apcupsd will automatically search the standard locations
for the UPS.
Normally, the ./configure program will set an appropriate default
value. You may also specify the --with-serial-dev= option of the
./configure program to set this directive at build time.
If you have specified UPSTYPE net, then the device name to be
specified consists of hostname:port where the hostname is the fully
164










