Manuals / APC / Computer Equipment / Power Supply

APC UPS control system manual Credits, Contributors

Models: UPS control system

1 233

Download 233 pages 42.59 Kb

Page 203

in your home directory (or edit the ﬁle if it already exists) and add the following line:

%_topdir /home/myuser/redhat

Credits

The success of apcupsd is due to the many people that helped in develop- ment, testing and in many other ways.

Thank all the developers that worked hard to make APCUPSDone of the best piece of software for UPSmanagement.

Contributors

Current Code Maintainer and Project Manager: Kern Sibbald (kern at sibbald dot com)

RPM Packager: D. Scott Barninger (barninger at fairﬁeldcomputers dot com)

Super USB bug ﬁxer: Adam Kropelin (akropel1 at rochester dot rr dot com)

CGI and HTML ﬁxer: William King (wrking at dadaboom dot com)

Project Starter and Former Code Maintainer: Andre Hedrick (andre at linux-ide.org)

Former Code Maintainer and Project Manager: Riccardo Facchetti (riccardo at master.oasi.gpa.it)

Serial Communications: Andre Hedrick (andre at linux-ide.org)

2.0User’s Manual: Eric S. Raymond (esr at thyrsus.com)

Alpha Port: Kern Sibbald (kern at sibbald dot com)

J. Rochate (jrochate at ualg.pt) testing and machine loan

202

Image 203

APC UPS control system manual Credits, Contributors

Contents

Page Page Contents Page Page Page 159 164 Conﬁguration Directives used during Power Failures 161Conﬁguration Directive Reference General Conﬁguration Directives 159Page List of Figures List of Tables Change Log for current version New FeaturesApcupsd User’s Manual Release Notes Change Log for older versions Page Quick Start for Beginners How To Use This ManualBasic User’s Guide Planning Your Installation Page Supported Operating Systems, UPSes and Cables Page Not APC ModelUpstype Upscable UPSUSB UPS USBAPC USB, ES USB RS/XSConﬁguration types Apcupsd Known USB IssuesMore details are provided in the following section Checking Out Your USB Subsystem Page Or perhaps something like Where you should getYou should get BUS=usb, SYSFSidVendor=051d, NAME=usb/hiddev%n USB Dynamic Minors CONCd apcupsd-source/examples make hid-ups Platforms & Versions Known Issues with BSD USBChecking UPS is Recognized by the Kernel Kernel ConfigurationMaking Device Nodes Apcupsd ConfigurationMicrosoft Windows Building and Installing apcupsdInstallation from Binary Packages Red Hat LinuxInstallation from Source Verifying a Source Installation Sbin/apcupsd $ whereis apcupsd Conﬁgure Options Page Page For most systems, we recommend the following options Recommended Options for most SystemsOr simply see the previous section of this manual Compilers and OptionsOr for example on the Sun Solaris system, you can use You can get a listing of all available options by doingAlpha Operating System SpeciﬁcsFreeBSD Debian Build Install Procedures are Somewhat ParticularDebian This port is complete Is operation by several usersOpenBSD NetBSDSun Solaris Red Hat SystemsSlackware Page Usr/ccs/bin/make install Page Eeprom com1-noprobe=true Eeprom com2-noprobe=true Unknown System Windows Systems with Cygwin InstalledAfter which, you can do a After InstallationTo install apcupsd, do Checking Your Conﬁguration FileArranging for Reboot on Power-Up Making sure apcupsd Is Running On Suse systems Conﬁguration ExamplesSimple USB Conﬁguration Simple Conﬁguration for a SmartUPS Simple Master Conﬁguration Simple Conﬁguration for a Simple Signaling or DumbSimple Slave Conﬁguration Variation on the Master/Slave Conﬁguration Sample NIS Slave Conﬁguration Using the Net DriverUpsmode disable Nettime Process-Status Test Testing ApcupsdAfter you start apcupsd, execute the following command Apcmain Etc/apcupsd/apcupsd.conf You should see output that looks similar to the following Apcaccess TestLogging Test Your apcupsd.conf ﬁle To run the apcaccess test, use the following commandUpsiden If you see a message to the eﬀect Communications TestSimulated Power Fail Test Power failure. Running on UPS batteries System Shutdown Test When it is commented out, it looks likeFull Power Down Test Or on Windows systems with Look at the Shutdown grace delayShutdown Sequence ApctestPage Reconnection does not clean up the lockﬁle Troubleshooting Your InstallationKnown Problems with USB UPSes Some Cheaper Models Do Not Have Battery ChargeApcupsd Cannot Reconnect After a Reboot Monitoring and Tuning your UPSPower Oﬀ killpower of UPS Does Not Work As mentioned above, the full form of the command is ApcaccessYour apcupsd.conf ﬁle Apcaccess status For a SmartUPS 1000 apcaccess will emit the following output Apcaccess eprom Lotransfer Apcupsd Notiﬁcation and EventsNetwork Information Server NIS Setting up and Testing the CGI ProgramsHid-ups and USB Speciﬁc Information Apcupsd Network Monitoring CGI ProgramsMultimon.cgi TH COLSPAN=10 BGCOLOR=#60B0B0 VisitUpsstats.cgi Multimon.cgiUpsfstatus.cgi Then execute it Working Example Client Test ProgramHttp//hostname8888/cgi/multimon.cgi Tip from Carl Erhorn for Sun SystemsCredits Security IssuesApcupsd No Longer Conﬁgures Eeprom Conﬁguring Your 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 Frequently-Asked Questions Here is a link to the APC Battery StorePage Page Ls /dev Device /dev/com2 Netserver on Advanced topics Customizing Event Handling Apcupsd BugsApccontrol Command Line Options Page 104 Master/Slave Conﬁgurations Master/Slave Shutdown Master/Slave ProblemsServer/Slave Networking using NIS and the NET Driver Conﬁguration Directives107 Batterylevel 5 Minutes108 Error Messages from a Master ConﬁgurationOpen stream socket Error Messages from a Slave ConﬁgurationMaster/Slave Connection Not Working Second Copy of apcupsd Controlling Multiple UPSes on one MachineConﬁguration First Copy of apcupsdImportant Steps after Installation of the Second Copy Support for Snmp UPSes Connecting an Snmp UPSConﬁgure line Building and Installing apcupsdKnown Problems Snmp Speciﬁc InformationRunning the server as a child of apcupsd Alternate Ways To Run The Network Information ServerRunning apcnisd from Inetd Running apcnisd Standalome Debug Data Status Events Apcupsd System LoggingLogging Types Apcupsd splits its logging into four separate types calledImplementation Details First as root, you create the named pipe Developers NotesInstallation Installation Windows Windows Version of apcupsdPage Page Page Cd c\apcupsd\bin apcupsd /service Page Upgrading Installation DirectoryTesting 128 Problem Areas Post InstallationUtility Functions Disclaimer Email Notiﬁcation of Events Killpower under WindowsFound under the key Power Down During ShutdownBuilding the Win32 Version from the Source Command Line Options Speciﬁc to the Windows VersionConnecting a Serial-Line UPS to a USB Port 136 Connecting a APC USB UPS to either a PC USB or Serial PortCables Smart-Custom Cable for SmartUPSesSmart Signalling Cable for BackUPS CS Models UPS DB9F 139 Voltage-Signalling Cable for dumb UPSesApcupsd SIMPLE-CUSTOM Cable 140Other APC Cables that apcupsd Supports 142 Voltage SignallingAnalyses of APC Cables Back-UPS Oﬃce 500 signalsIt appears that the signals work as follows 940-0020B Cable Wiring144 940-0020C Cable WiringThanks to Lazar M. Fleysher 145 940-0023A Cable Wiring940-0095A Cable Wiring Shutdown 147 940-0095B Cable Wiring940-0119A Cable Wiring BackOﬃce ES BackUPS ES and CS in Serial mode with Cable 940-0128AComputer Inside the Connector 2N2222NPN Vvvv 2OnBatt 151 Win32 Implementation Restrictions for Simple UPSesInternal Apcupsd Actions for Simple Cables 152 RS232 Wiring and Signal Conventions Ioctl to RS232 Correspondence Testing Serial-Line UPSesEstablishing Serial Port Connection 156 Page Then it will present you with the following list of choices Using apctest on Serial-Line UPSsesOn Win32 systems, use It will present you with the following outputIf you have conﬁgured your UPS as Expected apctest Signals for a UPSOnce you have established serial communications Troubleshooting Serial Line communicationsDetermining Which Voltage-Signaling Cable You Have Expected apctest Signals for a BackUPS ProBizarre Intermittent Behavior Testing Apcupsd section One additional note appliesRecalibrating the UPS Runtime 162 Status Logging On Serial-Line UPSes163 BackUPS and NetUPS Simple SignalsData Logging General Conﬁguration Directives Upscable type of cable you are usingTechnical Reference Conﬁguration Directive Reference Page 166 Conﬁguration Directives used during Power FailuresPage 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 Sensitivity sets sensitivity level High, Medium, Low Conﬁguration Directives Used to Set the UPS EpromPage Status report format Apcupsd Status Logging176 Status Report Example177 Status Report Fields Page Page Shutown Sequence and its Discontents Page Apcaccess eeprom 184 Output should look something like the followingJust after the line that reads Shutdown ProblemsMaster/Slave Shutdown Windows Considerations APC smart protocolStartup RS-232 diﬀerences Diagram for cable hackersDescription Below Smart ProtocolSMART-UPS BYE Low battery only, N = no alarm Clear DELVAC Is unable to transferStatus bits Dip switch infoAlert messages Register Register196 Interpretation of the Old Firmware RevisionEeprom Values Interpretation of the New Firmware RevisionOn OFF 198Programming the UPS Eeprom Edit it to read Apcupsd RPM Packaging FAQAcknowledgements Answers201 Spec ﬁle directly or pass it to rpmbuild on the command lineContributors CreditsApcupsd Support and Knowledge Base Brian Schau Brian.Schau 204 Disclaimer no WarrantyProject Discussions Apcupsd Mailing List 205 Kernel ConﬁgTypical USB section of a .conﬁg ﬁle might be 206 207 Interpretation of /proc/usb info on 2.4 kernelsUSB 208209 210 211 212 213 214 215 Interpretation of /proc/bus/usb info on 2.6 kernels216 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 Extbatts FAQEprom Inetd HitransHitransfer upper limit of ups batt. transfer HostnameNumxfers MinlinevMMM NombattvSense 229 PercentSelftest Cannot read magic from slave SSSUpsmode UPSCannot resolve slave name 232 Xoffbatt Xonbatt XXX