Apcupsd настройка в windows

Конфигурация

Ведущий

Ведомые

UPSCABLE ether
UPSTYPE net
DEVICE master-dvs.local:3551
POLLTIME 10
BATTERYLEVEL 80
MINUTES 6

Расписания

Для минимизации казусов, я выбрал такие значения директив «BATTERYLEVEL» и «MINUTES»:

Role	BATTERYLEVEL	MINUTES
Primary7)	90	7
Slaves	80	6
Master9)	70	5

Т.к. в этой модели ведомые опрашивают ведущего, а не ведущий уведомляет ведомых, для корректной последовательности выключения важно, чтобы ведущий выключался последним, иначе, при потере связи с ведущим, ведомые сразу выключатся не взирая на «расписание»!

Уведомления

Дисклеймер

Последнее изменение: 2023/09/21 01:28 —

Николай Солошин

Last modified: Jun. 11, 2010

Contents
1 - Summary
2 - Dependencies
3 - Apcupsd installation
4 - Service configuration
5 - Apcaccess example
6 - Apctray example
7 - Service check


1 - Summary

This guide will show how to install apcupsd in Windows. Apcupsd is used
for power management and controlling of APC UPS's. This has been tested in
Windows 2000, XP, 2003 and 2008.


2 - Dependencies

You will need to have Windows configured to send emails using Blat. You will
will also need some information about the UPS and the UPS cable.
  Model number
  UPS cable type
The serial port or USB ports will need to be enabled in the BIOS of the
computer. If you enabled the serial port in the BIOS and plan to use it, you
can find out what the serial COM port is by doing the following. Type the
following in at the Run button on the Start Menu. This will open the device
management console.
  devmgmt.msc
Expand Port (COM & LPT) to find the serial COM port number in the computer.



For this guide we will use the serial port.


3 - Apcupsd installation

Download the apcupsd Windows package at http://www.apcupsd.org/. Run the
installer and keep all components selected to be installed.


        

          Картинка с сайта: www.packetwatch.net
        
      

I set the destination folder to be C:\Program Files\apcupsd. Uncheck the box to
edit the client configuration file (apcupsd.conf). On the next screen, keep the
box checked next to Install Apcupsd as a Service and uncheck the box next to
Start Apcupsd now. Next, you will get a message that says the apcupsd service
has been successfully installed.



Keep the box checked to Install the icon in the System Tray. Next, you will get
a message that says the apctray has been successfully installed.



The apcupsd service and the apctray application have been successfully installed.


4 - Service configuration

We need to make a change in the registry to the apcupsd service so that it will
kill the power to the UPS after the computer has been shut down. Open the
registry editor by typing the following at the Run button on the Start Menu.
  regedit
Navigate to the following area and change the ImagePath entry to end in -p.
  HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Apcupsd
  


Set it so that the apcupsd service will start when the system starts up. Open
the services management console by typing the following at the Run button on
the Start Menu.
  services.msc
Set the Apcupsd UPS Monitor service to have it's startup type to be Automatic.


        

          Картинка с сайта: www.packetwatch.net
        
      

You can modify the apccontrol script to send email notifications for different
UPS events. The apccontrol script is the following file.
  C:\Program Files\apcupsd\etc\apcupsd\apccontrol.bat
Navigate to C:\Program Files\apcupsd\etc\apcupsd and make a backup of the
apccontrol.bat file. Afterwards, edit the apccontrol.bat file.

The configuration file that the apcupsd service will use is the following file.
  C:\Program Files\apcupsd\etc\apcupsd\apcupsd.conf
You can create your own configuration file. Here is a simple example. This uses
an APC UPS 940-0095A serial cable.
  ## apcupsd.conf v1.1 ##
  UPSCABLE 940-0095A
  UPSTYPE apcsmart
  DEVICE COM1
  UPSCLASS standalone
  UPSMODE disable
Navigate to C:\Program Files\apcupsd\etc\apcupsd and make a backup of the
apcupsd.conf file. Afterwards, edit the apcupsd.conf file.

Open a command prompt and start the apcupsd service.


        

          Картинка с сайта: www.packetwatch.net
        
      

The service has successfully started. Also, you will now see the apctray icon
in the lower right-hand corner of the screen near where the time is displayed.




5 - Apcaccess example

This command prints the UPS model number, software version, status, load
percentage, battery charge and other information.


        

          Картинка с сайта: www.packetwatch.net
        
      


6 - Apctray example

You can view the apcaccess information graphically by right-clicking on the
apctray icon and selecting Status.


        

          Картинка с сайта: www.packetwatch.net
        
      


7 - Service check

Reboot your computer. Log in like normal and check to see that the apcupsd
service is running. Open the services management console by typing the
following at the Run button on the Start Menu.
  services.msc
Check to make sure that the apcupsd service has started.


        

          Картинка с сайта: www.packetwatch.net
        
      

That's it, now you have apcupsd running in Windows.

Содержание

apt-get install apcupsd

Дополнительно можно установить документацию и APC UPS Power Management (web interface):

apt-get install apcupsd-doc apcupsd-cgi

User Manual

Файл: /etc/apcupsd/apcupsd.conf

Здесь приведены переменные для настройки управления ИБП при аварии питания, ни одна из этих переменных не является обязательной. Но если вы используете ИБП с упрощенной системой команд (dumb) он не определяет низкий заряд батареи и поэтому нужно задать значение для переменной TIMEOUT которая используется для выключения системы.

Уровень заряда батарей в процентах (%).

Если указано значение BATTERYLEVEL, то во время отключения электроэнергии, apcupsd выдаст команду на завершение выключение системы, когда уровень заряда батареи упадет ниже заданного значения.

Значение по умолчанию: 5

Значение для отключения этого параметра: -1

Этот параметр игнорируется для простых ИБП (не имеющих расширенной сигнализации).

Время работы от батарей, в минутах.

Если указано значение MINUTES, то во время отключения электроэнергии, apcupsd выдаст команду на завершение выключение системы, когда оставшиеся время работы от батарей (рассчитанное ИБП) будет меньше заданного времени.

Значение по умолчанию: 3

Расчетное время работы от батарей TIMELEFT может быть получено в результате выполнения команды apcaccess

Если значение равно нулю или неправдоподобное, то ИБП, вероятно, сломан.

Значение для отключения этого параметра: -1

Этот параметр игнорируется для простых ИБП (не имеющих расширенной сигнализации).

Следует отметить, что некоторые могут выдавать неверное значение, когда аккумулятор полностью заряжен.

Время в секундах.

После отключения электропитания, apcupsd будет остановить систему, когда заданное в этом параметре время в секундах, уже истекло.

Чтобы отключить этот параметр установите его значение -1

Обычно для всех моделей Smart UPS и простых ИБП с кабелями, которые поддерживают индикация разряда батарей, это должно быть нулю, так что время завершения работы будет зависеть от уровня заряда аккумулятора (BATTERYLEVEL) и/или времени работы от батарей (MINUTES), либо в случае напряжения сигнализации ИБП, когда батарея исчерпан.

Эта команда необходима для простых (не имеющих расширенной сигнализации ИБП), которые не обеспечивают выдачу сигнала полного разряда аккумулятора (для них только тестирование может определить этот момент).

Для получения дополнительной информации см. apctest.

Этот таймер может быть также полезно, если вы хотите, чтобы некоторые рабом машины остановки до другой машины для экономии энергии батареи. Это также полезно для тестирования apcupsd потому что вы можете заставить быстрого выключения, установив небольшой стоимости (например 60) и потянув за вилку к ИБП.

TIMEOUT, BATTERYLEVEL, and MINUTES can be set together without problems. apcupsd will react to the first case or test that is valid. Normally SmartUPS users will set TIMEOUT to zero so that the system is shutdown depending on the percentage battery charge remaining (BATTERYLEVEL) or the remaining battery runtime (MINUTES).

Время в секундах.

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

Этот счётчик запускается только тогда, когда ИБП работает от батареи.

Значение по умолчанию это 300 секунд (5 минут).

По умолчанию, отправить сообщение на системную консоль в системах Unix и всплывающее сообщение в MS Windows.

Значение ANNOYDELAY должно быть больше ANNOY, с тем чтобы получить слишком частые сообщения.

Время в секундах.

Время задержки в секундах перед тем, как apcupsd начнёт рассылать подключённым пользователям предложение выйти из системы. Этот таймер запускается только после того, ИБП работает от батареи. Этот таймер сбрасывается, когда внешнее питание возобновляется. Значение по умолчанию составляет 60 секунд. Таким образом, первое предупреждение, чтобы выйти из системы происходит после 60 секунд работы от батарей, при условии, что NOLOGON не установлен, чтобы отключить.

Имя устройства.

Например для Com 1 значение: /dev/ttyS0

Тип интерфейса.

/etc/apcupsd/apcupsd.conf

#
# Master
#
 
UPSNAME UPS_Name
UPSCABLE 940-0024C
UPSTYPE apcsmart
DEVICE /dev/ttyS0
POLLTIME 60
LOCKFILE /var/lock
SCRIPTDIR /etc/apcupsd
PWRFAILDIR /etc/apcupsd
NOLOGINDIR /etc
ONBATTERYDELAY 6
BATTERYLEVEL 15
MINUTES 10
TIMEOUT 0
ANNOY 300
ANNOYDELAY 60
NOLOGON disable
KILLDELAY 0
NETSERVER on
NISIP 0.0.0.0
NISPORT 3551
 
EVENTSFILE /var/log/apcupsd.events
EVENTSFILEMAX 10
 
UPSCLASS sharemaster
UPSMODE disable
 
STATTIME 600
STATFILE /tmp/apcupsd.status
LOGSTATS off
DATATIME 0

/etc/apcupsd/apcupsd.conf

#
# Slave
#
 
UPSTYPE apcsmart
UPSTYPE net
DEVICE IP-Address:Port
POLLTIME 60
LOCKFILE /var/lock
SCRIPTDIR /etc/apcupsd
PWRFAILDIR /etc/apcupsd
NOLOGINDIR /etc
ONBATTERYDELAY 6
BATTERYLEVEL 5
MINUTES 15
TIMEOUT 0
ANNOY 300
ANNOYDELAY 60
NOLOGON disable
KILLDELAY 0
NETSERVER on
NISIP 0.0.0.0
NISPORT 3551
 
EVENTSFILE /var/log/apcupsd.events
EVENTSFILEMAX 10
 
UPSCLASS shareslave
UPSMODE disable
 
STATTIME 3600
STATFILE /var/log/apcupsd.status
LOGSTATS off
DATATIME 0

После настройки:

1. Вносим изменения в файл

/etc/default/apcupsd

ISCONFIGURED=yes

2. Запускаем

service apcupsd start

Отслеживание состояния ИБП через apcupsd Zabbix сервером.

Template APCUPSd

Ссылка на Share.Zabbix.com

Переменные:

• Имя

• Текущий статус

• Уровень заряда батареи

• Внутренняя температура

• Напряжение на входе

• Уровень нагрузки

• Уровень чувствительности

• Количество переходов на питание от батареи с момента запуска apcupsd

Работает через Zabbix агент, ниже приведены настройки для различных ОС:

Linux

/etc/zabbix/zabbix_agentd.conf.d/userparameter_apcupsd.conf

UserParameter=UPSNAME,cat /var/log/apcupsd.status|awk '/^(UPSNAME).*:/ {print $3}'
UserParameter=STATUS,cat /var/log/apcupsd.status|awk '/^(STATUS).*:/ {print $3,$4,$5}'
UserParameter=ITEMP,cat /var/log/apcupsd.status|awk '/^(ITEMP).*:/ {print $3}'
UserParameter=LOADPCT,cat /var/log/apcupsd.status|awk '/^(LOADPCT).*:/ {print $3}'
UserParameter=NUMXFERS,cat /var/log/apcupsd.status|awk '/^(NUMXFERS).*:/ {print $3}'
UserParameter=BCHARGE,cat /var/log/apcupsd.status|awk '/^(BCHARGE).*:/ {print $3}'
UserParameter=SENSE,cat /var/log/apcupsd.status|awk '/^(SENSE).*:/ {print $3}'
UserParameter=LINEV,cat /var/log/apcupsd.status|awk '/^(LINEV).*:/ {print $3}'

MS Windows

В этом примере использован Gawk 3.1.6.

c:\zabbix\conf\userparameter_apcupsd.win.conf

UserParameter=UPSNAME,type c:\apcupsd\etc\apcupsd\apcupsd.status|c:\programs\bin\awk "/^(UPSNAME).*:/ {print $3}"
UserParameter=STATUS,type c:\apcupsd\etc\apcupsd\apcupsd.status|c:\programs\bin\awk "/^(STATUS).*:/ {print $3,$4,$5}"
UserParameter=ITEMP,type c:\apcupsd\etc\apcupsd\apcupsd.status|c:\programs\bin\awk "/^(ITEMP).*:/ {print $3}"
UserParameter=LOADPCT,type c:\apcupsd\etc\apcupsd\apcupsd.status|c:\programs\bin\awk "/^(LOADPCT).*:/ {print $3}"
UserParameter=NUMXFERS,type c:\apcupsd\etc\apcupsd\apcupsd.status|c:\programs\bin\awk "/^(NUMXFERS).*:/ {print $3}"
UserParameter=BCHARGE,type c:\apcupsd\etc\apcupsd\apcupsd.status|c:\programs\bin\awk "/^(BCHARGE).*:/ {print $3}"
UserParameter=SENSE,type c:\apcupsd\etc\apcupsd\apcupsd.status|c:\programs\bin\awk "/^(SENSE).*:/ {print $3}"
UserParameter=LINEV,type c:\apcupsd\etc\apcupsd\apcupsd.status|c:\programs\bin\awk "/^(LINEV).*:/ {print $3}"

Sign up