Manuals / APC / Computer Equipment / Power Supply

APC UPS control system manual Conﬁguration Directives used dur- ing Power Failures

Models: UPS control system

1 233

Download 233 pages 42.59 Kb

Page 226

Once you have established se- rial , 155

Troubleshooting Serial Line , 155

Communications Test , 58 Compilers and Options , 34 Conﬁg

Kernel , 200 Conﬁguration

Simple Master , 49

Simple Slave , 50

Simple USB , 47

Variation on the Master/Slave

,51

Conﬁguration , 106 Conﬁguration Directive Reference

,159

Conﬁguration Directives , 101 Conﬁguration Directives for Shar-

ing a UPS , 165 Conﬁguration Directives Used by

the Network Information Server , 160

Conﬁguration Directives used dur- ing Power Failures , 161

Conﬁguration Directives used to Control System Logging , 164

Conﬁguration Directives Used to Set the UPS EPROM , 168

Conﬁguration Examples , 47 Conﬁgurations

Master/Slave , 100

Network Problems with Mas- ter/Slave or Server/Slave

,103

Conﬁgure Options , 30 Conﬁguring Your EEPROM , 79 Connect to slave SSS failed , 104 connected , 97

Connecting a APC USB UPS to either a PC USB or Serial Port , 131

Connecting a Serial-Line UPS to a USB Port , 130

Connecting an SNMP UPS , 108 Connection

Establishing Serial Port , 150 Considerations

Windows , 181 Contributors , 197

Controlling Multiple UPSes on one Machine , 106

Conventions

RS232 Wiring and Signal , 148 Correspondence

Ioctl to RS232 , 149 Credits , 197 CUMONBATT , 174

Current Code Maintainer and Project Manager: , 197

Customizing Event Handling , 96

DATA Logging , 113, 158 DATATIME<time> , 164 DATE , 173 Description , 182 Details

Implementation , 114 Determining Which Voltage-

Signaling Cable You Have , 155

Developers Notes , 115

DEVICE <name of device> , 159 Diagram for cable hackers , 182 Diﬀerences

RS-232 , 182 Dip switch info , 188 DIPSW , 175 Directives

Conﬁguration , 101 General Conﬁguration , 159

Directory Installation , 122

disable , 162 Disclaimer , 126

225

Image 226

APC UPS control system manual Conﬁguration Directives used dur- ing Power Failures

Contents

Page Page Contents Page Page Page 159 General Conﬁguration Directives 159 Conﬁguration Directives used during Power Failures 161Conﬁguration Directive Reference 164Page List of Figures List of Tables Apcupsd User’s Manual Release Notes New FeaturesChange Log for current version Change Log for older versions Page Basic User’s Guide Planning Your Installation How To Use This ManualQuick Start for Beginners Page Supported Operating Systems, UPSes and Cables Page UPS APC ModelUpstype Upscable NotRS/XS USBAPC USB, ES USB USB UPSApcupsd Known USB Issues Conﬁguration typesMore details are provided in the following section Checking Out Your USB Subsystem Page You should get Where you should getOr perhaps something like BUS=usb, SYSFSidVendor=051d, NAME=usb/hiddev%n CON USB Dynamic MinorsCd apcupsd-source/examples make hid-ups Known Issues with BSD USB Platforms & VersionsKernel Configuration Checking UPS is Recognized by the KernelApcupsd Configuration Making Device NodesRed Hat Linux Building and Installing apcupsdInstallation from Binary Packages Microsoft WindowsInstallation from Source Verifying a Source Installation Sbin/apcupsd $ whereis apcupsd Conﬁgure Options Page Page Recommended Options for most Systems For most systems, we recommend the following optionsYou can get a listing of all available options by doing Compilers and OptionsOr for example on the Sun Solaris system, you can use Or simply see the previous section of this manualOperating System Speciﬁcs AlphaThis port is complete Is operation by several users Debian Build Install Procedures are Somewhat ParticularDebian FreeBSDNetBSD OpenBSDSlackware Red Hat SystemsSun Solaris Page Usr/ccs/bin/make install Page Eeprom com1-noprobe=true Eeprom com2-noprobe=true Windows Systems with Cygwin Installed Unknown SystemChecking Your Conﬁguration File After InstallationTo install apcupsd, do After which, you can do aArranging for Reboot on Power-Up Making sure apcupsd Is Running Simple USB Conﬁguration Conﬁguration ExamplesOn Suse systems Simple Conﬁguration for a SmartUPS Simple Conﬁguration for a Simple Signaling or Dumb Simple Master ConﬁgurationSimple Slave Conﬁguration Sample NIS Slave Conﬁguration Using the Net Driver Variation on the Master/Slave ConﬁgurationUpsmode disable Nettime After you start apcupsd, execute the following command Testing ApcupsdProcess-Status Test Apcmain Etc/apcupsd/apcupsd.conf Logging Test Apcaccess TestYou should see output that looks similar to the following To run the apcaccess test, use the following command Your apcupsd.conf ﬁleUpsiden Communications Test If you see a message to the eﬀectSimulated Power Fail Test Power failure. Running on UPS batteries When it is commented out, it looks like System Shutdown TestFull Power Down Test Apctest Look at the Shutdown grace delayShutdown Sequence Or on Windows systems withPage Some Cheaper Models Do Not Have Battery Charge Troubleshooting Your InstallationKnown Problems with USB UPSes Reconnection does not clean up the lockﬁlePower Oﬀ killpower of UPS Does Not Work Monitoring and Tuning your UPSApcupsd Cannot Reconnect After a Reboot Your apcupsd.conf ﬁle Apcaccess status ApcaccessAs mentioned above, the full form of the command is For a SmartUPS 1000 apcaccess will emit the following output Apcaccess eprom Apcupsd Notiﬁcation and Events LotransferApcupsd Network Monitoring CGI Programs Setting up and Testing the CGI ProgramsHid-ups and USB Speciﬁc Information Network Information Server NISMultimon.cgi Visit TH COLSPAN=10 BGCOLOR=#60B0B0Multimon.cgi Upsstats.cgiUpsfstatus.cgi Working Example Client Test Program Then execute itTip from Carl Erhorn for Sun Systems Http//hostname8888/cgi/multimon.cgiSecurity Issues CreditsConﬁguring Your Eeprom Apcupsd No Longer Conﬁgures EepromUsing apctest to Conﬁgure 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 Here is a link to the APC Battery Store Frequently-Asked QuestionsPage Page Ls /dev Device /dev/com2 Netserver on Apcupsd Bugs Advanced topics Customizing Event HandlingApccontrol Command Line Options Page 104 Master/Slave Conﬁgurations Conﬁguration Directives Master/Slave ProblemsServer/Slave Networking using NIS and the NET Driver Master/Slave ShutdownBatterylevel 5 Minutes 107Error Messages from a Master Conﬁguration 108Error Messages from a Slave Conﬁguration Open stream socketMaster/Slave Connection Not Working First Copy of apcupsd Controlling Multiple UPSes on one MachineConﬁguration Second Copy of apcupsdImportant Steps after Installation of the Second Copy Connecting an Snmp UPS Support for Snmp UPSesSnmp Speciﬁc Information Building and Installing apcupsdKnown Problems Conﬁgure lineAlternate Ways To Run The Network Information Server Running the server as a child of apcupsdRunning apcnisd from Inetd Running apcnisd Standalome Apcupsd splits its logging into four separate types called Apcupsd System LoggingLogging Types Debug Data Status EventsImplementation Details Developers Notes First as root, you create the named pipeInstallation Windows Windows Version of apcupsd InstallationPage Page Page Cd c\apcupsd\bin apcupsd /service Page Testing Installation DirectoryUpgrading 128 Post Installation Problem AreasUtility Functions Disclaimer Killpower under Windows Email Notiﬁcation of EventsPower Down During Shutdown Found under the keyCommand Line Options Speciﬁc to the Windows Version Building the Win32 Version from the SourceConnecting a Serial-Line UPS to a USB Port Smart-Custom Cable for SmartUPSes Connecting a APC USB UPS to either a PC USB or Serial PortCables 136Smart Signalling Cable for BackUPS CS Models UPS DB9F Voltage-Signalling Cable for dumb UPSes 139140 Apcupsd SIMPLE-CUSTOM CableOther APC Cables that apcupsd Supports Voltage Signalling 142940-0020B Cable Wiring Back-UPS Oﬃce 500 signalsIt appears that the signals work as follows Analyses of APC CablesThanks to Lazar M. Fleysher 940-0020C Cable Wiring144 940-0095A Cable Wiring 940-0023A Cable Wiring145 Shutdown 940-0119A Cable Wiring 940-0095B Cable Wiring147 BackUPS ES and CS in Serial mode with Cable 940-0128A BackOﬃce ESComputer Inside the Connector 2N2222NPN Vvvv 2OnBatt Internal Apcupsd Actions for Simple Cables Win32 Implementation Restrictions for Simple UPSes151 152 RS232 Wiring and Signal Conventions Testing Serial-Line UPSes Ioctl to RS232 CorrespondenceEstablishing Serial Port Connection 156 Page It will present you with the following output Using apctest on Serial-Line UPSsesOn Win32 systems, use Then it will present you with the following list of choicesExpected apctest Signals for a UPS If you have conﬁgured your UPS asExpected apctest Signals for a BackUPS Pro Troubleshooting Serial Line communicationsDetermining Which Voltage-Signaling Cable You Have Once you have established serial communicationsRecalibrating the UPS Runtime Testing Apcupsd section One additional note appliesBizarre Intermittent Behavior Status Logging On Serial-Line UPSes 162Data Logging BackUPS and NetUPS Simple Signals163 Technical Reference Conﬁguration Directive Reference Upscable type of cable you are usingGeneral Conﬁguration Directives Page Conﬁguration Directives used during Power Failures 166Page Page Conﬁguration Directives used to Control System Logging Conﬁguration Directives for Sharing a UPS Upsmode disable share net sharenet are valid types We recommend that the machine names used on the Master 172 Conﬁguration Directives Used to Set the UPS Eprom Sensitivity sets sensitivity level High, Medium, LowPage Apcupsd Status Logging Status report formatStatus Report Example 176177 Status Report Fields Page Page Shutown Sequence and its Discontents Page Apcaccess eeprom Output should look something like the following 184Master/Slave Shutdown Shutdown ProblemsJust after the line that reads Startup APC smart protocolWindows Considerations Description Diagram for cable hackersRS-232 diﬀerences SMART-UPS Smart ProtocolBelow BYE Low battery only, N = no alarm DEL ClearIs unable to transfer VACDip switch info Status bitsAlert messages Register RegisterInterpretation of the Old Firmware Revision 196Interpretation of the New Firmware Revision Eeprom Values198 On OFFProgramming the UPS Eeprom Answers Apcupsd RPM Packaging FAQAcknowledgements Edit it to readSpec ﬁle directly or pass it to rpmbuild on the command line 201Credits ContributorsApcupsd Support and Knowledge Base Brian Schau Brian.Schau Project Discussions Apcupsd Mailing List Disclaimer no Warranty204 Typical USB section of a .conﬁg ﬁle might be Kernel Conﬁg205 206 Interpretation of /proc/usb info on 2.4 kernels 207208 USB209 210 211 212 213 214 Interpretation of /proc/bus/usb info on 2.6 kernels 215216 217 218 219 220 221 222 Index Back-UPS Oﬃce 500 signals , 138 Bad APC magic from master Conﬁguration Directives used dur- ing Power Failures Eprom FAQExtbatts Hostname HitransHitransfer upper limit of ups batt. transfer InetdNombattv MinlinevMMM NumxfersSelftest PercentSense 229 SSS Cannot read magic from slaveUPS UpsmodeXoffbatt Xonbatt XXX Cannot resolve slave name 232