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 nutupsdrv(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/