Provided by: nut-snmp_2.0.3-4build1_i386 bug

NAME

       snmp‐ups - Multi‐MIB Driver for 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

       The  new  snmp‐ups  driver  supports a wide range of devices by loading
       various MIBS:

       ietf:  UPS that is RFC 1628 (UPS MIB) compliant, ie  MGE  UPS  SYSTEMS,
              Liebert, perhaps others (default)

       mge:   MGE UPS SYSTEMS devices with SNMP cards (ref 66062, 66045, 66074
              and 66244)

       apcc:  APC AP9606 APC Web/SNMP management card, perhaps others

       netvision:
              Socomec   Sicon   UPS   with   Netvision   Web/SNMP   management
              card/external box

       pw:    Powerware devices with ConnectUPS SNMP cards

EXTRA ARGUMENTS

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

       mibs=name
              Set MIB compliance (default=ietf, allowed mge,apcc,netvision,pw)

       community=name
              Set  community name (default = public).  Note that you require a
              RW community name to perform UPS settings (as for a  powerdown).

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

       pollfreq=value
              Set  polling  frequency  in  seconds,  to  reduce  network  flow
              (default=30)

       notransferoids
              Disable the monitoring of the low and high voltage transfer OIDs
              in  the  hardware.   This  will  remove  input.transfer.low  and
              input.transfer.high from the list  of  variables.   This  should
              only be used on APCC Symmetra equipment which has strangeness in
              the three‐phase power reporting.

REQUIREMENTS

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

EXPERIMENTAL DRIVER

       This  driver has been tagged experimental, even if it has been reported
       to be stable. Thus it is not suitable for production systems and it  is
       not  built  by  default.  This  is mainly due to the fact that there is
       still no proper upsdrv_shutdown() function implemented !

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
                 mibs = ietf
                 pollfreq = 15

AUTHORS

   Sponsored by MGE UPS SYSTEMS <http://www.mgeups.com/opensource/>
       Dmitry Frolov, Hans Ekkehard Plesser, Arnaud Quette

SEE ALSO

   The core driver:
       nutupsdrv(8)

   NUT SNMP Protocols Library
       Available at: http://random.networkupstools.org/protocols/snmp/

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

                                Sun Mar 14 2004                    snmp-ups(8)