Мозаика системного администрирования

Инструменты пользователя

Инструменты сайта

Network UPS Tools (NUT)

Содержание

Network UPS Tools (NUT) — комплект программ для мониторинга ИБП .

Сервер — upsd

upsd отвечает за передачу данных от драйверов к клиентским программам по сети. Его следует запускать сразу после upsdrvctl в сценариях запуска вашей системы.

По возможности, upsd следует поддерживать в рабочем состоянии, поскольку это единственный источник информации о состоянии для клиентов мониторинга, таких как upsmon.

upsd.conf

upsd.users

ups.conf

Нужно обязательно дать права на файл устройства (порта), иначе будет ошибка:

Для того, чтобы после перезагрузки были правильные права на файл, нужно создать файл:

upsdrvctl

UPS driver controller

Клиент мониторинга — upsmon

upsmon предоставляет важную функцию, которую вы ожидаете найти в ПО для мониторинга ИБП — это безопасное отключение при сбое питания.

В иерархии ПО NUT это клиент. Он отдельно описан в документации, так как он очень важен. Вы настраиваете его, указывая все ИБП, информацию о которых необходимо получать, это делается в файле в upsmon.conf .

В файле nut.conf нужно указать режим:

СИСТЕМА	ИМЯ_ИБП @СЕРВЕР
PV	Целое число, равное числу блоков питания, которые ИБП питает в этой системе. Большинство обычных компьютеров имеют один блок питания, и ИБП питает его, поэтому это значение будет 1. Если нужно только контролировать ИБП , который на самом деле не подаёт питание на эту систему нужно использовать значение 0. Это полезно, когда вы хотите, чтобы upsmon только оправлял уведомления об изменениях статуса ИБП
ПОЛЬЗОВАТЕЛЬ	Имя пользователя
ПАРОЛЬ	Пароль пользователя
ТИП	Тип: master или slave

Клиент MS Windows

WinNUT

WinNUT — The Windows Network UPS Tools

WinNUT is currently being replaced by a full port to Windows, part of the official NUT distribution. MSI packages are available too.

Windows NUT client

Графический интерфейс к WinNUT

Windows NUT client is a partial port of KNutClient to Windows using AutoIt scripting language.

Другие клиенты

Клиенты общаются с upsd по сети и делают полезные вещи с данными из драйверов. Существуют инструменты для доступа к командной строке и несколько специальных клиентов, которые можно запускать через ваш веб-сервер как программы CGI.

upsc — это быстрый способ узнать, правильно ли работают ваши драйверы и upsd .

upsc -L	список всех настроенных ИБП
upsc ИМЯ_ИБП	список всех доступных переменных с их текущими значениями
upsc ИМЯ_ИБП ИМЯ_ПЕРЕМЕННОЙ	текущее значение переменной

Для подавления сообщения:

Нужно использовать следующую конструкцию:

upslog

upslog будет записывать информацию о состоянии из upsd в файл через заданные промежутки времени. Вы можете использовать это для создания графиков или отчетов с помощью других программ.

Пример вывода протокола в файл с помощью upslog

upsrw

upsrw требует прав администратора для изменения настроек оборудования. Обратитесь к upsd.users для получения информации об определении пользователей в upsd .

upscmd

upscmd требует прав администратора для запуска мгновенных команд. Чтобы определить пользователей и пароли в upsd , см. upsd.users

Веб мониторинг

Настройка

Zabbix

Мониторинг через Zabbix, работает через Zabbix агент.

Параметр	Имя переменной	Примечания
Имя драйвера NUT	driver.name
Модель ИБП	ups.model
Нагрузка (%)	ups.load
Напряжение батарей (В)	battery.voltage
Напряжение на входе (В)	input.voltage
Напряжение на выходе (В)	output.voltage
Номинальная нагрузка (ВА)	ups.power.nominal
Производитель ИБП	ups.mfr
Расчётное время работы от батарей (Мин.)	battery.runtime
Состояние	ups.status	Эта переменная может содержать несколько значений, вот пример:

для этого введены переменные ups.status-2 … ups.status-5 , если эти переменные не содержат значений то возвращается 0

Состояние, значение №2 ups.status-2 Состояние, значение №3 ups.status-3 Состояние, значение №4 ups.status-4 Состояние, значение №5 ups.status-5 Тревога ups.alarm Эта переменная получает значение только при возникновении тревоги (alarm) поэтому для при ошибке:

возвращается 0 , также она может содержать несколько значений, для этого введены переменные ups.alarm-2 … ups.alarm-10

Тревога, значение №2 ups.alarm-2 Тревога, значение №3 ups.alarm-3 Тревога, значение №4 ups.alarm-4 Тревога, значение №5 ups.alarm-5 Тревога, значение №6 ups.alarm-6 Тревога, значение №7 ups.alarm-7 Тревога, значение №8 ups.alarm-8 Тревога, значение №9 ups.alarm-9 Тревога, значение №10 ups.alarm-10 Температура (°C) ups.temperature Уровень заряда батарей (В) battery.charge Частота на входе (Гц) input.frequency

Если переменная не поддерживается, возникает ошибка:

Welcome

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, Automatic Transfer Switch, Power Supply Units and Solar Controllers.

NUT provides many control and monitoring features, with a uniform control and management interface. If you are just getting acquainted with NUT, that page also explains the technical design and some possible set-ups.

More than 140 different manufacturers, and several thousands of models are compatible.

This software is the combined effort of many individuals and companies.

March 6, 2021: great thanks to Fosshost Org for providing virtual servers that we can use for diverse build farm!

November 13, 2020: announced handing of maintainership reins from Arnaud Quette to Evgeny «Jim» Klimov

March 9, 2016: NUT 2.7.4 released

April 16, 2015: NUT 2.7.3 released

April 17, 2014: NUT 2.7.2 released

February 18, 2014: new project nut-snmpagent

November 20, 2013: NUT 2.7.1 released

June 21, 2013: new client walNUT released

February 10, 2013: NUT source repository is converted to Git using reposurgeon

August 8, 2012: NUT 2.6.5 released

June 5, 2012: WMNut 0.64 released, and move hosting

May 31, 2012: NUT 2.6.4 released, including CVE-2012-2944 fix

May 10, 2012: WMNut 0.63 released

May 9, 2012: Official publication of Riello communication protocols

Download information

This section presents the different methods to download NUT.

Source code

You should always use PGP/GPG to verify the signatures before using any source code.

You can use the following procedure to do so.

Stable tree: 2.7

Development tree:

Code repository

The development tree is available through a Git repository hosted at GitHub.

To retrieve the current development tree, use the following command:

The configure script and its dependencies are not stored in Git. To generate them, ensure that autoconf, automake and libtool are installed, then run the following script in the directory you just checked out:

Then refer to the NUT user manual for more information.

Browse code

You can also browse the code at GitHub, or at the Alioth mirror. The code was originally kept in Subversion, and the old Trac site will be kept around for a bit so as not to break the URLs in the mailing list archives.

Snapshots

GitHub has several download links for repository snapshots (for particular tags or branches), but you will need a number of tools such as autoconf, automake and libtool to use these snapshots.

If our Buildbot instance is behaving, you can download a snapshot which does not require auto* tools from this builder. Look for the latest [tarball] link towards the top of the page, and be sure to check the Build ## link to verify the branch name.

Related projects

There are many programs and devices that integrate NUT support.

This page tries to track them.

Graphical desktop clients

KNutClient

KNutClient is a visual client for NUT.

NUT-Monitor

NUT-Monitor is a graphical application to monitor and manage UPSes connected to a NUT server. This application is written in Python and PyGTK, and uses the PyNUT class.

NUT-Monitor is part of NUT since NUT v2.4.1. It will further evolve toward the NUT Control Center.

walNUT

A Gnome Shell extension to monitor/manage NUT-controlled devices.

Windows NUT client

Windows NUT client is a partial port of KNutClient to Windows using AUTOIT scripting language.

WinNUT

WinNUT is a partial port of the client side of Network UPS Tools (NUT) to Windows.

WinNUT is currently being replaced by a full port to Windows, part of the official NUT distribution. MSI packages are available too.

WMNUT

WMNut is a dockapp program to monitor multiple UPSs statistics through the NUT (Network UPS Tools) framework on Linux and other systems.

Network Management Systems (NMS) integration

There are at least three different scripts that add NUT support to Cacti:

collectd

The collectd system statistics collection daemon features a NUT plugin to collect statistics from UPSes.

Xymon (Hobbit) monitor

A NUT plugin is available.

MonAMI NUT plugin

A plugin to return UPS status to the MonAMI universal sensor framework.

Munin NUT plugin

A NUT plugin is available.

Nagios plugin

The check_ups plugin returns UPS status to the Nagios monitoring system using NUT.

Configuration GUIs

KNutSetting

KNutSetting is a visual KDE tool for configuring NUT — Network UPS Tools.

Other software projects

42ITy™

42ITy™ is a next generation platform for data center service optimization that aims to bridge the gap between the traditional silos of IT and facility management.

42ITy™ promotes an open, community based approach, to ensure broad and vendor agnostic support, while leveraging and giving back to leading open source software components including NUT (Network UPS Tools), ØMQ/Malamute & MariaDB, among others.

Network UPS Tools Services for Windows

Network UPS Tools Services for Windows provides tools and services to run an upsd -compatible server to report the status of UPS devices connected to a system or server in master mode. It allows other Network UPS Tools slave daemons and monitoring clients access to UPS information using standard Windows programing interfaces for easier setup.

nut-snmpagent

nut-snmpagent is an SNMP wrapper to expose the upsc output into Net-SNMP.

PyNUT

PyNUT is an abstraction class written in Python to access NUT (Network UPS Tools) server and execute commands without needing to know the communication protocol.

PyNUT is part of NUT since NUT v2.4.1.

RRDtool logging support

This patch adds RRDtool logging support to NUT. (See also [collectd].)

ups_control

A developing Python wrapper to upsc which can generate email and shutdown the machine.

UPS::Nut

A Perl module to talk to an UPS via NUT (Network UPS Tools) upsd.

UPS::Nut is part of NUT since NUT v2.6.1.

python-nut2

A fork and complete API overhaul of PyNUT, a Python library to allow communication with Network UPS Tools servers.

webNUT

A simple web interface for Network UPS Tools servers.

go.nut

A Golang library for interacting with NUT.

Hardware projects involving NUT

This is an incomplete list of the hardware known to embed NUT.

Dell PowerVault NX3500

Dell is using NUT to protect the new PowerVault NX3500 storage devices.

OpenGear

Opengear provides an advanced NUT integration into many models. There is also a video presentation of the NUT integration.

For more information on Opengear’s contributions to NUT, have a look at the acknowledgements information.

Synology

Synology has worked closely with Arnaud to integrate UPS support on all its devices.

Alcatel Lucent IPBX

Alcatel has been working for years with us (Patrick Agrain and Arnaud) to improve NUT integration into some of their IPBX.

Netgear ReadyNAS

The RAIDiator firmware for the ReadyNAS product line includes NUT to either monitor a local USB UPS, or to connect as a slave to a NUT server.

Thecus NAS

Thecus NAS firmware includes NUT for UPS support. The following list of devices is known to be supported.

Buffalo NAS

Buffalo TeraStation NAS (Business-class) include NUT for UPS support.

Eaton — Intelligent Power Controller

Eaton Intelligent Power Controller provides easy infrastructure monitoring solution, using the 42ITy™ Open Source data center monitoring software stack, which relies on NUT for power devices monitoring.

Legacy and discontinued projects

GKrellM NUT

Simple UPS monitoring plugin for GKrellM. Uses NUT (Network UPS Tools) for UPS connection.

PHP4 / GD / MySQL / jpgraph package to visualize logged UPS status data.

Eaton — Personal Solution Pac

NUT configuration and monitoring software for Eaton (previously MGE Office Protection Systems) units.

UPS Monitor

Multi-threaded python/GTK2 graphical monitoring application.

Notes

Client authors: send updates on your releases to the NUT users mailing list. We will also put a link to you in the news section of the top page when things change.

If you know of a project which should be listed, please send in the URL.