APC UPS kezelő telepítése (Stretch)

Work in progress - még ne vedd komolyan!

Ez a cikk az APC SmartUPS és BackUPS típusú szünetmentes tápegységeinek vezérlésére és állapotuk lekérdezésére szolgáló (funkciójában a Microsoft környezetben használatos PowerChute-hoz hasonló, de parancssori) apcupsd eszköz telepítését és beállítását ismerteti Debian Stretch környezetben.

Az apcupsd két üzemmódban működtethető:

• NIS master - a számítógép közvetlen kapcsolatban áll a tápegységgel, és képes azt vezérelni, illetve annak állapotát a hálózaton megosztani;
• NIS slave - a számítógép képes a tápegység állapotát a mastertől lekérdezni és erre reagálni - pl. a tápegység kimerülése előtt önmagát szabályosan leállítani.

Egy számítógép működhet egyszerre mindkét üzemmódban is.

Telepítés

Mindkét üzemmódhoz ugyanazt a Debian csomagot kell telepíteni, csak a telepítés utáni beállításokban van különbség.

apt-get install apcupsd apcupsd-doc  # a dokumentáció telepítése opcionális

A telepítést követően állítsuk le a konfigurálatlan daemont, mentsük el a maintainer által biztosított konfigurációt, és készítsünk helyette egy új, egyelőre üres állományt:

systemctl stop apcupsd

mv /etc/apcupsd/apcupsd.conf /etc/apcupsd/apcupsd.conf.bak
touch /etc/apcupsd/apcupsd.conf

Konfigurálás NIS master és standalone üzemmódban

Ezt a szakaszt végre kell hajtani minden olyan számítógépen, amelyik közvetlenül csatlakozik az UPS-hez.

Csatlakoztassuk az UPS-t és ellenőrizzük, hogy a Linux kernel felismeri-e az eszközt

• USB csatlakozás esetén:

lsusb  # az alábbihoz hasonló sort keressünk

Bus 002 Device 002: ID 051d:0002 American Power Conversion Uninterruptible Power Supply

• Soros porti csatlakozás esetén:

TODO!

Ha a csatlakozás sikeres, készítsük el a konfigurációs állományt - az alábbi példában a tápegység USB-n csatlakozik, kizárólag ezt a számítógépet látja el (standalone konfiguráció) és az alapértelmezett shutdown feltételek (5% töltöttség vagy 3' hátralévő idő) esetén állítja le a számítógépet:

-rw-r--r-- root root /etc/apcupsd/apcupsd.conf

## apcupsd.conf v1.1 ##

# NIS Master configuration

# Specification of the UPS connected - see man apcupsd.conf
UPSNAME APCUPS
UPSCABLE usb
UPSTYPE usb
# we don't use APC ShareUPS expansion card
UPSCLASS standalone
UPSMODE disable
## device autodetection
DEVICE 
LOCKFILE /var/lock
POLLTIME 60

# Netserver is always necessary for apcaccess and Munin monitoring 
NETSERVER on
## restricted to the localhost for a standalone device
NISIP 127.0.0.1
## non restricted for a real NIS Master
#NISIP 0.0.0.0
NISPORT 3551
EVENTSFILE /var/log/apcupsd.events
EVENTSFILEMAX 10

# Settings to control the system logging
STATTIME 0
STATFILE /var/log/apcupsd.status
LOGSTATS off
DATATIME 0
FACILITY DAEMON

# Power failure handling
SCRIPTDIR /etc/apcupsd
PWRFAILDIR /etc/apcupsd
NOLOGINDIR /etc
ONBATTERYDELAY 6
## shutdown if any of the following events occur
## level of charge in %
BATTERYLEVEL 5
## minutes left
MINUTES 3
## running on batteries (0: disable)
TIMEOUT 0
## see man apcupsd.conf 
ANNOY 0
KILLDELAY 0
NOLOGON disable

A fenti állományban UPSNAME a telepítés alatt álló szerverhez kapcsolódó UPS tetszőlegesen megadható neve. Az egyéb paramétereket az apcupsd manual részletezi.

Gyorsteszt

Teszteléshez indítsuk el a démont és figyeljük a /var/log/apcupsd.events állományt:

systemctl start apcupsd; tail -f /var/log/apcupsd.events

ebben sikeres indulásra utaló üzenetnek kell megjelennie. Ha a démon fut, próbáljuk meg lekérdezni az UPS állapotát az

apcaccess status

paranccsal! Siker esetén - ha van rá lehetőség - szimuláljunk áramkimaradást az UPS tápellátásának kb. egy percre történő megszüntetésével, és ellenőrizzük, hogy ezt az eseményt a telepítés alatt álló szerver észleli, illetőleg megfelelően kezeli-e.

Sikeres teszt után jelezhetjük, hogy a konfigurációs állomány érvényes, a rendszerindításkor a daemon elindítható:

-rw-r--r-- root root /etc/default/apcupsd

[...]
ISCONFIGURED=yes

Irodalom

• Az APC honlapja
• Az apcupsd honlapja
• Az apcupsd a Debian Wikiben