snmp-ups(8)						      Network UPS Tools (NUT)						       snmp-ups(8)

NAME

       snmp-ups - Driver for RFC 1628 SNMP UPS equipment

NOTE

       This  man  page	only  documents the hardware-specific features of the snmp-ups driver.	For information about the core driver, see nutups-
       drv(8).

SUPPORTED HARDWARE

       Any UPS that is RFC 1628 (UPS MIB) compliant.

EXPERIMENTAL DRIVER

       This driver has been tagged experimental and is not built by default.

REQUIREMENTS

       This driver needs UCD SNMP, aka Net-SNMP installed to compile successfully.  See http://www.net-snmp.org/ for more information.

       On Red Hat 7.2, these packages are required:

	    ucd-snmp-devel-4.2.3-1, ucd-snmp-4.2.3-1, ucd-snmp-utils-4.2.3-1

       You must install SNMP-UPS-MIB.txt in your MIBs directory - typically /usr/share/snmp/mibs/, but it may vary from system to system.  You can
       generate this from chapter 4 of RFC 1628 (see http://www.faqs.org).

EXTRA ARGUMENTS

       This driver supports the following optional settings in the ups.conf(5):

       community=name
	      Set community name (default = public)

       snmp_version=version
	      Set SNMP version (default = v1, the other allowed value is v2c)

INSTALLATION

       This driver is not built by default.  You can build it by using "configure --with-drivers=snmp-ups" before calling make.

IMPLEMENTATION

       The hostname of the UPS is specified with the "port" value in ups.conf, i.e.:

	    [snmp]
		 driver = snmp-ups
		 port = snmp-ups.example.com
		 community = public
		 snmp_version = v1

SUPPORTED VARIABLES

	    INFO_MFR  UPS Manufacturer
	    INFO_MODEL	   UPS Model
	    INFO_FIRMREV   Firmware/Software Version
	    INFO_STATUS    OFF, OL, OB, BOOST, TRIM
	    INFO_BATTPCT   Battery percentage
	    INFO_RUNTIME   Predicted runtime on battery
	    INFO_BATTVOLT  Battery Voltage
	    INFO_OUTVOLT   Output Voltage

PLANNED SUPPORT

	    INFO_UTILITY   Input Voltage
	    INFO_ACFREQ    AC Frequency
	    INFO_UPSTEM    UPS Temperature
	    INFO_LOADPCT   Load Percentage
	    CMD_?	   Not determined

AUTHORS

       Arnaud Quette, Hans Ekkehard Plesser

SEE ALSO

   The core driver:
       nutupsdrv(8)

   Internet resources:
       The NUT (Network UPS Tools) home page: http://www.exploits.org/nut/

       NUT mailing list archives and information: http://lists.exploits.org/

								  Tue Oct 22 2002						       snmp-ups(8)