Подсистема контроля UPS

h3. Зачем нужна подсистема контроля UPS?

При отсутствии подключенного UPS, подсистема минимизирует риски потери информации при работе биллинга путем перевода базы данных в синхронный режим. В этом режиме изменения и новые данные сразу записываются на диск.
При наличии подключенного UPS, подсистема переключает базу данных в асинхронный режим, в этом случае изменения и новые данные хранятся в памяти и периодически сбрасываются на диск подсистемой ввода/вывода операционной системы. Это дает гораздо большую производительность, чем при синхронном режиме.

h3. Ответы на очевидные вопросы

_Возникает вопрос_: А нужно ли настраивать UPS, если база и так надежно защищена синхронным режимом?
_Ответ_: Да, нужно. Потому что синхронный режим не гарантирует корректную работы БД после сбоя по питанию, а также кроме БД в биллинге есть другие подсистемы, которые при внезапном отключении питания могут принести долгий простой и много боли при восстановлении.

h2. Настройка подсистемы

Все конфигурационные файлы находятся в директории "*/etc/ups*".
* *ups.conf* \- настройки *nut* для работы с UPS (драйвер/порт/наименование).
* *upsd.conf* \- настройка основного демона *upsd* Network UPS Tools.
* *upsd.users* \- контроль доступа к UPS демону (профили пользователей).
* *upsmon.conf* \- настройка текущего клиентского агента.

h4. ups.conf

Конфигурация подключенных UPS.

* *\[ups_name\]* \- это имя используется как адрес вашего UPS. Вы можете его изменить на любое произвольное имя;
* *driver* \- драйвер, используемый для работы с UPS;
* *port* \- порт, на котором висит UPS (для подключения через USB указываете значение "auto"). Для snmp-ups: имя хоста SNMP агента. Для newhidups: значение "auto" для автоматического соединения с USB UPS;
* *bus* \- канал/шина на котором расположен порт;
* *desc* \- описание устройства;
* *sdorder* \- необязательный элемент. При наличии нескольких UPS подключенных к этому серверу можно выключать UPS в определенном порядке. используя *upsdrvctl* к примеру можно выключить все 0s или 1s, 2s и тд. Для исключения последовательной остановки используйте \-1;
* *nolock* \- необязательный элемент, его не рекомендуется использовать в этом конфиге. Он служит для отключения блокировки порта при пользовании утилитой;
* *maxstartdelay* \- необязательный элемент. Может быть, заданна как глобальная переменная выше вашего первого UPS. Это значение определяет, сколько *upsdrvctl* будет ожидать окончания запуска драйвера. Данная возможность предоставляет стабильность в работе. Значение по умолчанию равно 45 секундам;
* *cable* \- Если драйвер UPS требует дополнительных параметров, вы можете указать их здесь. Не указывайте это значение, если ваше подключение к UPS стандартно.

h4. upsd.conf

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

* *MAXAGE* \- по умолчанию 15 секунд. Это частота обновления данных клиентов после остановки драйвера UPS. Следует использовать другое значение только в том случае, если у вас трудности с обновлением данных;
* *LISTEN address port* \- здесь указывается IP адрес и порт 3493 (по умолчанию) для прослушивания подключений;
* *MAXCONN connections* \- по умолчанию используется 1024 подключений. Каждый UPS, каждого LISTEN адреса и каждого клиента считается как одно подключение. Если на сервере заполнится количество подключений, он больше не будет принимать новых входящих клиентских подключений.

h4. upsd.users

Контроль доступа для UPS демона (профили пользователей). Именно в этом файле вы указываете, кто и в какой мере будет работать с *nut*.
* *\[NAME\]* \- имя пользователя;
* *password* \- пароль пользователя;
* *actions* \- возможность настройки см ниже;
* *instcmds* \- выполняемые команды см ниже;
* *upsmon* \- вид подключения клиентов см ниже.

Каждый UPS монитор может определяться как один из трех возможных типов:
*upsmon master* \- полные полномочия управления питанием подключенных к системе UPS. Отвечает за выключение разряженного аккумулятора. Выключение происходит после безопасного выключения всех *slave* мониторов. Если ваш UPS подключен непосредственно к системе через последовательный порт, то для upsmon этой системы следует определить его как *master*.

*upsmon slave* \- эта система, под управлением *upsmon master* и она не выключается непосредственно. Операционная система будет выключена перед отключением питания *master*. Используйте этот режим при запуске монитора на других серверах работающих на том же UPS. И очевидно, что только один сервер может быть подключен к последовательному порту на UPS, коим будет является *master*. Все остальные сервера будут *slave*.

*upsmon monitor-only* \- при этом режиме будут создаваться уведомления о состоянии или изменении работы батареи, переключении на линию и т.д., но не будет завершать работу системы.

*actions* \- Действия пользователя с применением upsd.

* SET - изменить значения определенных переменных в UPS;
* FSD - установка флага "принудительного выключения" для UPS.

*instcmds* \- разрешения пользователю на инициирование конкретных команд. Применяя "ALL" вы разрешаете использовать все команды, Существует множество команд выполните "*upscmd \-l&nbsp; <имя UPS в настройках>*" чтобы увидеть, что ваше оборудование поддерживает. Вот, к примеру, несколько команд.
* test.panel.start - старт теста передней панели
* test.battery.start - старт теста батареи
* test.battery.stop - остановка теста батареи
* calibrate.start - запуск калибровки батареи
* calibrate.stop - остановка калибровки батареи

h4. upsmon.conf

Этот конфигурационный файл предоставляет основные функции в программе мониторинга UPS, например это безопасное завершение работы при сбое питания, уведомления и другие переменные. В многоуровневой схеме утилиты *nut* это клиент.
* *MINSUPPLIES* \- указываем количество блоков питания которые должны получать мощность сохраняя систему запущенной. Большинство систем имеют один БП. Но дорогие сервера, например HP NetServer LH4 могут работать с 2 из 4 БП и ему нужно ставить 2;
* *SHUTDOWNCMD* \- upsmon выполняет эту команду, когда систему необходимо выключить;
* *POLLFREQ* \- опрос мониторами с частотой (измеряется в секундах) для обычной деятельности. Вы можете отрегулировать эту частоту опроса, чтобы upsmon не “зашумлял” вашу сеть, но не вносите слишком большие значения тк. оно может пропустить отключение питания;
* *POLLFREQALERT* \- опрос UPS с частотой в секундах. Можно сделать значение поменьше, чем POLLFREQ для лучшей чувствительности работы батареи;
* *HOSTSYNC* \- как долго upsmon будет ждать перед переходом к следующему upsmon. master upsmon использует это число при ожидании slaves чтобы отключиться после того как он установил флаг принудительное завершение работы (FSD). И если slaves не отключаться после этого тайм аута, то выключение продолжится без них;
* *DEADTIME* \- интервал ожидания перед объявлением статуса UPS как «мертвый». Upsmon требует, чтобы UPS предоставлял свою статус информацию, каждые несколько секунд (см. POLLFREQ и POLLFREQALERT). Если статус загрузки, UPS помечен fails. И если оно остается fails более чем DEADTIME секунд, то UPS помечается как «мертвый». Выставляйте значение этой переменной в несколько (в три раза пойдет) раз больше чем *POLLFREQ* и *POLLFREQALERT*;
* *POWERDOWNFLAG* \- флаг файла для форсирования завершения работы UPS в master системе;
* *NOTIFYMSG* \- изменение сообщения, отправленные upsmon при возникновении определенных событий;
* *NOTIFYCMD* \- upsmon отправляет сообщение при происшествиях;
* *NOTIFYFLAG* \- изменение поведения upsmon при возникновении событий NOTIFY;
* *RBWARNTIME* \- предупреждение замены аккумулятора в секундах;
* *NOCOMMWARNTIME* \- предупреждение по времени при не общении к UPS в секундах;
* *FINALDELAY* \- через сколько выполнить SHUTDOWNCMD.

----

3. если UPS один и подключается через USB (а так же максимально совместим с *nut*), то в настройках можно указать порт как *"auto"*;

4. если UPS не один, *nut* не может определить порт в режиме "auto", или тип подключения не через USB, то нужно выяснить порт, через который произведено подключение UPS;

5. найти драйвер для вашего UPS по ссылке --- [http://www.networkupstools.org/ddl/] находите модель UPS и смотрите строку *driver.name*;

6. если UPS в единственном числе и подключен на прямую к серверу, то нужно использовать standalone мод, если же схема другая (UPS подключен не напярмую, несколько ups), то *nut* нужно сконфигурировать под данную схему, обращайтесь в тех. поддержу;

0. обязательно прочитать заметки\!


1. Указываем *nut*, &nbsp;то есть что UPS один и подключен на прямую к серверу ;
{code}vim /etc/ups/nut.conf
— далее изменяем переменную
MODE = standalone{code}
2. Добавляем UPS (в качестве примера был выбран APC Black-UPS ES 700);
{code:lang=actionscript}vim /etc/ups/ups.conf
— добавляем строки
[apces700]
driver = usbhid-ups
desc = "Back-UPS ES 700"
bus = "004"
 port = "005"
vendorid = 051d
productid = 0002{code}
В случае, если управление ups будет происходить по snmp, данный файл будет выглядеть примерно следующим образом:
{code}
[apces700]
driver = snmp-ups
port = 10.0.0.1
community = public
snmp_version = v1
pollfreq = 15
desc = "Example SNMP v1 device"

[apces700]

— добавляем строки

upsmon master{code}
6. Устанавливаем основные настройки *nut*;

NOTIFYCMD /usr/sbin/upssched
POLLFREQ 5
POLLFREQALERT 5
HOSTSYNC 15
DEADTIME 15
POWERDOWNFLAG /etc/killpower
NOTIFYMSG ONLINE "UPS %s on line power"
NOTIFYMSG ONBATT "UPS %s on battery"
NOTIFYMSG LOWBATT "UPS %s battery is low"
NOTIFYMSG FSD "UPS %s: forced shutdown in progress"
NOTIFYMSG COMMOK "Communications with UPS %s established"
NOTIFYMSG COMMBAD "Communications with UPS %s lost"
NOTIFYMSG SHUTDOWN "Auto logout and shutdown proceeding"
NOTIFYMSG REPLBATT "UPS %s battery needs to be replaced"
NOTIFYMSG NOCOMM "UPS %s is unavailable"
NOTIFYMSG NOPARENT "upsmon parent process died - shutdown impossible"
NOTIFYFLAG ONLINE SYSLOG+EXEC
NOTIFYFLAG ONBATT SYSLOG+EXEC
NOTIFYFLAG LOWBATT SYSLOG+EXEC
NOTIFYFLAG FSD SYSLOG+EXEC
NOTIFYFLAG COMMOK SYSLOG+EXEC
NOTIFYFLAG COMMBAD SYSLOG+EXEC
NOTIFYFLAG SHUTDOWN SYSLOG+EXEC
NOTIFYFLAG REPLBATT SYSLOG+EXEC
NOTIFYFLAG NOCOMM SYSLOG+EXEC
NOTIFYFLAG NOPARENT SYSLOG+EXEC
NOCOMMWARNTIME 300
FINALDELAY 0{code}
7. Запускаем демон;
{code}service ups start{code}

9. Настраиваем планировщик *nut*;
{code}vim /etc/ups/upssched.conf
— добавляем
CMDSCRIPT /etc/ups/cmd.sh
PIPEFN /tmp/upspipe
LOCKFN /tmp/upslock
AT COMMBAD * EXECUTE commbad
AT COMMOK * EXECUTE commok
AT NOCOMM * EXECUTE nocomm
AT ONBATT * EXECUTE powerout
AT ONBATT * START-TIMER shutdownnow 90
AT LOWBATT * EXECUTE shutdowncritical
AT ONLINE * CANCEL-TIMER shutdownnow
AT ONLINE * EXECUTE powerup
{code}
10. Создаем скрипт поведения UPS при штатных ситуациях;
{code:lang=actionscript}touch /etc/ups/cmd.sh
chmod 777 /etc/ups/cmd.sh
vim /etc/ups/cmd.sh
- добавляем

#!/bin/bash
case $1 in
commbad)
logger "UPS communications failure"
;;
commok)
logger "UPS communications restored"
;;
nocomm)
logger "UPS communications cannot be established"
;;

logger "UPS has been on battery for 90 seconds. Starting orderly shutdown"
/etc/init.d/apps stop
/sbin/shutdown -h now
;;
shutdowncritical)
logger "UPS battery level CRITICAL. Shutting down NOW!!!!"
/sbin/shutdown -h now
;;

logger "Unrecognized command: $1"
;;
esac{code}

11. Добавляем демон в автозагрузку;

{code}

* Внимательно просмотрите листинги, <имя_пользователя>, <ваш_пароль>, <имя_UPS> --- это абстрактное обозначение *Ваших* данных, так же *не надо печатать угловые скобки*, т.е. попытка ввода в настройки *nut* строчек типа: <имя_пользователя>, <имя_UPS>, <etc>... --- приведет к ошибкам/некорректной работе;
* Если схема подключения отличается от "эталонной", то при возникновении затруднений --- обратиться в техподдержку;
* Если UPS один и подключается через USB, то в настройках можно указать порт ("port") как "auto" и не вводить "bus";
* Что бы узнать номер порта и шины UPS, можно воспользоваться утилитой lsusb (если UPS подключен через USB), другие варианты подключения (COM, Ethernet) нужно настраивать индивидуально;
* Нужный драйвер можно посмотреть на странице проекта --- [http://www.networkupstools.org/ddl/|http://www.networkupstools.org/ddl/], находите модель UPS и смотрите строку driver.name;
* Все параметры настройки UPS можно посмотреть в разделе "Конфигурационные файлы" --- пункт "ups.conf"
* В зависимости от списка команд можно гибко настраивать поведение UPS, если драйвер/UPS поддерживает то или иное действие;
* shutdown.return --- данную опцию нужно проверять командой: upscmd \-l <имя_UPS>@localhost
* Драйвер для Вашего устройства или производителя устройства можно попробовать найти в файле */usr/share/driver.list*, например:
{code}cat /usr/share/driver.list | grep -i Smart-UPS{code}
Вывод, в котором выведены драйвера с которыми можно попробовать интегрировать APC Smart-UPS:
{code}"APC" "ups" "1" "Smart-UPS" "" "apcsmart"
"APC" "ups" "2" "Smart-UPS USB" "USB" "usbhid-ups"
"APC" "ups" "3" "Smart-UPS RT XL" "AP9618 SNMP monitoring card" "snmp-ups"
{code}

{code}
/etc/init.d/apps stop
{code}
# По завершении остановки сервисов биллинга, убедитесь, что UPS подключен и функционирует
{code}
# upsc -L
apces700: Back-UPS ES 700
{code}
# Запустите мониторинг системного лога
{code}
tail -f -n 0 /var/log/messages | grep -Ei 'ups|shut'
{code}
# Отключите UPS от сети.
Сообщения в логе должны выглядеть приблизительно так:
{code}
upsmon[1393]: UPS apces700@localhost on battery
upssched[22505]: Executing command: powerout
logger: UPS on battery. Shutdown in 90 seconds....
upsd[1388]: Instant command: ups@127.0.0.1 did shutdown.return on apces700
upssched[22509]: Timer daemon started
upssched[22509]: New timer: shutdownnow (90 seconds)
usbhid-ups[1384]: instcmd: command [shutdown.return] handled
{code}
По истечении 90 секунд, сервер должен выключиться.

При успешном завершении работы, тест можно считать пройденным. При возникновении каких-либо ошибок, обратитесь в техподдержку CarbonSoft.


h2. Источники

Вероятное местоположение информации о типах используемых кабелей для подключения

/app/base/usr/local/lib/nut/docs/images/cables
/app/base/usr/local/lib/nut/docs/cables