File: user-manual.txt

package info (click to toggle)
nut 2.7.4-13
  • links: PTS, VCS
  • area: main
  • in suites: bullseye
  • size: 11,240 kB
  • sloc: ansic: 70,280; sh: 12,685; python: 2,235; cpp: 1,715; makefile: 1,387; perl: 705; xml: 40
file content (187 lines) | stat: -rw-r--r-- 3,811 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
:titles.underlines: "__","==","--","~~","^^"

Network UPS Tools User Manual
_____________________________
:Author: Russell_Kroll,_Arnaud_Quette_and_Arjen_de_Korte
:Author Initials: RK, AQ & ADK

Introduction
============

The primary goal of the Network UPS Tools (NUT) project is to provide support
for Power Devices, such as Uninterruptible Power Supplies, Power Distribution
Units and Solar Controllers.

NUT provides many control and monitoring <<Features,features>>, with a uniform
control and management interface.

More than 100 different manufacturers, and several thousands models are
<<HCL,compatible>>.

This software is the combined effort of many
<<Acknowledgements,individuals and companies>>.

This document intend to describe how to install software support for your
<<general_powerdev_info, Power Devices>> (UPS, PDU, ...), and how to use the
NUT project. It is not intended to explain what are, nor distinguish the
different technologies that exist.  For such information, have a look at the
<<general_powerdev_info,General Power Devices Information>>.

If you wish to discover how everything came together, have a look at the
<<Project_History,Project History>>.


[[Overview]]

include::../README[]


[[Features]]

include::features.txt[]


Compatibility information
-------------------------

Hardware
~~~~~~~~

The current list of hardware supported by NUT can be viewed <<HCL,here>>.

Operating systems
~~~~~~~~~~~~~~~~~

This software has been reported to run on:

- Linux distributions,
- the BSDs,
- Apple's OS X,
- Sun Solaris,
- SGI IRIX,
- HP/UX,
- Tru64 Unix,
- AIX.

There is also a port of the client-side monitoring to Windows called WinNUT.
Windows users may be able to build it directly with Cygwin.

Your system will probably run it too. You just need a good C compiler and
possibly some more packages to gain access to the serial ports.
Other features, such as USB / SNMP / whatever, will also need extra software
installed.

Success reports are welcomed to keep this list accurate. 


[[Download_instructions]]

include::download.txt[]


[[_installation_instructions]]

include::../INSTALL.nut[]


[[Configuration_notes]]

include::config-notes.txt[]


[[Advanced_usage_scheduling_notes]]

include::scheduling.txt[]


[[Outlets_PDU_notes]]

include::outlets.txt[]


[[NUT_Security]]

include::security.txt[]


Appendix A: Glossary
====================

This section document the various acronyms used throughout the present
documentation.

[template="glossary",id="terms"]
ATS::
	Automatic Transfer Switch.
NUT::
	Network UPS Tools.
PDU::
	Power Distribution Unit.
PSU::
	Power Supply Units.
SCD::
	Solar Controller Device.
UPS::
	Uninterruptible Power Supply.


[[Acknowledgements]]
Appendix B: Acknowledgements / Contributions
============================================

include::acknowledgements.txt[Acknowledgements / Contributions]


[[nut-names]]
Appendix C: NUT command and variable naming scheme
==================================================

include::nut-names.txt[]


[[HCL]]
Appendix D: Hardware Compatibility List
=======================================

Refer to the link:http://www.networkupstools.org/stable-hcl.html[online HCL].


Appendix E: Documentation
=========================

include::documentation.txt[]


[[Support_Request]]
Appendix F: Support instructions
================================

include::support.txt[]


[[Cables_information]]
Appendix G: Cables information
==============================

include::cables.txt[]


[[Configure_options]]
Appendix H: Configure options
=============================

include::configure.txt[]


[[Upgrading_notes]]
Appendix I: Upgrading notes
===========================

include::../UPGRADING[]


[[Project_History]]
Appendix J: Project history
===========================

include::history.txt[]