Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- ubuntu:ups [2026/07/19 12:17] – [Ziel] franz
+++ ubuntu:ups [2026/08/25 11:35] (aktuell) – [Voraussetzungen] franz
@@ Zeile 1: / Zeile 1: @@
-====== UPS NUT-Master für APC Smart-UPS SMC1500IC unter Ubuntu einrichten\\
+====== USV NUT-Master für APC Smart-UPS SMC1500IC unter Ubuntu einrichten ======
-======
+===== Ziel =====
+Die APC Smart-UPS SMC1500IC wird über ein USB-Datenkabel mit einem Ubuntu-Server verbunden.
+Dieser Server übernimmt folgende Aufgaben:
+* Auslesen des USV-Status\\
+* Erkennen eines Stromausfalls\\
+* Kontrolliertes Herunterfahren des lokalen Servers\\
+* Bereitstellen der USV-Informationen für weitere Server im Netzwerk
+Der direkt mit der USV verbundene Rechner wird in dieser Anleitung als **NUT-Master** bezeichnet.
+<note important>\\
+Das USB-Datenkabel der USV muss direkt mit dem Ubuntu-Server verbunden sein.
+Der SmartConnect-Netzwerkanschluss ersetzt die USB-Verbindung für NUT nicht.\\
+</note>
 ===== Voraussetzungen =====
@@ Zeile 11: / Zeile 29: @@
 * Root- oder sudo-Berechtigung
-Beispiel-IP des NUT-Masters:
+Beispiel-IP des NUT-Masters: 192.168.1.20\
-<code>
-.168.1.20
-</code>
 Diese Adresse muss durch die tatsächliche IP-Adresse des Servers ersetzt werden.
 ===== 1. USB-Verbindung prüfen =====
@@ Zeile 28: / Zeile 42: @@
 <code bash>
 lsusb | grep -i -E 'APC|American Power Conversion'
 </code>
@@ Zeile 42: / Zeile 55: @@
 Die Kennung ''051d'' steht für APC beziehungsweise American Power Conversion.
 ===== 2. NUT installieren =====
@@ Zeile 48: / Zeile 62: @@
 <code bash>
 sudo apt \update
 </code>
@@ Zeile 56: / Zeile 69: @@
 <code bash>
 sudo apt install nut-server nut-\client
 </code>
@@ Zeile 64: / Zeile 76: @@
 <code bash>
 apt-cache policy nut-\server
 </code>
@@ Zeile 74: / Zeile 85: @@
 <code bash>
 sudo cp -a /etc/nut "/etc/nut.backup.$(date +%F-%H%M%S)"
 </code>
@@ Zeile 88: / Zeile 98: @@
 Die Datei ''/etc/nut/nut.conf'' öffnen:
 <code bash>
 sudo nano /etc/nut/nut.\conf
 </code>
@@ Zeile 98: / Zeile 108: @@
 <code ini>
 MODE=\netserver
 </code>
-<note> Bei ''MODE=netserver'' werden der USV-Treiber, der NUT-Datenserver und der lokale Überwachungsdienst gestartet.
+<note>
+Bei ''MODE=netserver'' werden der USV-Treiber, der NUT-Datenserver und der lokale Überwachungsdienst gestartet.
-Zusätzlich können andere Server im Netzwerk auf die USV-Informationen zugreifen. </note>
+Zusätzlich können andere Server im Netzwerk auf die USV-Informationen zugreifen.
+</note>
 Beim Eintrag dürfen um das Gleichheitszeichen keine Leerzeichen stehen.
@@ Zeile 112: / Zeile 123: @@
 <code ini>
 MODE=\netserver
 </code>
@@ Zeile 120: / Zeile 130: @@
 <code ini>
 MODE = \netserver
 </code>
@@ Zeile 127: / Zeile 136: @@
 Die Datei ''/etc/nut/ups.conf'' öffnen:
 <code bash>
 sudo nano /etc/nut/ups.\conf
 </code>
@@ Zeile 141: / Zeile 150: @@
   vendorid = \051d
   desc = "APC Smart-UPS SMC1500IC"
 </code>
@@ Zeile 147: / Zeile 155: @@
 Bedeutung der Einstellungen:
-^Einstellung^Bedeutung| | | | | | | | | | | | |
+^ Einstellung ^ Bedeutung ^
-|''[apc]'' |Interner Name der USV|   |''driver'' |USB-HID-Treiber für kompatible APC-USV-Geräte|   |''port = auto'' |Automatische Erkennung des USB-Anschlusses|   |''vendorid = 051d'' |USB-Herstellerkennung von APC|   |''desc'' |Frei wählbare Beschreibung|
+| ''[apc]'' | Interner Name der USV |\\
+| ''driver'' | USB-HID-Treiber für kompatible APC-USV-Geräte |\\
+| ''port = auto'' | Automatische Erkennung des USB-Anschlusses |\\
+| ''vendorid = 051d'' | USB-Herstellerkennung von APC |\\
+| ''desc'' | Frei wählbare Beschreibung |
 Wenn mehrere APC-USV-Geräte am selben Server angeschlossen sind, kann zusätzlich die Produkt-ID angegeben werden:
-<code ini>
+<code ini>\\
-  productid = 0003\
+  productid = 0003\\
 </code>
@@ Zeile 167: / Zeile 178: @@
   productid = \0003
   desc = "APC Smart-UPS SMC1500IC"
 </code>
@@ Zeile 177: / Zeile 187: @@
 <code bash>
 ip -br \address
 </code>
@@ Zeile 206: / Zeile 215: @@
 Die Datei ''/etc/nut/upsd.conf'' öffnen:
 <code bash>
 sudo nano /etc/nut/upsd.\conf
 </code>
@@ Zeile 217: / Zeile 226: @@
 LISTEN 127.0.0.1 \3493
 LISTEN 192.168.1.20 \3493
 </code>
@@ Zeile 234: / Zeile 242: @@
 <code ini>
 LISTEN 127.0.0.1 \3493
 </code>
@@ Zeile 242: / Zeile 249: @@
 <code ini>
 LISTEN 192.168.1.20 \3493
 </code>
@@ Zeile 254: / Zeile 260: @@
 <code bash>
 openssl rand -hex \24
 </code>
@@ Zeile 261: / Zeile 266: @@
 Die Datei ''/etc/nut/upsd.users'' öffnen:
 <code bash>
 sudo nano /etc/nut/upsd.\users
 </code>
@@ Zeile 277: / Zeile 282: @@
   password = \CLIENT_PASSWORT_HIER_EINTRAGEN
   upsmon \slave
 </code>
@@ Zeile 291: / Zeile 295: @@
   password = \CLIENT_PASSWORT_HIER_EINTRAGEN
   upsmon \secondary
 </code>
-<note warning> Die Platzhalter müssen durch echte Passwörter ersetzt werden.
+<note warning>
+Die Platzhalter müssen durch echte Passwörter ersetzt werden.
-Die Passwörter sollten nicht in einer öffentlich zugänglichen Dokumentation gespeichert werden. </note>
+Die Passwörter sollten nicht in einer öffentlich zugänglichen Dokumentation gespeichert werden.
+</note>
 ===== 9. Lokalen NUT-Monitor konfigurieren =====
 Die Datei ''/etc/nut/upsmon.conf'' öffnen:
 <code bash>
 sudo nano /etc/nut/upsmon.\conf
 </code>
 Vorhandene aktive ''MONITOR''-Zeilen sollten auskommentiert oder entfernt werden.
 ==== Ubuntu 22.04 beziehungsweise NUT 2.7 ====
 <code ini>
 MONITOR apc@localhost 1 monmaster MASTER_PASSWORT_HIER_EINTRAGEN master
 MINSUPPLIES 1
 SHUTDOWNCMD "/sbin/shutdown -h +0"
 POWERDOWNFLAG /etc/\killpower
 </code>
 ==== Ubuntu 24.04 beziehungsweise NUT 2.8 ====
@@ Zeile 333: / Zeile 337: @@
 POWERDOWNFLAG /etc/\killpower
 </code>
@@ Zeile 341: / Zeile 344: @@
 Bedeutung der wichtigsten Einträge:
-^Einstellung^Bedeutung| | | | | | | | | | | | | | | | | | |
+^ Einstellung ^ Bedeutung ^
-|''apc@localhost'' |USV mit dem Namen ''apc'' auf dem lokalen Server|   |''1'' |Power-Wert der USV|   |''monmaster'' |Benutzer aus ''upsd.users'' |   |''master'' beziehungsweise ''primary'' |Rolle des direkt angeschlossenen Servers|   |''MINSUPPLIES 1'' |Mindestens eine Stromversorgung muss verfügbar sein|   |''SHUTDOWNCMD'' |Befehl zum Herunterfahren des Servers|   |''POWERDOWNFLAG'' |Kennzeichnung für das spätere Abschalten der USV|
+| ''apc@localhost'' | USV mit dem Namen ''apc'' auf dem lokalen Server |\\
+| ''1'' | Power-Wert der USV |\\
+| ''monmaster'' | Benutzer aus ''upsd.users'' |\\
+| ''master'' beziehungsweise ''primary'' | Rolle des direkt angeschlossenen Servers |\\
+| ''MINSUPPLIES 1'' | Mindestens eine Stromversorgung muss verfügbar sein |\\
+| ''SHUTDOWNCMD'' | Befehl zum Herunterfahren des Servers |\\
+| ''POWERDOWNFLAG'' | Kennzeichnung für das spätere Abschalten der USV |
 ===== 10. Dateirechte absichern =====
 Die Konfigurationsdateien enthalten Passwörter und sollten nur für root und die Gruppe ''nut'' lesbar sein.
-<code bash>
-sudo chown root:nut /etc/nut/upsmon.conf /etc/nut/upsd.users\
+<code bash>\\
+sudo chown root:nut /etc/nut/upsmon.conf /etc/nut/upsd.users\\
 </code>
@@ Zeile 355: / Zeile 364: @@
 <code bash>
 sudo chmod 640 /etc/nut/upsmon.conf /etc/nut/upsd.\users
 </code>
@@ Zeile 363: / Zeile 371: @@
 <code bash>
 ls -l /etc/nut/upsmon.conf /etc/nut/upsd.\users
 </code>
@@ Zeile 383: / Zeile 390: @@
 <code bash>
 sudo systemctl enable nut-server nut-\monitor
 </code>
@@ Zeile 391: / Zeile 397: @@
 <code bash>
 sudo systemctl restart nut-\server
 </code>
@@ Zeile 399: / Zeile 404: @@
 <code bash>
 sudo systemctl restart nut-\monitor
 </code>
@@ Zeile 407: / Zeile 411: @@
 <code bash>
 systemctl --no-pager --full status nut-server nut-\monitor
 </code>
@@ Zeile 417: / Zeile 420: @@
 <code bash>
 sudo systemctl restart nut-driver-enumerator.\service
 </code>
@@ Zeile 423: / Zeile 425: @@
 <code bash>
 sudo systemctl restart nut-server.\service
 </code>
@@ Zeile 429: / Zeile 430: @@
 <code bash>
 sudo systemctl restart nut-monitor.\service
 </code>
@@ Zeile 437: / Zeile 437: @@
 <code bash>
 systemctl --no-pager --full status nut-driver-enumerator.service nut-server.service nut-monitor.\service
 </code>
@@ Zeile 486: / Zeile 485: @@
 <code>
-\OL
+OL
 </code>
@@ Zeile 508: / Zeile 507: @@
 * Netzversorgung \vorhanden * Batterie wird geladen
 ===== 13. Netzwerkzugriff mit UFW erlauben =====
@@ Zeile 514: / Zeile 514: @@
 Beispiel für das Netzwerk ''192.168.1.0/24'':
 <code bash>
 sudo ufw allow from 192.168.1.0/24 to any port 3493 proto \tcp
 </code>
@@ Zeile 524: / Zeile 524: @@
 <code bash>
 sudo ufw \status
 </code>
@@ Zeile 532: / Zeile 531: @@
 <code bash>
 sudo ss -ltnp | grep \3493
 </code>
@@ Zeile 550: / Zeile 548: @@
 <code bash>
 sudo apt \update
 </code>
@@ Zeile 556: / Zeile 553: @@
 <code bash>
 sudo apt install nut-\client
 </code>
@@ Zeile 564: / Zeile 560: @@
 <code bash>
 upsc apc@192.168.1.\20
 </code>
@@ Zeile 579: / Zeile 574: @@
 sollten folgende Punkte kontrolliert werden:
-* Ist ''nut-server'' gestartet? * Ist die richtige IP in ''upsd.conf'' eingetragen? * Ist TCP-Port 3493 durch die Firewall freigegeben? * Ist die IP-Adresse vom Client erreichbar?
+* Ist ''nut-server'' gestartet?
+* Ist die richtige IP in ''upsd.conf'' eingetragen?
+* Ist TCP-Port 3493 durch die Firewall freigegeben?
+* Ist die IP-Adresse vom Client erreichbar?
 ===== 15. Vorsichtiger Stromausfalltest =====
@@ Zeile 588: / Zeile 587: @@
 <code bash>
 watch -n 2 'upsc apc@localhost ups.status; upsc apc@localhost battery.charge; upsc apc@localhost battery.runtime'
 </code>
@@ Zeile 596: / Zeile 594: @@
 Dabei sollten folgende Änderungen sichtbar sein:
-^Zustand^Erwarteter Status| | | | | | |
+^ Zustand ^ Erwarteter Status ^
-|Netzstrom vorhanden|''OL'' |   |Netzstrom getrennt|''OB'' |   |Netzstrom wiederhergestellt|''OL'' |
+| Netzstrom vorhanden | ''OL'' |\\
+| Netzstrom getrennt | ''OB'' |\\
+| Netzstrom wiederhergestellt | ''OL'' |
 Die angeschlossenen Server müssen während des kurzen Tests weiterlaufen.
@@ Zeile 612: / Zeile 612: @@
 <code bash>
-\
+upsdrvctl shutdown
-upsdrvctl shutdown\
@@ Zeile 621: / Zeile 620: @@
 Dadurch verlieren alle an der USV angeschlossenen Geräte unmittelbar ihre Stromversorgung.
 ===== 17. Fehlerdiagnose =====
@@ Zeile 635: / Zeile 635: @@
 <code bash>
-\lsusb
+lsusb
@@ Zeile 663: / Zeile 663: @@
 </code>
 ==== Fehler: Driver failed to start ====
@@ Zeile 670: / Zeile 671: @@
 <code bash>
 sudo upsdrvctl \stop
 </code>
@@ Zeile 678: / Zeile 678: @@
 <code bash>
 sudo /lib/nut/usbhid-ups -a apc -\DDD
 </code>
@@ Zeile 688: / Zeile 687: @@
 <code bash>
 sudo systemctl restart nut-\server
 </code>
@@ Zeile 698: / Zeile 696: @@
 <code bash>
 ps aux | grep -E 'apcupsd|usbhid-ups|upsd|upsmon'
 </code>
@@ Zeile 708: / Zeile 705: @@
 <code bash>
 systemctl status \apcupsd
 </code>
 Falls NUT verwendet werden soll, ''apcupsd'' stoppen und deaktivieren:
 <code bash>
 sudo systemctl disable --now \apcupsd
 </code>
@@ Zeile 723: / Zeile 719: @@
 <code bash>
 sudo systemctl restart nut-server nut-\monitor
 </code>
@@ Zeile 733: / Zeile 728: @@
 <code bash>
 sudo systemctl status nut-server --no-\pager
 </code>
@@ Zeile 741: / Zeile 735: @@
 <code bash>
 sudo journalctl -u nut-server -n 100 --no-\pager
 </code>
@@ Zeile 749: / Zeile 742: @@
 <code bash>
 lsusb | grep -i -E 'APC|American Power Conversion'
 </code>
@@ Zeile 757: / Zeile 749: @@
 ===== 18. Konfigurationsdateien im Überblick =====
-^Datei^Aufgabe| | | | | | | | | | | | |
+^ Datei ^ Aufgabe ^
-|''/etc/nut/nut.conf'' |Legt die NUT-Betriebsart fest|   |''/etc/nut/ups.conf'' |Definiert die angeschlossene USV und den Treiber|   |''/etc/nut/upsd.conf'' |Legt Netzwerkadressen und Port des NUT-Servers fest|   |''/etc/nut/upsd.users'' |Definiert Benutzer, Passwörter und Berechtigungen|   |''/etc/nut/upsmon.conf'' |Konfiguriert Überwachung und automatisches Herunterfahren|
+| ''/etc/nut/nut.conf'' | Legt die NUT-Betriebsart fest |\\
+| ''/etc/nut/ups.conf'' | Definiert die angeschlossene USV und den Treiber |\\
+| ''/etc/nut/upsd.conf'' | Legt Netzwerkadressen und Port des NUT-Servers fest |\\
+| ''/etc/nut/upsd.users'' | Definiert Benutzer, Passwörter und Berechtigungen |\\
+| ''/etc/nut/upsmon.conf'' | Konfiguriert Überwachung und automatisches Herunterfahren |
 ===== 19. Beispiel einer vollständigen Konfiguration =====
@@ Zeile 765: / Zeile 761: @@
 <code ini>
-\
+MODE=netserver
-MODE=netserver\
 </code>
 ==== /etc/nut/ups.conf ====
 <code ini>
-\
+[apc]
-[apc]\
+  driver = usbhid-ups
-  driver = usbhid-ups\
+  port = auto
-  port = auto\
+  vendorid = 051d
-  vendorid = 051d\
+  desc = "APC Smart-UPS SMC1500IC"
-  desc = "APC Smart-UPS SMC1500IC"\
 </code>
 ==== /etc/nut/upsd.conf ====
 <code ini>
-\
 LISTEN 127.0.0.1 3493\
 LISTEN 192.168.1.20 3493\
@@ Zeile 793: / Zeile 788: @@
 </code>
 ==== /etc/nut/upsd.users für Ubuntu 22.04 ====
 <code ini>
-\
+[monmaster]
-[monmaster]\
   password = MASTER_PASSWORT_HIER_EINTRAGEN\
   upsmon master
-[monclient]\
+[monclient]
   password = CLIENT_PASSWORT_HIER_EINTRAGEN\
-  upsmon slave\
+  upsmon slave
 </code>
 ==== /etc/nut/upsmon.conf für Ubuntu 22.04 ====
 <code ini>
-\
 MONITOR apc@localhost 1 monmaster MASTER_PASSWORT_HIER_EINTRAGEN master
 MINSUPPLIES 1
 SHUTDOWNCMD "/sbin/shutdown -h +0"
+POWERDOWNFLAG /etc/killpower
-POWERDOWNFLAG /etc/killpower\
+</code>
-</code>
 ===== Ergebnis =====
@@ Zeile 829: / Zeile 822: @@
 <code bash>
-\
+upsc apc@localhost
-upsc apc@localhost\
@@ Zeile 836: / Zeile 828: @@
 Bei normaler Netzversorgung sollte unter anderem folgender Status erscheinen:
 <code>
+ups.status: OL
-\
-ups.status: OL\
 </code>