Content
Dateianzeige für apcupsd (3.4.0)
usr/share/doc/apcupsd/apcupsd.txt
Apcupsd - UPS Uninterruptable Power Supply
Die Einleitung
Dieses Programm stellt einen Dienst für eine USV zur Verfügung. Eine
unterbrechungsfreie Stromversorgung (USV, engl. Uninterruptable Power
Supply oder Uninterruptible Power Source, UPS) soll beim Ausfall der
Netzspannung, die Stromversorgung mit Hilfe von Akkumulatoren (kurz
Akkus), für eine bestimmte Zeitspanne sicherstellen. Schwankungen im
Stromnetz der Energieversorgungsunternehmen (EVU) sind heute an der
Tagesordnung, so dass die USV auch Schwankungen (Spitzen usw.) abfangen
sollen. USVs werden u.a. in Krankenhäusern, Fernseh- und
Radiostationen, Rechenzentren und Einsatzzentralen eingesetzt.
Diese Software unterliegt der GNU General Public License (GPL) mit
allen daraus resultierenden Rechten, sowie dem Ausschluss jeglicher
Gewährleistung.
Hinweis: Vor dem produktiven Einsatz sollten alle Einstellungen
gründlich getestet werden. Dabei ist es sinnvoll den Server NICHT an
die Spannungsversorgung der USV anzuschliessen. Insbesondere die
Einstellungen zum Abschalten der USV sind hier kritisch und können zum
unbeabsichtigten Abschalten der Versorgung führen.
Das Menü im Setup-Programm
Das Menü im Setup-Programm ist wie folgt aufgebaut:
4. Service administration
x. Apcupsd
1. View documentation
2. Edit configuration
3. Advanced configuration file handling
4. Show status
5. Stop service
6. Start service
7. Restart service
8. Test USV
9. [1]Apcupsd web monitoring (optional)
TIPP im BIOS des Rechners sollte in den Energieeinstellungen 'always
on' gesetzt werden, ansonsten wird der Server nach Wiedereinschalten
der Versorgung nicht wieder starten.
Änderung der Konfiguration
Die Konfiguration kann über den Menüpunkt „Edit configuration“ geändert
werden.
Die Konfigurationsdatei
In der Konfigurationsdatei, die über das Menü zugänglich ist, sind
folgende Parameter vorhanden; wer sie von Hand editieren will findet
sie unter
/etc/config.d/apcupsd
Die Parameter
START_APCUPSD
Legt fest ob apcupsd gestartet werden soll. Ein Stoppen über das
Menü ist jederzeit möglich.
Gültige Werte: yes, no
Standardeinstellung: START_APCUPSD='no'
APCUPSD_UPSCABLE
Verwendetes Kabel für die Kommunikation mit der USV.
Gültige Werte:
simple | 940-0020B | 940-0023A
smart | 940-0024B | 940-0024C
940-1524C | 940-0024G | 940-0095A
940-0095B | 940-0095C | 940-0119A
ether | usb
Standardeinstellung: APCUPSD_UPSCABLE='smart'
APCUPSD_UPSTYPE
Hier wird der Typ der angeschlossenen USV angegeben.
UPSTYPE und DEVICE müssen aufeinander abgestimmt sein, siehe
APCUPSD_DEVICE.
Gültige Werte: dump, apcsmart, net, usb, snmp
Standardeinstellung: APCUPSD_UPSTYPE='apcsmart'
APCUPSD_DEVICE
Abhängig vom Eintrag unter APCUPSD_UPSTYPE:
Gültige Werte:
APCUPSD APCUPSD
UPSTYPE DEVICE Beschreibung
apcsmart /dev/tty** Neuere seriell angeschlossene USV.
Passend für SmartUPS Modelle die keinen
USB Anschluss verwenden. Mögliche Einträge
für Device /dev/ttyS[0-9]
usb Für neue USV-Modelle mit USB Anschluss.
Dabei bleibt APCUPSD_DEVICE leer!
net hostname:port Dieser Eintrag ist für Computer,
die nicht direkt an die USV angeschlossen
sind. Dafür muss der Eintrag
APCUPSD_NETSERVER auf dem Master Server
auf 'YES' stehen. Dieser stellt dann die
Informationen über den Status der USV
zur Verfügung, so dass bei einem
Netzausfall auch die Slave Rechner an der USV
herunter gefahren werden können. Angegeben
wird IP-Adresse oder Hostname und Port des
Master Rechners.
snmp hostname:port: Für USV die über eine SNMP-Karte verfügen.
vendor:community Dabei steht Hostname für den Namen der
SNMP-Karte der USV, hier kann auch eine
IP-Adresse eingetragen werden. Port ist
gewöhnlich. Für vendor sind
die Einträge APC, APC_NOTRAP und RFC möglich.
Hier kann meist APC verwendet werden.
APC powernet MIB
APC_NOTRAP powernet mit SNMP trap ohne
caching RFC rfc1628 UPS-MIB
Community ist normalerweise privat.
dump /dev/tty** Für ältere USV-Modelle, die nur die simple
Signalisierung beherrschen. Mögliche Einträge
für Device /dev/ttyS[0-9]
pcnet ipaddr:username: Für das 'PowerChute Network Shutdown
passphrase protocol' wird diese Einstellung benötigt.
Dieses Protokoll wird von den neueren
PowerNet Karten der AP9617 Familie
verwendet.IP-Adresse ist die Adresse der
UPS mgmt Karte. Username und Passwort sind
die auf der Karte konfigurierten Werte.
Standardeinstellung: APCUPSD_DEVICE='/dev/ttyS0'
APCUPSD_POLLTIME
Zeit in Sekunden, zwischen den Abfragen des USV Status. Der Wert
wird bei einem Netzausfall automatisch auf eine Sekunde gesetzt.
Ist die Netzspannung zurückgekehrt, wird wieder der eingegebene
Wert benutzt. Der Wert wirkt sowohl für direkt angeschlossene
USV Typen, als auch für über das Netzwerk (net, snmp)
angebundene Typen. Standard sind 60 Sekunden, ein kleinerer Wert
belastet die CPU entsprechend mehr.
Gültige Werte: Zahl
Standardeinstellung: APCUPSD_POLLTIME='60'
Verhalten bei einem Stromausfall
Die folgenden Einstellungen dienen der Festlegung des Verhaltens bei
einem Stromausfall.
APCUPSD_ONBATTERYDELAY
Wartezeit in Sekunden vom Ausfall der Netzspannung bis zur
Reaktion von apcupsd. Um eine Benachrichtigung bei kurzen
Stromausfällen zu vermeiden, kann hier eine entsprechend lange
Zeit eingestellt werden. Standard 6 Sekunden.
Gültige Werte: Zahl
Standardeinstellung: APCUPSD_ONBATTERYDELAY='6'
APCUPSD_BATTERYLEVEL
Der hier eingegebene Wert legt fest, bei wie viel Prozent der
Akku-Kapazität das Herunterfahren des Servers ausgelöst wird.
Standardwert ist 5 %. Die Einstellung wird bei simple
Signalisierung ignoriert. Zum Deaktivieren der Einstellung kann
ein Wert von -1 gesetzt werden.
Gültige Werte: Zahl, -1
Standardeinstellung: APCUPSD_BATTERYLEVEL='5'
APCUPSD_MINUTES
Verbleibende Akku Restlaufzeit in Minuten.
Wird die Restlaufzeit, von der in der USV berechneten
unterschritten, wird das Herunterfahren des Servers ausgelöst.
Standardwert sind 3 Minuten. Die Einstellung wird bei simple
Signalisierung ignoriert. Zum Deaktivieren der Einstellung kann
ein Wert von -1 gesetzt werden. Es sollte beachtet werden, dass
einige USV-Modelle den Wert falsch berechnen. In der
Statusanzeige kann der Wert für TIMELEFT geprüft werden. Ist der
Wert NULL oder unplausibel liegt evtl. ein Defekt an der USV
vor. In diesem Fall den Wert deaktivieren.
Gültige Werte: Zahl, -1
Standardeinstellung: APCUPSD_MINUTES='3'
APCUPSD_TIMEOUT
Bei einem Stromausfall wird nach Ablauf dieser Zeit in Sekunden
der Server heruntergefahren. Für alle smart USV-Typen und
USV-Typen die ein Low Battery Signal übermitteln, kann dieser
Wert auf 0 gesetzt werden. Ein Herunterfahren wird hier über
BATTERYLEVEL oder MINUTES ausgelöst. Für andere USV-Typen muss
der Wert gesetzt werden. So wird der Server nach der hier
eingestellten Zeit heruntergefahren. Dieser Wert kann auch für
Testzwecke nützlich sein. Bei einem kleinen Wert z.B. 60
Sekunden kann das korrekte Herunterfahren schnell geprüft
werden. Die Werte TIMEOUT, BATTERYLEVEL und MINUTES können auch
alle gesetzt werden. Der Wert der zuerst erreicht wird löst dann
das Herunterfahren aus.
Gültige Werte: Zahl
Standardeinstellung: APCUPSD_TIMEOUT='0'
APCUPSD_MAILNOTIFY
Aktiviert/Deaktiviert Email-Benachrichtigung.
Gültige Werte: yes, no
Standardeinstellung: APCUPSD_MAILNOTIFY='yes'
APCUPSD_ANNOY
Pause in Sekunden zwischen den Aufforderungen sich abzumelden.
Standard Wert ist 300 Sekunden (5 Minuten). Der Zeitwert muss
größer sein als der für APCUPSD_ANNOYDELAY.
Hinweis
Wenn APCUPSD_NOLOGON auf disable oder always gesetzt ist wird
diese Einstellung ebenfalls deaktiviert.
Gültige Werte: Zahl
Standardeinstellung: APCUPSD_ANNOY='300'
APCUPSD_ANNOYDELAY
Zeit in Sekunden bis angemeldete Benutzer bei einem Netzausfall
das erste mal aufgefordert werden sich abzumelden. Standardwert
ist 60 Sekunden.
Hinweis
Wenn APCUPSD_NOLOGON auf disable oder always gesetzt ist wird
diese Einstellung ebenfalls deaktiviert.
Gültige Werte: Zahl
Standardeinstellung: APCUPSD_ANNOYDELAY='60'
APCUPSD_NOLOGON
Steuert ob und wann ein Login bei Stromausfall verhindert wird.
Kommentar: Die wahrscheinlich sinnvollsten Einstellungen sind
disable und always. Bei allen anderen Einstellungen ist die Zeit
zwischen dem Verhindern eines Login und dem Herunterfahren des
Servers sehr kurz.
disable deaktiviert diese Funktion, das heisst jeder Benutzer
kann sich während eines Netzausfalls anmelden. Die
Funktionen ANNOY und ANNOYDELAY sind damit ebenfalls
ausgeschaltet.
timeout verhindert ein Login wenn 90% der in TIMEOUT
eingestellten Zeit vergangen ist.
Kommentar: Da in den meisten Fällen der TIMEOUT Wert
nicht gesetzt wird ist diese Einstellung weniger nützlich.
percent ein Login wird verhindert, wenn die verbleibende
Akku-Kapazität 110% oder weniger als der in BATTERYLEVEL
eingestellt Wert erreicht hat.
Beispiel: BATTERYLEVEL=15 ein Login wird bei weniger
als 16% Akkukapazität verhindert (15% X 110% = 16%).
minutes ein Login wird verhindert, wenn die verbleibende
Restlaufzeit 110% oder weniger als der in MINUTES
eingestellt Wert erreicht hat.
Beispiel: MINUTES=3 ein Login wird bei weniger als
3 Minuten Restlaufzeit verhindert (3 X 110% = 3).
always bei einem Netzausfall wird das Login sofort verhindert.
Die Funktionen ANNOY und ANNOYDELAY sind damit ebenfalls
ausgeschaltet.
Gültige Werte: disable, timeout, percent, minutes, always
Standardeinstellung: APCUPSD_NOLOGON='disable'
APCUPSD_KILLPOWER
Über diesen Parameter wird bestimmt ob beim Herunterfahren das
KILLPOWER Signal an die USV gesendet wird. Normalerweise kann
die Einstellung auf 'yes' belassen werden. Falls die USV
abschaltet bevor der Server heruntergefahren ist und sich die
Zeit in der USV bis zum Abschalten nicht einstellen lässt, kann
hier 'no' gesetzt werden. Allerdings wird die USV dann solange
laufen bis der Akku erschöpft ist. Sollte vorher die
Netzspannung wiederkehren, wird der Rechner nicht neu starten.
Gültige Werte: yes, no
Standardeinstellung: APCUPSD_KILLPOWER='yes'
Network Information Server
Die folgenden Einstellungen dienen der Konfiguration des Network
Information Servers (NIS).
Diese Einstellungen sind für eine einwandfreie Funktion NICHT
erforderlich.
APCUPSD_NETSERVER
Network Information Server aktivieren.
Es wird ein Child-Prozess gestartet der Staus und Ereignisse im
Netzwerk zur Verfügung stellt. Diese Informationen werden
hauptsächlich von den CGI Programmen des Webinterfaces genutzt.
Gültige Werte: yes, no
Standardeinstellung: APCUPSD_NETSERVER='yes'
APCUPSD_NISIP
IP-Adresse auf die der NIS Server lauscht. Standard ist 0.0.0.0,
das heisst es wird auf allen Adressen gelauscht. Es kann auch
eine Spezielle IP-Adresse angegeben werden. Oder auch 127.0.0.1
(loopback), es werden nur Verbindungen des lokalen Rechners
erlaubt.
Gültige Werte: IP Addresse
Standardeinstellung: APCUPSD_NISIP='0.0.0.0'
APCUPSD_NISPORT
Port den der Network Information Server verwendet. Vorgabe ist
3551, dieser ist dafür von der IANA (Internet Assigned Numbers
Authority) offiziell zugeordnet. Wird der Port geändert
funktionieren die CGI Programme des Webinterfaces nicht mehr.
Die CGI Programme müssen dann mit der geänderten Portnummer neu
kompiliert werden.
Gültige Werte: Port Nummer
Standardeinstellung: APCUPSD_NISPORT='3551'
USV Sharing
Die folgenden Einstellungen sind für das USV Sharing (an einer USV sind
mehrere Rechner angeschlossen).
Die Werte sind ausschliesslich für die Nutzung der APC
Erweiterungskarte ShareUPS.
APCUPSD_UPSCLASS
Standard ist standalone, es sei denn eine APC ShareUPS Karte
wird verwendet.
Gültige Werte: standalone, shareslave, sharemaster
Standardeinstellung: APCUPSD_UPSCLASS='standalone'
APCUPSD_UPSMODE
Standard ist disable, es sei denn eine APC ShareUPS Karte wird
verwendet.
Gültige Werte: disable, share.
Standardeinstellung: APCUPSD_UPSMODE='disable'
Loggen von Statusmeldungen
Mit den folgenden Einstellungen wird das Loggen von Statusmeldungen
konfiguriert.
APCUPSD_STATTIME
Hier wird das Intervall, in Sekunden, für das Schreiben des
Statusfiles (/etc/apcupsd/apcupsd.status) festgelegt. Der Wert
sollte auf 0 belassen werden, d.h. es wird kein Statusfile
geschrieben.
Gültige Werte: Zahl
Standardeinstellung: APCUPSD_STATTIME='0'
APCUPSD_LOGSTATS
Loggen von Statusmeldungen.
Hinweis
Wird diese Einstellung aktiviert, werden sehr viele Meldungen
ins Logfile geschrieben.
Gültige Werte: yes, no
Standardeinstellung: APCUPSD_LOGSTATS='no'
APCUPSD_DATATIME
Intervall in Sekunden in denen die Statusmeldungen ins Logfile
geschrieben werden. Dieser Wert ist normalerweise 0.
Gültige Werte: Zahl
Standardeinstellung: APCUPSD_DATATIME='0'
EEPROM Programierung
Die folgenden Einstellungen lassen sich mit dem apctest Modul
(Menüpunkt 'Test USV') in das EEPROM der USV Programmieren. Diese Werte
haben keine Wirkung auf den apcupsd Daemon. Die aktuell in der USV
gespeicherten Werte lassen sich über den Menüpunkt 'Show Status' oder
'Test USV' Anzeigen.
ACHTUNG
Die Einstellungen sind mit Vorsicht zu wählen, da sich hier z.B auch
die Ausgangsspannung der USV beeinflussen lässt. Wird für einen
Parameter IGNORE gesetzt wird dieser beim Programmieren des EEPROM
nicht berücksichtigt.
APCUPSD_EEPROM_UPSNAME
Name der USV maximal 8 Zeichen. (scheint beim Schreiben ins
EEPROM ignoriert zu werden)
Gültige Werte: Name
Standardeinstellung: APCUPSD_EEPROM_UPSNAME='IGNORE'
APCUPSD_EEPROM_BATTDATE
Datum des letzten Akkutausches Format mm/dd/yy (scheint beim
Schreiben ins EEPROM ignoriert zu werden)
Gültige Werte: mm/dd/yy
Standardeinstellung: APCUPSD_EEPROM_BATTDATE='IGNORE'
APCUPSD_EEPROM_SENSITIVITY
Ansprech-Empfindlichkeit der USV. Je höher die Empfindlichkeit
eingestellt wird, desto schneller schaltet die USV bei
Netzschwankungen auf Batterieversorgung.
Standard Einstellung ist 'H'. Diese Einstellung kann geändert
werden, wenn die USV aufgrund von Spannungsschankungen sehr oft
auf Batterie umschaltet. Vorausgesetzt die Computer-Hardware
verkraftet dann die Spannungsschwankungen.
Gültige Werte: (H)igh, (M)edium, (L)ow.
Standardeinstellung: APCUPSD_EEPROM_SENSITIVITY='IGNORE'
APCUPSD_EEPROM_WAKEUP
Wartezeit vor dem Wiedereinschalten der USV in Sekunden. Nach
dem Herunterfahren des Servers und dem Abschalten der USV bei
einem Stromausfall, wird vor dem Wiedereinschalten der USV diese
Zeit gewartet. Diese Einstellung schützt die Hardware vor zu
frühem Wiedereinschalten, vor allem wenn die Netzspannung in
kurzen Abständen wieder ausfällt.
Standard = 0 ⇒ (Deaktiviert)
Gültige Werte: 0, 60, 180, 300
Standardeinstellung: APCUPSD_EEPROM_WAKEUP='IGNORE'
APCUPSD_EEPROM_SLEEP
Verzögerung in Sekunden vom Empfang des KILLPOWER Signals bis
zum Abschalten der USV. Beim Herunterfahren, aufgrund eines
Stromausfalls, wird das KILLPOWER Signal zum Abschalten an die
USV gesendet. Die Zeit bis zum tatsächlichen Abschalten muss so
gewählt werden, daß der Server genügend Zeit zum herunterfahren
hat!
Standard = 0 ⇒ (Deaktiviert)
Gültige Werte: 0, 20, 180, 300, 600
Standardeinstellung: APCUPSD_EEPROM_SLEEP='IGNORE'
APCUPSD_EEPROM_LOTRANSFER
Unterschreitet die Netzspannung diesen Wert in Volt, wird auf
Akku-Betrieb geschaltet.
Die Werte sind vom USV-Modell abhängig.
Gültige Werte:
D ⇒ 106 103 100 097
M ⇒ 177 172 168 182
A ⇒ 092 090 088 086
I ⇒ 208 204 200 196
Standard = 0 ⇒ (Deaktiviert)
Standardeinstellung: APCUPSD_EEPROM_LOTRANSFER='IGNORE'
APCUPSD_EEPROM_HITRANSFER
Überschreitet die Netzspannung diesen Wert in Volt wird auf
Akku-Betrieb geschaltet.
Die Werte sind vom USV-Modell abhängig.
Gültige Werte:
D ⇒ 127 130 133 136
M ⇒ 229 234 239 224
A ⇒ 108 110 112 114
I ⇒ 253 257 261 265
Standard = 0 ⇒ (Deaktiviert)
Standardeinstellung: APCUPSD_EEPROM_HITRANSFER='IGNORE'
APCUPSD_EEPROM_RETURNCHARGE
Dieser Wert legt den erforderlichen Akku-Ladezustand in Prozent
fest, bei dem die USV nach einem Stromausfall wieder
einschaltet.
Die Werte sind vom USV-Modell abhängig.
Gültige Werte: 00, 15, 50, 90
Standard = 15
Standardeinstellung: APCUPSD_EEPROM_RETURNCHARGE='IGNORE'
APCUPSD_EEPROM_BEEPSTATE
Hier wird das Verhalten des in der USV eingebauten Piepsers
eingestellt.
0 ⇒ sobald ein Problem mit der Stromversorgung auftritt.
T ⇒ Wie 0 aber mit 30 Sekunden Verzögerung.
L ⇒ Warnung erst bei niedrigem Akkustand.
N ⇒ Piepser immer ausgeschaltet.
Gültige Werte: 0, T, L ,N
Standardeinstellung: APCUPSD_EEPROM_BEEPSTATE='IGNORE'
APCUPSD_EEPROM_LOWBATT
Verzögerung bis zur Warnung niedriger Batteriestandïn Minuten.
Gültige Werte: 02, 05, 07, 10
Standard = 02
Standardeinstellung: APCUPSD_EEPROM_LOWBATT='IGNORE'
APCUPSD_EEPROM_OUTPUTVOLTS
Ausgangsspannung in Volt der USV.
Die Werte sind vom USV-Modell abhängig.
Gültige Werte:
D ⇒ 115
M ⇒ 208
A ⇒ 100
I ⇒ 230 240 220 225
Standard = 0 ⇒ (Deaktiviert)
Standardeinstellung: APCUPSD_EEPROM_OUTPUTVOLTS='IGNORE'
APCUPSD_EEPROM_SELFTEST
Einstellung für den Selbsttest der USV.
Gültige Werte:
OFF ⇒ kein Selbsttest.
ON ⇒ beim Einschalten der USV.
168 ⇒ alle 168 Stunden (eine Woche)
336 ⇒ alle 336 Stunden (zwei Wochen)
Standardeinstellung: APCUPSD_EEPROM_SELFTEST='IGNORE'
__________________________________________________________________