Manuals / APC / Computer Equipment / Power Supply

APC UPS control system manual Your apcupsd.conf ﬁle

Models: UPS control system

1 233

Download 233 pages 42.59 Kb

Page 62

in your apcupsd.conf ﬁle.

To run the apcaccess test, use the following command:

apcaccess status

Depending on the type of UPS you have, you will get slightly diﬀerent output, but an example For a Smart-UPS is as follows:

APC	: 001,048,1088
DATE	: Fri Dec 03 16:49:24 EST 1999
HOSTNAME : daughter
RELEASE	: 3.7.2
CABLE	: APC Cable 940-0024C
MODEL	: APC Smart-UPS 600
UPSMODE	: Stand		Alone
UPSNAME	: SU600
LINEV	: 122.1		Volts
MAXLINEV : 123.3			Volts
MINLINEV : 122.1			Volts
LINEFREQ : 60.0 Hz
OUTPUTV	: 122.1		Volts
LOADPCT	:	32.7	Percent Load Capacity
BATTV	: 26.6 Volts
BCHARGE	: 095.0		Percent
MBATTCHG : 15 Percent
TIMELEFT :		19.0	Minutes
MINTIMEL : 3 Minutes
SENSE	: Medium
DWAKE	: 000 Seconds
DSHUTD	: 020 Seconds
LOTRANS	: 106.0		Volts
HITRANS	: 129.0		Volts
RETPCT	: 010.0		Percent
STATFLAG : 0x08 Status Flag
STATUS	: ONLINE
ITEMP	: 34.6 C Internal

ALARMDEL : Low Battery

LASTXFER : Unacceptable Utility Voltage Change

SELFTEST : NO

STESTI	: 336
DLOWBATT : 05 Minutes
DIPSW	: 0x00 Dip Switch
REG1	: N/A
REG2	: N/A
REG3	: 0x00 Register 3
MANDATE	: 03/30/95

SERIALNO : 13035861

BATTDATE : 05/05/98

61

Image 62

APC UPS control system manual Your apcupsd.conf ﬁle, To run the apcaccess test, use the following command

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 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 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 Or perhaps something like Where you should getYou should get 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 OpenBSDSun Solaris Red Hat SystemsSlackware 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 On Suse systems Conﬁguration ExamplesSimple USB Conﬁguration 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 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 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ﬁleApcupsd 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 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 Upgrading Installation DirectoryTesting 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 Cables144 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 BackUPS ES and CS in Serial mode with Cable 940-0128A BackOﬃce ESComputer Inside the Connector 2N2222NPN Vvvv 2OnBatt 151 Win32 Implementation Restrictions for Simple UPSesInternal Apcupsd Actions for Simple Cables 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 communicationsBizarre Intermittent Behavior Testing Apcupsd section One additional note appliesRecalibrating the UPS Runtime Status Logging On Serial-Line UPSes 162163 BackUPS and NetUPS Simple SignalsData Logging General Conﬁguration Directives Upscable type of cable you are usingTechnical Reference Conﬁguration Directive Reference 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 184Just 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 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 204 Disclaimer no WarrantyProject Discussions Apcupsd Mailing List 205 Kernel ConﬁgTypical USB section of a .conﬁg ﬁle might be 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 Extbatts FAQEprom Hostname HitransHitransfer upper limit of ups batt. transfer InetdNombattv MinlinevMMM NumxfersSense 229 PercentSelftest SSS Cannot read magic from slaveUPS UpsmodeXoffbatt Xonbatt XXX Cannot resolve slave name 232