snmp-ups(8)

1snmp-ups(8)                 Network UPS Tools (NUT)                snmp-ups(8)
2
3
4

NAME

6       snmp‐ups - Multi‐MIB Driver for SNMP UPS equipment
7

NOTE

9       This  man  page  only  documents  the hardware‐specific features of the
10       snmp‐ups driver.  For information about the core  driver,  see  nutups‐
11       drv(8).
12
13

SUPPORTED HARDWARE

15       The  new  snmp‐ups  driver  supports a wide range of devices by loading
16       various MIBS:
17
18       ietf:  UPS that is RFC 1628 (UPS MIB) compliant, ie  MGE  UPS  SYSTEMS,
19              Liebert, perhaps others (default)
20
21       mge:   MGE UPS SYSTEMS devices with SNMP cards (ref 66062, 66045, 66074
22              and 66244)
23
24       apcc:  APC AP9606 APC Web/SNMP management card, perhaps others
25
26       netvision:
27              Socomec Sicon UPS with Netvision Web/SNMP management card/exter‐
28              nal box
29
30       pw:    Powerware devices with ConnectUPS SNMP cards
31
32

EXTRA ARGUMENTS

34       This   driver   supports   the   following  optional  settings  in  the
35       ups.conf(5):
36
37
38       mibs=name
39              Set MIB compliance (default=ietf, allowed mge,apcc,netvision,pw)
40
41
42       community=name
43              Set community name (default = public).  Note that you require  a
44              RW community name to perform UPS settings (as for a powerdown).
45
46
47       snmp_version=version
48              Set SNMP version (default = v1, the other allowed value is v2c)
49
50
51       pollfreq=value
52              Set  polling  frequency  in  seconds,  to  reduce  network  flow
53              (default=30)
54
55
56       notransferoids
57              Disable the monitoring of the low and high voltage transfer OIDs
58              in  the  hardware.   This  will  remove  input.transfer.low  and
59              input.transfer.high from the list  of  variables.   This  should
60              only be used on APCC Symmetra equipment which has strangeness in
61              the three‐phase power reporting.
62
63

REQUIREMENTS

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

EXPERIMENTAL DRIVER

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

INSTALLATION

77       This driver is not built by default.  You can build it by  using  "con‐
78       figure --with-drivers=snmp-ups" before calling make.
79
80

IMPLEMENTATION

82       The hostname of the UPS is specified with the "port" value in ups.conf,
83       i.e.:
84
85            [snmp]
86                 driver = snmp-ups
87                 port = snmp-ups.example.com
88                 community = public
89                 snmp_version = v1
90                 mibs = ietf
91                 pollfreq = 15
92
93

AUTHORS

95   Sponsored by MGE UPS SYSTEMS <http://opensource.mgeups.com/>
96       Arnaud Quette, Dmitry Frolov
97
98