Page
Page
Contents
Page
Page
Page
159
Configuration Directive Reference
Configuration Directives used during Power Failures 161
General Configuration Directives 159
164
Page
List of Figures
List of Tables
Apcupsd User’s Manual Release Notes
New Features
Change Log for current version
Change Log for older versions
Page
Basic User’s Guide Planning Your Installation
How To Use This Manual
Quick Start for Beginners
Page
Supported Operating Systems, UPSes and Cables
Page
Upstype Upscable
APC Model
UPS
Not
APC USB, ES USB
USB
RS/XS
USB UPS
Configuration types
Apcupsd Known USB Issues
More details are provided in the following section
Checking Out Your USB Subsystem
Page
You should get
Where you should get
Or perhaps something like
BUS=usb, SYSFSidVendor=051d, NAME=usb/hiddev%n
USB Dynamic Minors
CON
Cd apcupsd-source/examples make hid-ups
Platforms & Versions
Known Issues with BSD USB
Checking UPS is Recognized by the Kernel
Kernel Configuration
Making Device Nodes
Apcupsd Configuration
Installation from Binary Packages
Building and Installing apcupsd
Red Hat Linux
Microsoft Windows
Installation from Source
Verifying a Source Installation
Sbin/apcupsd $ whereis apcupsd
Configure Options
Page
Page
For most systems, we recommend the following options
Recommended Options for most Systems
Or for example on the Sun Solaris system, you can use
Compilers and Options
You can get a listing of all available options by doing
Or simply see the previous section of this manual
Alpha
Operating System Specifics
Debian
Debian Build Install Procedures are Somewhat Particular
This port is complete Is operation by several users
FreeBSD
OpenBSD
NetBSD
Slackware
Red Hat Systems
Sun Solaris
Page
Usr/ccs/bin/make install
Page
Eeprom com1-noprobe=true Eeprom com2-noprobe=true
Unknown System
Windows Systems with Cygwin Installed
To install apcupsd, do
After Installation
Checking Your Configuration File
After which, you can do a
Arranging for Reboot on Power-Up
Making sure apcupsd Is Running
Simple USB Configuration
Configuration Examples
On Suse systems
Simple Configuration for a SmartUPS
Simple Master Configuration
Simple Configuration for a Simple Signaling or Dumb
Simple Slave Configuration
Variation on the Master/Slave Configuration
Sample NIS Slave Configuration Using the Net Driver
Upsmode disable Nettime
After you start apcupsd, execute the following command
Testing Apcupsd
Process-Status Test
Apcmain Etc/apcupsd/apcupsd.conf
Logging Test
Apcaccess Test
You should see output that looks similar to the following
Your apcupsd.conf file
To run the apcaccess test, use the following command
Upsiden
If you see a message to the effect
Communications Test
Simulated Power Fail Test
Power failure. Running on UPS batteries
System Shutdown Test
When it is commented out, it looks like
Full Power Down Test
Shutdown Sequence
Look at the Shutdown grace delay
Apctest
Or on Windows systems with
Page
Known Problems with USB UPSes
Troubleshooting Your Installation
Some Cheaper Models Do Not Have Battery Charge
Reconnection does not clean up the lockfile
Power Off killpower of UPS Does Not Work
Monitoring and Tuning your UPS
Apcupsd Cannot Reconnect After a Reboot
Your apcupsd.conf file Apcaccess status
Apcaccess
As mentioned above, the full form of the command is
For a SmartUPS 1000 apcaccess will emit the following output
Apcaccess eprom
Lotransfer
Apcupsd Notification and Events
Hid-ups and USB Specific Information
Setting up and Testing the CGI Programs
Apcupsd Network Monitoring CGI Programs
Network Information Server NIS
Multimon.cgi
TH COLSPAN=10 BGCOLOR=#60B0B0
Visit
Upsstats.cgi
Multimon.cgi
Upsfstatus.cgi
Then execute it
Working Example Client Test Program
Http//hostname8888/cgi/multimon.cgi
Tip from Carl Erhorn for Sun Systems
Credits
Security Issues
Apcupsd No Longer Configures Eeprom
Configuring Your Eeprom
Using apctest to Configure Your Eeprom
Select function number Doing prepdevice
Maintaining Your UPS
What Various People Have to Say about Batteries
Kind of cool
Andre Hedrick Linux ATA Development
Page
Page
Page
Where Carl Suggests You Get Batteries
Frequently-Asked Questions
Here is a link to the APC Battery Store
Page
Page
Ls /dev
Device /dev/com2
Netserver on
Advanced topics Customizing Event Handling
Apcupsd Bugs
Apccontrol Command Line Options
Page
104
Master/Slave Configurations
Server/Slave Networking using NIS and the NET Driver
Master/Slave Problems
Configuration Directives
Master/Slave Shutdown
107
Batterylevel 5 Minutes
Error Messages from a Master Configuration
Open stream socket
Error Messages from a Slave Configuration
Master/Slave Connection Not Working
Configuration
Controlling Multiple UPSes on one Machine
First Copy of apcupsd
Second Copy of apcupsd
Important Steps after Installation of the Second Copy
Support for Snmp UPSes
Connecting an Snmp UPS
Known Problems
Building and Installing apcupsd
Snmp Specific Information
Configure line
Running the server as a child of apcupsd
Alternate Ways To Run The Network Information Server
Running apcnisd from Inetd
Running apcnisd Standalome
Logging Types
Apcupsd System Logging
Apcupsd splits its logging into four separate types called
Debug Data Status Events
Implementation Details
First as root, you create the named pipe
Developers Notes
Installation
Installation Windows Windows Version of apcupsd
Page
Page
Page
Cd c\apcupsd\bin apcupsd /service
Page
Testing
Installation Directory
Upgrading
128
Problem Areas
Post Installation
Utility Functions
Disclaimer
Email Notification of Events
Killpower under Windows
Found under the key
Power Down During Shutdown
Building the Win32 Version from the Source
Command Line Options Specific to the Windows Version
Connecting a Serial-Line UPS to a USB Port
Cables
Connecting a APC USB UPS to either a PC USB or Serial Port
Smart-Custom Cable for SmartUPSes
136
Smart Signalling Cable for BackUPS CS Models
UPS DB9F
139
Voltage-Signalling Cable for dumb UPSes
Apcupsd SIMPLE-CUSTOM Cable
140
Other APC Cables that apcupsd Supports
142
Voltage Signalling
It appears that the signals work as follows
Back-UPS Office 500 signals
940-0020B Cable Wiring
Analyses of APC Cables
Thanks to Lazar M. Fleysher
940-0020C Cable Wiring
144
940-0095A Cable Wiring
940-0023A Cable Wiring
145
Shutdown
940-0119A Cable Wiring
940-0095B Cable Wiring
147
BackOffice ES
BackUPS ES and CS in Serial mode with Cable 940-0128A
Computer Inside the Connector
2N2222NPN Vvvv 2OnBatt
Internal Apcupsd Actions for Simple Cables
Win32 Implementation Restrictions for Simple UPSes
151
152
RS232 Wiring and Signal Conventions
Ioctl to RS232 Correspondence
Testing Serial-Line UPSes
Establishing Serial Port Connection
156
Page
On Win32 systems, use
Using apctest on Serial-Line UPSses
It will present you with the following output
Then it will present you with the following list of choices
If you have configured your UPS as
Expected apctest Signals for a UPS
Determining Which Voltage-Signaling Cable You Have
Troubleshooting Serial Line communications
Expected apctest Signals for a BackUPS Pro
Once you have established serial communications
Recalibrating the UPS Runtime
Testing Apcupsd section One additional note applies
Bizarre Intermittent Behavior
162
Status Logging On Serial-Line UPSes
Data Logging
BackUPS and NetUPS Simple Signals
163
Technical Reference Configuration Directive Reference
Upscable type of cable you are using
General Configuration Directives
Page
166
Configuration Directives used during Power Failures
Page
Page
Configuration Directives used to Control System Logging
Configuration Directives for Sharing a UPS
Upsmode disable share net sharenet are valid types
We recommend that the machine names used on the Master 172
Sensitivity sets sensitivity level High, Medium, Low
Configuration Directives Used to Set the UPS Eprom
Page
Status report format
Apcupsd Status Logging
Status Report Example
177
Status Report Fields
Page
Page
Shutown Sequence and its Discontents
Page
Apcaccess eeprom
184
Output should look something like the following
Master/Slave Shutdown
Shutdown Problems
Just after the line that reads
Startup
APC smart protocol
Windows Considerations
Description
Diagram for cable hackers
RS-232 differences
SMART-UPS
Smart Protocol
Below
BYE
Low battery only, N = no alarm
Clear
DEL
VAC
Is unable to transfer
Status bits
Dip switch info
Alert messages
Register
196
Interpretation of the Old Firmware Revision
Eeprom Values
Interpretation of the New Firmware Revision
On OFF
198
Programming the UPS Eeprom
Acknowledgements
Apcupsd RPM Packaging FAQ
Answers
Edit it to read
201
Spec file directly or pass it to rpmbuild on the command line
Contributors
Credits
Apcupsd Support and Knowledge Base Brian Schau Brian.Schau
Project Discussions Apcupsd Mailing List
Disclaimer no Warranty
204
Typical USB section of a .config file might be
Kernel Config
205
206
207
Interpretation of /proc/usb info on 2.4 kernels
USB
208
209
210
211
212
213
214
215
Interpretation of /proc/bus/usb info on 2.6 kernels
216
217
218
219
220
221
222
Index
Back-UPS Office 500 signals , 138 Bad APC magic from master
Configuration Directives used dur- ing Power Failures
Eprom
FAQ
Extbatts
Hitransfer upper limit of ups batt. transfer
Hitrans
Hostname
Inetd
MMM
Minlinev
Nombattv
Numxfers
Selftest
Percent
Sense 229
Cannot read magic from slave
SSS
Upsmode
Cannot resolve slave name 232
Xoffbatt Xonbatt XXX