~ubuntu-branches/ubuntu/saucy/nut/saucy

« back to all changes in this revision

Viewing changes to man/powernet.8

  • Committer: Bazaar Package Importer
  • Author(s): Reinhard Tartler
  • Date: 2005-07-20 19:48:50 UTC
  • mto: (16.1.1 squeeze)
  • mto: This revision was merged to the branch mainline in revision 4.
  • Revision ID: james.westby@ubuntu.com-20050720194850-oo61wjr33rrx2mre
Tags: upstream-2.0.2
ImportĀ upstreamĀ versionĀ 2.0.2

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
.TH powernet 8 "Tue Oct 22 2002" "" "Network UPS Tools (NUT)"
2
 
.SH NAME
3
 
powernet \- Driver for APC SNMP UPS equipment
4
 
.SH NOTE
5
 
This man page only documents the hardware-specific features of the
6
 
powernet driver.  For information about the core driver, see
7
 
\fBnutupsdrv\fR(8).
8
 
 
9
 
.SH DESCRIPTION
10
 
This driver partially implements APC Powernet SNMP MIB, and allows
11
 
NUT UPSD to talk to APC SNMP-capable hardware.
12
 
 
13
 
.SH SUPPORTED HARDWARE
14
 
.HP
15
 
APC AP9606 Web/SNMP management card
16
 
.HP
17
 
APC AP9605 SNMP management card (as reported by Chuck Fee)
18
 
.HP
19
 
Perhaps other AP96xx cards and APC SNMP-capable hardware
20
 
 
21
 
.SH EXTRA ARGUMENTS
22
 
 
23
 
This driver supports the following optional settings in the
24
 
\fBups.conf\fR(5):
25
 
 
26
 
.IP "community=\fIvalue\fR"
27
 
SNMPv1 community to use (default = public). \fBNote:\fR you should
28
 
specify SNMP community with write permissions to be able to send
29
 
commands to the UPS and modify UPS variables.
30
 
 
31
 
.IP "sdtype=\fIvalue\fR"
32
 
Shutdown type to use - possible values:
33
 
 
34
 
0 = Soft shutdown or powerdown, depending on line status (default)
35
 
 
36
 
1 = Soft shutdown followed by powerdown
37
 
 
38
 
2 = Instant shutdown
39
 
 
40
 
3 = Shutdown with grace period
41
 
 
42
 
.SH REQUIREMENTS
43
 
You will need to install the Net-SNMP package from 
44
 
http://www.net-snmp.org/ before building this driver.
45
 
 
46
 
.SH INSTALLATION
47
 
This driver is not built by default.  You can build it by using 
48
 
"configure --with-drivers=powernet" before calling make.
49
 
 
50
 
.SH IMPLEMENTATION
51
 
The hostname of the UPS is specified with the "port" value in
52
 
\fBups.conf\fR, i.e.:
53
 
 
54
 
.nf
55
 
        [ap9606]
56
 
                driver = powernet
57
 
                port = apc-snmp-ups.example.com
58
 
                community = writable
59
 
.fi
60
 
 
61
 
.SH BUGS
62
 
UPS enumerated values are implemented as strings in the driver.
63
 
In a set request string converted to int and set to the
64
 
nearest available value by the agent.
65
 
 
66
 
.SH AUTHORS
67
 
Dmitry Frolov (powernet)
68
 
 
69
 
Hans Ekkehard Plesser (snmp-ups)
70
 
 
71
 
Arnaud Quette (snmp-ups)
72
 
 
73
 
.SH SEE ALSO
74
 
 
75
 
.SS APC's PowerNet MIB v3.3.0
76
 
Available online at http://apcc.com/tools/download/
77
 
 
78
 
.SS The core driver:
79
 
\fBnutupsdrv\fR(8)
80
 
 
81
 
.SS Internet resources:
82
 
The NUT (Network UPS Tools) home page: http://www.networkupstools.org/