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.
Настройка NUT для управления ИБП с нескольких серверов
NUT — это Network UPS Tools или набор программных компонентов, предназначенных для мониторинга силовых устройств, таких как источники бесперебойного питания (ИБП), блоки распределения питания, солнечные контроллеры и блоки питания серверов.
В среде Linux — NUT — это стандарт де-факто для управления ИБП, который позволяет производить мониторинг ИБП не только с сервера к которому подключен ИБП, но и по сети, а так же выполнят ряд действий при наступлении определенных условий. Например, в случае когда заряд батарей ИБП истощается NUT может произвести корректное завершение работы серверов и уведомить об этом системного администратора.
Как настроить NUT на Linux и Windows серверах ? Читаем ниже.
Исходные данные: 1. В локальной сети организации есть 2 сервера под управлением Debian 8.9 (jessie) и 1 сервер под управлением Windows Server 2012 R2; 2. Есть ИБП компании APC, модель Smart-UPS 1000. ИБП подключен по USB к одному из серверов Debian 8.9 (jessie);
Задача: На сервере Debian 8.9 к которому подключен ИБП установить серверную часть NUT и настроить клиентскую часть NUT на этом сервере и других серверах. В случае перехода питания серверов на ИБП и истощения заряда батарей ИБП нужно произвести корректное завершение работы всех серверов.
Распределение IP адресов во внутренней сети компании между серверами: 192.168.100.1 (srv1.mycompany.ru) — Сервер Debian 8.9 (jessie) к которому подключен APC Smart-UPS 1000 по USB — на нем будет серверная часть NUT и клиентская; 192.168.100.2 (srv2.mycompany.ru) — Сервер Debian 8.9 (jessie) — на нем будет клиентская часть NUT; 192.168.100.3 (srv3.mycompany.ru) — Сервер Windows 2012 R2 — на нем будет клиентская часть NUT;
Настройка серверной части NUT.
1. Проверим факт обнаружения нашего ИБП ядром Linux с помощью утилиты lsusb:
Для ИБП марки APC Smart-UPS значения idVendor и idProduct будут 051d и 0002 соответственно.
2. Установка NUT (серверной части на хосте 192.168.100.1):
Далее отредактируем файл /etc/nut/ups.conf и приведем его к виду:
Этой минимальной конфигурации хватит для нашего ИБП.
Как Вы уже догадались в файле /etc/nut/ups.conf описываются все наши ИБП, а так же драйвер и их параметры для работы с NUT.
Нашему ИБП мы присвоили имя apc и будем использовать драйвер usbhid-ups. Драйвер usbhid-ups гарантировано работает с ИБП Smart-UPS компании APC. Более детально со списком драйверов и списком ИБП каких фирм может работать NUT описано на этой странице. Список параметров драйвера usbhid-ups можно посмотреть на этой странице.
3. Настройка драйвера NUT для работы с нашим ИБП.
Далее нам нужно установить права на наше USB устройство чтобы драйвер NUT смог работать с ним.
Для этого создадим правило /etc/udev/rules.d/90-nut-ups.rules для udev со следующим содержимым:
Далее нужно перечитать все правила, для этого выполним:
Для тех кто хочет понять в чем тут дело, объясняю:
При выводе информации по нашему ИБП с помощью lsusb мы можем увидеть строку «Bus 004 Device 003»:
Она говорит, что ядро Linux при подключении нашего ИБП по USB присвоило ему номер шины обмена данными 4 и id устройства 3, само наше устройство соответственно будет находится по такому пути /dev/bus/usb/004/003 а владельцем будут пользователь root и группа root с правами 664 (crw-rw-r—), но для работы драйвера NUT этого не достаточно, драйвер в таком случае не сможет управлять устройством.
С помощью файла /etc/udev/rules.d/90-nut-ups.rules и утилиты udevadm мы задали правило для сервиса udev который управляет периферией, получая от Linux ядра разного рода уведомления. По этому правилу для нового устройства с определенным idVendor и idProduct владельцем будет назначаться группа nut.
Если интересно, то запросить информацию у udev по нашему устройству можно так:
4. Теперь запустим все драйвера NUT описанные в /etc/nut/ups.conf с помощью команды:
Если в файле /etc/nut/ups.conf у Вас описаны несколько ИБП, то остановить конкретный драйвер или запустить его можно так:
5. Теперь опишем права доступа к нашему серверу NUT для доступа клиентских ОС по сети, за это отвечает файл /etc/nut/upsd.conf
Директива LISTEN задает адрес и порт на котором будет принимать соединения демон upsd (Сервер NUT).
ВНИМАНИЕ! Директивы ACL, ACCEPT, REJECT в файле /etc/nut/upsd.conf больше не используется и является устаревшей.
6. Теперь опишем пользователей и пароли для подключения клиентских устройств к серверу NUT, за это отвечает файл /etc/nut/upsd.users:
В секции [admin] мы описали пользователя для управления NUT через утилиту upscmd, а так же разрешили менять все параметры самого ИБП (строка actions = SET и instcmds = ALL). Если нужно разрешить пользователю admin менять только определенные параметры, то их нужно описать в опции instcmds, например так:
Секции [local_mon] [srv2_mon] и [srv3_mon] описывают пользователей для клиентских ОС, на них будет стоять клиентская часть NUT. В этих секциях мы указали индивидуальные пароли (опция password) и статус этих пользователей (опция upsmon).
Для пользователя local_mon мы указали в опции upsmon значение master, это сделано не спроста, дело в том что на том же ПК, где у нас будет работать сервер NUT мы настроим и клиентскую часть NUT и когда сервер NUT отправит всем клиентам сигнал о критическом состоянии батарей ИБП, то master должен выключиться самым последним из серверов, дождавшись выключения всех slave серверов.
ВНИМАНИЕ! Директива allowfrom в файле /etc/nut/upsd.users больше не используется и является устаревшей.
7. Настроим режим работы NUT на сервере 192.168.100.1 (работа в режиме сервера), для этого в файле /etc/nut/nut.conf напишем:
8. Запустим сервер NUT:
И проверим его статус:
Проверим открытые порты:
Настройка клиентской части NUT на серверах.
1. Настроим клиент мониторинга (upsmon), который будет заниматься слежением за состоянием ИБП и правильным завершением работы сервера при отсутствии электричества и полном разряде батарей. (Первый клиент у нас будет на том же хосте, что и сервер NUT, то есть на 192.168.100.1):
Для этого отредактируем файл /etc/nut/upsmon.conf и приведем его к виду:
Директиву NOTIFYCMD в которой как правило задают запуск планировщика upssched, а далее настраивают upssched.conf мы не используем. Если Вам нужно настроить уведомления на email или в мессенджеры и кастомизировать процедуру выключения, то тогда нужно настраивать планировщик. Но нам это пока не нужно.
Самое интересное здесь — это директива
В ней описывается подключение к нашему серверу NUT, формат здесь простой: MONITOR @
— берется с сервера NUT из файла /etc/nut/ups.conf, в нашем случае apc; — думаю тут все понятно, для локального клиента это localhost; — как правило это 1, если Вам нужно контролировать переход на питание от ИБП, но выключать этот сервер по сигналу NUT Вы не хотите, то установите этот параметр в 0; и — думаю тут тоже все понятно, данные берутся с сервера NUT из файла /etc/nut/upsd.users; — если указана опция master, то данный сервер будет выключаться после выключения всех slave серверов;
Так же нужно остановиться на директиве POWERDOWNFLAG и разъяснить как происходит отключение системы в случае когда заряд батарей ИБП истощается. Итак, в режиме работы от батарей, перед самым их истощением, ИБП генерирует сообщение «battery low». Демон upsmon получает это сообщение от сервера NUT (от upsd) и обрабатывает этот сигнал, вызывая команду описанную в опции SHUTDOWNCMD для корректной остановки системы. Более детально данный процесс можно описать следующей последовательностью: 1. ИБП генерирует событие «battery low»; 2. upsmon получает данный сигнал от сервера NUT и инициирует выключение ПК; 3. Создается специальный файл POWERDOWNFLAG, являющийся признаком того, что система находится в режиме отключения в связи с истощением батарей ИБП; 4. Выполняется команда SHUTDOWNCMD; 5. RC-сценарий использует проверку флага POWERDOWNFLAG для предотвращения так называемой «энергетической гонки» (power race);
«Энергетической гонкой» называется ситуация, когда ИБП переходит в режим работы от сети вскоре после генерации сигнала «battery low», в процессе останова системы. В этом случае компьютер, настроенный на автоматическое включение после сбоя электропитания окажется заложником собственной «осторожности», ведь фактически никакого сбоя не произойдет. Многие современные ИБП имеют механизмы разрешения такой ситуации и дополнительного анализа POWERDOWNFLAG флага на стороне ОС как правило не нужно, но знать про это необходимо.
Теперь перезапустим клиента NUT командой
И проверим его статус:
Проверить подключение к серверу и вывести все параметры ИБП можно командой:
Посмотреть значение какого-то конкретного параметра можно указав дополнительно его имя:
Кроме того, как я писал выше есть более сложный клиент (upscmd), который позволяет не только просматривать настройки, но и выполнять команды. Список доступных команд можно увидеть вот так:
2. Теперь настроим клиент мониторинга NUT (upsmon) на сервере под управлением Debian Linux (хост 192.168.100.2):
Отредактируем файл /etc/nut/upsmon.conf и приведем его к виду:
Отредактируем файл /etc/nut/nut.conf и приведем его к виду:
Теперь перезапустим клиента NUT командой
И проверим подключение к серверу NUT путем вывода всех параметров ИБП командой:
3. Теперь настроим клиента мониторинга NUT (upsmon) на серверe под управлением Windows Server 2012 R2 (хост 192.168.100.3):
Скачиваем инсталлятор NUT под Windows с официального сайта и устанавливаем.
Скачиваем OpenSSL 1.0.2q (x86) или новее, но обязательно x86 версию (Win32 OpenSSL v1.0.2q Light) и устанавливаем, в процессе установки когда нас спросят копировать файлы библиотеки в системную паку — отказываемся, далее копируем 3 файла (ssleay32.dll, libssl32.dll и libeay32.dll) из «C:\OpenSSL-Win32\» в «C:\Program Files (x86)\NUT\bin\»
Переименовываем файл «C:\Program Files (x86)\NUT\etc\nut.conf.sample» в «C:\Program Files (x86)\NUT\etc\nut.conf» и пишем в конце файла:
Далее переименовываем файл «C:\Program Files (x86)\NUT\etc\upsmon.conf.sample» в «C:\Program Files (x86)\NUT\etc\upsmon.conf» и приводим его к виду:
Открываем консоль cmd с правами Администратор и рестартуем службу:
И наконец там же из cmd проверяем подключение к серверу NUT путем вывода всех параметров ИБП командой:
На этом все, до скорых встреч. Если у Вас возникли вопросы или Вы хотите чтобы я помог Вам, то Вы всегда можете связаться со мной разными доступными способами.
