DOCSLIB.ORG

Apcupsd Is a UPS Control System That Permits Orderly Shutdown of Your Computer in the Event of a Power Failure

Total Page：16

File Type：pdf, Size：1020Kb

Download full-text PDF Read full-text
Apcupsd Is a UPS Control System That Permits Orderly Shutdown of Your Computer in the Event of a Power Failure Apcupsd is a UPS control system that permits orderly shutdown of your computer in the event of a power failure. Kern Sibbald February 10, 2007 This manual documents apcupsd version 3.14.x Copyright (C) 1999-2005 Kern Sibbald Copying and distribution of this file, with or without modification, are per- mitted in any medium without royalty provided the name Apcupsd, the copyright notice, and this notice are preserved. Apcupsd source code is released under the GNU General Public License version 2. Please see the file COPYING in the main source directory. For more information on the project, please visit the main web site at http://www.apcupsd.com 1 Contents How To Use This Manual . 11 Basic User's Guide . 11 Planning Your Installation . 11 Quick Start for Beginners . 11 Supported Operating Systems . 13 Supported UPSes and Cables . 14 Choosing a Configuration Type . 16 Building and Installing apcupsd . 29 Installation from Binary Packages . 29 Installation from Source . 30 Verifying a Source Installation . 32 Configure Options . 34 Recommended Options for most Systems . 37 Compilers and Options . 37 Operating System Specifics . 38 After Installation . 46 Checking Your Configuration File . 46 Arranging for Reboot on Power-Up . 47 Making sure apcupsd Is Running . 48 2 Configuration Examples . 49 Simple USB Configuration . 49 Simple Configuration for a SmartUPS . 49 Simple Configuration for a Simple Signaling or Dumb . 50 NIS Server/Client Configuration Using the Net Driver . 51 PowerChute Network Shutdown Driver (PCNET) . 53 Testing Apcupsd . 54 Process-Status Test . 54 Logging Test . 55 apcaccess Test . 55 Communications Test . 58 Simulated Power Fail Test . 59 System Shutdown Test . 61 Full Power Down Test . 61 Shutdown Sequence . 62 apctest . 63 Troubleshooting Your Installation . 65 Known Problems with USB UPSes . 65 Monitoring and Tuning your UPS . 66 apcaccess . 66 Apcupsd Notification and Events . 69 hid-ups and USB Specific Information . 70 apcupsd Network Monitoring (CGI) Programs . 70 Setting up and Testing the CGI Programs . 71 Configuring Your EEPROM . 77 3 Maintaining Your UPS . 81 What Various People Have to Say about Batteries . 81 Where Carl Suggests You Get Batteries . 87 Frequently-Asked Questions . 89 Apcupsd Bugs . 93 Advanced topics . 94 Customizing Event Handling . 94 apccontrol Command Line Options . 95 Controlling Multiple UPSes on one Machine . 98 Configuration . 98 Support for SNMP UPSes . 100 Planning and Setup for SNMP Wiring . 100 Planning and Setup for SNMP Configuration . 101 Connecting APCUPSD to a SNMP UPS . 104 Building with SNMP support . 105 SNMP Trap Catching . 106 Known Problems . 106 Running The Network Information Server . 107 apcupsd System Logging . 108 Logging Types . 108 Implementation Details . 109 Developers Notes . 110 Windows Version of apcupsd . 110 Installation . 111 Configuration . 111 4 Starting Apcupsd . 112 Testing . 113 Upgrading . 113 Post Installation . 114 Problem Areas . 114 Disclaimer . 115 Email Notification of Events . 116 Killpower under Windows . 116 Power Down During Shutdown . 117 Command Line Options Specific to the Windows Version . 118 Building the Win32 Version from the Source . 118 Installation: Serial-Line UPSes . 119 Overview of Serial-Interface UPSes . 119 Connecting a Serial-Line UPS to a USB Port . 119 Connecting a APC USB UPS to either a PC USB or Serial Port . 120 Cables . 120 Smart-Custom Cable for SmartUPSes . 120 Voltage-Signalling Cable for "dumb" UPSes . 121 Custom-RJ45 Smart Signalling Cable for BackUPS CS Models 123 Other APC Cables that apcupsd Supports . 124 Voltage Signalling Features Supported by Apcupsd for Various Cables125 Voltage Signalling . 125 Back-UPS Office 500 signals . 126 Analyses of APC Cables . 126 Win32 Implementation Restrictions for Simple UPSes . 135 5 Internal Apcupsd Actions for Simple Cables . 135 RS232 Wiring and Signal Conventions . 136 Pin Assignment for the Serial Port (RS-232C), 25-pin and 9-pin, Female End137 Ioctl to RS232 Correspondence . 137 Testing Serial-Line UPSes . 138 Establishing Serial Port Connection . 139 Using apctest on Serial-Line UPSses . 141 Troubleshooting Serial Line communications . 144 Determining Which Voltage-Signaling Cable You Have . 144 Once you have established serial communications . 144 Recalibrating the UPS Runtime . 144 Status Logging On Serial-Line UPSes . 146 DATA Logging . 146 Technical Reference . 147 Configuration Directive Reference . 147 General Configuration Directives . 147 Configuration Directives Used by the Network Information Server148 Configuration Directives used during Power Failures . 149 Configuration Directives used to Control System Logging . 153 Configuration Directives for Sharing a UPS . 153 Configuration Directives Used to Set the UPS EPROM . 154 apcupsd Status Logging . 156 Status report format . 157 Status Report Example . 158 Status Report Fields . 159 6 Logging the STATUS Information . 162 Shutown Sequence and its Discontents . 162 Shutdown Sequence . 162 Shutdown Problems . 166 Master/Slave Shutdown . 166 Startup . 166 Windows Considerations . 167 APC smart protocol . 167 Description . 168 RS-232 differences . 168 Diagram for cable hackers . 168 Smart Protocol . 169 Dip switch info . 173 Status bits . 174 Alert messages . 174 Register 1 . 175 Register 2 . 176 Register 3 . 176 Interpretation of the Old Firmware Revision . 177 Interpretation of the New Firmware Revision . 177 EEPROM Values . 178 Programming the UPS EEPROM . 179 Acknowledgements . 180 Apcupsd | RPM Packaging FAQ . 181 Answers . 181 7 Credits . 183 Contributors . 184 Disclaimer: NO WARRANTY . 186 8 List of Figures Configuration Types . ..
Load more

Recommended publications
  • Power Monitoring Using the Raspberry Pi
    2013 ASCUE Proceedings Power monitoring using the Raspberry Pi Robin M Snyder RobinSnyder.com [email protected] http://www.robinsnyder.com Abstract The Raspberry Pi is a credit card size low powered compute board with Ethernet connection, HDMI video output, audio, full Linux operating system run from an SD card, and more, all for $45. With ca- bles, SD card, etc., the cost is about $70. Originally designed to help teach computer science principles to low income children and students, the Pi has taken on a life of its own, with many online resources and projects that cover most everything one would want to do with a small low monetary cost and low battery power computer. This paper/session will present the Raspberry Pi and provide ideas of what it can do and how one can get started using it. The author has used Pi's for Internet data acquisi- tion/monitoring, cluster processing using more than one Pi, email notifications, and power monitoring. The particular focus example will be on UPS power monitoring and status using off the shelf Open Source software. The main software for the purpose of power monitoring is NUT, Network UPS Tools, whose goal is "to provide support for Power Devices, such as Uninterruptible Power Supplies, Power Distribution Units and Solar Controllers." Some background in the theory and practice of electrical power, surge protection, uninterruptible powers supplies, etc., will be provided. Introduction The Raspberry Pi is a credit card size low powered compute board with Ethernet connection, HDMI video output, audio, full Linux operating system run from an SD card, and more, all for $45.
    [Show full text]
  • Eaton UPS Software Intelligent Power Manager Manual
    www.eaton.com Eaton Intelligent Power® Manager – User’s Guide / AL - v1.30 Page 1/125 www.eaton.com Table of Contents 1 Introduction .................................................................................................................... 8 2 Installation ...................................................................................................................... 9 2.1 Installation Prerequisites ................................................................................................................... 9 ® 2.1.1 On the System Hosting « Intelligent Power Manager » ............................................................... 9 2.1.2 On the System that Displays Web-based Graphical User Interface.............................................. 9 2.2 Quick Start & Installation .................................................................................................................. 10 2.3 Installation Result .............................................................................................................................. 14 2.4 Uninstalling the Product ................................................................................................................... 14 2.5 Upgrading the Product ...................................................................................................................... 14 2.6 Installation / Uninstallation from command line ............................................................................. 15 3 Configuration ................................................................................................................
    [Show full text]
  • LBT PROJECT 2 X 8,4M OPTICAL TELESCOPE UPS and Thermal Monitor Client System Configuration
    LBT PROJECT 2x8,4m TELESCOPE Doc.No. : 228s010 Issue : b Date : 10-May-2012 LBT PROJECT 2 X 8,4m OPTICAL TELESCOPE UPS and Thermal Monitor Client System Configuration LBT PROJECT Doc.No : 228s010 Issue : b Page 2 UPS Client System Configuration Date : 10-May-12 Signature Date Prepared Dan Cox 31-Oct-11 Reviewed Norm Cushing 05-Jan-12 Approved Joar Brynnel 05-Jan-12 LBT PROJECT Doc.No : 228s010 Issue : b Page 3 UPS Client System Configuration Date : 10-May-12 1. Revision History Issue Date Changes Responsible a 31-Oct-11 First draft Dan Cox b 10-May-12 References to “red button” replaced with Dan Cox “yellow button”; section added for testing shutdown applications. LBT PROJECT Doc.No : 228s010 Issue : b Page 4 UPS Client System Configuration Date : 10-May-12 2. Table Of Contents 1.Revision History...............................................................................................................3 2.Table Of Contents.............................................................................................................4 4.List Of Abbreviations........................................................................................................5 5.About this document.........................................................................................................6 1.1. Purpose......................................................................................................................6 1.2. Reference Documents...............................................................................................6
    [Show full text]
  • Owner's Manual
    Owner’s Manual Console Server Management Switch Models: B096-016 / B096-032 / B096-048 Console Server with PowerAlert Model: B092-016 Console Server Models: B095-004-1E / B095-003-1E-M / B094-008-2E-M-F / B094-008-2E-V PROTECT YOUR INVESTMENT! Register your product for quicker service and ultimate peace of mind. You could also win an ISOBAR6ULTRA surge protector—a $50 value! www.tripplite.com/warranty 1111 W. 35th Street, Chicago, IL 60609 USA • www.tripplite.com/support Copyright © 2014 Tripp Lite. All rights reserved. All trademarks are the property of their respective owners. 1 FCC Information, Class A This device complies with part 15 of the FCC Rules. Operation is subject to the following two conditions: (1) This device may not cause harmful interference, and (2) this device must accept any interference received, including interference that may cause undesired operation. Note: This equipment has been tested and found to comply with the limits for a Class A digital device, pursuant to part 15 of the FCC Rules. These limits are designed to provide reasonable protection against harmful interference when the equipment is operated in a commercial environment. This equipment generates, uses, and can radiate radio frequency energy and, if not installed and used in accordance with the instruction manual, may cause harmful interference to radio communications. Operation of this equipment in a residential area is likely to cause harmful interference in which case the user will be required to correct the interference at his own expense. The user must use shielded cables and connectors with this equipment.
    [Show full text]
  • Enhanced Console Server
    Enhanced Console Server ECS0016 FCC Compliance Statement This equipment has been tested and found to comply with the limits for a Class B digital de- vice, pursuant to part 15 of the FCC Rules. These limits are designed to provide reasonable protection against harmful interference in a residential installation. This equipment generates, uses and can radiate radio frequency energy and, if not installed and used in accordance with the instructions, may cause harmful interference to radio communications. However, there is no guarantee that interference will not occur in a particular installation. If this equipment does cause harmful interference to radio or television reception, which can be determined by turning the equipment off and on, the user is encouraged to try to correct the interference by one or more of the following measures: • Reorient or relocate the receiving antenna. • Increase the separation between the equipment and receiver. • Connect the equipment into an outlet on a circuit different from that to which the receiver is connected. • Consult the dealer or an experienced radio/TV technician for help. Use of Trademarks, Registered Trademarks, and other Protected Names and Symbols This manual may make reference to trademarks, registered trademarks, and other protected names and/or symbols of third-party companies not related in any way to StarTech.com. Where they occur these references are for illustrative purposes only and do not represent an endorse- ment of a product or service by StarTech.com, or an endorsement of the product(s) to which this manual applies by the third-party company in question. Regardless of any direct acknowl- edgement elsewhere in the body of this document, StarTech.com hereby acknowledges that all trademarks, registered trademarks, service marks, and other protected names and/or symbols contained in this manual and related documents are the property of their respective holders.
    [Show full text]
  • Opengear CLI and Scripting Reference.Pdf
    CLI and Scripting Reference ACM7000 Remote Site Gateway ACM7000-L Resilience Gateway IM7200 Infrastructure Manager CM7100 Console Servers Version 2.0 2019-07-23 1 Table of Contents Safety Please take care to follow the safety precautions below when installing and operating the console server: - Do not remove the metal covers. There are no operator serviceable components inside. Opening or removing the cover may expose you to dangerous voltage which may cause fire or electric shock. Refer all service to Opengear qualified personnel. - To avoid electric shock the power cord protective grounding conductor must be connected through to ground. - Always pull on the plug, not the cable, when disconnecting the power cord from the socket. Do not connect or disconnect the console server during an electrical storm. Use a surge suppressor or UPS to protect the equipment from transients. FCC Warning Statement This device complies with Part 15 of the FCC rules. Operation of this device is subject to the following conditions: (1) This device may not cause harmful interference, and (2) this device must accept any interference that may cause undesired operation. Proper back-up systems and necessary safety devices should be utilized to protect against injury, death or property damage due to system failure. Such protection is the responsibility of the user. This console server device is not approved for use as a life-support or medical system. Any changes or modifications made to this console server device without the explicit approval or consent of Opengear will void Opengear of any liability or responsibility of injury or loss caused by any malfunction.
    [Show full text]
  • Packager Guide
    NUT Packager and Integrators Guide i NUT Packager and Integrators Guide NUT Packager and Integrators Guide ii REVISION HISTORY NUMBER DATE DESCRIPTION NAME 2.7.4 2016-03-09 Current release of Network UPS Tools (NUT). 2.6.0 2011-01-14 First release of AsciiDoc documentation for Network UPS Tools (NUT). NUT Packager and Integrators Guide iii Contents 1 Introduction 1 2 Packagers involved 2 3 Possible use cases 3 4 Optimised packaging proposal 3 4.1 Overview of the package tree.............................................3 4.2 Detailed view of the package tree...........................................4 4.2.1 nut......................................................4 4.2.2 libupsclient1.................................................4 4.2.3 libupsclient1-dev...............................................5 4.2.4 nut-cgi....................................................5 4.2.5 nut-powerman-pdu..............................................5 4.2.6 nut-snmp...................................................5 4.2.7 nut-xml....................................................5 4.2.8 nut-clients...................................................6 4.2.9 python-pynut.................................................6 4.2.10 python-nut-gui................................................6 4.2.11 nut-doc....................................................6 NUT Packager and Integrators Guide iv Abstract The aim of this document is to describe the best way to package the Network UPS Tools, and the best practices across the various packaging implementation of NUT. So as to these can be spread on all supported platforms as a standard, and as a foundation block to build upon. NUT Packager and Integrators Guide 1 / 7 Warning this is a Work In Progress document. 1 Introduction Packaging is a final aim for software. It eases and completes the software integration into an OS, and allows users to have an easy software installation and support out of the box.
    [Show full text]
  • NUT - Network UPS Tools NUT - Network UPS Tools
    2021/09/26 07:37 1/7 NUT - Network UPS Tools NUT - Network UPS Tools This guide explains how to install NUT on a client / server architecture with several clients accessing the UPS. NUT Server Installation 1. Installing the nut package, should add the nut user and group. If it doesn’t, you have to add those manually. sudo apt-get install nut 2. Make the USB-Device accessible by NUT lsusb output: Bus 001 Device 002: ID 051d:0003 American Power Conversion UPS 3. Create new udev rule sudo vim /etc/udev/rules.d/90-nut-ups.rules ACTION=="add", SUBSYSTEM=="usb", ATTR{idVendor}=="051d", ATTR{idProduct}=="0003", MODE="0660", GROUP="nut" 4. Activate udevadm control --reload-rules udevadm trigger ups.conf [ups] driver = usbhid-ups port = auto pollonly desc = "ups" The label in the square brackets can be anything. It identifies the UPS to upsd and upsmon. Find your UPS model on the NUT hardware compatibility list and substitute the corresponding driver for usbhid- ups above. If your UPS isn’t listed, find similar ones. They probably use the same driver. If you have a USB-based UPS, you can leave the port as auto; it’s ignored. Note: if you are connecting a Synology NAS to your NUT setup, then the label in square brackets must be named ups. Bernard's Wiki - https://wiki.condrau.com/ 2021/09/26 07:37 2/7 NUT - Network UPS Tools Make sure that nut properly detects the UPS: # upsdrvctl start You should see something like the following: Network UPS Tools - UPS driver controller 2.2.2 Network UPS Tools: 0.29 USB communication driver - core 0.33 (2.2.2) Using subdriver: APC HID 0.92 Now, we need to configure upsd and upsmon.
    [Show full text]
  • Network UPS Tools
    Network UPS Tools Jason Healy, Director of Networks and Systems Last Updated Mar 18, 2008 2 Contents 1 Network UPS Tools5 1.1 Introduction..............................5 1.2 Suffield’s Setup............................5 1.3 Server Setup.............................6 1.3.1 Install the Software.....................6 1.3.2 Port Identification......................6 1.3.3 Configuring the UPSes....................7 1.3.4 Configuration Access Controls...............7 1.3.5 Configuring Monitoring...................9 1.3.6 Enable NUT......................... 12 1.3.7 NUT CGI........................... 12 1.4 Compiling NUT............................ 12 1.4.1 Getting the Sources..................... 13 1.4.2 Add a User.......................... 13 1.4.3 Build the Software...................... 13 1.4.4 Configure the Software.................... 14 1.4.5 Launch the Software..................... 14 1.5 Replacing Batteries.......................... 15 1.5.1 When to Replace?...................... 15 1.5.2 Replacing the Battery.................... 15 3 1.5.3 Updating the Battery Date Variables............ 15 1.5.4 Refreshing UPS Battery Data................ 15 4 Chapter 1 Network UPS Tools Last updated 2008/03/18 1.1 Introduction To prevent data loss and corruption, Suffield has several Uniterruptable Power Supplies (UPSes) that provide battery-backed power in the event of an electrical outage. Most of our UPSes have a serial port, which allows a computer running moni- toring software to receive status updates from the unit. This way, the host can shut down when the batteries of the unit run low. Because each of our UPSes have more than one server attached to them, we needed a centralized way to manage the UPSes and shut down all affected servers during an outage.
    [Show full text]
  • Network UPS Tools User Manual I
    Network UPS Tools User Manual i Network UPS Tools User Manual Network UPS Tools User Manual ii REVISION HISTORY NUMBER DATE DESCRIPTION NAME 2.7.4.1 2021-09-26 Current release of Network UPS Tools (NUT). 2.6.0 2011-01-14 First release of AsciiDoc documentation for Network UPS Tools (NUT). Network UPS Tools User Manual iii Contents 1 Introduction 1 2 Network UPS Tools Overview 1 2.1 Description......................................................1 2.2 Installing.......................................................1 2.3 Upgrading.......................................................1 2.4 Configuring and using.................................................1 2.5 Documentation....................................................1 2.6 Network Information.................................................2 2.7 Manifest........................................................2 2.8 Drivers........................................................2 2.8.1 Extra Settings.................................................3 2.8.2 Hardware Compatibility List.........................................3 2.8.3 Generic Device Drivers............................................3 2.8.4 UPS Shutdowns...............................................4 2.8.5 Power distribution unit management.....................................4 2.9 Network Server....................................................4 2.10 Monitoring client...................................................4 2.10.1 Primary....................................................5 2.10.2 Secondary...................................................5
    [Show full text]
  • APC UPS Management Under Linux
    APC UPS management under Linux Apcupsd Linux UPS daemon version 3.8.5 Apcupsd 3.8.5 User's Manual Last update to this manual 4 January 2002 Release Notes • Known Bugs • New features in Apcupsd 3.8.5 • New features in Apcupsd 3.8.4 • New features in Apcupsd 3.8.3 • Features in Previous Versions • Apcupsd License Apupsd Reference Manual • General −− Man Page • UPS Models and Cables Supported • Operating Systems Supported • Main Configuration Types • Compiling and Installing • Starting • Stopping or Restarting • Configuration Directives • Configuration Examples • Master/Slave Configuration • Cables • Testing • Shutdown Sequence • Trouble Shooting • Apcupsd Network Information Server • Apcupsd EVENTS • Apcupsd STATUS • Apcupsd DATA • Apcupsd System Logging • The CGI Network Interface • apcaccess • apctest • Configuring your EEPROM • UPS Programming Bible • Apcupsd under Windows 98 and Windows NT • Using Apcupsd with a USB UPS • Configuration for Controlling Multiple UPSes • Batteries Apcupsd 3.8.5 User's Manual 1 APC UPS management under Linux Other Notes • Frequently Asked Questions • Security • Thanks Other Notes 2 APC UPS management under Linux New Features in Apcupsd 3.8.5 This version of apcupsd corrects a bug that could cause a master/slave process to die due to a TCP/IP disconnect error. This version also includes the ability with the apctest program to perform a Battery Runtime Calibration. For more information on using apctest, please see the apctest Chapter of this manual. apcupsd is mainly developed under Linux and will compile cleanly and work under most flavors of Unix as well as many other operating systems including Windows. What to do if you find bugs : send an email to apcupsd−[email protected] (Developers mailing list) or go to one of the following sites: http://www.apcupsd.org http://www.sibbald.com/apcupsd Please be sure to include the version of apcupsd you are running, your operating system, and a detailed description of your problem.
    [Show full text]
  • Eaton® Intelligent Power® Manager (IPM) User’S Guide Eaton Is a Registered Trademarks of Eaton Corporation Or Its Subsidiaries and Affiliates
    Eaton® Intelligent Power® Manager (IPM) User’s Guide Eaton is a registered trademarks of Eaton Corporation or its subsidiaries and affiliates. Google Chrome is a trademark of Google, Inc. HyperTerminal is a registered trademark of Hilgraeve. Linux is a registered trademark of Linus Torvalds in the United States, other countries, or both. Microsoft, Internet Explorer, Vista, and Windows are registered trademarks of Microsoft Corporation in the United States and other countries. Mozilla and Firefox are registered trademarks of the Mozilla Foundation. National Electrical Code and NEC are registered trademarks of National Fire Protection Association, Inc. Phillips is a registered trademark of Phillips Screw Company. All other trademarks are property of their respective companies. ©Copyright 2013 Eaton Corporation, Raleigh NC, USA. All rights reserved. No part of this document may be reproduced in any way without the express written approval of Eaton Corporation. Class A EMC Statements FCC Information This equipment has been tested and found to comply with the limits for a Class A digital device, pursuant to part 15 of the FCC Rules. These limits are designed to provide reasonable protection against harmful interference when the equipment is operated in a commercial environment. This equipment generates, uses and can radiate radio frequency energy and, if not installed and used in accordance with the instruction manual, may cause harmful interference to radio communications. Operation of this equipment in a residential area is likely to cause harmful interference in which case the user will be required to correct the interference at his own expense. ICES-003 This Class A Interference Causing Equipment meets all requirements of the Canadian Interference Causing Equipment Regulations ICES-003.
    [Show full text]