User's Manual UPS control system

ManualsBrandsAPC ManualsPower SupplyUPS control system

Table Of Contents

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

To start apcupsd manually (as you will probably do immediately following

the installation), enter the following:

/etc/rc.d/apcupsd start

Normally, when properly installed, apcupsd will be started and stopped au-

tomatically by your system. Unfortunately, the details are diﬀerent for each

system. Below, we give the commands for selected systems. Alternatively,

there are simple stopapcupsd and startapcupsd scripts in the examples di-

rectory, or you can modify one of the scripts in the distributions directory

to meet your needs.

To stop apcupsd you can do the following:

On Red Hat systems:

/etc/rc.d/init.d/apcupsd stop

On SUSE systems:

/etc/rc.d/apcupsd stop

Please see the Testing Apcupsd (see Testing Apcupsd) chapter for more

details on insuring that apcupsd is running properly.

Conﬁguration Examples

A Simple USB Conﬁguration

If you have a USB UPS, and you have apcupsd version 3.10.7 or higher, the

essential elements of your apcupsd.conf ﬁle should look like the following:

## apcupsd.conf v1.1 ##

UPSCABLE usb

UPSTYPE usb

DEVICE

LOCKFILE /var/lock

UPSCLASS standalone

UPSMODE disable