Manuals / APC / Computer Equipment / Power Supply

APC UPS control system manual Multimon.cgi, Upsstats.cgi

Models: UPS control system

1 233

Download 233 pages 42.59 Kb

Page 80

multimon.cgi:

This program monitors multiple UPSes at the same time. A typical output of multimon.cgi as displayed in your Web browser might look like the following:

The machines monitored as well as the values and their col- umn headings are all conﬁgurable (see /etc/apcupsd/hosts.conf and /etc/apcupsd/multimon.conf)

upsstats.cgi:

By clicking on the system name in the multimon.cgi display, you will invoke upsstats.cgi for the speciﬁed system, which will produce a bar graph display of three of the monitored values. For example,

79

Image 80

APC UPS control system manual Multimon.cgi, Upsstats.cgi

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 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 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 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 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 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 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 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 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ﬁ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 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 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 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 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 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 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 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 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 Hitrans Hitransfer upper limit of ups batt. transferHostname InetdMinlinev MMMNombattv NumxfersSense 229 PercentSelftest SSS Cannot read magic from slaveUPS UpsmodeXoffbatt Xonbatt XXX Cannot resolve slave name 232