User's Manual UPS control system
Table Of Contents
- Apcupsd User's Manual
- Release Notes
- How To Use This Manual
- Basic User's Guide
- Planning Your Installation
- Building and Installing apcupsd
- After Installation
- Configuration Examples
- Testing Apcupsd
- Troubleshooting Your Installation
- Monitoring and Tuning your UPS
- Maintaining Your UPS
- Frequently-Asked Questions
- Apcupsd Bugs
- Advanced topics
- Customizing Event Handling
- Master/Slave Configurations
- Controlling Multiple UPSes on one Machine
- Support for SNMP UPSes
- Alternate Ways To Run The Network Information Server
- apcupsd System Logging
- Installation: Windows
- Windows Version of apcupsd
- 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
- Troubleshooting Serial Line communications
- Recalibrating the UPS Runtime
- DATA Logging
- Technical Reference
- Configuration Directive Reference
- apcupsd Status Logging
- Shutown Sequence and its Discontents
- APC smart protocol
- Apcupsd --- RPM Packaging FAQ
- Credits
- Kernel Config
and means that the default values do not generate annoy messages:
KES).
Note that if NOLOGON is set to disable the annoy messages will
also be disabled.
ANNOYDELAY <time in seconds> Specify delay time in seconds
before apcupsd begins requesting logged in users to get off the system
during a power failure. This timer starts only after the UPS is running
on batteries. This timer is reset when the power returns. The default
is 60 seconds. Thus, the first warning to log off the system occurs
after 60 seconds on batteries, assuming that NOLOGON is not set
to disable.
NOLOGON <specifies when apcupsd should prevent user logins>
[ disable — timeout — percent — minutes — always ] are valid types.
The type specified allows you define the point when apcupsd will create
the /etc/nologin file and thus when user logins are prohibited. Once
the /etc/nologin file is created, normal users are prevented from log-
ging in. Control of when this file is created is important for allowing
systems with big UPSes to run as normally until the system adminis-
trator determines the need for preventing user logins. The feature also
allows the system administrator to hold the “ANNOY” factor until the
/etc/nologin file is created. The default is always if no NOLOGON
directive is specified.
As far as I can tell, the only useful types are disable and always since
the difference in the time when the logout warning is given and shut-
down occurs for the other types is very short (KES).
disable prevents apcupsd from creating the nologin file. Conse-
quently, any user can login during a power failure condition. Also,
the ANNOY feature is disabled so users will not be warned to lo-
goff the system.
timeout specifies that apcupsd should prohibit logins after the UPS
is on batteries for 90% of the time specified on the TIMEOUT
configuration directive. Note! Normally you don’t want to specify
a TIMEOUT value, so this option is probably not too useful
(KES).
percent specifies that apcupsd should prohibit logins when the re-
maining battery charge percentage reaches 110% or less than the
value specified on the BATTERYLEVEL configuration direc-
tive. Thus if the BATTERYLEVEL is specified as 15, apcupsd
will prohibit logins when the battery charge drops below 16%
(15% X 110% = 16%).
167










