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
or the equivalent for your system. If you are running on Linux and using the
fork()ing version of apcupsd, you should something similar to the following
output.
4492 ? S 0:00 apcmain -f /etc/apcupsd/apcupsd.conf
4496 ? S 0:00 \_ apcser -f /etc/apcupsd/apcupsd.conf
4497 ? S 0:00 \_ apcnis -f /etc/apcupsd/apcupsd.conf
This indicates that apcupsd is up and running and has started the two
(default) child processes. If you are running with the pthreaded version,
now the default, and 2.4.x kernels, you will still see the three processes (see
below). However, under 2.6.x kernels, the threads do not have independent
process ids so everything will be compressed into a single ps line.
apcmain is the main program that waits until it receives a termination
signal (SIGTERM) or one of the child processes dies.
apcser is the process that manages the serial port and takes any actions
(generates events) that are necessary as a result of a change of state
of the UPS.
apcnis is the Network information server process that provides EVENTS
and STATUS information over the network. This information is used
by the CGI programs.
If you are running on a non-Linux system, or using pthreads on a Linux
system (recommended), your output will probably not show the names of
the processes and will appear more like the following:
632 ? S 0:00 /sbin/apcupsd -f /etc/apcupsd/apcupsd.conf
841 ? S 0:00 \_ /sbin/apcupsd -f /etc/apcupsd/apcupsd.conf
842 ? S 0:00 \_ /sbin/apcupsd -f /etc/apcupsd/apcupsd.conf
If you see only one instance of apcupsd running, don’t worry about it as this
is normal on most non-Linux systems, and on Linux 2.6.x kernels.
If you do not find that apcupsd is in the above list, the most likely problem
is a configuration file glitch. If no messages were printed, you should check
your system log (normally /var/log/messages where you will find one or
messages indicating the nature of the problem.
59










