%
% nfsclient.tex
% Last Update: $Id$
%
%%%%%%%%%%%%%%%%%%%%%%%%%%% Kapitel Nfsclient %%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% Achtung: Dateien muessen mit latin1-Encoding gespeichert werden!
% Attention: Files must be saved using latin1 encoding!
%

\chapter{Das NFSclient-Paket}

\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 Version 3 Protokoll.


\section{Die Funktionen}

    Das NFSclient-Paket besteht aus folgender Komponente:

    \begin{itemize}
        \item NFS-Utils - stellt die NFS-Dienstprogramme zur Verf"ugung.\\
        (\url{http://nfs.sourceforge.net/})
    \end{itemize}


\section{Die Voraussetzungen}

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


\section{Die Installation}

    Das NFSclient-Paket wird "uber das Setup-Men"u installiert. Wird eine
    "altere Paketversion vorgefunden, so wird diese deinstalliert bevor
    die neuen Programmdateien installiert werden. Nach dem Installieren
    der Programmdateien wird direkt der Konfigurations-Editor gestartet
    um die Konfiguration anzupassen. Nach Beendigung dieses Schrittes
    werden die Konfigurationsdateien generiert und alle ben"otigten
    Programme gestartet.


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

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

    \begin{itemize}
        \item NFSclient administration
        \begin{itemize}
            \item View documentation: Anzeigen der Dokumentation
            \item Edit configuration: Bearbeiten der Konfiguration
            \item Advanced configuration file handling: Konfigurationen verwalten
            \item Show Status: Status des NFS-Client anzeigen
            \item Stop NFS client: NFS-Client beenden
            \item Start NFS client: NFS-Client starten
            \item Show list of active NFS client mounts: Aktive NFS-Mounts anzeigen
            \item Return: Untermen"u verlassen
        \end{itemize}
    \end{itemize}

    Die Men"upunkte d"urften selbsterkl"arend sein, da sie keinerlei weitere
    Eingaben erwarten. Aus diesem Grund wird auf deren Funktion nicht weiter
    eingegangen.


\section{Die "Anderung der Konfiguration}

    Die Konfiguration kann "uber den Men"upunkt 'Edit configuration'
    ge"andert werden. Standardm"a"sig wird der Editor aufgerufen, der in der
    Environment-Konfiguration "uber die Variable 'EDITOR' festgelegt wurde.
    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, welche "uber das Men"u zug"anglich ist, sind
    folgende Parameter vorhanden; wer sie von Hand editieren will findet
    sie unter /etc/config.d/nfsclient.


\section{Die Parameter}

\begin{description}
%%  JED - show this description only in the help file
 %  \config{NFSCLIENT\_DO\_DEBUG}{NFSCLIENT\_DO\_DEBUG}{NFSCLIENTDODEBUG}
 %      Optionaler Parameter: Um den Debug-Modus zu aktivieren muss diese
 %      Variable lediglich auf den Wert `yes' gestellt werden. Die Einstellung
 %      `no' deaktiviert den Debug-Modus.
 %
 %      G"ultige Werte: yes, no
 %
 %      Standardeinstellung: \texttt{NFSCLIENT\_DO\_DEBUG='no'}

    \config{START\_NFSCLIENT}{START\_NFSCLIENT}{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\_NFSCLIENT='no'}

    \config{NFSCLIENT\_PRELOAD\_DAEMONS (Optionaler Parameter)}{NFSCLIENT\_PRELOAD\_DAEMONS}{NFSCLIENTPRELOADDAEMONS}
        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{NFSCLIENT\_MOUNT\_N}{NFSCLIENT\_MOUNT\_N}{NFSCLIENTMOUNTN}
        "Uber diesen Parameter wird die Anzahl der entfernten
        Verzeichnisse angegeben, auf welche zugegriffen werden soll.

        G"ultige Werte: Zahl

        Standardeinstellung: \texttt{NFSCLIENT\_MOUNT\_N='0'}

    \config{NFSCLIENT\_MOUNT\_x\_ACTIVE}{NFSCLIENT\_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{NFSCLIENT\_MOUNT\_1\_ACTIVE='no'}

     \config{NFSCLIENT\_MOUNT\_x\_HOST}{NFSCLIENT\_MOUNT\_x\_HOST}{NFSCLIENTMOUNTxHOST}
        "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{NFSCLIENT\_MOUNT\_1\_HOST='host.lan.eis'}

    \config{NFSCLIENT\_MOUNT\_x\_TYPE}{NFSCLIENT\_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{NFSCLIENT\_MOUNT\_x\_TYPE='nfs'}

    \config{NFSCLIENT\_MOUNT\_x\_MOUNTPOINT}{NFSCLIENT\_MOUNT\_x\_MOUNTPOINT}{NFSCLIENTMOUNTxMOUNTPOINT}
        "Uber diesen Parameter wird der Name des entfernten,
        freigegebenen Verzeichnisses angegeben auf welches zugegriffen
        werden soll.\\
        \hinweis{Auch bei einem NFS4-Mount muss dem Freigabenamen ein
            f"uhrender '/' voran gestellt werden!}

        G"ultige Werte: Absoluter Verzeichnispfad

        Beispiel: \texttt{NFSCLIENT\_MOUNT\_1\_MOUNTPOINT='/home'}

    \config{NFSCLIENT\_MOUNT\_x\_DIRECTORY}{NFSCLIENT\_MOUNT\_x\_DIRECTORY}{NFSCLIENTMOUNTxDIRECTORY}
        "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{NFSCLIENT\_MOUNT\_1\_DIRECTORY='/nfs'}

    \config{NFSCLIENT\_MOUNT\_x\_OPTION}{NFSCLIENT\_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{NFSCLIENT\_MOUNT\_1\_OPTION=$''$}
\end{description}
