Desc: Information about the powernet driver
File: powernet.txt
Date: 28 May 2002
Auth: Dmitry Frolov <frolov@riss-telecom.ru>

$RISS: nut/docs/drivers/powernet.txt,v 1.2 2002/05/28 05:30:58 frol Exp $

Description
-----------

This driver partially implements APC Powernet SNMP MIB, and allows
NUT UPSD to talk to APC hardware with network controller,
such as Web/SNMP smart-slot cards. Actually, it only tested
with AP9606 card. You can find Powernet SNMP MIB description
file, powernet.mib here for reference:

http://apcc.com/tools/download/

The driver is experimental, so there should be bugs. Bug reports
are welcomed.

The driver was developed on following platform:
FreeBSD 4.6-RC
Net-SNMP v4.2.4
AP9606 APC Web/SNMP management card
Smart-UPS 2200

Requirements
------------

You will need Net-SNMP package installed to build and use
this driver. See http://www.net-snmp.org/ for information
on how to install this package.

Installation
------------

The driver is not built by default. You can enable building
of the driver at configure stage by adding it to --with-drivers
option:

./configure --with-drivers=powernet[,<other drivers you need>]

than type "make" to build, and "make install" as root to install
NUT suite

Usage
-----

Driver uses SNMPv1. You should specify SNMP host name or address
with "port" parameter (with -x powernet option or in ups.conf).
If you use SNMP community other than "public", You should set it with
"community" parameter.

Note: you should specify SNMP community with write permissions (such as
"private") to be able to send commands to the UPS, or modify UPS variables.

Example of ups.conf section:

[ap9606]
        driver = powernet
        port = apc-snmp-ups.company.com
        community = writable
