Modus konfigurieren¶

Dazu editiert ^[4] man /etc/nut/nut.conf wie folgt:

MODE=netserver

Anschluss an USV konfigurieren¶

Dazu editiert man die /etc/nut/ups.conf:

[ups1]
  driver = "apcsmart"		# Treiber der verwendet werden soll
  port = "/dev/ttyS0"		# Port, an dem die USV angeschlossen ist (hier COM1)
  desc = "Meine USV"		# Beschreibung der USV

Es gibt noch weitere Parameter, die man hier angeben kann. Diese kann man in der man-Page von ups.conf nachlesen. Eine Liste unterstützter USVs und Infos zu den Treibern findet man unter Hardware compatibility list 🇬🇧. (Bei manchen Treibern,z.B. blazer_usb, kann der Port auf "auto" gestellt werden, in diesem Fall, weil USB hier Standard ist).

Serverdienst upsd konfigurieren¶

Dazu editiert man die /etc/nut/upsd.conf.

Mit der Option LISTEN konfiguriert man, auf welchen IP-Adressbereich der Server hört. In der aktuellen Version von NUT darf hier nur noch ein LISTEN-Eintrag gemacht werden. Im Grunde gibt es zwei Szenarien:

• Es gibt nur einen Rechner vom Typ B und sonst keine. Auf dem Rechner laufen dann alle Dienste von NUT und upsd muss nur auf den „local host“ hören:

LISTEN 127.0.0.1

• Es gibt neben dem Rechner vom Typ B auch Rechner vom Typ A oder C (auf denen upsmon laufen soll)

LISTEN 0.0.0.0

Benutzer einrichten¶

Dazu editiert man /etc/nut/upsd.users. Es bietet sich hier an, drei Benutzer anzulegen, und zwar einen upsmaster (der auf dem Server die Überwachung übernimmt), einen upsslave (der von den Clients die Überwachung übernimmt) und einen upsadmin (der Verwaltungsaufgaben übernehmen darf).

[upsmaster]				# Benutzername
  password = upsmasterpw    		# Passwort für den Benutzer
  upsmon master		         	# Art des Zugriffs*

[upsslave]
  password = upsslavepw
  upsmon slave

[upsadmin]
  password = upsadminpw
  actions = SET
  instcmds = ALL

Alternativ lassen sich "master" und "admin" auch kombinieren zu:

[upsmaster]
  password = upsmasterpw
  actions = SET
  instcmds = ALL
  upsmon master

[upsslave]
  password = upsslavepw
  upsmon slave

upsmon einrichten¶

Im Fall (B) richten wir auch den Client ein. Im seltenen Fall (D) ist dies optional. Dazu editiert man die /etc/nut/upsmon.conf:

RUN_AS_USER nut

Hier wird eingestellt unter welchem User weitere Aktionen ausgeführt werden.

Als nächstes konfiguriert man die Verbindung zum upsd:

MONITOR ups1@localhost 1 upsmaster upsmasterpw master

Dies sagt dem upsmon, dass die USV "ups1" am lokalen Rechner (Typ B) mit den Benutzer "upsmaster" und dem Passwort "upsmasterpw" an upsd angemeldet wird.

MINSUPPLIES 1

Gibt an, wie viele USVs mindestens verfügbar sein müssen. In den meisten Fällen 1.

SHUTDOWNCMD “/sbin/shutdown -h +0“

Der Befehl zum Herunterfahren des Systems.

NOTIFYCMD /sbin/upssched

Gibt an welches Programm gestartet werden soll, wenn ein bestimmtes Ereignis eintritt. Hier kann ein eigenes Skript eingestellt werden oder (wie im Beispiel) upssched. Zu upssched später mehr.

POLLFREQ 5

Ist das Intervall in Sekunden, in dem der Monitor die USV abfragt.

POLLFREQALERT 5

Ist das Intervall in Sekunden, in dem der Monitor die USV abfragt, wenn die USV auf Alarm steht (bspw. die USV auf Batterie läuft).

HOSTSYNC 15

Ist die Zeit, die der Server wartet, dass die Clients ihre Verbindung trennen können, wenn FSD gesetzt worden ist (FSD wird gesetzt wenn z.B. die Batterie fast leer ist).

DEADTIME 15

Die Zeit die gewartet wird, wenn die USV nicht erreichbar ist (bevor sie als nicht verfügbar gilt). Sollte das 3-fache von POLLFREQ und POLLFREQALERT sein.

POWERDOWNFLAG /etc/killpower

Diese Datei wird vom Monitor erstellt, wenn der Rechner herunterfahren soll.

NOTIFYMSG ONLINE "USV-ONLINE"
NOTIFYMSG ONBATT "USV-AUF-BATTERIE"
# und so weiter ...

Hier werden die Nachrichtentexte für bestimmte Ereignisse deklariert. Ereignisse können sein:

• ONLINE - USV bekommt wieder externen Strom

• ONBATT - USV läuft auf Batteriebetrieb

• LOWBATT - USV hat niedrigen Batteriestand erreicht

• FSD - Herunterfahren eingeleitet (Forced Shutdown)

• COMMOK - Kommunikation mit USV aufgebaut

• COMMBAD - Kommunikation mit USV verloren

• SHUTDOWN - Das System wird heruntergefahren

• REPLBATT - USV-Batterie muss getauscht werden

• NOCOMM - USV ist nicht erreichbar

• NOPARENT - upsmon Elternprozess beendet, Herunterfahren unmöglich

NOTIFYFLAG ONLINE SYSLOG+WALL+EXEC
NOTIFYFLAG ONBATT SYSLOG+WALL+EXEC
# und so weiter ...

Dies sind die Aktionen, die durchgeführt werden, wenn ein Ereignis eintritt. SYSLOG gibt an, das das Ereignis ins Systemprotokoll geschrieben wird. WALL sendet Nachrichten an alle angemeldeten Benutzer am lokalen PC (siehe auch wall). EXEC gibt den Status an das Programm von NOTIFYCMD weiter. Wenn z.B. nur Nachrichten gesendet werden sollen, reicht WALL aus. Hier werden die selben Ereignisse verwendet wie bei NOTIFYMSG.

RBWARNTIME 43200

Ist die Zeit in Sekunden bevor die Meldung für den Batteriewechsel kommt.

NOCOMMWARNTIME 300

Ist die Zeit in Sekunden bis die Meldung kommt, dass die USV nicht erreichbar ist. Diese Meldung wiederholt sich so lange bis die USV wieder erreichbar ist.

FINALDELAY 5

Ist die Zeit die gewartet wird, nachdem der SHUTDOWNCMD aufgerufen wird bevor er ausgeführt wird.

CMDSCRIPT /etc/nut/upssched/upsscript

PIPEFN /etc/nut/upssched/upssched.pipe
LOCKFN /etc/nut/upssched/upssched.lock

AT ONBATT * START-TIMER onbatt 90
AT ONLINE * CANCEL-TIMER onbatt
AT LOWBATT * EXECUTE battleer

Beispiel-Skript für upssched¶

Das Skript ist ein einfaches Beispiel für die Konfiguration:

1
2
3
4
5
6
7
8
9

#!/bin/sh
case $1 in
  onbatt)
    /sbin/shutdown -h +0;;
  battleer)
    /sbin/upssched fsd;;
  *)
    echo "Falscher Parameter";;
esac

Rechte ändern¶

Da die Dateien wichtige Konfigurationen und Passwörter enthalten müssen sie gut durch Einschränkung von Rechten geschützt werden. Im Ordner /etc/nut sollten alle Dateien root gehören und die Gruppe nut Leserechte ^[5] haben. Dies geschieht mit

cd /etc/nut
chown -R root:nut /etc/nut/*
chmod -R 640 /etc/nut/* 

Sollte man ein eigenes Skript erstellt und in /etc/nut gespeichert haben, muss dies zusätzlich ausführbar gemacht werden:

chmod -R 750 /etc/nut/myscript.sh 

Wenn man mit upssched Befehle über "sudo" ausführen will, z.B. "sudo systemctl hibernate -i", dann muss man dafür sorgen, dass der Benutzer "nut" diese Befehle per sudo aufrufen kann, ohne dass ein Password nötig ist. Dazu legt man eine sudoers-Datei an:

sudo visudo -f /etc/sudoers.d/hibernate 

und füllt sie mit dieser Policy:

%nut    ALL=NOPASSWD: /bin/systemctl hibernate *, /usr/bin/systemctl hibernate *, /lib/systemd/systemd-sleep hibernate *, /usr/bin/systemctl suspend *

Testen der Einstellungen¶

Wenn man alles nach seinen Wünschen eingestellt hat, kann man nun den Rechner neu starten. Dann kann man mit

upsc ups1 

den Status seiner USV auslesen. Als nächstes zieht man die Stromversorgung der USV ab, um zu sehen ob alles so funktioniert wie gewünscht. Wenn alles funktioniert, kann man nun die USV richtig an den Rechner anschließen.

Modus einrichten¶

Dazu editiert man die /etc/nut/nut.conf:

MODE=netclient

upsmon konfigurieren¶

Im Prinzip genau wie oben beim Server-Betrieb, nur dass die Zeile von Monitor anders lautet. Dazu editiert man die /etc/nut/upsmon.conf:

# MONITOR upsname@adress_of_upsd_pc 1 ups_user password master/slave
MONITOR ups1@192.168.156.54 1 upsslave upsslavepw slave

Dabei ist die IP-Adresse Anstatt der IP-Adresse kann hier auch der Hostname angegeben werden, falls er aufgelöst werden kann.

upssched oder Skripte einrichten¶

Kann hier genau so genutzt werden wie beim Server.

Testen der Einstellungen¶

Rechner neu starten und mit:

upsc ups1@192.168.156.54  

testen, ob die Daten ausgelesen werden können.