Contents

• List of Figures
• List of Tables
• How To Use This Manual
• Basic User's Guide
• Planning Your Installation
  • Quick Start for Beginners
  
  
• Supported Operating Systems
• Supported UPSes and Cables
• Choosing a Configuration Type
• USB Configuration
  • Linux USB Configuration
  • BSD USB Configuration
  • Windows USB Configuration
  • Solaris USB Configuration
  • Mac OS X (Darwin) USB Configuration
  
  
• 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
  • A Simple USB Configuration
  • A Simple Configuration for a SmartUPS
  • A Simple Configuration for a Simple Signaling or Dumb
  • NIS Server/Client Configuration Using the Net Driver
  • PowerChute Network Shutdown Driver (PCNET)
  
  
• 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
  • Security Issues:
  • Firewall Settings
  • TCP Wrappers
  • 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
  
  
• Controlling Multiple UPSes on one Machine
  • Configuration
  
  
• Support for SNMP UPSes
  • Planning and Setup for SNMP Wiring
  • Planning and Setup for SNMP Configuration
  • Connecting APCUPSD to a SNMP UPS
  • Building with SNMP support
  • SNMP Trap Catching
  • Known Problems
  
  
• Running The Network Information Server
• apcupsd System Logging
  • Logging Types
  • Implementation Details
  • Developers Notes
  
  
• The Windows Version of apcupsd
  • Installation
  • Configuration
  • Starting Apcupsd
  • Apctray
  • Testing
  • Upgrading
  • Post Installation
  • Problem Areas
  • Email Notification of Events
  • Killpower under Windows
  • Power Down During Shutdown
  • Command Line Options Specific to the Windows Version
  
  
• 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
  • Simple-Custom Voltage-Signalling Cable for ``dumb'' UPSes
  • Custom-RJ45 Smart Signalling Cable for BackUPS CS Models
  • Other APC Cables that apcupsd Supports
  • Voltage Signalling Features Supported by Apcupsd for Various Cables
  • Voltage Signalling
  • The 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
  
  
• The 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
  • The 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
  
  
• Linux-Kernel-Info
  • Linux Kernel Config
  • Interpreting /proc/bus/usb (linux-2.4)
  • Interpreting /proc/bus/usb (linux-2.6)
  
  
• Index
• About this document ...