%
% mini_httpd_unimount.tex
% Last Update: $Id$
%
%%%%%%%%%%%%%%%%%%%%% Kapitel Mini_httpd_unimount %%%%%%%%%%%%%%%%%%%%%%%%%

\chapter{Das Mini\_HTTPD\_Unimount-Paket}

    Mit dem Universal Mounter lassen sich "uber die Mini\_HTTPD-Oberfl"ache
    auf einfache Weise Laufwerke mounten bzw. unmounten.
    Auf Wunsch kann das Paket eventuell ben"otigte USB-Treiber vorab laden.
    Hierzu ist es unter Umst"anden n"otig das Skript do\_usb.sh, welches
    sich im Verzeichnis /usr/local/htdocs/unimount befindet, den eigenen
    Bed"urfnissen anzupassen. Es wurde bis dato noch nicht entschieden, ob
    diese Funktion zuk"unftig eine "Uberarbeitung erf"ahrt oder ersatzlos
    gestrichen wird.

    \hinweis{Normalerweise sollten ben"otigte USB-Treiber "uber den Men"upunkt
    `setup -> System administration -> USB administration' geladen werden.}


\section{Die Installation}

    Das 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 Mini\_HTTPD-Modulmen"u im Setup-Programm ist wie folgt aufgebaut:

    \begin{itemize}
        \item ...
        \item Goto modules: Zum Modulmen"u verzweigen
        \begin{itemize}
            \item ...
            \item Unimount - Universal Mounter
            \begin{itemize}
                \item View documentation: Anzeigen der Dokumentation
                \item Edit configuration: Bearbeiten der Konfiguration
                \item Advanced configuration file handling: Konfigurationen verwalten
                \item View log file: Logdatei anzeigen
                \item Exit: Untermen"u verlassen
            \end{itemize}
        \end{itemize}
        \item ...
        \item Exit: Untermen"u verlassen
    \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 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/mini\_httpd\_unimount}.


\section{Die Parameter}

\begin{description}
    \config{START\_UNIMOUNT}{START\_UNIMOUNT}{STARTUNIMOUNT}
        Wird der Wert dieses Parameters auf `yes' gesetzt, so wird das
        Mini\_HTTPD\_Unimount-Paket aktiviert, der Wert `no' deaktiviert es.

        G"ultige Werte: yes, no

        Standardwert: \texttt{START\_UNIMOUNT='no'}

    \config{UNIMOUNT\_INFO}{UNIMOUNT\_INFO}{UNIMOUNTINFO}
        Wird der Wert dieses Parameters auf `yes' gesetzt, so wird eine Liste
        aller gemounteter Laufwerke angezeigt, der Wert `no' verhindert die
        Anzeige der gemounteten Laufwerke.

        G"ultige Werte: yes, no

        Standardwert: \texttt{UNIMOUNT\_INFO='yes'}

    \config{UNIMOUNT\_USB}{UNIMOUNT\_USB}{UNIMOUNTUSB}
        Wird der Wert dieses Parameters auf `yes' gesetzt, so werden eventuell
        ben"otigte USB-Treiber beim Start geladen, der Wert `no' verhindert das
        Laden von USB-Treibern durch das Unimount-Paket.

        \hinweis{Normalerweise sollten ben"otigte USB-Treiber "uber den Men"upunkt
        `setup -> System administration -> USB administration' geladen werden.}

        G"ultige Werte: yes, no

        Standardwert: \texttt{UNIMOUNT\_INFO='no'}

    \config{UNIMOUNT\_N}{UNIMOUNT\_N}{UNIMOUNTN}
        "Uber diesen Parameter wird die Anzahl der zu mountenden Laufwerke angegeben,
        die von Unimount ber"ucksichtigt werden sollen.

        G"ultige Werte: Zahl

        Beispiel: \texttt{UNIMOUNT\_N='3'}

    \config{UNIMOUNT\_x\_ACTIVE}{UNIMOUNT\_x\_ACTIVE}{UNIMOUNTxACTIVE}
        Wird der Wert dieses Parameters auf `yes' gesetzt, so wird der entsprechende
        Datensatz aktiviert, der Wert `no' deaktiviert ihn.

        G"ultige Werte: yes, no

        Standardwert: \texttt{UNIMOUNT\_1\_ACTIVE='no'}

    \config{UNIMOUNT\_x\_NAME}{UNIMOUNT\_x\_NAME}{UNIMOUNTxNAME}
        "Uber diesen Parameter legt man einen Namen fest welcher die Identifikation
        des Datensatzes erleichtert. Dieser Eintrag dient einzig der Anzeige und wird
        sonst nicht ausgewertet.

        G"ultige Werte: Text

        Beispiel: \texttt{UNIMOUNT\_1\_NAME='Home-Verzeichnis'}

    \config{UNIMOUNT\_x\_DEVICE}{UNIMOUNT\_x\_DEVICE}{UNIMOUNTxDEVICE}
        "Uber diesen Parameter legt man das Laufwerk bzw. Ger"at fest, welches
        gemountet werden soll.

        G"ultige Werte: Ger"atename

        Beispiel: \texttt{UNIMOUNT\_1\_DEVICE='/dev/sdb2'}

    \config{UNIMOUNT\_x\_POINT}{UNIMOUNT\_x\_POINT}{UNIMOUNTxPOINT}
        "Uber diesen Parameter legt man den Mountpoint fest "uber welchen auf das
        Laufwerk bzw. Ger"at zugegriffen werden soll.

        G"ultige Werte: existierender Mountpoint

        Beispiel: \texttt{UNIMOUNT\_1\_POINT='/mnt/mp-home'}

    \config{UNIMOUNT\_x\_OPTION}{UNIMOUNT\_x\_OPTION}{UNIMOUNTxOPTION}
        Optionaler Parameter: "Uber diesen Parameter k"onnen bei Bedarf zus"atzlich
        ben"otigte Mount-Optionen angegeben werden.

        G"ultige Werte: g"ultige Mount-Option

        Beispiel:\\
        \texttt{UNIMOUNT\_1\_OPTION='-o loop'\\
                UNIMOUNT\_1\_OPTION='ro'\\
                UNIMOUNT\_1\_OPTION='rw'\\
                UNIMOUNT\_1\_OPTION='???'}

    \config{UNIMOUNT\_x\_USER}{UNIMOUNT\_x\_USER}{UNIMOUNTxUSER}
        Optionaler Parameter: "Uber diesen Parameter kann bei Bedarf ein vom Benutzer
        `root' abweichender Anwendername angegeben werden mit welchem der Mount-Befehl
        ausgef"uhrt werden soll. Wird dieser Wert nicht gesetzt, so wird standardm"a"sig
        der Benutzer `root' verwendet.

        G"ultige Werte: g"ultiger Benutzer

        Beispiel: \texttt{UNIMOUNT\_1\_USER='nobody'}

    \config{UNIMOUNT\_x\_GROUP}{UNIMOUNT\_x\_GROUP}{UNIMOUNTxGROUP}
        Optionaler Parameter: "Uber diesen Parameter kann bei Bedarf eine von der
        Benutzergruppe `root' abweichender Gruppenname angegeben werden mit welchem
        der Mount-Befehl ausgef"uhrt werden soll. Wird dieser Wert nicht gesetzt, so
        wird standardm"a"sig die Benutzergruppe `root' verwendet.

        G"ultige Werte: g"ultige Benutzergruppe

        Beispiel: \texttt{UNIMOUNT\_1\_GROUP='nogroup'}

    \config{UNIMOUNT\_x\_TYPE}{UNIMOUNT\_x\_TYPE}{UNIMOUNTxTYPE}
        Optionaler Parameter: "Uber diesen Parameter kann bei Bedarf der Typ des
        Dateisystems angegeben werden welches gemountet werden soll. Wird dieser
        Parameter nicht gesetzt, so wird versucht den Dateisystemtyp automatisch
        zu ermitteln.

        G"ultige Werte: Name eines Dateisystem

        Beispiel: \texttt{UNIMOUNT\_1\_TYPE='ext3'}

    \config{UNIMOUNT\_x\_AUTH\_USER}{UNIMOUNT\_x\_AUTH\_USER}{UNIMOUNTxAUTHUSER}
        Optionaler Parameter: "Uber diesen Parameter kann bei Bedarf der Anmeldename
        angegeben werden, der z.B. beim Mounten einer SMB-Freigabe verwendet werden
        soll.

        G"ultige Werte: Anmeldename

        Beispiel: \texttt{UNIMOUNT\_1\_AUTH\_USER='frank'}

    \config{UNIMOUNT\_x\_AUTH\_PASS}{UNIMOUNT\_x\_AUTH\_PASS}{UNIMOUNTxAUTHPASS}
        Optionaler Parameter: "Uber diesen Parameter kann bei Bedarf das Kennwort
        angegeben werden, welches z.B. beim Mounten einer SMB-Freigabe verwendet
        werden soll.

        G"ultige Werte: g"ultiges Kennwort

        Beispiel: \texttt{UNIMOUNT\_1\_AUTH\_PASS='geheim'}
\end{description}

\section{Verschiedenes}

\begin{description}
    \config{Auf\ eine\ SMB-Laufwerksfreigabe\ zugreifen}{Auf\ eine\ SMB-Laufwerksfreigabe\ zugreifen}{AufeineSMB-Laufwerksfreigabezugreifen}
        Will man auf eine SMB-Laufwerksfreigabe zugreifen, so sollte die Konfiguration
        etwa wie folgt aussehen:

        \begin{verbatim}
UNIMOUNT_5_ACTIVE='yes'             # Datensatz aktiviert
UNIMOUNT_5_NAME='VOL1'              # Beschreibender Name
UNIMOUNT_5_DEVICE='//server/daten'  # //Servername/Freigabename
UNIMOUNT_5_POINT='/vol1'            # Mountpoint fuer den Zugriff
UNIMOUNT_5_OPTION='???'             # durch die Netzfreigabe bestimmt
UNIMOUNT_5_USER='nobody'            # alternativer Anwender zu 'root'
UNIMOUNT_5_GROUP='nogroup'          # alternative Gruppe zu 'root'
UNIMOUNT_5_TYPE='smbfs'             # Dateisystemtyp: smbfs Volume
UNIMOUNT_5_AUTH_USER='Admin'        # Anmeldename fuer Serverzugriff
UNIMOUNT_5_AUTH_PASS='pluto'        # Kennwort fuer Serverzugriff
        \end{verbatim}
\end{description}
