APC UPS control system User Manual

APC Tools

Apcupsd is a UPS control system that permits orderly

shutdown of your computer in the event of a power failure.

Kern Sibbald

April 3, 2005

This manual documents apcupsd version 3.10.17

Table of contents

Document Outline

Apcupsd User's Manual
Release Notes
- New Features
How To Use This Manual
Basic User's Guide
Planning Your Installation
- Quick Start for Beginners
- Supported Operating Systems, UPSes and Cables
- Apcupsd Known USB Issues
- Checking Out Your USB Subsystem
Building and Installing apcupsd
- Installation from Binary Packages
- Installation from Source
- Verifying a Source Installation
- Configure Options
- Recommended Options for most Systems
- Compilers and Options
- Operating System Specifics
After Installation
- Checking Your Configuration File
- Arranging for Reboot on Power-Up
- Making sure apcupsd Is Running
Configuration Examples
- Simple USB Configuration
- Simple Configuration for a SmartUPS
- Simple Configuration for a Simple Signaling or Dumb
- Simple Master Configuration
- Simple Slave Configuration
- Variation on the Master/Slave Configuration
- Sample NIS Slave Configuration Using the Net Driver
Testing Apcupsd
- Process-Status Test
- Logging Test
- apcaccess Test
- Communications Test
- Simulated Power Fail Test
- System Shutdown Test
- Full Power Down Test
- Shutdown Sequence
- apctest
Troubleshooting Your Installation
- Known Problems with USB UPSes
Monitoring and Tuning your UPS
- apcaccess
- Apcupsd Notification and Events
- hid-ups and USB Specific Information
- apcupsd Network Monitoring (CGI) Programs
- Setting up and Testing the CGI Programs
- Configuring Your EEPROM
Maintaining Your UPS
- What Various People Have to Say about Batteries
- Where Carl Suggests You Get Batteries
Frequently-Asked Questions
Apcupsd Bugs
Advanced topics
Customizing Event Handling
- apccontrol Command Line Options
Master/Slave Configurations
- Configuration Directives
- Master/Slave Problems
- Network Problems with Master/Slave or Server/Slave Configurations
Controlling Multiple UPSes on one Machine
- Configuration
Support for SNMP UPSes
- Connecting an SNMP UPS
- Building and Installing apcupsd
- SNMP Specific Information
- Known Problems
Alternate Ways To Run The Network Information Server
- Running the server as a child of apcupsd
- Running apcnisd from INETD
- Running apcnisd Standalome
apcupsd System Logging
- Logging Types
- Implementation Details
- Developers Notes
Installation: Windows
Windows Version of apcupsd
- Installation
- Installation Directory
- Testing
- Upgrading
- Post Installation
- Problem Areas
- Utility Functions
- Disclaimer
- Email Notification of Events
- Killpower under Windows
- Power Down During Shutdown
- Command Line Options Specific to the Windows Version
- Building the Win32 Version from the Source
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
- Establishing Serial Port Connection
- Using apctest on Serial-Line UPSses
Troubleshooting Serial Line communications
- Determining Which Voltage-Signaling Cable You Have
- Once you have established serial communications
Recalibrating the UPS Runtime
- Status Logging On Serial-Line UPSes
DATA Logging
Technical Reference
Configuration Directive Reference
- General Configuration Directives
- Configuration Directives Used by the Network Information Server
- Configuration Directives used during Power Failures
- Configuration Directives used to Control System Logging
- Configuration Directives for Sharing a UPS
- Configuration Directives Used to Set the UPS EPROM
apcupsd Status Logging
- Status report format
- Status Report Example
- Status Report Fields
- Logging the STATUS Information
Shutown Sequence and its Discontents
- Shutdown Sequence
- Shutdown Problems
- Master/Slave Shutdown
- Startup
- Windows Considerations
APC smart protocol
- Description
- RS-232 differences
- Diagram for cable hackers
- Smart Protocol
- Dip switch info
- Status bits
- Alert messages
- Register 1
- Register 2
- Register 3
- Interpretation of the Old Firmware Revision
- Interpretation of the New Firmware Revision
- EEPROM Values
- Programming the UPS EEPROM
- Acknowledgements
Apcupsd --- RPM Packaging FAQ
- Answers
Credits
- Contributors
- Disclaimer: NO WARRANTY
Kernel Config