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
Change Log for current version
New Features
Apcupsd User’s Manual Release Notes
Change Log for older versions
Page
Quick Start for Beginners
How To Use This Manual
Basic User’s Guide Planning Your Installation
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
Or perhaps something like
Where you should get
You should get
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
Sun Solaris
Red Hat Systems
Slackware
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
On Suse systems
Configuration Examples
Simple USB Configuration
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
Process-Status Test
Testing Apcupsd
After you start apcupsd, execute the following command
Apcmain Etc/apcupsd/apcupsd.conf
You should see output that looks similar to the following
Apcaccess Test
Logging Test
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
Apcupsd Cannot Reconnect After a Reboot
Monitoring and Tuning your UPS
Power Off killpower of UPS Does Not Work
As mentioned above, the full form of the command is
Apcaccess
Your apcupsd.conf file Apcaccess status
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
Upgrading
Installation Directory
Testing
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
144
940-0020C Cable Wiring
Thanks to Lazar M. Fleysher
145
940-0023A Cable Wiring
940-0095A Cable Wiring
Shutdown
147
940-0095B Cable Wiring
940-0119A Cable Wiring
BackOffice ES
BackUPS ES and CS in Serial mode with Cable 940-0128A
Computer Inside the Connector
2N2222NPN Vvvv 2OnBatt
151
Win32 Implementation Restrictions for Simple UPSes
Internal Apcupsd Actions for Simple Cables
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
Bizarre Intermittent Behavior
Testing Apcupsd section One additional note applies
Recalibrating the UPS Runtime
162
Status Logging On Serial-Line UPSes
163
BackUPS and NetUPS Simple Signals
Data Logging
General Configuration Directives
Upscable type of cable you are using
Technical Reference Configuration Directive Reference
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
Just after the line that reads
Shutdown Problems
Master/Slave Shutdown
Windows Considerations
APC smart protocol
Startup
RS-232 differences
Diagram for cable hackers
Description
Below
Smart Protocol
SMART-UPS
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
204
Disclaimer no Warranty
Project Discussions Apcupsd Mailing List
205
Kernel Config
Typical USB section of a .config file might be
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
Extbatts
FAQ
Eprom
Hitransfer upper limit of ups batt. transfer
Hitrans
Hostname
Inetd
MMM
Minlinev
Nombattv
Numxfers
Sense 229
Percent
Selftest
Cannot read magic from slave
SSS
Upsmode
Cannot resolve slave name 232
Xoffbatt Xonbatt XXX