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 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. | 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.
Die Konfiguration kann über den Menüpunkt „Edit configuration“ geändert werden.
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
Gültige Werte: yes, no
Standardeinstellung: START_APCUPSD='no'
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'
UPSTYPE und DEVICE müssen aufeinander abgestimmt sein, siehe APCUPSD_DEVICE.
Gültige Werte: dump, apcsmart, net, usb, snmp
Standardeinstellung: APCUPSD_UPSTYPE='apcsmart'
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 | <BLANK> | 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 protocol' | |
passphrase | 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'
Gültige Werte: Zahl
Standardeinstellung: APCUPSD_POLLTIME='60'
Die folgenden Einstellungen dienen der Festlegung des Verhaltens bei einem Stromausfall.
Gültige Werte: Zahl
Standardeinstellung: APCUPSD_ONBATTERYDELAY='6'
Gültige Werte: Zahl, -1
Standardeinstellung: APCUPSD_BATTERYLEVEL='5'
Gültige Werte: Zahl, -1
Standardeinstellung: APCUPSD_MINUTES='3'
Gültige Werte: Zahl
Standardeinstellung: APCUPSD_TIMEOUT='0'
Gültige Werte: yes, no
Standardeinstellung: APCUPSD_MAILNOTIFY='yes'
Hinweis
Wenn APCUPSD_NOLOGON auf disable oder always gesetzt ist
wird diese Einstellung ebenfalls deaktiviert.
Gültige Werte: Zahl
Standardeinstellung: APCUPSD_ANNOY='300'
Hinweis
Wenn APCUPSD_NOLOGON auf disable oder always gesetzt ist
wird diese Einstellung ebenfalls deaktiviert.
Gültige Werte: Zahl
Standardeinstellung: APCUPSD_ANNOYDELAY='60'
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'
Gültige Werte: yes, no
Standardeinstellung: APCUPSD_KILLPOWER='yes'
Die folgenden Einstellungen dienen der Konfiguration des
Network Information Servers (NIS).
Diese Einstellungen sind für eine einwandfreie Funktion NICHT erforderlich.
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'
Gültige Werte: IP Addresse
Standardeinstellung: APCUPSD_NISIP='0.0.0.0'
Gültige Werte: Port Nummer
Standardeinstellung: APCUPSD_NISPORT='3551'
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.
Gültige Werte: standalone, shareslave, sharemaster
Standardeinstellung: APCUPSD_UPSCLASS='standalone'
Gültige Werte: disable, share.
Standardeinstellung: APCUPSD_UPSMODE='disable'
Mit den folgenden Einstellungen wird das Loggen von Statusmeldungen konfiguriert.
Gültige Werte: Zahl
Standardeinstellung: APCUPSD_STATTIME='0'
Hinweis
Wird diese Einstellung aktiviert, werden sehr viele
Meldungen ins Logfile geschrieben.
Gültige Werte: yes, no
Standardeinstellung: APCUPSD_LOGSTATS='no'
Gültige Werte: Zahl
Standardeinstellung: APCUPSD_DATATIME='0'
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.
Gültige Werte: Name
Standardeinstellung: APCUPSD_EEPROM_UPSNAME='IGNORE'
Gültige Werte: mm/dd/yy
Standardeinstellung: APCUPSD_EEPROM_BATTDATE='IGNORE'
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'
Standard = 0 ⇒ (Deaktiviert)
Gültige Werte: 0, 60, 180, 300
Standardeinstellung: APCUPSD_EEPROM_WAKEUP='IGNORE'
Standard = 0 ⇒ (Deaktiviert)
Gültige Werte: 0, 20, 180, 300, 600
Standardeinstellung: APCUPSD_EEPROM_SLEEP='IGNORE'
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'
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'
Die Werte sind vom USV-Modell abhängig.
Gültige Werte: 00, 15, 50, 90
Standard = 15
Standardeinstellung: APCUPSD_EEPROM_RETURNCHARGE='IGNORE'
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'
Gültige Werte: 02, 05, 07, 10
Standard = 02
Standardeinstellung: APCUPSD_EEPROM_LOWBATT='IGNORE'
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'
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'