Manpages

NAME

powernet − Driver for APC SNMP UPS equipment

NOTE

This man page only documents the hardware-specific features of the powernet driver. For information about the core driver, see nutupsdrv(8).

DESCRIPTION

This driver partially implements APC Powernet SNMP MIB, and allows NUT UPSD to talk to APC SNMP-capable hardware.

SUPPORTED HARDWARE

APC AP9606 Web/SNMP management card

APC AP9605 SNMP management card (as reported by Chuck Fee)

Perhaps other AP96xx cards and APC SNMP-capable hardware

EXTRA ARGUMENTS

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

SNMPv1 community to use (default = public). Note: you should specify SNMP community with write permissions to be able to send commands to the UPS and modify UPS variables.

sdtype=value

Shutdown type to use - possible values:

0 = Soft shutdown or powerdown, depending on line status (default)

1 = Soft shutdown followed by powerdown

2 = Instant shutdown

3 = Shutdown with grace period

REQUIREMENTS

You will need to install the Net-SNMP package from http://www.net-snmp.org/ before building this driver.

INSTALLATION

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

IMPLEMENTATION

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

[ap9606]

driver = powernet

port = apc-snmp-ups.example.com

community = writable

BUGS

UPS enumerated values are implemented as strings in the driver. In a set request string converted to int and set to the nearest available value by the agent.

AUTHORS

Dmitry Frolov (powernet)

Hans Ekkehard Plesser (snmp-ups)

Arnaud Quette (snmp-ups)

SEE ALSO

APC’s PowerNet MIB v3.3.0
Available online at http://apcc.com/tools/download/

The core driver:
nutupsdrv(8)

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