%
% dsl.tex
% Last Update: $Id$
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%% Kapitel DSL %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

\chapter{Das DSL-Paket}
\marklabel{DSLADMIN}{}
\index{DSL}


\section{Die Einleitung}
    \eisfair unterst"utzt \glqq{}DSL\grqq{} via PPPoE (externe, "uber Ethernet
    angeschlossene DSL-Modem, "uber die PPPoE als Protokoll gefahren wird)

    Das \glqq{}DSL\grqq{} Paket ben"otgt f"ur Portforwarding das
    \glqq{}routing\grqq{} Paket.

    Das \glqq{}imond\grqq{} Paket ist optional und wird f"ur den DSL Betrieb
    nicht zwingend ben"otigt.


\section{Das Men"u im Setup-Programm}

    Das Men"u im Setup-Programm ist wie folgt aufgebaut:

    \mbox{}

    \begin{tabular}{llll}
    & 1. &  System administration \\
    \end{tabular}
\eline
    \begin{tabular}{p{1cm}llll}
    & 2. &  Network administration \\
    \end{tabular}
\eline
    \begin{tabular}{p{2cm}llll}
    & x. &  DSL (PPPoE) administration \\
    \end{tabular}
\eline
    \begin{tabular}{p{3cm}ll}
    & 1. & View documentation \\
    & 2. & Edit configuration \\
    & 3. & Advanced configuration file handling \\
    & 4. & Show status \\
    & 5. & Stop service \\
    & 6. & Start service \\
    & 7. & Logfile view \\
    \end{tabular}

    \mbox{}


\section{Die Konfiguration}

\begin{description}

\config{START\_DSL}
{START\_DSL}
{STARTDSL}
{
    Mit \texttt{START\_DSL} kann man einstellen, ob der
    DSL Service aktiviert werden soll.

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{START\_DSL='no'}
}


\config{DSL\_PPPOE\_NAME}
{DSL\_PPPOE\_NAME}
{DSLPPPOENAME}
{
    Hier sollte ein Name f"ur den Circuit vergeben werden - max.
    15 Stellen lang. Dieser wird im imon-Client imonc angezeigt.
    Leerstellen (Blanks) sind nicht erlaubt.

    G"ultige Werte: Name

    Standardeinstellung: \texttt{DSL\_PPPOE\_NAME='DSL'}
}


\config{DSL\_PPPOE\_USERPEERDNS}
{DSL\_PPPOE\_USERPEERDNS}
{DSLPPPOEUSERPEERDNS}
{
    Hiermit wird festgelegt, ob die vom Internet-Provider bei der Einwahl
    "ubergebenen Nameserver f"ur die Dauer der Onlineverbindung in die
    Konfigurationsdatei des lokalen Nameservers eingetragen werden
    sollen.

    Nachdem die Nameserver-IP-Adressen "ubertragen wurden, werden die unter
    \texttt{DNS\_SERVER} eingetragenen Nameserver aus der Datei
    resolv.conf entfernt und die vom Provider vergebenen IP-Adressen als
    Forwarder in die resolv.conf eingetragen. Danach wird der lokale
    Nameserver veranlasst, seine Konfiguration neu einzulesen. Dabei gehen
    bis dahin aufgel"oste Namen nicht aus dem Nameserver-Cache verloren.

    Diese Option bietet den Vorteil, immer mit den am n"achsten liegenden
    Nameservern arbeiten zu k"onnen, sofern der Provider die korrekten IP-
    Adressen "ubermittelt - dadurch geht die Namensaufl"osung schneller.

    Im Falle eines Ausfalls eines DNS-Servers beim Provider werden in der
    Regel die "ubergebenen DNS-Server-Adressen sehr schnell vom Provider
    korrigiert.

    Trotz allem ist vor jeder ersten Einwahl die Angabe eines g"ultigen
    Nameservers in \texttt{DNS\_SERVER} zwingend erforderlich, da sonst
    die erste Anfrage nicht korrekt aufgel"ost werden kann. Au"serdem wird
    beim Beenden der Verbindung die originale Konfiguration des lokalen
    Nameservers wieder hergestellt.

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{DSL\_PPPOE\_USEPEERDNS='no'}
}


\config{DSL\_PPPOE\_BIND\_ETH}
{DSL\_PPPOE\_BIND\_ETH}
{DSLPPPOEBINDETH}
{
    Bei diesem Parameter wird das Interface angegeben.

    Hier wird kein echter Netzwerk-Ger"ate Namen angegeben sondern der
    Index der Angabe IP\_ETH\_x\_NAME aus der Base  Konfiguration in
    /etc/config.d/base.

    Der Index kann, wenn der Editor \glqq{}\ece\grqq{} eingestellt ist,
    auch aus dem Dialog eingef"ugt werden.

    G"ultige Werte: 1, 2  etc...

    Standardeinstellung: \texttt{DSL\_PPPOE\_BIND\_ETH='2'}
}


\config{DSL\_PPPOE\_DEBUG}
{DSL\_PPPOE\_DEBUG}
{DSLPPPOEDEBUG}
{
    Soll pppd zus"atzliche Debug-Informationen ausgeben, muss man
    \texttt{DSL\_PPPOE\_DEBUG} auf 'yes' setzen. In diesem Fall schreibt pppd
    zus"atzlichen Informationen "uber die Syslog-Schnittstelle.

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{DSL\_PPPOE\_DEBUG='no'}
}


\index{DSL\_PPPOE\_PASS}
\config{DSL\_PPPOE\_USER}
{DSL\_PPPOE\_USER}
{DSLPPPOEUSER}
{
    Hier sind Benutzerkennung und Kennwort f"ur den jeweils benutzten
    Provider anzugeben.

    WICHTIG: F"ur einen T-Online-Zugang ist folgendes zu beachten:

    Der Username AAAAAAAAAAAATTTTTT\#MMMM setzt sich aus der zw"olfstelligen
    Anschlusskennung, der T-Online-Nummer und der Mitbenutzernummer zusammen.
    Hinter der T-Online-Nummer muss ein '\#' angegeben werden, wenn die L"ange
    der T-Online-Nummer k"urzer als 12 Zeichen ist.

    Sollte dies in Einzelf"allen nicht zum Erfolg f"uhren (offenbar abh"angig
    von der Vermittlungsstelle), muss zus"atzlich zwischen der Anschlusskennung
    und der T-Online-Nummer ein weiteres '\#'-Zeichen eingef"ugt werden.

    Ansonsten (T-Online-Nummer ist 12stellig) sind keine '\#'-Zeichen anzugeben.

    Die Benutzerkennung muss bei T-Online mit '@t-online.de' abgeschlossen
    werden!

    G"ultige Werte: Benutzerkennung

    Standardeinstellung: \texttt{DSL\_PPPOE\_USER='111111111111222222\#0001@t-online.de'}
}


\config{DSL\_PPPOE\_PASS}
{DSL\_PPPOE\_PASS}
{DSLPPPOEPASS}
{
    Hier ist das Passwort f"ur den jeweils benutzten
    Provider anzugeben.

    G"ultige Werte: Passwort

    Standardeinstellung: \texttt{DSL\_PPPOE\_PASS='secret'}
}


\config{DSL\_PPPOE\_HUP\_TIMEOUT}
{DSL\_PPPOE\_HUP\_TIMEOUT}
{DSLPPPOEHUPTIMEOUT}
{
    Hier kann die Zeit in Sekunden angegeben werden, nach welcher die
    Verbindung beendet werden soll, wenn nichts mehr "uber die DSL-Leitung
    l"auft.

    Wenn die Verbindung gehalten werden soll ist als Wert '0' zu setzen.

    G"ultige Werte: Zahl

    Standardeinstellung: \texttt{DSL\_PPPOE\_HUP\_TIMEOUT='600'}
}


\config{DSL\_PPPOE\_CHARGEINT}
{DSL\_PPPOE\_CHARGEINT}
{DSLPPPOECHARGEINT}
{
    Charge-Interval: Hier ist der Zeittakt in Sekunden anzugeben. Dieser
    wird dann f"ur die Kosten-Berechnung verwendet.

    Die meisten Provider rechnen minutengenau ab. In diesem Fall ist der
    Wert '60' richtig. Bei Providern mit sekundengenauer Abrechnung setzt
    man \texttt{DSL\_PPPOE\_CHARGEINT} besser auf '1'.

    Leider wird bei DSL der Zeittakt nicht voll ausgenutzt, so wie es bei
    ISDN der Fall ist. Hier wird immer nach der Zeit, die in
    \texttt{DSL\_PPPOE\_HUP\_TIMEOUT} angegeben ist, eingeh"angt.

    Hier ist deshalb \texttt{DSL\_PPPOE\_CHARGEINT} lediglich f"ur die Berechnung
    von Geb"uhren ma"sgeblich.

    G"ultige Werte: Zahl

    Standardeinstellung: \texttt{DSL\_PPPOE\_CHARGEINT='60'}
}


\config{DSL\_PPPOE\_TIMES}
{DSL\_PPPOE\_TIMES}
{DSLPPPOETIMES}
{
    Die hier angegebenen Zeiten bestimmen, wann dieser Circuit aktiviert
    werden soll und wann er wie viel kostet. Dadurch wird es m"oglich, zu
    verschiedenen Zeiten verschiedene Circuits mit Standardrouten zu
    verwenden (Least-Cost-Routing). Dabei kontrolliert der Daemon imond die
    Routen-Zuweisung.

    Aufbau der Variablen:

    \texttt{DSL\_PPPOE\_TIMES='times-1-info [times-2-info] ...'}

    Jedes Feld times-?-info besteht aus 4 Unterfeldern - durch Doppelpunkt
    (':') getrennt.

    \textbf{1. Feld: W1-W2}

    Wochentag-Zeitraum, z.B. Mo-Fr oder Sa-Su usw. Sowohl die deutsche als
    auch die englische Schreibweise ist erlaubt. Soll ein einzelner
    Wochentag eingetragen werden, ist zu W1-W1 schreiben, also z.B. Su-Su.

    \textbf{2. Feld: hh-hh}

    Stunden-Bereich, z.B. 09-18 oder auch 18-09. 18-09 ist gleichbedeutend
    mit 18-24 plus 00-09. 00-24 meint den ganzen Tag.

    \textbf{3. Feld: Charge}

    Hier werden in Euro-Werten die Kosten pro Minute angegeben, z.B. 0.032
    f"ur 3.2 Cent pro Minute. Diese werden unter Ber"ucksichtigung der
    Taktzeit umgerechnet f"ur die tats"achlich anfallenden Kosten, welche dann
    im imon-Client angezeigt werden.

    \textbf{4. Feld: LC-Default-Route}

    Der Inhalt kann Y oder N sein. Dabei bedeutet:

    \begin{tabular}{lll}
      & \texttt{Y:} & \texttt{Der angegebene Zeitbereich wird beim LC-Routing als Standardroute} \\
      &             & \texttt{verwendet.} \\
	  & \texttt{N:} & \texttt{Der angegebene Zeitbereich dient nur zum Berechnen von Kosten, er} \\
	  &             & \texttt{wird beim automatischen LC-Routing jedoch nicht weiter verwendet.} \\
    \end{tabular}


    Wichtig: Die bei \texttt{DSL\_PPPOE\_TIMES} angegebenen Zeiten m"ussen die
    ganze Woche abdecken. Ist das nicht der Fall, kann keine g"ultige
    Konfiguration erzeugt werden.

    Wenn die Zeitbereiche aller LC-Default-Route-Circuits (\glqq{}Y\grqq{})
    zusammengenommen nicht die komplette Woche beinhalten, gibt es zu diesen
    L"uckenzeiten keine Standardroute. Damit ist dann Surfen im Internet zu
    diesen Zeiten ausgeschlossen!

    Und noch eine letzte Bemerkung zum LC-Routing: Feiertage werden wie
    Sonntage behandelt.

    Beispiel (als eine lange Zeile zu lesen):

    G"ultige Werte:'Mo-Fr:09-18:0.049:N
                    Mo-Fr:18-09:0.044:Y
                    Sa-Su:00-24:0.039:Y'

    Standardeinstellung: \texttt{DSL\_PPPOE\_TIMES='Mo-Su:00-24:0.0:Y'}
}


\config{DSL\_PPPOE\_LOGGING}
{DSL\_PPPOE\_LOGGING}
{DSLPPPOELOGGING}
{
    "Uber diesen Parameter l"asst sich das loggen der Meldungen vom
    pppd Daemon ein- und ausschalten.

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{DSL\_PPPOE\_LOGGING='no'}
}


%\config{DSL\_PPPOE\_TYPE}
%{DSL\_PPPOE\_TYPE}
%{DSLPPPOETYPE}
%{
%    PPPOE steht f"ur die "Ubertragung von PPP-Paketen "uber
%    Ethernet-Leitungen. D.h., die zu "ubertragenden Daten werden
%    im ersten Schritt vom ppp-Daemon in ppp-Pakete und dann in
%    einem zweiten Schritt f"ur die "Ubertragung "ubers Ethernet
%    nochmals in pppoe-Pakete verpackt, um dann ans DSL-Modem
%    geschickt zu werden.
%
%
%    \begin{tabular}{lll}
%     & \texttt{async} &  \texttt{Die Pakete werden durch den pppoe-Daemon erzeugt; die} \\
%     &                &  \texttt{Kommunikation zwischen pppd und pppoe erfolgt asynchron.} \\
%     & \texttt{sync}  &  \texttt{Die Pakete werden durch den pppoe-Daemon erzeugt; die} \\
%    &                &  \texttt{Kommunikation zwischen pppd und pppoe erfolgt syncron.} \\
%     &                &  \texttt{Das f"uhrt zu einer effizienteren Kommunikation und damit} \\
%     &                &  \texttt{zu einer geringeren Prozessorlast.} \\
%    \end{tabular}
%
%
%    G"ultige Werte: async, sync
%
%    Standardeinstellung: \texttt{DSL\_PPPOE\_TYPE='async'}
%}

\end{description}

\jump{MENUSYSTEMNETWORK}{Zur"uck zum Men"u: Network administration}
