Network UPS Tools User Manual iNetwork UPS Tools User Manual
Network UPS Tools User Manual xI Upgrading notes 74I.1 Changes from 2.7.2 to 2.7.3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Network UPS Tools User Manual xiJ.4.3 April 2003: new naming scheme, better driver glue, and an overhauled protocol . . . . . . . . . . . . . . 82J.4.
Network UPS Tools User Manual 1 / 841 IntroductionThe primary goal of the Network UPS Tools (NUT) project is to provide support for Power Devices, suc
Network UPS Tools User Manual 2 / 842.6 Network InformationThese programs are designed to share information over the network. In the examples below, l
Network UPS Tools User Manual 3 / 842.8.1 Extra SettingsSome drivers may require additional settings to properly communicate with your hardware. If it
Network UPS Tools User Manual 4 / 842.8.4 UPS Shutdownsupsdrvctl can also shut down (power down) all of your UPS hardware.Warningif you play around wi
Network UPS Tools User Manual 5 / 842.10.3 Additional InformationMore information on configuring upsmon can be found in these places:• The upsmon(8) ma
Network UPS Tools User Manual 6 / 84[ups.test.interval]Interval between self testsType: ENUMOption: "1209600"Option: "604800" SELE
Network UPS Tools User Manual 7 / 842.12.1 Access RestrictionsThe CGI programs use hosts.conf to see if they are allowed to talk to a host. This keeps
Network UPS Tools User Manual 8 / 84Server versionClient version 1.0 1.2 1.4 2.0+1.0 yes yes yes no1.2 yes yes yes no1.4 yes yes yes yes2.0+ no no yes
Network UPS Tools User Manual iiREVISION HISTORYNUMBER DATE DESCRIPTION NAME2.7.3 2015-04-22 Current release of Network UPS Tools (NUT).2.6.0 2011-01-
Network UPS Tools User Manual 9 / 843.2 Multiple architecture support• Cross-platform - different flavors of Unix can be managed together with a common
Network UPS Tools User Manual 10 / 843.6 Web-based monitoring• Comes stock with CGI-based web interface tools for UPS monitoring and management, inclu
Network UPS Tools User Manual 11 / 843.9.2 "Advanced" configurationOne UPS, multiple computers. Only one of them can actually talk to the UPS
Network UPS Tools User Manual 12 / 843.9.4 "Bizarre" configurationYou can even have a UPS that has the serial port connected to a system that
Network UPS Tools User Manual 13 / 84• AIX.There is also a port of the client-side monitoring to Windows called WinNUT. Windows users may be able to b
Network UPS Tools User Manual 14 / 84Browse codeYou can also browse the code at GitHub, or at the Alioth mirror. The code was originally kept in Subve
Network UPS Tools User Manual 15 / 845 Installation instructionsThis chapter describe the various methods for installing Network UPS Tools.Whenever it
Network UPS Tools User Manual 16 / 84• to build and install SNMP drivers, add --with-snmp (note that you need to install libsnmp development package o
Network UPS Tools User Manual 17 / 84Ownership and permissionsSet ownership data and permissions on your serial or USB ports that go to your UPS hardw
Network UPS Tools User Manual 18 / 845.2.2 MandrivaNoteNUT is packaged and well maintained in these systems. The official Mandriva packager is part of
Network UPS Tools User Manual iiiContents1 Introduction 12 Network UPS Tools Overview 12.1 Description . . . . . . . . . . . . . . . . . . . . . . . .
Network UPS Tools User Manual 19 / 845.2.5 FreeBSDYou can either install NUT as a binary package or as a port.Binary packageTo install the main compon
Network UPS Tools User Manual 20 / 84SHUTDOWNCMD "/sbin/shutdown -h +0"Without the quotes, it would only see the first word on the line.OK, s
Network UPS Tools User Manual 21 / 846.2 Basic configurationThis chapter describe the base configuration to establish communication with the device.This
Network UPS Tools User Manual 22 / 84If the driver doesn’t start cleanly, make sure you have picked the right one for your hardware. You might need to
Network UPS Tools User Manual 23 / 846.2.5 Check the UPS dataStatus dataMake sure that the UPS is providing good status data./usr/local/ups/bin/upsc m
Network UPS Tools User Manual 24 / 84ups.beeper.status: enabledups.delay.shutdown: 20ups.delay.start: 30ups.firmware: 5102AHups.load: 0ups.mfr: EATONu
Network UPS Tools User Manual 25 / 84• generate a NOTIFY_SHUTDOWN event• wait FINALDELAY seconds - typically 5• call their SHUTDOWNCMD• disconnect fro
Network UPS Tools User Manual 26 / 84Power Off flag fileSet the POWERDOWNFLAG location for upsmon.In upsmon.conf, add a POWERDOWNFLAG directive with a fi
Network UPS Tools User Manual 27 / 84Checking upsmonLook for messages in the syslog to indicate success. It should look something like this:May 29 01:
Network UPS Tools User Manual 28 / 84Testing shutdownsUPS equipment varies from manufacturer to manufacturer and even within model lines. You should t
Network UPS Tools User Manual iv3 Features 83.1 Multiple manufacturer and device support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Network UPS Tools User Manual 29 / 846.4 Typical setups for enterprise networks and data roomsThe split nature of this UPS monitoring software allows
Network UPS Tools User Manual 30 / 84If you are running large server-class systems that have more than one power feed, see the next section for inform
Network UPS Tools User Manual 31 / 84As an added bonus, this means you can move a running server from one UPS to another (for maintenance purpose for
Network UPS Tools User Manual 32 / 847.1 The simple approach, using your own script7.1.1 How it works relative to upsmonYour command will be called wi
Network UPS Tools User Manual 33 / 847.1.4 Suppressing notify stormsupsmon will call your script every time an event happens that has the EXEC flag set
Network UPS Tools User Manual 34 / 84Establishing timersLet’s say that you want to receive a page when any UPS has been running on battery for 30 seco
Network UPS Tools User Manual 35 / 847.2.4 Early ShutdownsOne thing that gets requested a lot is early shutdowns in upsmon. With upssched, you can now
Network UPS Tools User Manual 36 / 848.2 NUT outlet data collectionNUT provides a complete and uniform integration of outlets related data, through th
Network UPS Tools User Manual 37 / 848.5 Other type of devicesAs mentioned in the introduction, some other devices can be considered and managed like
Network UPS Tools User Manual 38 / 849.2 System level privileges and ownershipAll configuration files should be protected so that the world can’t read t
Network UPS Tools User Manual vInstallation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16Stat
Network UPS Tools User Manual 39 / 84LISTEN 127.0.0.1LISTEN 192.168.50.1LISTEN ::1LISTEN 2001:0db8:1234:08d3:1319:8a2e:0370:7344This parameter will on
Network UPS Tools User Manual 40 / 849.5 Configuring SSLSSL is available as a build option (--with-ssl).It encrypts sessions between upsd and clients,
Network UPS Tools User Manual 41 / 84Install the client-side certificateUse the following commands to install the client-side certificate:mkdir <cert
Network UPS Tools User Manual 42 / 84Clean up the temporary filesrm -f upsd.crt upsd.keyRestart upsdIt should come back up without any complaints. If i
Network UPS Tools User Manual 43 / 84Create certificate and key for the hostNSS (package generally called libnss3-tools) will install a tool called cer
Network UPS Tools User Manual 44 / 84upsd (required): certificate database and self certificateEdit the upsd.conf to tell where find the certificate datab
Network UPS Tools User Manual 45 / 84upsmon (optional): certificate database and self certificateLike upsd, upsmon may need to authenticate itself (upsd
Network UPS Tools User Manual 46 / 849.5.7 ConclusionSSL support should be considered stable but purposely under-documented since various bits of the
Network UPS Tools User Manual 47 / 84mkdir -p /chroot/nut/devcp -a /dev/null /chroot/nut/devTry to start your driver(s) and make sure everything fires
Network UPS Tools User Manual 48 / 84B Acknowledgements / ContributionsThis project is the result of years of work by many individuals and companies.M
Network UPS Tools User Manual vi6.3.3 Using suspend to disk . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Network UPS Tools User Manual 49 / 84• Jonathan Dion: MGE internship (summer 2006), who has worked on configuration• Doug Reynolds: has worked on Cyber
Network UPS Tools User Manual 50 / 84B.3 Other contributors• Pavel Korensky’s original apcd provided the inspiration for pursuing APC’s smart protocol
Network UPS Tools User Manual 51 / 84C.1 VariablesC.1.1 device: General unit informationNotesome of these data will be redundant with ups.* informatio
Network UPS Tools User Manual 52 / 84Name Description Example valueups.timer.reboot Time before the load will be rebooted(seconds)10ups.timer.shutdown
Network UPS Tools User Manual 53 / 84Name Description Example valueinput.transfer.low.max greatest settable low voltage transferpoint95input.transfer.
Network UPS Tools User Manual 54 / 84Specification (SPEC)Voltage, current, frequency, etc are considered to be a specification of the measurement.With t
Network UPS Tools User Manual 55 / 84Name Descriptionfrequency Frequency (Hz)frequency.nominal Nominal frequency (Hz)realpower Current value of real p
Network UPS Tools User Manual 56 / 84Name Description Example valuebattery.alarm.threshold Battery alarm threshold 0 (immediate)battery.date Battery c
Network UPS Tools User Manual 57 / 84C.1.9 outlet: Smart outlet managementNoten stands for the outlet index. For more information, refer to the NUT ou
Network UPS Tools User Manual 58 / 84Name Description Example valueserver.info Server information Network UPS Tools upsd vX.Y.Z -http://www.networkups
Network UPS Tools User Manual vii9.5 Configuring SSL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Network UPS Tools User Manual 59 / 84E DocumentationE.1 User Documentation• FAQ - Frequently Asked Questions• NUT user manual• Cables information• Use
Network UPS Tools User Manual 60 / 84• HOWTO: MGE Ellipse 300 on gentoo (nielchiano)• Cum se configureaz˘a un UPS Apollo seria 1000F pe Linux (deschis,
Network UPS Tools User Manual 61 / 84F.2.2 Post a patch, ask a development question, . . .Use the NUT Developers mailing list.Refer to the NUT Develop
Network UPS Tools User Manual 62 / 84G.2 BelkinG.2.1 OmniGuard F6C***-RKMFrom "Daniel"A straight-through RS-232 cable (with pins 2-7 connect
Network UPS Tools User Manual 63 / 84G.3.1 MGE Office Protection SystemsThe three first cables also applies to MGE UPS SYSTEMS and Eaton.DB9-DB9 cable (
Network UPS Tools User Manual 64 / 84NMC DB9-RJ45 cableThe following applies to the MGE 66102 NMC (Network Management Card), and possibly other models
Network UPS Tools User Manual 65 / 84DB9-RJ12 cableThis cable is used on some older Ellipse models.
Network UPS Tools User Manual 66 / 84
Network UPS Tools User Manual 67 / 84G.3.2 Powerware LanSafeG.3.3 SOLA-330Just uses a normal serial cable, with pin 1-1 through to 9-9.
Network UPS Tools User Manual 68 / 84G.4 HP - CompaqG.4.1 Older Compaq UPS FamilyThis cable can be used with the following models:T700, T1000, T1500,
Network UPS Tools User Manual viiiB Acknowledgements / Contributions 48B.1 The NUT Team . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Network UPS Tools User Manual 69 / 84• http://pinoutsguide.com/UPS/best_power_pinout.shtml• http://lit.powerware.com/ll_download.asp?file=m_patriotproi
Network UPS Tools User Manual 70 / 84--with-usbBuild and install the USB drivers (default: auto-detect) Note that you need to install the libusb devel
Network UPS Tools User Manual 71 / 84--with-lib (default: no)Build and install the upsclient library and header files.--with-all (no default)Build and
Network UPS Tools User Manual 72 / 84The <groupname> is used for the permissions of some files, particularly the hotplugging rules for USB. The i
Network UPS Tools User Manual 73 / 84--with-drvpath=PATHThe UPS drivers will be installed to this path. By default they install to "<exec_prefi
Network UPS Tools User Manual 74 / 84H.6 Things the compiler might need to find--with-gd-includes="-I/foo/bar"If you installed gd in some pla
Network UPS Tools User Manual 75 / 84I.2 Changes from 2.7.1 to 2.7.2• upsdrvctl is now installed to $prefix/sbin rather than $driverexec. This usually
Network UPS Tools User Manual 76 / 84I.9 Changes from 2.4.3 to 2.6.0• users of the megatec and megatec_usb drivers must respectively switch to blazer_
Network UPS Tools User Manual 77 / 84I.16 Changes from 2.0.5 to 2.2.0• users of the newhidups driver are advised that the driver name has changed to u
Network UPS Tools User Manual 78 / 84I.22 Changes from 1.4.0 to 2.0.0• The sample config files are no longer installed by default. If you want to instal
Network UPS Tools User Manual ixF Support instructions 60F.1 Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Network UPS Tools User Manual 79 / 84Last login Sat May 11 21:33 (MDT) on ttyp0 from intrepid.rmi.netPlan:Welcome to the UPS monitor service at kadets
Network UPS Tools User Manual 80 / 84upsstats actually has since returned to using templates, despite having a period in the middle when it used hardc
Network UPS Tools User Manual 81 / 84The drivers stored status data in an array. At first, they passed this data to upsd by saving it to a file. upsd wo
Network UPS Tools User Manual 82 / 84J.4 Leaving 0.x territoryJ.4.1 August 2002: first stable tree: NUT 1.0.0After nearly 5 years of having a 0.x versi
Network UPS Tools User Manual 83 / 84J.4.4 July 2003: third stable tree: NUT 1.4.0On July 25, 2003, 1.4.0 was released. It contained support for both
Network UPS Tools User Manual 84 / 84J.7 The change of leadershipJ.7.1 February 2005: NUT 2.0.1The year 2004 was marked by a release slowdown, since R
Comments to this Manuals