%
% dhcpd_pxe.tex
% Last Update: $Id$
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%% Kapitel DHCPD_PXE %%%%%%%%%%%%%%%%%%%%%%%%%%%%%

\chapter{DHCP Server Plugin: PXELINUX}
\index{DHCPD\_PXE}

\section{Copyrights}

    Die in diesem Paket enthaltene Bestandteile des Syslinux Projekts
    unterliegen der
    \link{http://www.gnu.org/licenses/gpl-2.0.html}{GNU General Public License}
    Version 2 oder aktueller.


\section{Einleitung}

    Dieses Paket enth"alt die PXELINUX Tools des
    \link{https://wiki.syslinux.org/wiki/index.php?title=PXELINUX}{Syslinux Projekts}

    PXELINUX wird in Verbindung mit einem PXE-konformen Festwertspeicher
    (ROM) auf einer Netzwerkkarte eingesetzt. Das Preboot Execution
    Environment nutzt DHCP oder BOOTP, um Netzwerkbetrieb mit TCP/IP
    aufzunehmen, und l"adt dann mittels TFTP die Boot-Software herunter,
    welche einen Kernel l"adt und entsprechend ebenfalls vom TFTP-Server
    heruntergeladenen Anweisungen konfiguriert. [Quelle: Wikipedia]



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

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

    \mbox{}

    \begin{tabular}{llll}
    & 4. &  Service administration \\
    \end{tabular}
\eline
    \begin{tabular}{p{1cm}llll}
    & x. &  DHCP Server  \\
    \end{tabular}
\eline
    \begin{tabular}{p{2cm}llll}
    & x. &  DHCP Server Plugins \\
    \end{tabular}
\eline
    \begin{tabular}{p{3cm}ll}
    & x. & Server PXE configuration \\
    \end{tabular}
\eline
    \begin{tabular}{p{4cm}ll}
    & 1. & View documentation \\
    & 2. & Edit configuration \\
    & 3. & Advanced configuration file handling \\
    \end{tabular}

    \mbox{}


\section{Die "Anderung der Konfiguration}

    Die Konfiguration kann "uber den Men"upunkt 'Edit configuration'
    ge"andert werden.

    Nachdem der Editor beendet wurde, wird abgefragt, ob die Konfiguration
    aktiviert werden soll. Wird dies best"atigt, so werden "uber ein Skript
    die Anpassungen umgehend wirksam gemacht.


\section{Die Konfigurationsdatei}

    In der Konfigurationsdatei, die "uber das Men"u zug"anglich ist, sind
    folgende Parameter vorhanden; wer sie von Hand editieren will, findet sie
    unter\\
    \texttt{/etc/config.d/dhcpd\_pxe}


\section{Die Parameter}


\begin{description}

\config{DHCPD\_PXE\_N}
{DHCPD\_PXE\_N}
{DHCPDPXEN}
{
    Hier wird die Anzahl der Eintr"age im PXE-Bootmen"u angegeben.
    Das PXE-Bootmen"u wird f"ur alle Clients mit dynamischen IP-Adressen
    sowie f"ur die Clients mit statischen IP-Adressen, bei denen PXE
    aktiviert wurde, aber keine individuellen PXE-Startparameter
    angegeben wurden, verwendet.

    Standardeinstellung: \texttt{DHCPD\_PXE\_N='1'}
}


\config{DHCPD\_PXE\_x\_NAME}
{DHCPD\_PXE\_x\_NAME}
{DHCPDPXExNAME}
{
    Hier wird der Name der PXE Konfiguration angegeben.

    Beispiel: \texttt{DHCPD\_PXE\_x\_NAME='fli4l'}
}


\config{DHCPD\_PXE\_x\_ACTIVE}
{DHCPD\_PXE\_x\_ACTIVE}
{DHCPDPXExACTIVE}
{
    Hier kann eine PXE-Konfiguration deaktiviert ('no') werden.
    Um eine Konfiguration zu verwenden, muss diese Variable auf 'yes'
    gesetzt werden.

    G"ultige Werte: yes,no

    Standardeinstellung: \texttt{DHCPD\_PXE\_x\_ACTIVE='no'}
}


\config{DHCPD\_PXE\_x\_DESCRIPTION}
{DHCPD\_PXE\_x\_DESCRIPTION}
{DHCPDPXExDESCRIPTION}
{
    Hier wird der beschreibende Text f"ur die Anzeige im PXE-Bootmen"u
    eingegeben.

    Beispiel: \texttt{DHCPD\_PXE\_x\_DESCRIPTION='eisfair server'}
}


\config{DHCPD\_PXE\_x\_KERNEL}
{DHCPD\_PXE\_x\_KERNEL}
{DHCPDPXExKERNEL}
{
    Hier wird der f"ur PXE zu verwendende Kernel angegeben.

    Hier wird der Pfad des Kernel relativ zum Verzeichnis \texttt{/srv/tftpboot}
    angegeben. Zur "Ubertragung des Kernel wird pxelinux verwendet, die
    Konfiguration von pxelinux wird automatisch erstellt.

    Um von der lokalen Festplatte oder Diskette zu booten, muss diese
    Option leer gelassen werden.

    Um ein Image mittels memdisk booten zu k"onnen, muss diese Option
    ebenfalls leer gelassen werden.

    Beispiel: \texttt{DHCPD\_PXE\_x\_KERNEL='fli4l/kernel'}
}


\config{DHCPD\_PXE\_x\_INITRD}
{DHCPD\_PXE\_x\_INITRD}
{DHCPDPXExINITRD}
{
    Hier wird der Name der zu DHCPD\_PXE\_x\_KERNEL geh"origen
    initrd angegeben. Hier muss der Pfad relativ zu \texttt{/srv/tftpboot}
    angegeben werden.

    Um von der lokalen Festplatte oder Diskette zu booten, muss diese
    Option leer gelassen werden.

    Um ein Image mittels memdisk zu booten, muss hier der Pfad des
    Images relativ zu \texttt{/srv/tftpboot} angegeben werden.

    Beispiel: \texttt{DHCPD\_PXE\_x\_INITRD='fli4l/rootfs.img'}
}


\config{DHCPD\_PXE\_x\_ROOTFS}
{DHCPD\_PXE\_x\_ROOTFS}
{DHCPDPXExROOTFS}
{
    Hier wird der Name des zu DHCPD\_PXE\_x\_KERNEL geh"origen
    rootfs angegeben.

    Beispiel: \texttt{DHCPD\_PXE\_x\_ROOTFS='/dev/tmpfs'}
}


\config{DHCPD\_PXE\_x\_APPEND}
{DHCPD\_PXE\_x\_APPEND}
{DHCPDPXExAPPEND}
{
    Diese Option dient zur Angabe weiterer Optionen bei der Verwendung
    von pxelinux.

    Beispiel: \texttt{DHCPD\_PXE\_x\_APPEND='vag=normal ramdisk\_size=28000'}

    Standardeinstellung: \texttt{DHCPD\_PXE\_x\_APPEND=' '}
}
\end{description}
