Manuals / APC / Computer Equipment / Power Supply

APC UPS control system manual Hitransfer upper limit of ups batt. transfer, Hostname, Inetd

Models: UPS control system

1 233

Download 233 pages 42.59 Kb

Page 228

Determining Which Voltage- Signaling Cable You , 155 Hid-ups and USB Speciﬁc Infor-

mation , 71

HITRANS , 174

HITRANSFER <upper limit of ups batt. transfer> , 169

HOSTNAME , 173

How do I build Apcupsd for plat- form xxx? , 195

How do I control whether usb sup- port gets built? , 196

How To Use This Manual , 9 HP-UX Port , 198 HUMIDITY , 175

I’m getting errors about not hav- ing permission when , 196

Implementation Details , 114

INETD

Running apcnisd from , 111

Info

Dip switch , 188 Information

hid-ups and USB Speciﬁc , 71 Logging the STATUS , 176 SNMP Speciﬁc , 109

Installation After , 44 Planning Your , 9 Post , 124 Troubleshooting Your , 65 Verifying a Source , 28

Installation , 116 Installation Directory , 122 Installation from Binary Packages

, 26

Installation from Source , 27 Installation: Serial-Line UPSes ,

130 Installation: Windows , 116

Internal Apcupsd Actions for Sim- ple Cables , 146

Interpretation of the New Firmware Revision , 192

Interpretation of the Old Firmware Revision , 191

Ioctl to RS232 Correspondence , 149

Issues

Apcupsd Known USB , 15 ITEMP , 174

Kernel Conﬁg , 200

KILLDELAY <time in seconds> , 164

Killpower under Windows , 127 Known Problems , 109

Known Problems with USB UPSes , 65

LASTXFER , 174

LINEFREQ , 174

LINEV , 57, 173 loadlimit , 98 LOADPCT , 173

LOCKFILE <path to lockﬁle> , 160

Logging

apcupsd Status , 170 apcupsd System , 113 Conﬁguration Directives used

to Control System , 164 DATA , 113, 158 EVENTS , 114

STATUS , 113 Logging Test , 55

Logging the STATUS Information

,176

Logging Types , 113 LOTRANS , 174 LOTRANSFER <lower limit of

ups batt. transfer> , 169

Machine

227

Image 228

APC UPS control system manual Hitransfer upper limit of ups batt. transfer, Hostname, Inetd, Lastxfer Linefreq

Contents

Page Page Contents Page Page Page 159 Conﬁguration Directives used during Power Failures 161 Conﬁguration Directive ReferenceGeneral Conﬁguration Directives 159 164Page List of Figures List of Tables New Features Apcupsd User’s Manual Release NotesChange Log for current version Change Log for older versions Page How To Use This Manual Basic User’s Guide Planning Your InstallationQuick Start for Beginners Page Supported Operating Systems, UPSes and Cables Page APC Model Upstype UpscableUPS NotUSB APC USB, ES USBRS/XS USB UPSApcupsd Known USB Issues Conﬁguration typesMore details are provided in the following section Checking Out Your USB Subsystem Page Where you should get 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 NodesBuilding and Installing apcupsd Installation from Binary PackagesRed Hat Linux 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 optionsCompilers and Options Or for example on the Sun Solaris system, you can useYou can get a listing of all available options by doing Or simply see the previous section of this manualOperating System Speciﬁcs AlphaDebian Build Install Procedures are Somewhat Particular DebianThis port is complete Is operation by several users FreeBSDNetBSD OpenBSDRed Hat Systems SlackwareSun Solaris Page Usr/ccs/bin/make install Page Eeprom com1-noprobe=true Eeprom com2-noprobe=true Windows Systems with Cygwin Installed Unknown SystemAfter Installation To install apcupsd, doChecking Your Conﬁguration File After which, you can do aArranging for Reboot on Power-Up Making sure apcupsd Is Running Conﬁguration Examples Simple USB ConﬁgurationOn 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 Testing Apcupsd After you start apcupsd, execute the following commandProcess-Status Test Apcmain Etc/apcupsd/apcupsd.conf Apcaccess Test Logging 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 Look at the Shutdown grace delay Shutdown SequenceApctest Or on Windows systems withPage Troubleshooting Your Installation Known Problems with USB UPSesSome Cheaper Models Do Not Have Battery Charge Reconnection does not clean up the lockﬁleMonitoring and Tuning your UPS Power Oﬀ killpower of UPS Does Not WorkApcupsd Cannot Reconnect After a Reboot Apcaccess Your apcupsd.conf ﬁle Apcaccess statusAs 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 LotransferSetting up and Testing the CGI Programs Hid-ups and USB Speciﬁc InformationApcupsd Network Monitoring CGI Programs 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 Master/Slave Problems Server/Slave Networking using NIS and the NET DriverConﬁguration Directives 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 Controlling Multiple UPSes on one Machine ConﬁgurationFirst Copy of apcupsd Second Copy of apcupsdImportant Steps after Installation of the Second Copy Connecting an Snmp UPS Support for Snmp UPSesBuilding and Installing apcupsd Known ProblemsSnmp Speciﬁc Information 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 System Logging Logging TypesApcupsd splits its logging into four separate types called 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 Installation Directory TestingUpgrading 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 Connecting a APC USB UPS to either a PC USB or Serial Port CablesSmart-Custom Cable for SmartUPSes 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 142Back-UPS Oﬃce 500 signals It appears that the signals work as follows940-0020B Cable Wiring Analyses of APC Cables940-0020C Cable Wiring Thanks to Lazar M. Fleysher144 940-0023A Cable Wiring 940-0095A Cable Wiring145 Shutdown 940-0095B Cable Wiring 940-0119A Cable Wiring147 BackUPS ES and CS in Serial mode with Cable 940-0128A BackOﬃce ESComputer Inside the Connector 2N2222NPN Vvvv 2OnBatt Win32 Implementation Restrictions for Simple UPSes Internal Apcupsd Actions for Simple Cables151 152 RS232 Wiring and Signal Conventions Testing Serial-Line UPSes Ioctl to RS232 CorrespondenceEstablishing Serial Port Connection 156 Page Using apctest on Serial-Line UPSses On Win32 systems, useIt will present you with the following output Then it will present you with the following list of choicesExpected apctest Signals for a UPS If you have conﬁgured your UPS asTroubleshooting Serial Line communications Determining Which Voltage-Signaling Cable You HaveExpected apctest Signals for a BackUPS Pro Once you have established serial communicationsTesting Apcupsd section One additional note applies Recalibrating the UPS RuntimeBizarre Intermittent Behavior Status Logging On Serial-Line UPSes 162BackUPS and NetUPS Simple Signals Data Logging163 Upscable type of cable you are using Technical Reference Conﬁguration Directive ReferenceGeneral 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 184Shutdown Problems Master/Slave ShutdownJust after the line that reads APC smart protocol StartupWindows Considerations Diagram for cable hackers DescriptionRS-232 diﬀerences Smart Protocol SMART-UPSBelow 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 Apcupsd RPM Packaging FAQ AcknowledgementsAnswers 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 Disclaimer no Warranty Project Discussions Apcupsd Mailing List204 Kernel Conﬁg Typical USB section of a .conﬁg ﬁle might be205 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 FAQ EpromExtbatts Hitrans Hitransfer upper limit of ups batt. transferHostname InetdMinlinev MMMNombattv NumxfersPercent SelftestSense 229 SSS Cannot read magic from slaveUPS UpsmodeXoffbatt Xonbatt XXX Cannot resolve slave name 232