USV apcupsd - Deamon installieren CentOS 5

Der apcupsd ist eine Dienst (Deamon), welcher die Überwachung und Steuerung der USV leisten kann. Im Englischen UPS - (Uninterruptible Power Supplie), zu deutsch USV - (Unterbrechungsfreie Strom Versorgung).

Herunterladen

Es wird empfohlen die letzte stabile Version von Apcupsd herunter zu laden. Aktuell ist das die Version 3.14.8 - die zu herunter ladende Datei lautet aktuell

apcupsd-3.14.8-1.el5.i386.rpm

Installation

Ab hier werden root-Rechte zur Ausführung der nachfolgenden Befehle benötigt. Um root zu werden geben Sie bitte folgenden Befehl ein:

$ su -
Password:

Ein mögliche Installation wäre das RPM-Paket mit folgendem Befehl zu installieren, ausgehend davon das das RPM-Paket sich im Verzeichnis /tmp befindet:

# yum localinstall --nogpgcheck /tmp/apcupsd-3.14.8-1.el5.i386.rpm

Nach erfolgreicher Installation, kann mit nachfolgendem Befehl überprüft werden, welche Dateien innerhalb des Installationspakets apcupsd-3.14.8-1.el5.i386.rpm enthalten waren:

# rpm -qil apcupsd
Name        : apcupsd                      Relocations: (not relocatable)
Version     : 3.14.8                            Vendor: APC UPS Daemon Team
Release     : 1                             Build Date: Mon 18 Jan 2010 11:59:37 PM CET
Install Date: Sun 24 Jan 2010 11:34:17 AM CET      Build Host: steinman.kroptech.com
Group       : System Environment/Daemons    Source RPM: apcupsd-3.14.8-1.src.rpm
Size        : 1386259                          License: GPL v2
Signature   : DSA/SHA1, Tue 19 Jan 2010 01:18:55 AM CET, Key ID 24e84804a57b2d90
Packager    : Adam Kropelin <akropel1@rochester.rr.com>
URL         : http://www.apcupsd.com
Summary     : APC UPS Power Control Daemon for Linux
Description :
Apcupsd can be used for controlling most APC UPSes. During a
power failure, apcupsd will inform the users about the power
failure and that a shutdown may occur.  If power is not restored,
a system shutdown will follow when the battery is exausted, a
timeout (seconds) expires, or the battery runtime expires based
on internal APC calculations determined by power consumption
rates.  If the power is restored before one of the above shutdown
conditions is met, apcupsd will inform users about this fact.
Some features depend on what UPS model you have (simple or smart).
This package is configured for USB but can be reconfigured for
standard serial port UPS models. See the manual.
/etc/apcupsd
/etc/apcupsd/apccontrol
/etc/apcupsd/apcupsd.conf
/etc/apcupsd/changeme
/etc/apcupsd/commfailure
/etc/apcupsd/commok
/etc/apcupsd/hid-ups
/etc/apcupsd/make-hiddev
/etc/apcupsd/offbattery
/etc/apcupsd/onbattery
/etc/rc.d/init.d/apcupsd
/sbin/apcaccess
/sbin/apctest
/sbin/apcupsd
/sbin/smtp
/usr/share/doc/apcupsd-3.14.8
/usr/share/doc/apcupsd-3.14.8/COPYING
/usr/share/doc/apcupsd-3.14.8/ChangeLog
/usr/share/doc/apcupsd-3.14.8/DISCLAIMER
/usr/share/doc/apcupsd-3.14.8/ReleaseNotes
/usr/share/doc/apcupsd-3.14.8/Release_Notes-3.14.8-1.txt
/usr/share/doc/apcupsd-3.14.8/apcupsd.png
/usr/share/doc/apcupsd-3.14.8/charging.png
/usr/share/doc/apcupsd-3.14.8/commlost.png
/usr/share/doc/apcupsd-3.14.8/main_configs.png
/usr/share/doc/apcupsd-3.14.8/manual.html
/usr/share/doc/apcupsd-3.14.8/multimon.png
/usr/share/doc/apcupsd-3.14.8/onbatt.png
/usr/share/doc/apcupsd-3.14.8/online.png
/usr/share/doc/apcupsd-3.14.8/status.png
/usr/share/doc/apcupsd-3.14.8/thanks.png
/usr/share/doc/apcupsd-3.14.8/wininstall6.png
/usr/share/hal/fdi/policy/20thirdparty/80-apcupsd-ups-policy.fdi
/usr/share/man/man5/apcupsd.conf.5.gz
/usr/share/man/man8/apcaccess.8.gz
/usr/share/man/man8/apccontrol.8.gz
/usr/share/man/man8/apctest.8.gz
/usr/share/man/man8/apcupsd.8.gz

Konfiguration

Nach der erfolgreichen Installation des apcupsd ist es an der Zeit die Konfigurationsdatei

/etc/apcupsd/apcupsd.conf

entsprechend anzupassen.

Dies Konfigurationsdatei /etc/apcupsd/apcupsd.conf nach der Installation im default-Zustand sieht wie folgt aus (Kommentarzeilen und Leerzeilen werden nicht mit ausgegeben):

# egrep -v '(^.*#|^$)' /etc/apcupsd/apcupsd.conf
UPSCABLE usb
UPSTYPE usb
DEVICE
LOCKFILE /var/lock
SCRIPTDIR /etc/apcupsd
PWRFAILDIR /etc/apcupsd
NOLOGINDIR /etc
ONBATTERYDELAY 6
BATTERYLEVEL 5
MINUTES 3
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 standalone
UPSMODE disable
STATTIME 0
STATFILE /var/log/apcupsd.status
LOGSTATS off
DATATIME 0

Folgende drei Angaben in der Konfigurationsdatei /etc/apcupsd/apcupsd.conf sind minimal zu setzen, um den Deamon starten zu können:

UPSCABLE usb - Definiert die Art des Kabels, wie der Server mit der USV verbunden ist.
UPSTYPE usb - Definiert die Art, wie der Server mit der USV kommuniziert, was jedoch abhängig vom Kabel ist !!!
DEVICE - Beim UPSTYPE usb muss diese Angabe LEER bleiben !!!

Nachfolgende Angaben bestimmen das Verhalten des Deamon an sich und sind ebenfalls standardmäßig in der Konfigurationsdatei /etc/apcupsd/apcupsd.conf vorhanden:

LOCKFILE /var/lock - Pfad zur Sperr-Datei (zeigt an, ob der Deamon gestartet wurde)
SCRIPTDIR /etc/apcupsd - Pfad zum Verzeichnis in dem benötigte Scripte enthalten sind
PWRFAILDIR /etc/apcupsd - Pfad zum Verzeichnis in dem der Hinweis gespeichert wird, dass eine Abschaltung wegen Stromausfall durchgeführt wurde
NOLOGINDIR /etc - Pfad zum Verzeichnis in dem der Hinweis gespeichert wird, dass keine Neuanmeldungen bis zum Herunterfahren erfolgen dürfen

Dies ist eine Beispiel, wie eine Konfigurationsdatei /etc/apcupsd/apcupsd.conf aussehen könnte:

# egrep -v '(^.*#|^$)' /etc/apcupsd/apcupsd.conf
UPSNAME USV
UPSCABLE usb
UPSTYPE usb
DEVICE 
LOCKFILE /var/lock
SCRIPTDIR /etc/apcupsd
PWRFAILDIR /etc/apcupsd
NOLOGINDIR /etc
ONBATTERYDELAY 6
BATTERYLEVEL 5
MINUTES 5
TIMEOUT 180
ANNOY 60
ANNOYDELAY 10
NOLOGON disable
KILLDELAY 0
NETSERVER on
NISIP 127.0.0.1
NISPORT 3551
EVENTSFILE /var/log/apcupsd.events
EVENTSFILEMAX 10
UPSCLASS standalone
UPSMODE disable
STATTIME 0
STATFILE /var/log/apcupsd.status
LOGSTATS off
DATATIME 0

Für weitere Erklärungen zu den einzelnen Optionen in der Konfiguratiosndatei /etc/apcupsd/apcupsd.conf kann folgender Link hilfreich sein:

apcupsd - Manual - Optionen

Deamon starten

Um den Apcupsd zu starten kann folgender Befehl angewandt werden:

# service apcupsd start
Starting UPS monitoring:                                   [  OK  ]

Um den Apcupsd zu stoppen kann folgender Befehl angewandt werden:

# service apcupsd stop
Shutting down UPS monitoring:                              [  OK  ]

Eine Überprüfung ob der Start des Apcupsd erfolgreich war kann mit folgendem Befehl durchgeführt werden, welcher nachfolgende Ausgabe erzeugen sollte:

# service apcupsd status
apcupsd (pid  31518) is running...
APC      : 001,037,0937
DATE     : 2010-01-24 14:36:44 +0100
HOSTNAME : nss.tachtler.net
VERSION  : 3.14.8 (16 January 2010) redhat
UPSNAME  : nss.tachtler.net
CABLE    : USB Cable
MODEL    : Back-UPS RS 550GI
UPSMODE  : Stand Alone
STARTTIME: 2010-01-24 14:36:42 +0100
STATUS   : ONLINE
LINEV    : 230.0 Volts
LOADPCT  :   8.0 Percent Load Capacity
BCHARGE  : 100.0 Percent
TIMELEFT :  45.1 Minutes
MBATTCHG : 5 Percent
MINTIMEL : 3 Minutes
MAXTIME  : 0 Seconds
SENSE    : High
LOTRANS  : 176.0 Volts
HITRANS  : 282.0 Volts
ALARMDEL : Always
BATTV    : 13.6 Volts
LASTXFER : No transfers since turnon
NUMXFERS : 0
TONBATT  : 0 seconds
CUMONBATT: 0 seconds
XOFFBATT : N/A
SELFTEST : NO
STATFLAG : 0x07000008 Status Flag
MANDATE  : 2009-11-17
SERIALNO : 3B0947X11105
BATTDATE : 2009-11-17
NOMINV   : 100 Volts
NOMBATTV :  12.0 Volts
NOMPOWER : 330 Watts
FIRMWARE : 857.L1 .I USB FW:L1
APCMODEL : Back-UPS RS 550GI
END APC  : 2010-01-24 14:36:46 +0100

Um den apcupsd-Daemon dauerhaft bei jedem Neustart des Rechners automatisch zu starten geben Sie bitte als root folgenden Befehl ein, um zu überprüfen wie die aktuelle Konfiguration des Startverhaltens des aktuellen apcupsd-Daemon aussieht:

# chkconfig --list | grep apcupsd
apcupsd         0:off   1:off   2:on    3:on    4:on    5:on    6:off

Falls die Ausgabe wie oben gezeigt erscheinen sollte, wird der apcupsd-Daemon bei jedem Neustart des Rechners gestartet. Falls dies nicht so sein sollte, kann dies mit folgende Befehle nachgeholt werden:

# chkconfig apcupsd on

* Aktivieren des automatischen Starten des apcupsd-Daemon.