215 lines
4.6 KiB
Text
215 lines
4.6 KiB
Text
: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 140 different manufacturers, and several thousands of 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[]
|
|
|
|
|
|
include::outlets.txt[]
|
|
|
|
[[daisychain]]
|
|
NUT daisychain support notes
|
|
============================
|
|
|
|
include::daisychain.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
|
|
=============================
|
|
|
|
NOTE: For more information about build environment setup, see chapters
|
|
below about <<Config_Prereqs,Configuration prerequisites>>
|
|
and <<CI_Farm_Notes,CI Farm configuration notes>>.
|
|
|
|
include::configure.txt[]
|
|
|
|
|
|
[[Upgrading_notes]]
|
|
Appendix I: Upgrading notes
|
|
===========================
|
|
|
|
include::../UPGRADING[]
|
|
|
|
|
|
[[Project_History]]
|
|
Appendix J: Project history
|
|
===========================
|
|
|
|
include::history.txt[]
|
|
|
|
|
|
[[Config_Prereqs]]
|
|
Appendix K: Prerequisites for building NUT on different OSes
|
|
============================================================
|
|
|
|
include::config-prereqs.txt[]
|
|
|
|
|
|
[[CI_Farm_Notes]]
|
|
Appendix L: CI Farm configuration notes
|
|
=======================================
|
|
|
|
NOTE: This chapter contains information about NUT CI farm setup tricks
|
|
that were applied at different times by the maintainer team to ensure
|
|
regular builds and tests of the codebase. Whether these are used in
|
|
daily production today or not, similar setup should be possible locally
|
|
on developer and contributor machines.
|
|
|
|
include::ci-farm-lxc-setup.txt[]
|