%
% administration_base_config.tex
% Last Update: $Id$
%
% wird in administartion.tex eingebunden
% \input{administration_base_config}
% ab etwa Zeile 589
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%% Kapitel Base config %%%%%%%%%%%%%%%%%%%%%%%%%%%

\marklabel{BASEPARAMS}{\subsubsection{Edit base configuration}}

Der Men"upunkt \glqq{}Base administration\grqq{} "offnet die
Konfigurationsdatei \glqq{}base\grqq{}. In dieser Datei werden folgende
Einstellungen definiert:

  \begin{enumerate}
    \item Netzwerkeinstellungen
    \item DNS Einstellungen
    \item Aufruf zus"atzlicher Treiber beim Booten (z.B. SCSI)
    \item \dots
  \end{enumerate}

Die Parameter der Grundkonfiguration im Einzelnen:


\begin{description}


\config{HOSTNAME}
{HOSTNAME}
{HOSTNAME}
{
    Als erstes sollte man seinem \eisfair-Server einen Namen geben. Im
    Beispiel ist dies \glqq{}eis\grqq{}. Dieser Name muss nicht unbedingt im
    DNS aufgel"ost werden k"onnen (wenn man keinen eigenen DNS-Server hat).

    G"ultige Werte: Name

    Standardeinstellung: \texttt{HOSTNAME='eis'}
}


%\config{ETH\_DRV\_WAKE\_ON\_LAN}
%{ETH\_DRV\_WAKE\_ON\_LAN}
%{ETHDRVWAKEONLAN}
%{
%    Bei diesem Parameter gibt man an, ob der Netzwerkkartentreiber
%    f"ur \glqq{}wake-on-lan\grqq{} geladen bleiben soll 'yes', oder
%    entladen werden kann 'no'.
%
%    G"ultige Werte: yes, no
%
%    Standardeinstellung: \texttt{ETH\_DRV\_WAKE\_ON\_LAN='no'}
%}


\config{ETH\_DRV\_WAIT\_ON\_BOOT}
{ETH\_DRV\_WAIT\_ON\_BOOT}
{ETHDRVWAITONBOOT}
{
    Bei diesem Parameter gibt man an, ob der Bootvorgang verz"ogert
    werden soll, bis das Netzwerk verf"ugbar ist.

    G"ultige Werte: netzwerk name

    Standardeinstellung: \texttt{ETH\_DRV\_WAIT\_ON\_BOOT='{}'}
}


\config{IP\_ETH\_N}
{IP\_ETH\_N}
{IPETHN}
{
    Anzahl der Ethernet- oder USB-Netzwerkkarten, die an das IP-Protokoll
    gebunden werden sollen.

    Es m"ussen alle im System verbauten Netzwerkkarten in der base-config
    eingetragen werden, andere Pakete wie bonding, bridge, etc.. benutzen
    den Index um eine entsprechende Bindung an ein Netzwerk-Ger"at zu erzeugen.

    G"ultige Werte: Zahl

    Standardeinstellung: \texttt{IP\_ETH\_N='1'}
}


\config{IP\_ETH\_x\_NAME}
{IP\_ETH\_x\_NAME}
{IPETHxNAME}
{
    Bei diesem Parameter wird das Interface angegeben.
    Wenn nur eine Netzwerkkarte im System eingebaut ist,
    kann der Parameter leer bleiben.

    Es wird die Verwendung von Udev Namen wie 'enx123456789782'
    empfohlen, damit wird die gr"o"ste Sicherheit in der
    Verwendung der Netzwerknamen erreicht.

    Wenn das aus irgendeinem Grund nicht m"oglich erscheint, ist
    z.B. 'net0' oder 'net1' eine gute Wahl. Die Verwendung von
   'eth0' oder 'eth1' wird nicht empfohlen. Zu vermeiden sind ebenfalls
    Namen, die mit 'en' beginnen, da dies dem von Udev verwendeten
    Namensraum entspricht.

    Der Name kann, wenn der Editor \glqq{}\ece\grqq{} eingestellt ist, auch
    aus dem Dialog eingef"ugt werden. Somit sind keine Kryptischen
    Zeichen einzugeben.

    G"ultige Werte: enx*, net0, net1 etc..

    Beispiel:

\texttt{IP\_ETH\_1\_NAME='net0'}

    Standardeinstellung: \texttt{IP\_ETH\_1\_NAME='enx123456789782'}
}


\config{IP\_ETH\_x\_MACADDR}
{IP\_ETH\_x\_MACADDR}
{IPETHxMACADDR}
{
    Bei der Verwendung von 'net' oder 'eth' als Netzwerknamen ist
    die Angabe von der Mac Adresse der Netzwerkkarte zwingend
    erforderlich. Bei der Verwendung von Udev Namen wie 'enx*'
    ist die Mac Adresse nicht erforderlich und kann dann leer
    bleiben.

    G"ultige Werte: Mac '00:00:00:00:00:00'

    Standardeinstellung: \texttt{IP\_ETH\_x\_MACADDR='{}'}
}



\config{IP\_ETH\_x\_IP\_N}
{IP\_ETH\_x\_IP\_N}
{IPETHxIPN}
{
    Die Anzahl der IP Adressen die diesem Interface zugeordnet werden
    sollen.

    Bei der Einstellung \texttt{IP\_ETH\_x\_IP\_N='0'} werden keine Werte
    an diesem Interface angelegt.

    G"ultige Werte: Zahl

    Standardeinstellung: \texttt{IP\_ETH\_x\_IP\_N='1'}
}


\config{IP\_ETH\_x\_IP\_x\_IPADDR}
{IP\_ETH\_x\_IP\_x\_IPADDR}
{IPETHxIPxIPADDR}
{
    Die IP-Adresse der x'ten Netzwerkkarte im \eisfair-Server.

    Bei mehreren Netzwerkkarten, wo die 2.Netzwerkkarte an bonding oder
    bridge gebunden wird, kann dieser Eintrag leer bleiben. \\
    Bei dhcpc oder dsl ist eine Hinterlegte IP-Adresse ein 'Fallback' und
    wird nur beim Abschalten des Dienstes aktiviert.

    G"ultige Werte: IP Adresse

    Standardeinstellung: \texttt{IP\_ETH\_x\_IP\_x\_IPADDR='192.168.6.254'}
}


\config{IP\_ETH\_x\_IP\_x\_NETWORK}
{IP\_ETH\_x\_IP\_x\_NETWORK}
{IPETHxIPxNETWORK}
{
    Die Netzwerkadresse. Dieses ist bei Class-C-Netzen gleich der
    IP-Adresse der Karte, jedoch mit letztem Octett = 0. Bei anderen
    Netzen/Netmask entsprechend.

    Regel:

            ip-adress BITWISE-AND netmask = network

    Beispiel:

            192.168.6.55 BITWISE-AND 255.255.255.0 = 192.168.6.0


    G"ultige Werte: IP Adresse

    Standardeinstellung: \texttt{IP\_ETH\_x\_IP\_x\_NETWORK='192.168.6.0'}
}


% Gibt es Class-C-Netzwerke eigentlich noch?
\config{IP\_ETH\_x\_IP\_x\_NETMASK}
{IP\_ETH\_x\_IP\_x\_NETMASK}
{IPETHxIPxNETMASK}
{
    Konfiguriert die Netzwerkmaske f"ur das Netz. Der Wert in der
    Beispiel-Datei gilt f"ur ein Class-C-Netz und braucht z.B. f"ur Netze der
    Form 192.168.X.0 normalerweise nicht ge"andert werden.

    G"ultige Werte: Netmask

    Standardeinstellung: \texttt{IP\_ETH\_x\_IP\_x\_NETMASK='255.255.255.0'}
}




\config{IP\_DEFAULT\_GATEWAY}
{IP\_DEFAULT\_GATEWAY}
{IPDEFAULTGATEWAY}
{
    Hier wird die LAN-IP-Adresse des Standard-Gateways eingetragen.
    Da die \eisfair-Installation "uber das Internet erfolgt, muss
    das LAN eine funktionsf"ahige Verbindung zum Internet haben,
    z.B. "uber einen \fli-Router.

    G"ultige Werte: IP Adresse

    Standardeinstellung: \texttt{IP\_DEFAULT\_GATEWAY='192.168.6.1'}
}


\config{IP\_ROUTE\_N}
{IP\_ROUTE\_N}
{IPROUTEN}
{
    Anzahl von zus"atzlichen Netzwerkrouten. Zus"atzliche Netzwerkrouten
    sind zum Beispiel dann erforderlich, wenn sich im LAN weitere Router
    befinden, "uber die andere Netzwerke erreichbar sein sollen.

    Im Normalfall ist die Angabe von weiteren Netzwerkrouten nicht
    erforderlich, daher ist die

    G"ultige Werte: Zahl

    Standardeinstellung: \texttt{IP\_ROUTE\_N='0'}
}


\config{IP\_ROUTE\_x}
{IP\_ROUTE\_x}
{IPROUTEx}
{
    Die zus"atzlichen Routen \texttt{IP\_ROUTE\_1, IP\_ROUTE\_2,}
    \dots haben folgenden Aufbau:

        network netmask gateway

    Ist z.B. das Netzwerk 192.168.7.0 mit der Netzwerkmaske 255.255.255.0
    "uber das Gateway 192.168.6.99 erreichbar, ist anzugeben:

        IP\_ROUTE\_1='192.168.7.0 255.255.255.0 192.168.6.99'
}


\config{DOMAIN\_NAME}
{DOMAIN\_NAME}
{DOMAINNAME}
{
    Hier sollte man die Domain einsetzen, die lokal im LAN verwendet
    wird (z.B. im DNS-Server eines \fli-Routers eingestellt ist).

    G"ultige Werte: Lan Name

    Standardeinstellung: \texttt{DOMAIN\_NAME='lan.home'}
}


\config{DNS\_SERVER}
{DNS\_SERVER}
{DNSSERVER}
{
    Hier muss die IP-Adresse des DNS-Servers eingetragen werden.
    Verwendet man einen \fli-Router als Gateway, sollte man diesen
    auch als DNS-Server eintragen.

    G"ultige Werte: IP Adresse

    Standardeinstellung: \texttt{DNS\_SERVER='192.168.6.1'}
}



\config{MODULE\_N}
{MODULE\_N}
{MODULEN}
{
    Diese Variable beschreibt die Anzahl der zus"atzlichen Kernel-Module,
    die beim Systemstart geladen werden sollen.

    G"ultige Werte: Zahl

    Standardeinstellung: \texttt{MODULE\_N='0'}
}


\config{MODULE\_x\_NAME}
{MODULE\_x\_NAME}
{MODULExNAME}
{
    Dies ist der Name des x.ten zus"atzlich Kernel-Moduls, welches beim
    Systemstart geladen werden soll.

    G"ultige Werte: Name des Kernel Moduls

    Standardeinstellung: \texttt{MODULE\_x\_NAME='{}'}
}


\config{MODULE\_x\_ACTIVE}
{MODULE\_x\_ACTIVE}
{MODULExACTIVE}
{
    "Uber diesen Parameter wird eingestellt, ob der Datensatz aktiv
    sein soll.

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{MODULE\_x\_ACTIVE='no'}
}


\config{MODULE\_x\_ACTION}
{MODULE\_x\_ACTION}
{MODULExACTION}
{
    \begin{itemize}
        \item option \\
            "Uber diesen Parameter k"onnen auf Wunsch zus"atzliche Optionen
            an das "uber den Parameter \texttt{MODULE\_x\_NAME}
            festgelegte Kernelmodul "ubergeben werden, welche dann beim
            Laden ber"ucksichtigt werden.

        \item blacklist \\
            "Uber diesen Parameter kann auf Wunsch der Name eines
            Kernelmoduls angegeben werden welches bei der automatischen
            Erkennung eines Ger"ates unber"ucksichtigt bleiben und nicht
            geladen werden soll. Dies kann dann erforderlich sein, wenn
            f"ur ein Ger"at mehr als nur ein Kernelmodul existiert und man
            sicher stellen m"ochte, dass das richtige Modul zum Einsatz kommt.

         \item forcedstart \\
            "Uber diesen Parameter kann ein Kernelmodul festgelegt werden,
            welches direkt beim Start, ohne Ber"ucksichtigung der
            automatischen Modulerkennung, geladen werden soll. Auf diese
            Weise kann man eventuellen Modulerkennungsproblemen vorbeugen.
     \end{itemize}

    G"ultige Werte: option, blacklist, forcedstart

    Standardeinstellung: \texttt{MODULE\_x\_ACTION='option'}
}


\config{MODULE\_x\_STRING}
{MODULE\_x\_STRING}
{MODULExSTRING}
{
    Sollte das Module zus"atzliche Parameter ben"otigen, so k"onnen
    diese hier eingetragen werden.

    G"ultige Werte: Modulspezifisch

    Standardeinstellung: \texttt{MODULE\_x\_STRING='{}'}
}


\end{description}
