##----------------------------------------------------------------------------
## opt_wol                                                  fli4l-3.0.1 v1.6.3
##
## Creation:     12.10.2002  gk
## Last Update:  29.03.2006 m.p.
##
## Copyright (c) 2006 Matthias Pilz <fli4l.pilz@tiscali.de>
## original release (c) 2002-2004 Georg Kainzbauer <georgkainzbauer@gmx.net>
##
## This program is free software; you can redistribute it and/or modify
## it under the terms of the GNU General Public License as published by
## the Free Software Foundation; either version 2 of the License, or
## (at your option) any later version.
##----------------------------------------------------------------------------

Einleitung:
===========
Mit diesem Paket knnen Rechner, die mit einer Wake-on-LAN fhigen
Netzwerkkarte ausgerstet sind, ber das Konsolenkommando 'wol.sh' vom
Router aus gebootet (aufgeweckt) werden.
Damit das klappt, muss die Netzwerkkarte normalerweise mit einem kleinen
dreiadrigen Kabel mit dem Mainboard verbunden sein, damit die Netzwerkkarte
auch bei abgeschaltetem Rechner vom ATX-Netzteil mit Standby-Strom versorgt
und das Einschalt-Signal an das Mainboard gesendet werden kann.
Jngere PCI-Gerte (ab 2.1 ?) bentigen das aber nicht mehr.
Das Rechner-BIOS muss meist entsprechend eingestellt werden.
Frisch eingeschaltete Rechner knnen oft noch nicht gebootet werden,
nur "heruntergefahrene" Rechner knnen "aufgeweckt" werden.

Installation:
=============
Das OPT-Archiv in das FLI4L Installationsverzeichnis entpacken (wie blich).
Danach die config-Datei wol.txt an das Netzwerk anpassen.

OPT_WOL='yes'                         # install opt_wol: yes or no
Muss auf yes gesetzt sein wenn opt_wol installiert werden soll.

WOL_HOST_N='2'                        # Anzahl der Wake-on-LAN fhigen Clients
WOL_HOST_1_NAME='Client1'             # Rechnername des ersten Clients
WOL_HOST_1_IF='eth0'                  # Netzwerkinterface fr ersten Client
WOL_HOST_1_IP='192.168.1.1'           # IP-Adresse des ersten Clients
WOL_HOST_1_MAC='11:11:11:11:11:11'    # MAC-Adresse des ersten Clients
WOL_HOST_2_NAME='Client2'             # Rechnername des zweiten Clients
WOL_HOST_2_IF='eth0'                  # Netzwerkinterface fr zweiten Client
WOL_HOST_2_IP='192.168.1.2'           # IP-Adresse des zweiten Clients
WOL_HOST_2_MAC='22:22:22:22:22:22'    # MAC-Adresse des zweiten Clients
Diese Zeilen sollten eigentlich selbsterklrend sein.

Wozu die Interface-Angabe?
Damit das Paket in das richtige LAN geschickt wird.
Interessant wird es, wenn mehr als ein LAN am FLI4L hngt oder das DSL auf
eth0 konfiguriert ist (default ist eth1 - siehe base.txt).

FAQ: Wie findet man die MAC-Adresse einer Netzwerkkarte heraus?
Windows 9x: in der MS-DOS-Eingabeaufforderung "winipcfg" ausfhren
Windows XP/2000: in der MS-DOS-Eingabeaufforderung "ipconfig /all" ausfhren
Linux: hier hilft der Befehl "ifconfig"
Der arp-Befehl knnte auch hilfreich sein.

WOL_BOOT='yes'                        # install WOL on Boot: yes or no
Diese Einstellung dann auf "yes" setzten, wenn Rechner im Netzwerk
beim Starten des Routers ebenfalls (via Wake-on-LAN) booten sollen.

WOL_BOOT_N='0'                        # Anzahl der Rechner
WOL_BOOT_1_IF='eth0'                  # Netzwerkinterface fr ersten Client
WOL_BOOT_1_MAC='11:11:11:11:11:11'    # MAC-Adresse des ersten Clients
WOL_BOOT_2_IF='eth0'                  # Netzwerkinterface fr zweiten Client
WOL_BOOT_2_MAC='22:22:22:22:22:22'    # MAC-Adresse des zweiten Rechners
Diese Zeilen sollten eigentlich auch selbsterklrend sein.

Fr das Webinterface ist diese Berechtigung notwendig (siehe httpd.txt):
status:boot

Wer also den FLI4L rebooten darf, kann auch anderen Rechnern im LAN WOL-Pakete
schicken, um sie zu starten.

Benutzung:
==========
Per Webinterface (miniHTTPd - Berechtigung beachten):
In der Tabelle sind die in der wol.txt definierten Rechner aufgelistet.
Ein Klick auf "WOL" schickt ein Magic Packet ins LAN. Einfach, oder?

Per Konsole, SSH, Cron-Job, Telmond:
 wol.sh <Rechnername>
oder
 wol.sh <IP-Adresse>
oder
 wol.sh <MAC-Adresse>

Nicht in der wol.txt eingetragene Rechner knnen auch direkt durch ether-wake
gestartet werden:
 ether-wake [-i <Interface>] <MAC-Addresse>
Im Zweifelsfalle bitte die Syntax von ether-wake zu Rate ziehen!

Interessant knnte dieses OPT auch zusammen mit OPT_TELMOND sein, wenn mal
gerade kein Internet verfgbar ist (siehe isdn.txt):
TELMOND_CMD_1='<MSN> <Handy-Nummer> ether-wake <MAC-Adresse>'


Bekannte Probleme:
==================
Im syslog wird diese (harmlose) Meldung ausgegeben:
kernel: ether-wake uses obsolete (PF_INET,SOCK_PACKET)
Das beeintrchtigt aber nicht die Funktion und hat keine negativen Auswirkungen.
Ausserdem kommt diese Meldung scheinbar auch nur beim ersten Aufruf von ether-wake.


Allgemeines:
============
Probleme, Erfolgsberichte und Verbesserungsvorschlge:
http://www.georgkainzbauer.de/forum/ (Support eingestellt)
FLI4L-Newsgroup: http://www.fli4l.de/hilfe/newsgruppen.html
email an fli4l.pilz@tiscali.de


Vielen Dank fr das Lesen der Dokumentation - viel Erfolg mit opt_wol.

letzte nderungen: 29.03.2006
