Page
Page
Contents
Page
Page
Page
159
164
Configuration Directives used during Power Failures 161
Configuration Directive Reference
General Configuration Directives 159
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
Not
APC Model
Upstype Upscable
UPS
USB UPS
USB
APC USB, ES USB
RS/XS
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
Microsoft Windows
Building and Installing apcupsd
Installation from Binary Packages
Red Hat Linux
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 simply see the previous section of this manual
Compilers and Options
Or for example on the Sun Solaris system, you can use
You can get a listing of all available options by doing
Alpha
Operating System Specifics
FreeBSD
Debian Build Install Procedures are Somewhat Particular
Debian
This port is complete Is operation by several users
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
After which, you can do a
After Installation
To install apcupsd, do
Checking Your Configuration File
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
Or on Windows systems with
Look at the Shutdown grace delay
Shutdown Sequence
Apctest
Page
Reconnection does not clean up the lockfile
Troubleshooting Your Installation
Known Problems with USB UPSes
Some Cheaper Models Do Not Have Battery Charge
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
Network Information Server NIS
Setting up and Testing the CGI Programs
Hid-ups and USB Specific Information
Apcupsd Network Monitoring CGI Programs
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
Master/Slave Shutdown
Master/Slave Problems
Server/Slave Networking using NIS and the NET Driver
Configuration Directives
107
Batterylevel 5 Minutes
Error Messages from a Master Configuration
Open stream socket
Error Messages from a Slave Configuration
Master/Slave Connection Not Working
Second Copy of apcupsd
Controlling Multiple UPSes on one Machine
Configuration
First Copy of apcupsd
Important Steps after Installation of the Second Copy
Support for Snmp UPSes
Connecting an Snmp UPS
Configure line
Building and Installing apcupsd
Known Problems
Snmp Specific Information
Running the server as a child of apcupsd
Alternate Ways To Run The Network Information Server
Running apcnisd from Inetd
Running apcnisd Standalome
Debug Data Status Events
Apcupsd System Logging
Logging Types
Apcupsd splits its logging into four separate types called
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
136
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
UPS DB9F
139
Voltage-Signalling Cable for dumb UPSes
Apcupsd SIMPLE-CUSTOM Cable
140
Other APC Cables that apcupsd Supports
142
Voltage Signalling
Analyses of APC Cables
Back-UPS Office 500 signals
It appears that the signals work as follows
940-0020B Cable Wiring
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
Then it will present you with the following list of choices
Using apctest on Serial-Line UPSses
On Win32 systems, use
It will present you with the following output
If you have configured your UPS as
Expected apctest Signals for a UPS
Once you have established serial communications
Troubleshooting Serial Line communications
Determining Which Voltage-Signaling Cable You Have
Expected apctest Signals for a BackUPS Pro
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
Edit it to read
Apcupsd RPM Packaging FAQ
Acknowledgements
Answers
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
Inetd
Hitrans
Hitransfer upper limit of ups batt. transfer
Hostname
Numxfers
Minlinev
MMM
Nombattv
Selftest
Percent
Sense 229
Cannot read magic from slave
SSS
Upsmode
Cannot resolve slave name 232
Xoffbatt Xonbatt XXX