%
% nfs-client.tex
% Last Update: $Id$
%
%%%%%%%%%%%%%%%%%%%%%%%%%%% Kapitel NFS-client %%%%%%%%%%%%%%%%%%%%%%%%%%%%%

\chapter{Das NFS-Client-Paket}
\index{nfs-client}

\section{Die Einleitung}

    Dieser Paket erm"oglicht es auf freigegebene Verzeichnisse, die auf
    anderen Rechnern freigegeben wurden, zuzugreifen. Verwendung findet
    hierbei das Network File System Protokoll.


\section{Die Funktionen}

    Das NFS-Client-Paket besteht aus folgender Komponente:

    \begin{itemize}
        \item \link{https://kernel.org/pub/linux/utils/nfs-utils}{NFS-Utils}
        - stellt die NFS-Dienstprogramme zur Verf"ugung.\\
    \end{itemize}


\section{Die Voraussetzungen}

    Ein lauff"ahiger \eisfair-Server ;-$)$


\section{Die Installation}

    Das NFS-Client-Paket wird "uber das Setup-Men"u installiert. Wird eine
    "altere Paketversion vorgefunden, so wird diese deinstalliert bevor
    die neuen Programmdateien installiert werden.


\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}
    & x. & Network administration
    \end{tabular}
\eline
    \begin{tabular}{p{2cm}llll}
    & x. & NFS-Client Service
    \end{tabular}
\eline
    \begin{tabular}{p{3cm}llll}
    & 1. &  View documentation \\
    & 2. &  Edit configuration \\
    & 3. &  Advanced configuration file handling \\
    & 4. &  Show status \\
    & 5. &  Stop service \\
    & 6. &  Start service \\
    & 7. &  Show list of active NFS client mounts \\
    & 8. &  Mount NFS client mounts \\
    & 9. &  Unmount NFS client mounts \\
    \end{tabular}

    \mbox{}


\section{Die "Anderung der Konfiguration}

    Die Konfiguration kann "uber den Men"upunkt \glqq{}Edit configuration
    \grqq{}
    ge"andert werden.
    Nachdem der Editor beendet wurde wird abgefragt, ob die Konfiguration
    aktiviert werden soll. Wird dies best"atigt, werden "uber ein Skript die
    modifizierten "Anderungen 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/nfs-client}


\section{Die Parameter}

\begin{description}

\config{START\_NFS\_CLIENT}
{START\_NFS\_CLIENT}
{STARTNFSCLIENT}
{
    F"ur die Aktivierung des NFS-Client muss dieser Parameter lediglich
    auf den Wert 'yes' gestellt werden. Die Einstellung 'no' deaktiviert
    den NFS-Client.

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{START\_NFS\_CLIENT='no'}
}


\config{NFS\_CLIENT\_SYSTEM\_MOUNT}
{NFS\_CLIENT\_SYSTEM\_MOUNT}
{NFSCLIENTSYSTEMMOUNT}
{
    Wird dieser Parameter auf den Wert 'yes' gesetzt, so werden die
    NFS-Treiber beim erstmaligen Start geladen und nicht mehr bei
    jeder Konfigurations"anderung beendet und neu gestartet.\\
    Dies verhindert Fehlermeldungen bei NFS-Laufwerksverbindungen
    welche "uber die fstab-Datei konfiguriert wurden.

    G"ultige Werte: yes, no

    Beispiel: \texttt{NFSCLIENT\_PRELOAD\_DAEMONS='yes'}
}


\config{NFS\_CLIENT\_MOUNT\_N}
{NFS\_CLIENT\_MOUNT\_N}
{NFSCLIENTMOUNTN}
{
    "Uber diesen Parameter wird die Anzahl der entfernten
    Verzeichnisse angegeben, auf welche zugegriffen werden soll.

    G"ultige Werte: Zahl

    Standardeinstellung: \texttt{NFS\_CLIENT\_MOUNT\_N='0'}
}


\config{NFS\_CLIENT\_MOUNT\_x\_NAME}
{NFS\_CLIENT\_MOUNT\_x\_NAME}
{NFSCLIENTMOUNTxNAME}
{
    An dieser Stelle kann eine Beschreibung hinterlegt werden,
    z. B. welcher Host oder irgend etwas anderes.
    NFS-Client wertet diesen Parameter nicht aus.

    G"ultige Werte: alles

    Standardeinstellung: \texttt{NFS\_CLIENT\_MOUNT\_x\_NAME='{}'}
}


\config{NFS\_CLIENT\_MOUNT\_x\_ACTIVE}
{NFS\_CLIENT\_MOUNT\_x\_ACTIVE}
{NFSCLIENTMOUNTxACTIVE}
{
    Wird dieser Parameter auf den Wert 'yes' gesetzt, so wird
    der Zugriff auf das entfernte Verzeichnis aktiviert, 'no'
    deaktiviert den Zugriff.

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{NFS\_CLIENT\_MOUNT\_x\_ACTIVE='no'}
}


\config{NFS\_CLIENT\_MOUNT\_x\_REMOTE\_HOST}
{NFS\_CLIENT\_MOUNT\_x\_REMOTE\_HOST}
{NFSCLIENTMOUNTxREMOTEHOST}
{
    "Uber diesen Parameter wird die IP-Adresse oder der Rechnername
    angegeben, auf dessen freigegebenes Verzeichnis zugegriffen
    werden soll.

    G"ultige Werte: IP-Adresse oder Hostname

    Beispiel: \texttt{NFS\_CLIENT\_MOUNT\_x\_REMOTE\_HOST='host.lan.eis'}
}


\config{NFS\_CLIENT\_MOUNT\_x\_REMOTE\_DIRECTORY}{NFS\_CLIENT\_MOUNT\_x\_REMOTE\_DIRECTORY}
{NFSCLIENTMOUNTxREMOTEDIRECTORY}
{
    "Uber diesen Parameter wird der Name des entfernten,
    freigegebenen Verzeichnisses angegeben auf welches zugegriffen
    werden soll.\\

    \hinweis{Bei einem NFS4-Mount darf nur der Freigabenamen mit einem
            f"uhrenden '/' benutzt werden oder f"ur die NFS-Root ein
            einzelner '/', es darf nicht der ganze Pfad mit dem
            NFS-BASE-SHARE angegben werden, da"s f"uhrt dann zu einem
            ERORR!}

    G"ultige Werte: Absoluter Verzeichnispfad

    Beispiel: \texttt{NFS\_CLIENT\_MOUNT\_x\_REMOTE\_DIRECTORY='/home'}
}


\config{NFS\_CLIENT\_MOUNT\_x\_TYPE}
{NFS\_CLIENT\_MOUNT\_x\_TYPE}
{NFSCLIENTMOUNTxTYPE}
{
    "Uber diesen Parameter wird der NFS-Typ angegeben, der f"ur den
    Verzeichniszugriff verwendet werden soll.

    G"ultige Werte: nfs oder nfs4

    Standardeinstellung: \texttt{NFS\_CLIENT\_MOUNT\_x\_TYPE='nfs'}
}


\config{NFS\_CLIENT\_MOUNT\_x\_LOCAL\_DIRECTORY}
{NFS\_CLIENT\_MOUNT\_x\_LOCAL\_DIRECTORY}
{NFSCLIENTMOUNTxLOCALDIRECTORY}
{
    "Uber diesen Parameter wird das lokale Verzeichnis angegeben
    "uber welches zuk"unftig auf das entfernte, freigegebene
    Verzeichnis zugegriffen werden soll. Falls dieses Verzeichnis
    nicht existiert, so wird es angelegt.

    G"ultige Werte: Absoluter Verzeichnispfad

    Beispiel: \texttt{NFS\_CLIENT\_MOUNT\_x\_LOCAL\_DIRECTORY='/nfs'}
}


\config{NFS\_CLIENT\_MOUNT\_x\_OPTION}
{NFS\_CLIENT\_MOUNT\_x\_OPTION}
{NFSCLIENTMOUNTxOPTION}
{
    "Uber diesen Parameter k"onnen zus"atzliche Optionen angegeben
    werden, die beim Verbinden mit dem entfernten Verzeichnis
    angewendet werden sollen. Wird z.B. 'ro' angegeben so wird
    nur ein 'read-only'-Zugriff auf die Resource erlaubt.

    G"ultige Werte: Mount-Optionen

    Standardeinstellung: \texttt{NFS\_CLIENT\_MOUNT\_x\_OPTION='{}'}
}

\end{description}
