Content
Dateianzeige für nethaltd (3.4.0)
usr/share/doc/nethaltd/nethaltd.txt
Net Halt Daemon
Net Halt Daemon (nethaltd) ist ein einfacher HTTP-Server, der dazu ge-
dacht ist, mit Hilfe spezieller URLs den Server aus der Ferne entweder
auszuschalten oder neu zu starten. Dabei steht vor allem das Zusammen-
spiel mit dem Tool "Remote-Wake-Sleep-ON-LAN-Server" [1] im Fokus, das
(z.B. auf einem Raspberry Pi installiert) es erlaubt, ueber ein Web-
Fontend Computer im Netzwerk (mittels Wake-On-LAN) zu starten und
wieder auch wieder herunterzufahren. Damit letzteres funktioniert,
muss auf dem jeweiligen Computer ein Dienst wie nethaltd eingerichtet
sein.
Aktuell werden dazu die folgenden URLs angeboten:
http://:/shutdown
Bewirkt, dass das Kommando 'halt' aufgerufen wird, das wiederum
dem Kommando 'shutdown -h now' entspricht. Nach dem Aufruf der
URL wird der Server unmittelbar heruntergefahren.
http://:/reboot
Bewirkt, dass das Kommando 'reboot' aufgerufen wird. Dieses wie-
derum hat zur Folge, dass der Server unmittelbar nach der Anfor-
derung heruntergefahren und anschliessend neu gestartet wird.
Um ein Mindestmass an Sicherheit zu gewaehrleisten, kann das Zugriffs-
recht auf den Dienst auf einzelne Rechner ueber eine Access-Control-
List (ACL) beschraenkt werden.
Konfiguration
-------------
START_NETHALTD
Schaltet den Dienst frei. Sobald der Wert auf 'yes' gesetzt wird,
wird nethaltd beim Aktivieren der Konfiguration und bei jedem
Neustart des Systems automatisch gestartet.
Gueltige Werte: yes, no
Standardwert: START_NETHALTD='no'
NETHALTD_PORT
TCP/IP-Port auf dem der Net-Halt-Dienst auf Anfragen lauschen soll.
Beispiel: NETHALTD_PORT='4700'
NETHALTD_VERBOSE_LOG
Der Dienst legt unter /var/log Protokolldateien mit dem Namen
'nethaltd_.log' an, in die Fehlermeldungen ausgegeben werden.
Wird o.g. Option auf 'yes' gesetzt, erfolgt (zu Debug- oder
Ueberwachungszwecken) eine ausführlichere Ausgabe von Protokoll-
meldungen.
Gueltige Werte: yes, no
NETHALTD_ACL_N
Diese Option legt die Anzahl von Eintraegen in der Liste be-
rechtigter Computer fest (ACL), die auf diesen Dienst zugrei-
fen duerfen. Es ist dabei wichtig zu beachten, dass eine leere
ACL den Zugriff auf den Dienst fuer alle Computer freischaltet.
Falls beabsichtigt ist, den Zugriff auf nethaltd zu deaktivieren
sollte statt dessen START_NETHALTD='no' gesetzt werden.
NETHALTD_ACL_%_HOST
Legt pro Eintrag eine einzelne Host-Adresse in Form einer IPv4
Adresse fest. Es koennen weder Host-Namen noch Netzwerke an-
gegeben werden.
Beispiel: NETHALTD_ACL_1='192.168.0.1'
Remote-Wake-Sleep-On-LAN-Server
-------------------------------
Damit nethaltd mit o.g. Web-App zusammenarbeitet, muss deren Konfigu-
ration (config.php) wie folgt angepasst werden. Es werden hier nur die
Optionen wiedergegeben, die nethaltd betreffen:
$COMPUTER_LOCAL_IP = array("", ...)
$COMPUTER_SLEEP_CMD_PORT = 4700;
$COMPUTER_SLEEP_CMD = "shutdown";
Links
-----
[1] https://github.com/sciguy14/Remote-Wake-Sleep-On-LAN-Server