%
% samba.tex
% Last Update: $Id$
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%% Kapitel Samba %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\chapter{Das Samba-Paket}

Dokumentation des Samba-Paketes f"ur eisfair von Thomas Bork
(E-MAIL \kmail{tom@eisfair.net}), zusammengestellt mit Hilfe von Ralf Koester
(E-MAIL \kmail{ralf@familie-koester.de}). Die Dokumentation zu smbwebclient stammt von
Marcus Hochhuth (E-MAIL \kmail{marcus.hochhuth@web.de}), die Dokumentation zu
SAMBA\_PRINTER\_x\_PDF\_PERMS von Jan Mader (E-MAIL \kmail{jan.mader@jan-mader.de})
und die Dokumentation zu DFS von Raphael Gradenwitz (E-MAIL \kmail{raphael@gradenwitz.ath.cx}).


Version 9.2.0 (stable)


\section{Copyrights/Paket-Ersteller}
%=============================

Samba ist ein OpenSource-Projekt und unterliegt der GNU General Public
Licence. Die Heimat von Samba im WWW ist

    \url{http://www.samba.org}

Wer deutsche Dokumentationen bevorzugt, wird vielleicht bei

    \url{http://www.samba.sernet.de}

f"undig.

F"ur eisfair habe ich Teile von Samba als Paket implementiert. Aus
dem rechtlichen Status von Samba leitet sich der rechtliche Status
der Implementierung her:

Samba steht unter der GPL.

Ich gebe weder eine Garantie auf die Funktionsf"ahigkeit des Samba-Paketes,
noch hafte ich f"ur Sch"aden, z.B. Datenverlust, die durch den Einsatz des
Samba-Paketes entstehen.

Bitte unbedingt lesen:

     \url{http://www.pwr.ch/produkte/linux/gpl-ger.html}


\section{Einsatzgebiet}
%================
\subsection{Was ist Samba?}
%------------------

Samba im Allgemeinen ist die Implementierung eines Server-Message-Block-(SMB-)
Protokoll-Servers, der auf fast jeder existierenden Variante von Unix laufen
kann. Microsoft-Clients k"onnen dieses Protokoll benutzen, um auf Datei- und
Druck-Services zuzugreifen, die sich auf einem lokalen Unix-Rechner befinden,
als w"are dieser ein normaler Windows-Server.

Folgende Funktionen werden dabei konkret geboten:

\begin{itemize}
\item
Samba kann als Freigabe-Server fungieren. Das bedeutet, ein Samba-Server bietet
die Freigaben (Shares) an, die normalerweise ein Windows-Server anbietet. Eine
Freigabe ist ein f"ur bestimmte User freigebenes Verzeichnis mit einem
definierten Freigabenamen auf dem Server. Dieser Dienst entspricht der
Verzeichnis-Freigabe eines normalen Windows-Arbeitsplatzes.

\item
Samba kann auf dem Server installierte Drucker bestimmten Usern zur Verf"ugung
stellen. Damit fungiert der Samba-Server auch als Print-Server in Windows-
Umgebungen. Dieser Dienst entspricht der Drucker-Freigabe eines normalen
Windows-Arbeitsplatzes.
Es k"onnen Druckertreiber auf dem Samba-Server hinterlegt werden, die beim
ersten Zugriff auf einen freigegebenen Drucker automatisch installiert
werden.

\item
Samba kann als WINS-Server dienen. Das bedeutet, dass Samba die Registrierung
der NETBIOS-Namenszuordnungen in einem Windows-Netzwerk "ubernehmen kann.

\item
Samba kann als Primary Domain Controller (PDC) vergleichbar zu einem Windows-
NT-Server eingesetzt werden. Wenn Samba als Dom"anen-Controller arbeitet,
werden Benutzer-Accounts der Dom"ane zentral verwaltet.
Benutzer haben bei Anmeldung an der Dom"ane netzwerkweit Ihr Arbeitsprofil
zur Verf"ugung.

\item
Samba bietet noch einige weitere Dienste in einem Windows-Netz an. Details kann
man auf den oben genannten Internetseiten nachlesen. Zusammengefasst bietet
Samba weitestgehend die Funktionalit"at eines Windows-(NT-4.0-)Servers.

\end{itemize}

\achtung{Samba f"ur eisfair{} beinhaltet nicht alle Bestandteile von Samba,
sondern wurde auf die wichtigsten Bestandteile reduziert!}


\section{Installation, Update und Konfiguration}
%=========================================

\subsection{Installation und Update}
%---------------------------

Das Samba-Paket wird derzeit wie jedes andere Paket "uber das eisfair{}-
Setup-Men"u installiert:

Im Men"u-Punkt

\begin{verbatim}
   Package administration
\end{verbatim}

w"ahlt man

\begin{verbatim}
   Install new package
\end{verbatim}

, dann

\begin{verbatim}
   Printer and File Services
\end{verbatim}

und hier das Paket

\begin{verbatim}
   Samba File Services
\end{verbatim}

"Uber die entsprechende Nummer aus und best"atig mit Enter.
Nachdem man die Infomationsdatei gelesen hat, beantwortet man die Frage

\begin{verbatim}
   Install (y/n)?
\end{verbatim}

mit \glqq{}y\grqq{}. Nach dem Best"atigen mit <Enter> wird unmittelbar der Download
gestartet.

Sollte bereits eine fr"uhere Version installiert sein, so wird Samba
angehalten, einige Sicherungsdateien werden angelegt und die alte Version wird
bis auf f"ur das Update relevante Dateien deinstalliert.
Bei einem Update wird im Rahmen der M"oglichkeiten die alte Konfiguration
"ubernommen, dabei wird auf neue, ge"anderte oder hinzugef"ugte Variablen
speziell hingewiesen.
War Samba noch nicht installiert, wird eine Beispiel-Konfigurationsdatei
erzeugt.

Nach dem Download wird bei Neuinstallationen angeboten, die Konfigurationsdatei
zu editieren. Die Konfigurationsdatei wird vom eingestellten Editor ge"offnet
und ist zum Editieren bereit. F"ur einen ersten Start muss im Abschnitt
\glqq{}General Settings\grqq{} unbedingt der Parameter

\jumplabel{SAMBA\_WORKGROUP}{SAMBAWORKGROUP}='WORKGROUP'

angepasst werden. Hier wird die Arbeitsgruppe von Windows eingetragen. Hat man
diese in seinem Windowsnetzwerk nicht ge"andert, so steht hier bei deutschen
Windows-Versionen \glqq{}Arbeitsgruppe\grqq{} und bei englischen Versionen \glqq{}WORKGROUP\grqq{}.

Nun speichert man die "Anderungen und verl"asst den Editor.

Die Frage \glqq{}Activate Samba configuration now (y/n)?\grqq{} beantwortet man mit \glqq{}y\grqq{} und
<ENTER> und bendet damit die Installation. Jetzt werden einige Warnungen
angezeigt, weil vom Installationsskript vorsichtshalber noch einmal das Skript
zum Beenden von Samba aufgerufen wird. Danach wird das Skript zum Starten von
Samba aufgerufen - hierbei sollten keine Fehler auftauchen.

Bevor man sich das erste Mal am Samba-Server anmelden kann, m"ussen alle User,
die Zugriff haben sollen, als eisfair{}-System-User und als Samba-User angelegt
werden! Siehe dazu

\jumplabel {Samba-User anlegen}{SAMBADDUSER}

weiter unten.
Ein anonymer Zugriff ist ohne manuelle "Anderungen nicht m"oglich.
Wer das Paket so manipuliert, dass ein anonymer Zugriff m"oglich wird, muss
damit rechnen, dass viele Dinge nicht mehr sauber funktionieren. Ich werde
niemandem helfen, der das tut.

Danach kommt der grosse Moment: Wir versuchen uns das erste Mal mit dem
Samba-Server zu verbinden. Dazu wechseln wir z.B. im Windows-Explorer in die
Netzwerkumgebung. Hier sollten wir als Server den Samba-Server mit dem Namen
unseres eisfair{}-Servers sehen. W"ahlen wir diesen an, so sollten wir ein
Verzeichnis mit dem Namen \glqq{}public\grqq{} sehen.

Wie man das Paket auf seine pers"onlichen Bed"urfnisse anpasst, sehen wir im
n"achsten Kapitel - der Beschreibung der Konfiguration.


\marklabel{SAMBACONFIGMENU}{\subsection{Konfiguration "uber das Samba-Service-Men"u}}
%===============================================

Die Konfiguration wird "uber das Samba-Service-Men"u vorgenommen.
Hierhin gelangt man, wenn man sich als User \glqq{}eis\grqq{} an der Konsole anmeldet,
bzw. wenn man sich als User \glqq{}root\grqq{} an der Konsole anmeldet und hinterher
\glqq{}setup\grqq{} eingibt. Weiter geht es mit

\begin{verbatim}
   Service administration
   Samba
\end{verbatim}

Folgende Punkte stehen zur Auswahl:

\begin{verbatim}
   1: Read Samba Documentation

   2: Samba Configuration Handling

   3: Samba User Handling

   4: Samba Server Handling

   5: Samba Domain Handling

   6: SMB Filesystem Handling

   7: Send Message to SMB Hosts

   0: Exit
\end{verbatim}

\paragraph{Samba-Service-Men"u Punkt 1: Read Samba Documentation}
%-----------------------------------------------------------

Um sich vor der Konfiguration erst einmal einen "Uberblick "uber die
M"oglichkeiten des Samba-Paketes zu verschaffen, w"ahlt man

\subparagraph{1: Read Samba Configuration}

Mit diesem Men"u-Punkt wird die hier vorliegende Dokumentation zum Lesen mit
dem vom User konfigurierten Pager ge"offnet.


\paragraph{Samba-Service-Men"u Punkt 2: Samba Configuration Handling}
%---------------------------------------------------------------

Um die grundlegenden Samba-Funktionen zu konfigurieren, w"ahlt man

\subparagraph{2: Samba Configuration Handling}

und hier

\begin{verbatim}
   Edit Samba Configuration
\end{verbatim}

Die auftauchende Frage

\begin{verbatim}
   Since there is no eisfair configuration tool, you must edit the eisfair
   configuration file /etc/config.d/samba with the editor joe.

   You can get help by joe if you press 'Ctrl-K H'.

   Continue (y/n)?
\end{verbatim}

beantwortet man mit \glqq{}y\grqq{}. Damit befindet man sich dann im Editor joe und
editiert damit die Datei

\begin{verbatim}
   /etc/config.d/samba
\end{verbatim}

Die verschiedenen Abschnitte dieser Datei werden im Folgenden beschrieben:


\subparagraph{Abschnitt \glqq{}General Settings\grqq{}:}
%-----------------------------

Der Abschnitt wird eingeleitet mit

\begin{verbatim}
#------------------------------------------------------------------------------
# General Settings
#
# Minimum requirement if SAMBA_MANUAL_CONFIGURATION='no' is to change
# SAMBA_WORKGROUP to workgroup name of your windows clients!
#
#------------------------------------------------------------------------------
\end{verbatim}

und beinhaltet 2 Variablen:

\begin{description}
    \config{START\_SAMBA}{START\_SAMBA}{STARTSAMBA}

        Um Samba bei jedem Neustart automatisch starten zu lassen, muss die
        Variable START\_SAMBA den Wert \glqq{}yes\grqq{} erhalten. Wenn START\_SAMBA='no'
        ist, muss Samba von Hand gestartet werden. Dazu ist im
        eisfair{}-Setup-Men"u

\begin{verbatim}
          Service administration
\end{verbatim}

        auszuw"ahlen, dann

\begin{verbatim}
          Samba
\end{verbatim}

        dann

\begin{verbatim}
          Samba Server Handling
\end{verbatim}

        und hier

\begin{verbatim}
          Start Samba
\end{verbatim}

        oder auf der Befehlszeile

\begin{verbatim}
          /etc/init.d/samba forcestart
\end{verbatim}

        einzugeben.

        Standardeinstellung: \texttt{START\_SAMBA='yes'}


    \config{SAMBA\_WORKGROUP}{SAMBA\_WORKGROUP}{SAMBAWORKGROUP}
        Damit die Freigaben in der unter Windows definierten Arbeitsgruppe
        sichtbar werden (wo diese auf dem Client eingestellt wird, kann man
        in der Dokumentation seines Windows-Systems nachlesen), muss die
        Arbeitsgruppe f"ur Samba mit der unter Windows definierten
        Arbeitsgruppe "ubereinstimmen.
        Wenn also unter Windows die Arbeitsgruppe \glqq{}WORKGROUP\grqq{} heisst,
        muss diese Variable folgendermassen definiert werden:

\begin{verbatim}
          SAMBA_WORKGROUP='WORKGROUP'
\end{verbatim}

        Standardeinstellung: \texttt{SAMBA\_WORKGROUP='WORKGROUP'}

\end{description}


\subparagraph{Abschnitt \glqq{}Samba Manual Configuration\grqq{}:}
%-------------------------------------

Der Abschnitt wird eingeleitet mit

\begin{verbatim}
#------------------------------------------------------------------------------
# Samba Manual or Automatic Configuration
#
# Manual or Automatic Configuration of Shares and Printers
#
#  ********************************* ATTENTION ******************************
#  *                                                                        *
#  *     If you set SAMBA_MANUAL_CONFIGURATION to 'no', the Settings        *
#  *    in the Section 'Samba Advanced Configuration/Samba Shares' and      *
#  *    in the Section 'Samba Advanced Configuration/Samba Printers' and    *
#  *    in the Section 'Samba Advanced Configuration/Samba Mounts'          *
#  *                         don't have an Effect!                          *
#  *                                                                        *
#  ******************************** ATTENTION *******************************
#
# If you set SAMBA_MANUAL_CONFIGURATION='no', following Shares automatically
# created for you:
#
# - a share with your eisfair-username and full access only for you
# - a share 'public' with full access for all eisfair-users
# - an unvisible share 'all' with full access for user root
#   for the whole filesystem
# - shares for your printers in /etc/printcap, if lprng is installed
# - a printer share for eisfax printer, if eisfax is installed
# - a printer share for pdf printing, if ghostscript is installed
#
#------------------------------------------------------------------------------
\end{verbatim}

und beinhaltet nur eine Variable, die es aber in sich hat:

\begin{description}
     \config{SAMBA\_MANUAL\_CONFIGURATION}{SAMBA\_MANUAL\_CONFIGURATION}{SAMBAMANUALCONFIGURATION}
        Um so wenig wie m"oglich falsch zu machen, kann man eine automatische
        Konfiguration von Samba durchf"uhren lassen. Wenn dazu

          SAMBA\_MANUAL\_CONFIGURATION='no'

        konfiguriert ist, werden automatisch folgende Freigaben erstellt:

\begin{enumerate}
        \item
        Eine Freigabe mit dem entsprechenden Samba-Usernamen und vollen
        Rechten f"ur jeden User, der sich bei Samba anmeldet und nat"urlich
        vorher als eisfair{}- und Samba-User angelegt wurde (siehe
        entsprechenden Punkt in der Dokumentation).
        Diese Freigabe gibt das Heimat-Verzeichnisses des entsprechenden Users
        frei, also /home/<User-Name>.

        \item
        Eine Freigabe mit dem Namen \glqq{}public\grqq{} und vollen Rechten f"ur
        alle angelegten Samba-User. Das dazugeh"orige Verzeichnis findet sich
        unter

\begin{verbatim}
            /public
\end{verbatim}

        und wird bei Installation oder Update des Paketes automatisch angelegt,
        wenn es noch nicht existiert.

        \item
        Eine unsichtbare Freigabe mit dem Namen \glqq{}all\grqq{} und vollen Rechten
        f"ur den/die als \glqq{}root\grqq{} angemeldeten User.
        "Uber diese Freigabe hat man Zugriff auf das gesamte Dateisystem von
        eisfair{}, deshalb haben nur spezielle Benutzer darauf Zugriff und
        die Freigabe wird in der Netzwerkumgebung nicht angezeigt.
        Dieses Verzeichnis ist folgendermassen zu erreichen:
        Unter

\begin{verbatim}
            Start/Ausfuehren
\end{verbatim}

        gibt man

\begin{verbatim}
            \\eisfair\all
\end{verbatim}

        ein, wobei \glqq{}eisfair\grqq{} mit dem Namen zu ersetzen ist, den Ihr bei der
        Konfiguration der boot.txt als Inhalt der Variablen

\begin{verbatim}
            HOSTNAME
\end{verbatim}

        angegeben habt.

        \item
        Es werden alle unter eisfair{} eingerichteten Drucker automatisch f"ur
        alle registrierten Samba-Benutzer freigegeben. Dazu ist es allerdings
        vorher notwendig, das Paket LPRng von mir zu installieren:

\begin{verbatim}
            Package administration
            Install new package
            Printer / File Services
            LPRng Print Services
\end{verbatim}

        Die Einrichtung der von Samba freigegebenen Drucker auf Windows-Clients
        wird in Abschnitt 5 beschrieben.

        \item
        Bei installiertem eisfax-Paket wird automatisch die daf"ur
        notwendige Druckerfreigabe erzeugt.
        Die Einrichtung der von Samba freigegebenen Drucker auf Windows-Clients
        wird in Abschnitt 5 beschrieben.

        \item
        Bei installiertem Ghostscript-Paket wird automatisch
        eine Drucker-Freigabe f"ur einen PDF-Drucker erzeugt, der von den
        Windows-Clients aus daf"ur verwendet werden kann, aus jeder
        druckf"ahigen Anwendung heraus PDF-Dateien zu erzeugen.
        Die Einrichtung der von Samba freigegebenen Drucker auf Windows-Clients
        wird in Abschnitt 5 beschrieben.
\end{enumerate}


\end{description}

\subparagraph{Abschnitt \glqq{}Samba Advanced Configuration\grqq{}:}
%-----------------------------------------

Dieser Abschnitt wird eingeleitet mit:

\begin{verbatim}
#------------------------------------------------------------------------------
# Samba Advanced Configuration
#
# Please don't use this, if you are not very familar with Samba!
# Support for this Section is not available!
#
# Special General Settings
# and
# Individual Configuration of Shares and Printers
#
#------------------------------------------------------------------------------
\end{verbatim}

Es gibt auf unbestimmte Zeit keinen Support f"ur diese Sektion. Wer hier
Ver"anderungen vornimmt, sollte also genau wissen, was er tut!

F"ur die Spezialisten von Samba sei erw"ahnt, dass auch hier nur eine kleine
Anzahl an Variablen gesetzt werden kann. Die Standardeinstellungen der
automatischen Konfiguration mittels

\jumplabel{SAMBA\_MANUAL\_CONFIGURATION}{SAMBAMANUALCONFIGURATION}='no'

reichen "ublicherweise aus, um Samba in einer kleinen Windows-Arbeitsgruppe
laufen zu lassen.


\subparagraph{Abschnitt \glqq{}Samba Advanced Configuration/Special General Settings\grqq{}:}
%------------------------------------------------------------------

Der Abschnitt wird eingeleitet mit

\begin{verbatim}
#------------------------------------------------------------------------------
# Samba Advanced Configuration/Special General Settings
#------------------------------------------------------------------------------
\end{verbatim}

\achtung{
Die Einstellungen in diesem Abschnitt wirken sich sowohl bei

\jumplabel{SAMBA\_MANUAL\_CONFIGURATION}{SAMBAMANUALCONFIGURATION}='yes'

als auch bei

\jumplabel{SAMBA\_MANUAL\_CONFIGURATION}{SAMBAMANUALCONFIGURATION}='no'

aus!
}


\begin{description}
     \config{SAMBA\_COMPAT}{SAMBA\_COMPAT}{SAMBACOMPAT}
     Kompatibilit"atseinstellung f"ur sehr alte und unsichere Clients und
     Server.

        Neuere Samba-Versionen erh"ohen nach und nach die Sicherheit mit
        sehr viel restriktiveren Einstellungen. Das kann zu Problemen bei der
        Verbindung mit alten Clients und Servern f"uhren. Wenn

\begin{verbatim}
          SAMBA_COMPAT='yes'
\end{verbatim}

        konfiguriert wird, werden spezielle Optionen gesetzt, um Verbindungen
        von diesen alten Clients und zu diesen alten Servern zuzulassen.
        Dabei ist zu beachten, dass man dadurch seinen Server sehr viel
        angreifbarer macht. Es sollte also zuerst immer erst versucht werden,
        mit der Standardeinstellung 'no' zu leben und zu testen, ob alles normal
        funktioniert. Leider gibt es dabei einen Haken:
        Wenn die Standardeinstellung

\begin{verbatim}
          SAMBA_COMPAT='no'
\end{verbatim}

        gesetzt ist, l"oscht Samba unter Umst"anden den alten Lanman-Hash (LM),
        der von Versionen von Windows bis zu Windows Me verwendet wird. Er
        wird nur aus Gr"unden der Abw"artskompatibilit"at auch von neueren
        Windows-Versionen unterst"utzt, aber f"ur die Authentifizierung von
        Konten nicht verwendet.
        Gibt es in der Samba-Passwort-Datenbank einen Lanman-Hash, ist

\begin{verbatim}
          SAMBA_COMPAT='no'
\end{verbatim}

        und wird das Samba-Passwort ge"andert, so wird das Lanman-Passwort
        gel"oscht und es existiert nur noch ein NTLM-Passwort.
        Damit ist dann von einem alten Client keine Anmeldung mehr m"oglich,
        wenn der nur LM kann, bis wieder

\begin{verbatim}
          SAMBA_COMPAT='yes'
\end{verbatim}

        und das Samba-Passwort neu gesetzt wurde.

        Standardeinstellung: \texttt{SAMBA\_COMPAT='no'}


     \config{SAMBA\_INSECURE}{SAMBA\_INSECURE}{SAMBAINSECURE}
     Unsichere Einstellung, alle Interfaces und alle Netze erlaubt.

        Mit diesem Parameter wird ein unsicheres Verhalten von Samba eingestellt.
        Damit werden Verbindungen auf allen Interfaces und aus allen Netzen
        akzeptiert. Das ist zur Zeit die einzige M"oglichkeit, einen eisfair{}-
        Samba-Server mit DHCP zu betreiben.

        Normalerweise ermittelt und ber"ucksichtigt Samba beim Erstellen einer
        neuen Konfiguration die konfigurierten Interfaces (Netzwerkkarten) aus
        den Grundeinstellungen von eisfair{}. Es werden also automatisch
        Verbindungen auf allen diesen Netzwerkkarten zugelassen.
        Dieses Verhalten konnte bisher nur mit den Optionen

        \jumplabel{SAMBA\_INTERFACES}{SAMBAINTERFACES}

        und

        \jumplabel{SAMBA\_TRUSTED\_NETS}{SAMBATRUSTEDNETS}

        beeinflusst werden. Wenn eisfair{} aber keine feste IP-Adresse hat und
        sich diese per DHCP-Client zuweisen l"asst, ist diese Art der
        Konfiguration nicht m"oglich und es muss

\begin{verbatim}
          SAMBA_INSECURE='yes'
\end{verbatim}

        gesetzt werden, damit Samba konfiguriert und gestartet werden kann.
        Diese Einstellung bewirkt, dass Samba sich an alle gefundenen Interfaces
        bindet und den Zugriff aus allen Netzen erlaubt. Dabei werden die
        Einstellungen in

        \jumplabel{SAMBA\_INTERFACES}{SAMBAINTERFACES}

        und

        \jumplabel{SAMBA\_TRUSTED\_NETS}{SAMBATRUSTEDNETS}

        sowie die Einstellungen zu IP-Adressen und Netzen aus der base ignoriert.
        Aus Sicherheitsgr"unden empfehle ich, dem eisfair{}-Server immer eine
        feste IP-Adresse zuzuordnen und DHCP bei einem Server nicht zu
        verwenden!

        Standardeinstellung: \texttt{SAMBA\_INSECURE='no'}


     \config{SAMBA\_INTERFACES}{SAMBA\_INTERFACES}{SAMBAINTERFACES}
     Auf welchen Interfaces (Netzwerkkarten) soll Samba ansprechbar sein?

        Mit diesem Parameter wird eingestellt, auf welchen Interfaces Samba auf
        Anforderungen reagiert.
        Samba ermittelt und ber"ucksichtigt beim Erstellen einer neuen
        Konfiguration die konfigurierten Interfaces (Netzwerkkarten) aus den
        Grundeinstellungen von eisfair{}. Es werden also automatisch Verbindungen
        auf allen diesen Netzwerkkarten zugelassen.
        M"ochte man bei mehreren Netzwerkkarten Samba aber nur auf einem oder
        einigen dieser Interfaces laufen lassen, so sind diese hier einzutragen.
        Die Angabe hat dabei in der Form

\begin{verbatim}
          IP/NETMASK
\end{verbatim}

        zu erfolgen, also z.B.:

\begin{verbatim}
          SAMBA_INTERFACES='192.168.6.1/255.255.255.0'
\end{verbatim}

        Mehrere Eintr"age sind durch ein Leerzeichen zu trennen.
        Diese Angaben sollten unbedingt mit /etc/config.d/base und den dortigen
        Eintr"agen in

\begin{verbatim}
          IP_ETH_x_IPADDR
          IP_ETH_x_NETMASK
\end{verbatim}

        verglichen werden, da Samba bei falscher Angabe nicht mehr startet!
        Die Einstellungen hier werden ignoriert, wenn

        \jumplabel{SAMBA\_INSECURE}{SAMBAINSECURE}

        auf 'yes' gesetzt ist.

        Standardeinstellung: \texttt{SAMBA\_INTERFACES=}


     \config{SAMBA\_TRUSTED\_NETS}{SAMBA\_TRUSTED\_NETS}{SAMBATRUSTEDNETS}
     Von welchen Netzen aus ist der Zugriff auf Samba gestattet?

        Mit diesem Parameter wird eingestellt, welche Netze auf Samba zugreifen
        d"urfen.
        Samba ermittelt und ber"ucksichtigt beim Erstellen einer neuen
        Konfiguration die internen Netze aus den Grundeinstellungen von
        eisfair{}. Aus Sicherheitsgr"unden wird nur Rechnern aus diesen Netzen
        ein Zugriff gestattet.
        Sollen Rechner aus anderen Netzen zugreifen d"urfen, m"ussen diese hier
        gesondert konfiguriert werden. Es reicht dabei aus, nur die
        zus"atzlichen Netze anzugeben.
        Die Angabe hat in der Form

\begin{verbatim}
          NETZWERKNUMMER/ANZAHL-DER-GESETZTEN-BITS-IN-NETMASK
\end{verbatim}

        zu erfolgen, also z.B. f"ur Netze der Form 192.168.x.0:

\begin{verbatim}
          SAMBA_TRUSTED_NETS='192.168.6.0/24'
\end{verbatim}

        Die Einstellungen hier werden ignoriert, wenn

        \jumplabel{SAMBA\_INSECURE}{SAMBAINSECURE}

        auf 'yes' gesetzt ist.

        Standardeinstellung: \texttt{SAMBA\_TRUSTED\_NETS=}


     \config{SAMBA\_DEBUGLEVEL}{SAMBA\_DEBUGLEVEL}{SAMBADEBUGLEVEL}
        Hier kann man den Grad der Anzahl der Fehlermeldungen der Samba-
        Programme einstellen. Es kann ein Level von 0-10 angegeben werden,
        wobei maximal 3 eingestellt werden sollte.
        Das ist nur erforderlich, wenn Schwierigkeiten auftreten. Mit den
        Meldungen unter /var/log/log.smbd und /var/log/log.nmbd l"asst sich der
        Fehler dann oft besser eingrenzen.
        Bei

\begin{verbatim}
          SAMBA_DEBUGLEVEL='3'
\end{verbatim}

        und h"oher wird beim Zugriff auf Verzeichnis-Freigaben eine
        NETBIOS-Nachricht mit von Samba ermittelten Daten an den zugreifenden
        Rechner versendet:

\begin{verbatim}
          %T )  Datum/Zeit
          %d )  PID des Servers
          %v )  Samba-Version
          %h )  (Internet)Hostname des Servers
          %L )  NETBIOS-Name des Servers
          %N )  NIS Heimat-Verzeichnis
          %p )  Pfad des NIS-Heimatverzeichnisses
          %R )  Ausgehandeltes Protokoll-Level
          %S )  Name der aktuellen Freigabe
          %P )  Hauptverzeichnis der aktuellen Freigabe
          %U )  Vom Client angeforderter Benutzername
          %G )  Primaere Gruppe des angeforderten Benutzers
          %u )  Name des effektiven Benutzers
          %g )  Primaerer Gruppenname des effektiven Benutzers
          %H )  Heimatverzeichnis des effektiven Benutzers
          %I )  IP Adresse des Client-Rechners
          %M )  (Internet)Hostname des Client-Rechners
          %m )  NETBIOS-Name des Client-Rechners
          %a )  Betriebssystem des Client-Rechners
\end{verbatim}

        Bei der Erzeugung von PDF-Dateien werden in der Benachrichtigung
        per NETBIOS-Nachricht Debug-Informationen zur Ermittlung des
        Dokumentnamens mit angezeigt.
        Ohne diese Informationen kann ich bei Problemen nicht weiterhelfen,
        meldet Euch deswegen mit dem genauen Wortlaut in der Newsgroup.

        Ich rate dringend davon ab, Samba mit einem Debuglevel gr"osser 0
        zu betreiben, wenn alles zufriedenstellend l"auft. Das Schreiben der
        Informationen kostet sehr viel Performance!
        Ausserdem soll bestimmt nicht jeder die von Samba ermittelten
        Informationen lesen. Die Einstellung ist f"ur Administratoren zum
        Debuggen in einer ruhigen Minute gedacht!

        Standardeinstellung: \texttt{SAMBA\_DEBUGLEVEL='0'}


    \config{SAMBA\_MASTERBROWSER}{SAMBA\_MASTERBROWSER}{SAMBAMASTERBROWSER}
    Samba als Masterbrowser: 'yes' oder 'no'

        Da der eisfair{}-Rechner bei vielen durchgehend l"auft, ist es mitunter
        sinnvoll, ihn auch als Masterbrowser einzusetzen. Ein Masterbrowser ist
        in Windowsnetzwerken der Rechner, der eine Liste aller verf"ugbaren
        SMB-Server f"uhrt, wozu alle Rechner mit aktivierter Datei- und
        Druckerfreigabe geh"oren. Die Windows-Clients erfahren also vom
        Masterbrowser, welche Rechner mit aktivierter Datei- und Druckerfreigabe
        sich im Netzwerk befinden. In Netzwerken mit einem NT-Server sollte man
        lieber NT diese Aufgabe "uberlassen. In Netzwerken mit ein paar WIN9x-Rechnern
        kann eisfair{} diese Aufgabe problemlos "ubernehmen.

        Bei SAMBA\_MASTERBROWSER='yes' gewinnt eisfair{} die Wahl zum
        Masterbrowser gegen alle anderen Windowsmaschinen.

        Standardeinstellung: \texttt{SAMBA\_MASTERBROWSER='no'}


    \config{SAMBA\_WINSSERVER}{SAMBA\_WINSSERVER}{SAMBAWINSSERVER}
    Samba als WINS-Server: 'yes' oder 'no'

        Um NETBIOS-Namen in Windows-Netzen aufzul"osen, gibt es zwei
        M"oglichkeiten. Die erste benutzt eine statische Aufl"osung mit der
        Datei lmhosts und ist wie die DNS-Namensaufl"osung mit der Datei hosts
        schwer zu pflegen. Deshalb wurde von Microsoft WINS entwickelt:

        W indows I nternet N ame S ervice

        WINS hat den Vorteil, dass die NETBIOS-Namensaufl"osung per gerichteter
        Anfrage an einen WINS-Server passiert und nicht durch Broadcasts. Die
        WINS-Datenbank wird vom Server dynamisch aufgebaut, hat aber den
        Nachteil, dass der Server in den TCP/IP-Protokolleigenschaften auf
        jedem Client eingetragen werden muss. Samba hat diesen Server teilweise
        implementiert und damit steht er eisfair{} auch zur Verf"ugung.

        Um eisfair{} als WINS-Server zu betreiben, ist

\begin{verbatim}
          SAMBA_WINSSERVER='yes'
\end{verbatim}

        zu setzen und auf den Windows-Clients in den TCP/IP-
        Protokolleigenschaften der Netzwerkkarte unter
        /Start/Einstellungen/Systemsteuerung/Netzwerk/Lasche Konfiguration/
        TCP/IP auf der Lasche WINS-Konfiguration \glqq{}WINS-Aufl"osung aktivieren\grqq{}
        auszuw"ahlen.
        Unter WINS-Server Suchreihenfolge ist dabei die IP-Adresse des eisfair{}-
        Rechners zu hinterlegen, welche mit \glqq{}Hinzuf"ugen\grqq{} "ubernommen
        werden muss.

        Obwohl man hier nur die Wahl zwischen WINS ODER DHCP hat, entbindet die
        Angabe der IP-Adresse des eisfair{}-WINS-Servers nicht von einer korrekten
        TCP/IP-Konfiguration, entweder "uber Angabe der IP-Adresse jedes Clients
        oder "uber DHCP.
        In Netzwerken mit einem NT-Server, auf dem der WINS-Serverdienst
        aktiviert ist, sollte man lieber NT diese Aufgabe "uberlassen. Aber in
        Netzwerken mit ein paar WIN9x-Rechnern kann auch eisfair{} diese Aufgabe
        problemlos "ubernehmen.

\begin{verbatim}
          SAMBA_WINSSERVER='yes'
\end{verbatim}

        aktiviert diese Funktion (ben"otigt SAMBA\_EXTWINSIP='').

        Standardeinstellung: \texttt{SAMBA\_WINSSERVER='no'}


    \config{SAMBA\_WINSHOOK}{SAMBA\_WINSHOOK}{SAMBAWINSHOOK}
    (ben"otigt SAMBA\_WINSSERVER='yes')
    F"uhre Aktionen aus, wenn sich ein WINS-Client registriert: 'yes' oder 'no'

        Wenn sich ein Client bei einem auf eisfair{} laufenden WINS-Server
        registriert, k"onnen daraufhin spezielle Aktionen ausgel"ost werden.

        Voraussetzung f"ur die Ausf"uhrung dieser speziellen Aktionen ist die
        Aktivierung dieser Variable mittels SAMBA\_WINSHOOK='yes', ein auf
        eisfair{} laufender WINS-Server, ein Client, der darauf konfiguriert
        wurde, sich beim eisfair{}-WINS-Server zu registrieren, sowie die weiter
        unten folgenden Aktionen, die nach Bedarf aktiviert werden m"ussen.

        Achtung:
        Es liegen bisher keine Erfahrungen vor, welche Last die folgenden
        Funktionen in einem grossen Netzwerk mit vielen Clients verursachen.
        Ich kann mir gut vorstellen, dass dieses Szenario einen Server in die
        Knie zwingen kann:

        Zum Arbeitsbeginn um 8 Uhr morgens melden sich 250 Clients gleichzeitig
        bei einem eisfair{}-Server an, der als PDC arbeitet. 250 Clients ziehen
        sich parallel ihr Profil vom Server, registrieren sich beim WINS-Server,
        worauf 250 Nachrichten versendet werden. Nebenbei wird jeder Client bei
        dem DNS-Server Bind registriert.
        Eventuell erhalten diese 250 Clients ihre IP-Adresse von einem DHCP-
        Server auf eisfair{} und es laufen nebenbei noch einige andere Dienste...

        Bei Problemen solltet Ihr diese Funktionen deaktivieren, bevor Ihr Euch
        in der Newsgroup wegen pl"otzlich auftretender Probleme beschwert.

        Standardeinstellung: \texttt{SAMBA\_WINSHOOK='no'}


    \config{SAMBA\_WINSHOOK\_MESSAGE\_SEND}{SAMBA\_WINSHOOK\_MESSAGE\_SEND}{SAMBAWINSHOOKMESSAGESEND}
    (ben"otigt SAMBA\_WINSSERVER='yes' und SAMBA\_WINSHOOK='yes')
    Sende SAMBA\_WINSHOOK\_MESSAGE: 'yes' oder 'no'

        Wenn diese Variable auf 'yes' gesetzt ist, wird auf WINS-Clients, die
        sich am eisfair{}-WINS-Server registrieren, die in SAMBA\_WINSHOOK\_MESSAGE
        definierte Nachricht ausgegeben. Da einige Zeit vergeht, bis der Client
        nach dem Laden des Netzwerk-Stacks den Nachrichtendienst gestartet hat,
        wird die Meldung erst 60 Sekunden nach der Registrierung beim WINS-Server
        versendet.

        Voraussetzung ist die Aktivierung dieser Variable mittels
        SAMBA\_WINSHOOK\_MESSAGE\_SEND='yes', ein auf eisfair{} laufender
        WINS-Server (SAMBA\_WINSSERVER='yes'), ein Client, der darauf
        konfiguriert wurde, sich beim eisfair{}-WINS-Server zu registrieren,
        ein aktivierter Nachrichtendienst auf dem Client, sowie die M"oglichkeit,
        Meldungen an den Nachrichtendienst zu versenden (ein eventuell
        installierter Paketfilter auf dem Client muss das zulassen).
        Beachtet dabei, dass in Windows Vista/7/8/10 kein Nachrichtendienst mehr von
        Microsoft geliefert wird!

        Standardeinstellung: \texttt{SAMBA\_WINSHOOK\_MESSAGE\_SEND='no'}


    \config{SAMBA\_WINSHOOK\_MESSAGE}{SAMBA\_WINSHOOK\_MESSAGE}{SAMBAWINSHOOKMESSAGE}
    (ben"otigt SAMBA\_WINSSERVER='yes', SAMBA\_WINSHOOK='yes' und
    SAMBA\_WINSHOOK\_MESSAGE\_SEND='yes')

        Diese Nachricht wird bei der Registrierung eines WINS-Clients beim
        eisfair{}-WINS-Server auf diesem Client mit aktiviertem Nachrichtendienst
        ausgegeben, wenn die Variable

        \jumplabel{SAMBA\_WINSHOOK\_MESSAGE\_SEND}{SAMBAWINSHOOKMESSAGESEND}

        auf 'yes' gesetzt ist.

        Der Nachrichtendienst ist auf Windows-NT, Windows-2000 und Windows XP
        normalerweise aktiviert und muss anderenfalls nachinstalliert/aktiviert
        werden.
        Unter Windows-9x-Clients wie Windows 98 oder Windows Me muss dazu das
        Programm WinPopUp laufen.
        Unter Windows Vista/7/8/10 existiert kein Nachrichtendienst mehr!

        Beachtet die Voraussetzungen und die Warnung unter

        \jumplabel{SAMBA\_WINSHOOK}{SAMBAWINSHOOK}

        Standardeinstellung: \texttt{SAMBA\_WINSHOOK\_MESSAGE='Welcome to eisfair server'}


    \config{SAMBA\_WINSHOOK\_DNSUPDATE}{SAMBA\_WINSHOOK\_DNSUPDATE}{SAMBAWINSHOOKDNSUPDATE}
    (ben"otigt SAMBA\_WINSSERVER='yes' und SAMBA\_WINSHOOK='yes')
    Registriere WINS-Clients beim DNS-Server Bind: 'yes' oder 'no'

        Wenn auf eisfair{} das Paket Bind als DNS-Server l"auft, k"onnen WINS-Clients
        dort automatisch registriert werden (mit ens als DNS-Server funktioniert
        das nicht).
        Dazu ist SAMBA\_WINSHOOK\_DNSUPDATE='yes' zu setzen.

        Beachtet die Voraussetzungen und die Warnung unter

        \jumplabel{SAMBA\_WINSHOOK}{SAMBAWINSHOOK}

        Standardeinstellung: \texttt{SAMBA\_WINSHOOK\_DNSUPDATE='no'}


    \config{SAMBA\_EXTWINSIP}{SAMBA\_EXTWINSIP}{SAMBAEXTWINSIP}
    (ben"otigt SAMBA\_WINSSERVER='no')
    Die IP-Adresse des externen WINS-Servers f"ur Samba

        Wenn man, wie oben bereits erw"ahnt, in Netzwerken mit einem NT-Server
        arbeitet, sollte man diesem die Aufgabe "uberlassen, die WINS-Datenbank
        zu verwalten. Dabei kann man eisfair{} als WINS-Client konfigurieren. Der
        eisfair{}-Rechner versucht dann, sich bei dem konfigurierten WINS-Server
        zu registrieren. Hierbei ist darauf zu achten, dass eisfair{} nicht
        gleichzeitig als Server und Client konfiguriert werden kann -
        die Optionen

\begin{verbatim}
          SAMBA_WINSSERVER='yes'
\end{verbatim}

        und

\begin{verbatim}
          SAMBA_EXTWINSIP='IP-Adresse'
\end{verbatim}

        schliessen einander also aus und werden bei der "Uberpr"ufung der
        Konfiguration bem"angelt!
        Wenn man den eisfair{}-Rechner als WINS-Client betreiben m"ochte, muss
        man ihm die IP-Adresse des externen WINS-Servers bekanntmachen, bei dem
        er sich registrieren soll.

        Hier ein Beispiel mit der IP-Adresse 192.168.6.11:

\begin{verbatim}
          SAMBA_EXTWINSIP='192.168.6.11'
\end{verbatim}

        In diesem Modus arbeitet Samba ausserdem als WINS-Proxy. Das ist von
        Vorteil, wenn sich nicht nur WINS-Clients im Netzwerk befinden, der
        WINS-Server in einem anderen Netzwerk liegt und nicht per Broadcast
        erreichbar ist und die Nicht-WINS-Clients aber eine
        NETBIOS-Namensaufl"osung ben"otigen. Hierbei f"angt der eisfair{}-Rechner
        Broadcasts der Nicht-WINS-Clients auf, fragt den eingetragenen
        WINS-Server ab und schickt die Antwort per Broadcast an den
        anfragenden Rechner.

        Standardeinstellung: \texttt{SAMBA\_EXTWINSIP=}


    \config{SAMBA\_START\_MESSAGE\_SEND}{SAMBA\_START\_MESSAGE\_SEND}{SAMBASTARTMESSAGESEND}
    Sende SAMBA\_START\_MESSAGE: 'yes' oder 'no'

        Wenn diese Variable auf 'yes' gesetzt ist, wird beim Starten
        von Samba die in SAMBA\_START\_MESSAGE definierte Nachricht auf allen
        SMB-Hosts mit aktiviertem Nachrichtendienst ausgegeben (siehe auch
        SAMBA\_START\_MESSAGE).
        Da das bei grossen Netzwerken mit vielen Clients sehr lange dauern
        kann und Netzwerkbandbreite braucht, wurde als Voreinstellung 'no'
        definiert.

        Standardeinstellung: \texttt{SAMBA\_START\_MESSAGE\_SEND='no'}


    \config{SAMBA\_START\_MESSAGE}{SAMBA\_START\_MESSAGE}{SAMBASTARTMESSAGE}
        Diese Nachricht wird beim Starten des Samba-Servers auf allen
        SMB-Hosts mit aktiviertem Nachrichtendienst ausgegeben, wenn die
        Variable

        \jumplabel{SAMBA\_START\_MESSAGE\_SEND}{SAMBASTARTMESSAGESEND}

        auf 'yes' gesetzt ist.

        Der Nachrichtendienst ist auf Windows-NT, Windows-2000 und Windows XP
        normalerweise aktiviert und muss anderenfalls nachinstalliert/aktiviert
        werden.
        Unter Windows-9x-Clients wie Windows 98 oder Windows Me muss dazu das
        Programm WinPopUp laufen.
        Unter Windows Vista/7/8/10 existiert kein Nachrichtendienst mehr!

        Standardeinstellung:
        \texttt{SAMBA\_START\_MESSAGE='eisfair Samba Server is up now ...'}


    \config{SAMBA\_SHUTDOWN\_MESSAGE\_SEND}{SAMBA\_SHUTDOWN\_MESSAGE\_SEND}{SAMBASHUTDOWNMESSAGESEND}
    Sende SAMBA\_SHUTDOWN\_MESSAGE: 'yes' oder 'no'

        Wenn diese Variable auf 'yes' gesetzt ist, wird beim Herunterfahren
        von Samba die in SAMBA\_SHUTDOWN\_MESSAGE definierte Nachricht auf den
        in

        \jumplabel{SAMBA\_SHUTDOWN\_MESSAGE\_HOSTS}{SAMBASHUTDOWNMESSAGEHOSTS}

        definierten SMB-Hosts mit aktiviertem Nachrichtendienst ausgegeben
        (siehe auch \jumplabel{SAMBA\_SHUTDOWN\_MESSAGE}{SAMBASHUTDOWNMESSAGE}).
        Da das bei grossen Netzwerken mit vielen Clients sehr lange dauern
        kann und Netzwerkbandbreite braucht, wurde als Voreinstellung 'no'
        definiert.

        Standardeinstellung: \texttt{SAMBA\_SHUTDOWN\_MESSAGE\_SEND='no'}


    \config{SAMBA\_SHUTDOWN\_MESSAGE}{SAMBA\_SHUTDOWN\_MESSAGE}{SAMBASHUTDOWNMESSAGE}
    (ben"otigt SAMBA\_SHUTDOWN\_MESSAGE\_SEND='yes')
        Diese Nachricht wird beim Stoppen des Samba-Servers auf den in

        \jumplabel{SAMBA\_SHUTDOWN\_MESSAGE\_HOSTS}{SAMBASHUTDOWNMESSAGEHOSTS}

        definierten SMB-Hosts mit aktiviertem Nachrichtendienst ausgegeben,
        wenn die Variable

        \jumplabel{SAMBA\_SHUTDOWN\_MESSAGE\_SEND}{SAMBASHUTDOWNMESSAGESEND}

        auf 'yes' gesetzt ist.

        Der Nachrichtendienst ist auf Windows-NT, Windows-2000 und Windows XP
        normalerweise aktiviert und muss anderenfalls nachinstalliert/aktiviert
        werden.
        Unter Windows-9x-Clients wie Windows 98 oder Windows ME muss dazu das
        Programm WinPopUp laufen.
        Unter Windows Vista/7/8/10 existiert kein Nachrichtendienst mehr!

        Standardeinstellung:
        \texttt{SAMBA\_SHUTDOWN\_MESSAGE='eisfair Samba Server is going down now ...'}


    \config{SAMBA\_SHUTDOWN\_MESSAGE\_HOSTS}{SAMBA\_SHUTDOWN\_MESSAGE\_HOSTS}{SAMBASHUTDOWNMESSAGEHOSTS}
    (ben"otigt SAMBA\_SHUTDOWN\_MESSAGE='yes')

    Sende SAMBA\_SHUTDOWN\_MESSAGE an Hosts: 'all' oder 'active'

        Hier gibt man an, an welche Rechner die \jumplabel{SAMBA\_SHUTDOWN\_MESSAGE}{SAMBASHUTDOWNMESSAGE}
        versendet werden soll. M"ogliche Eintr"age sind:

\begin{verbatim}
          all   : Alle SMB-Hosts im Netzwerk.

          active: Alle SMB-Hosts im Netzwerk mit aktiven SMB-Verbindungen zu
                  eisfair.
\end{verbatim}

        Wer hier 'active' ausw"ahlt, sollte sich dar"uber im Klaren sein,
        dass ein Client, der "uber das Windows-Netzwerk eine Datei auf eisfair{}
        bearbeitet und dabei lange Pausen einlegt, irgendwann in einen Timeout
        l"auft und die Verbindung nicht mehr aktiv ist! Samba auf eisfair{}
        deklariert eine solche Verbindung nach 60 Minuten f"ur tot und trennt
        sie, was bei modernen Windows-Clients keine Probleme verursacht, da
        beim Speichern einfach wiederverbunden wird.
        Wurde die Verbindung aber von eisfair{} oder vom Client wegen zu hohem
        Timeout getrennt, erh"alt dieser Client keine Nachricht!

        Standardeinstellung: \texttt{SAMBA\_SHUTDOWN\_MESSAGE\_HOSTS='all'}


    \config{SAMBA\_LOCALIZATION}{SAMBA\_LOCALIZATION}{SAMBALOCALIZATION}
        Da Windows-Clients in verschiedenen Sprachen unterschiedliche
        Codepages benutzen (per chcp in der DOS-Box kann man die verwendete
        Codepage anzeigen lassen), muss dem Samba-Server diese Codepage
        bekanntgemacht werden.
        Die Angabe dieser Codepages (client codepage =) wird von Samba benutzt,
        um ankommende Dateinamen von der DOS-Codepage auf den verwendeten
        UNIX-Zeichensatz (character set =) umzusetzen.
        In der Konfigurationsdatei kann man folgende Werte einstellen, die wie
        folgt umgesetzt werden:

\begin{tabular}{p{3cm}|p{3cm}|p{3cm}|p{3cm}}
        Einstellung    &Sprachraum         &character set      &client codepage \\
\hline
        US             &Amerika            &--                 &437 \\
        ISO8859-1      &Western Europe     &iso8859-1          &850 \\
        ISO8859-2      &Eastern Europe     &iso8859-2          &852 \\
        ISO8859-5      &Russian Cyrillic   &iso8859-5          &866 \\
        ISO8859-7      &Greek              &iso8859-7          &737 \\
        ISO8859-15     &Western Europe     &iso8859-15         &850 \\
        UTF8           &Western Europe     &UTF-8              &unicode \\
\end{tabular}

        Da wir uns in Deutschland befinden, muss man eigentlich nur wissen,
        dass hier die Einstellung ISO8859-15 f"ur den EURO bzw. ISO8859-1
        f"ur Deutsch ohne Euro-Zeichen vorgenommen werden kann.
        Bei Systemen, die mit einem neueren Installer aufgesetzt wurden, l"auft
        das System an sich mit UTF-8 und genau so sollte Samba dann auch
        eingestellt werden.

        Standardeinstellung: \texttt{SAMBA\_LOCALIZATION='ISO8859-15'}


    \config{SAMBA\_PDC}{SAMBA\_PDC}{SAMBAPDC}
    Soll SAMBA als Primary Domain Controller arbeiten: 'yes' oder 'no'

        Wenn diese Variable auf 'yes' gesetzt ist, stellt Samba die
        Funktionen eines Primary Domain Controllers (PDC), vergleichbar zu
        einem Windows-NT-4.0-Server-PDC, f"ur Windows-9x-, Windows-2000-,
        Windows-XP-Professional-, Windows-7-, und Windows-8- und
        und Windows-10-Clients zur Verf"ugung.
        Die Home-Versionen der Microsoft-Betreibs-Systeme werden dabei nicht
        unterst"utzt, da sie von Microsoft k"unstlich beschnitten wurden!
        Die Active-Directory-Funktionen der Windows-Server werden von meinem
        Samba-Paket bisher nicht unterst"utzt!

        Will man Samba als PDC nutzen, ist folgende Vorgehensweise notwendig:

\begin{enumerate}
        \item
        Der Benutzer \glqq{}root\grqq{} wurde als Samba-Benutzer angelegt. Davon kann
        man sich im Samba-Service-Men"u mittels

\begin{verbatim}
            Samba User Handling
            List Samba User
\end{verbatim}

        "uberzeugen. Hier die Ausgabe von meinem eisfair{}-Rechner:

\begin{verbatim}
            List Samba Users

                User      Uid      Password    Active
                root      0        set         yes
                tb        2001     set         yes
                test      2003     set         yes

            Press ENTER to continue
\end{verbatim}

        \item
        In der Datei \texttt{/etc/user.map} wird der Benutzer \glqq{}Administrator\grqq{}
        der Workstation auf den Benutzer \glqq{}root\grqq{} gemappt.
        Wenn nicht gegen einen externen Passwortserver authentifiziert
        wird, sieht das so aus:

\begin{verbatim}
            root = "Administrator"
\end{verbatim}

        Wenn gegen einen externen Passwortserver authentifiziert wird, muss die
        Dom"ane vor dem Windows-Usernamen angegeben werden:

\begin{verbatim}
            root = "DOM\Administrator"
\end{verbatim}

        Die Datei \texttt{/etc/user.map} wird aus der Samba-Konfiguration
        heraus erzeugt. Wenn in der \texttt{/etc/user.map} der obige
        Eintrag fehlt, habt Ihr etwas falsch gemacht. Siehe auch

        \jumplabel{SAMBA\_USERMAP\_N}{SAMBAUSERMAPN}

        \item
        Samba l"auft noch im Arbeitsgruppen-Modus (SAMBA\_PDC='no').
        \item
        Damit die verschiedenen Windows-Client-Versionen erfolgreich in die
        Dom"ane integriert werden k"onnen, m"ussen je nach Version Registry-
        Patches auf den Clients angewendet werden. Diese Registry-Patches
        finden sich nach der Installation des Samba-Paketes unter
        \texttt{/usr/share/doc/samba/regpatches}.
        \item
        Jetzt benennt man als \glqq{}Administrator\grqq{} tempor"ar die Arbeitsgruppe auf
        den Clients um (z.B. in TESTGROUP), weil es zu Schwierigkeiten kommt,
        wenn der Name der Arbeitsgruppe, in der man sich befindet und der
        Name der Dom"ane, in die man wechseln m"ochte, identisch sind. Dabei
        wird man aufgefordert, den Client neu zu starten, was auch unbedingt
        erforderlich ist.
        \item
        Jetzt erst setzt man SAMBA\_PDC='yes' und hinterlegt in der Variable
        \jumplabel{SAMBA\_WORKGROUP}{SAMBAWORKGROUP} den gew"unschten Dom"anen-Namen,
        z.B. SAMBA\_WORKGROUP='DOMAIN'.
        \item
        Nachdem die neue Konfiguration aktiviert wurde, muss folgende Meldung
        in /var/log/log.nmbd auftauchen:

\begin{verbatim}
            Samba server XXX is now a domain master browser for workgroup
            YYY on subnet ZZZ.
\end{verbatim}

        Dabei stehen XXX, YYY und ZZZ f"ur Eure individuelle Konfiguration.
        \item
        Jetzt trennt man alle eventuell ge"offneten Freigaben und gemappten Laufwerke,
        da diese eine erfolgreiche Integration in die Dom"ane verhindern.
        Dazu "offnet man eine DOS-Box, indem man unter

\begin{verbatim}
            Start/Ausfuehren
\end{verbatim}

\begin{verbatim}
            command
\end{verbatim}

        eingibt und dort folgenden Befehl ausf"uhrt:

\begin{verbatim}
            net use * /delete
\end{verbatim}

        \item
        Man kann nun als Benutzer \glqq{}Administrator\grqq{} unter Windows die
        Workstation zur Dom"ane hinzuf"ugen:

        Per Rechtsklick auf
        Arbeitsplatz/Eigenschaften/Netzwerkidentifikation/Eigenschaften
        (Beispiel Windows 2000) oder
        Arbeitsplatz/Eigenschaften/Computername/"Andern
        (Beispiel Windows XP Professional)
        definiert man, dass diese Workstation ein
        Mitglied der Dom"ane YYY (siehe oben, jetzige Einstellung von
        \jumplabel{SAMBA\_WORKGROUP}{SAMBAWORKGROUP}) sein soll.

        Bei der Abfrage

\begin{verbatim}
            Geben Sie Namen und Kennwort eines Kontos mit der Berechtigung
            dieser Domaene beizutreten ein.
\end{verbatim}

        gibt man einfach \glqq{}Administrator\grqq{} und das entsprechende Passwort von
        \glqq{}root\grqq{} an (da in der Datei /etc/user.map der Benutzer \glqq{}Administrator\grqq{}
        auf \glqq{}root\grqq{} umgesetzt wird, wenn Ihr Euch an die Beschreibung
        gehalten habt) und erh"alt, wenn man alles richtig gemacht hat, die nette
        Best"atigung:

             \glqq{}Willkommen in der Dom"ane YYY.\grqq{} (siehe oben)

        \item
        Es wurde von Samba automatisch ein Maschinenkonto f"ur die Workstation
        erzeugt, wovon man sich im Samba-Service-Men"u "uberzeugen kann:

\begin{verbatim}
            Samba Domain Handling
            Samba PDC Workstation Configuration (NT, 2000, XP)
            List Samba Workstations
\end{verbatim}

        \item
        Aus der Ereignisanzeige/System des Windows-Clients:

             Dieser Computer wurde erfolgreich \glqq{}domain\grqq{} hinzugef"ugt: \glqq{}YYY\grqq{}.

        YYY steht f"ur Euren Dom"anen-Namen.

        \item
        Nach einem Neustart kann man sich als angelegter Samba-Benutzer an
        der Dom"ane anmelden und gibt dabei bei \glqq{}Anmelden an\grqq{} nicht den
        lokalen Rechner an, sondern die Dom"ane.
        Windows-Benutzer, die in der Datei /etc/user.map auf andere
        Samba-Benutzer umgesetzt werden, m"ussen dabei das Passwort des
        Benutzers eingeben, auf den sie umgesetzt werden! Siehe auch

        \jumplabel{SAMBA\_USERMAP\_N}{SAMBAUSERMAPN}

        \item
        Startet Samba das erste Mal als PDC, so wird eine eindeutige SID (Security ID)
        f"ur diesen PDC erzeugt. Diese SID identifiziert die Dom"ane eindeutig. Bei Integration von
        Clients in die Dom"ane wird diesen die SID zugeordnet.
        Daraus ergibt sich, dass es nicht ausreicht, einen Client als Dom"anenmitglied einfach
        identisch zu benennen, um wieder in die Dom"ane zu kommen, da der Client diese SID
        nicht kennt. Das ist aus Sicherheitsgr"unden absolut sinnvoll!

        Setzt man bei irgendwelchen Tests sp"ater einmal SAMBA\_PDC='no' und danach wieder
        SAMBA\_PDC='yes', kann es passieren, dass wiederum eine eindeutige SID generiert
        wird, welche von der vorigen abweicht. Das Ergebnis ist verheerend:
        Kein Client kommt mehr in die Dom"ane, da die Clients ihren PDC mit einer anderen
        SID assoziieren. Es ist in diesem Fall notwendig, alle Clients wieder neu in die
        Dom"ane zu integrieren.
        Das gleiche Problem ergibt sich auch bei einer Namens"anderung des PDC, also
        genau dann, wenn man den Hostnamen des eisfair{}-Rechners "andert!
        Man kann das Problem umgehen, indem man vor "Anderung von SAMBA\_PDC='yes' auf
        SAMBA\_PDC='no' und vor einer Namens"anderung die SID abspeichert und nach
        "Anderung von SAMBA\_PDC='no' auf SAMBA\_PDC='yes' oder "Anderung des Namens
        wieder in Samba einliest.
        Siehe dazu

\begin{verbatim}
            Save Samba SID to /root/MACHINE.SID
\end{verbatim}

        und

\begin{verbatim}
            Restore Samba SID from /root/MACHINE.SID
\end{verbatim}

        Wenn Samba als PDC l"auft, werden statische Group-Mappings
        eingerichtet (dynamische Mappings werden von mir noch nicht
        unterst"utzt).
        Die Namen der Windows-Gruppen sind dabei von den Spracheinstellungen
        des Samba-Paketes abh"angig. Bei

        \jumplabel{SAMBA\_LOCALIZATION}{SAMBALOCALIZATION}='ISO8859-15'

        oder

        \jumplabel{SAMBA\_LOCALIZATION}{SAMBALOCALIZATION}='ISO8859-1'

        oder

        \jumplabel{SAMBA\_LOCALIZATION}{SAMBALOCALIZATION}='UTF-8'

        werden folgende Namen verwendet:

\begin{tabular}{p{6cm}|p{3cm}|p{3cm}}
        Windows-Gruppe          &eisfair-Gruppe &GID    \\
\hline
        Dom"anen-Administratoren &root           &0      \\
        Dom"anen-G"aste          &nogroup        &65534  \\
        Dom"anen-Hauptbenutzer   &sys            &3      \\
        Dom"anen-Benutzer        &users          &100    \\
        Dom"anen-Computer        &machines       &777    \\
\end{tabular}

        Bei allen anderen Spracheinstellungen:

\begin{tabular}{p{6cm}|p{3cm}|p{3cm}}
        Windows-Gruppe          &eisfair-Gruppe &GID    \\
\hline
        Domain-Administrators   &root           &0      \\
        Domain-Guests           &nogroup        &65534  \\
        Domain-Power-Users      &sys            &3      \\
        Domain-Users            &users          &100    \\
        Domain-Computers        &machines       &777    \\
\end{tabular}

        Das Mapping kann mittels

\begin{verbatim}
            net groupmap list
\end{verbatim}

        auf der Konsole oder "uber die Samba-Startmeldungen "uberpr"uft werden.
        Die globale Windows-Gruppe der Dom"anen-Administratoren wird bei
        Integration der Workstation in die Dom"ane automatisch der lokalen
        Gruppe der Administratoren hinzugef"ugt, sodass bei Anmeldung an der
        Dom"ane lokale Administratoren Rechte zur Dom"anen-Administration
        besitzen.

        Standardeinstellung: \texttt{SAMBA\_PDC='no'}


\end{enumerate}


    \config{SAMBA\_PDC\_PROFILES}{SAMBA\_PDC\_PROFILES}{SAMBAPDCPROFILES}
    (ben"otigt SAMBA\_PDC)
    Sollen servergespeicherte Profile verwendet werden: 'yes' oder 'no'

        Bei Verwendung von

        \jumplabel{SAMBA\_PDC}{SAMBAPDC}='yes'

        kann man sein User-Profil auf dem Server speichern lassen und bei
        jeder Anmeldung wieder davon laden. Das bietet den Vorteil, auf allen
        Rechnern der Dom"ane die selbe Arbeitsumgebung vorzufinden, hat aber den
        Nachteil, dass je nach Umfang der Userprofile ziemlich viel Platz auf
        dem Server ben"otigt wird und An- oder Abmeldungen am Server l"anger
        dauern, da das Profil herunter- oder heraufgeladen werden muss.
        Wer diese Funktion nicht ben"otigt, kann sie mit

\begin{verbatim}
          SAMBA_PDC_PROFILES='no'
\end{verbatim}

        abschalten.

        Standardeinstellung: \texttt{SAMBA\_PDC\_PROFILES='yes'}


    \config{SAMBA\_PDC\_LOGONSCRIPT}{SAMBA\_PDC\_LOGONSCRIPT}{SAMBAPDCLOGONSCRIPT}
    (ben"otigt SAMBA\_PDC)
    Basieren die Logon-Skripte auf 'user', 'group', 'machine' oder 'all'

        Bei Verwendung von

        \jumplabel{SAMBA\_PDC}{SAMBAPDC}='yes'

        k"onnen im Verzeichnis /netlogon Batchdateien abgelegt werden, die
        nach erfolgreicher Anmeldung an der Dom"ane auf den Client geladen
        und in der dortigen Umgebung verarbeitet werden.
        Die Batchdateien sollten auf einem Windows-Client angelegt und auch
        dort getestet werden, um Probleme mit den unterschiedlichen
        Zeilenenden von DOS und Unix auszuschliessen.

        Je nach Einstellung dieses Parameters werden unterschiedlich
        benannte Batchdateien erwartet:

        W"ahlt man SAMBA\_PDC\_LOGONSCRIPT='user', so wird nach der Datei
        username.bat gesucht, wobei \glqq{}username\grqq{} f"ur den Namen des
        angemeldeten Benutzers steht. Es ist der effektive Name des Benutzers
        gemeint, bei gemappten Benutzern also der Name, auf den gemappt wird.
        An diese Batchdatei wird der Gruppenname des angemeldeten Users
        sowie der NETBIOS-Name der Anmeldemaschine mit "ubergeben und kann
        dort weiter ausgewertet werden, z.B. um aus der Batchdatei des Users
        mittels

\begin{verbatim}
          call %1.bat
\end{verbatim}

        eine gruppenabh"angige Batchdatei aufzurufen, die f"ur alle
        Mitglieder einer Gruppe ein Netzlaufwerk mappt.
        Aus der Batchdatei des Users kann ausserdem mittels

\begin{verbatim}
          call %2.bat
\end{verbatim}

        eine weitere Batchdatei mit dem NETBIOS-Namen des Clients aufgerufen
        werden, an dem der User sich gerade anmeldet, um maschinenbezogene
        Aktionen auszuf"uhren.

        W"ahlt man SAMBA\_PDC\_LOGONSCRIPT='group', so wird nach der Datei
        groupname.bat gesucht, wobei \glqq{}groupname\grqq{} f"ur den
        Gruppennamen des angemeldeten Benutzers steht. Es ist die effektive
        Gruppe gemeint, bei gemappten Usern also die prim"are Gruppe des
        Users, auf den gemappt wird.
        An diese Batchdatei wird der Username des angemeldeten Users
        sowie der NETBIOS-Name der angemeldeten Maschine mit "ubergeben und kann
        dort weiter ausgewertet werden, z.B. um aus der Batchdatei der Gruppe
        mittels

\begin{verbatim}
          call %1.bat
\end{verbatim}

        eine userabh"angige Batchdatei aufzurufen, die spezielle Aktionen
        f"ur diesen User ausf"uhrt.
        Aus der Batchdatei der Gruppe kann ausserdem mittels

\begin{verbatim}
          call %2.bat
\end{verbatim}

        eine weitere Batchdatei mit dem NETBIOS-Namen des Clients aufgerufen
        werden, an dem der User sich gerade anmeldet, um maschinenbezogene
        Aktionen auszuf"uhren.

        W"ahlt man SAMBA\_PDC\_LOGONSCRIPT='machine', so wird nach der Datei
        machinename.bat gesucht, wobei \glqq{}machinename\grqq{} f"ur den
        NETBIOS-Namen der Anmeldemaschine steht.
        An diese Batchdatei wird der effektive Username sowie der effektive
        Gruppenname des angemeldeten Users mit "ubergeben und kann dort weiter
        ausgewertet werden, z.B. um aus der Batchdatei der Maschine
        mittels

\begin{verbatim}
          call %1.bat
\end{verbatim}

        eine userabh"angige Batchdatei aufzurufen, die spezielle Aktionen
        f"ur diesen User ausf"uhrt.
        Aus der Batchdatei der Maschine kann ausserdem mittels

\begin{verbatim}
          call %2.bat
\end{verbatim}

        eine weitere Batchdatei mit dem Gruppennamen des angemeldeten Users
        aufgerufen werden, um gruppenbezogene Aktionen auszuf"uhren.

        W"ahlt man SAMBA\_PDC\_LOGONSCRIPT='all', so wird nach der Datei
        logon.bat gesucht.
        An diese Batchdatei werden der effektive Username, der effektive
        Gruppenname des angemeldeten Users sowie der NETBIOS-Name der
        Anmeldemaschine mit "ubergeben und kann dort weiter ausgewertet
        werden, z.B. um aus der Batchdatei logon.bat mittels

\begin{verbatim}
          call %1.bat
\end{verbatim}

        eine userabh"angige Batchdatei aufzurufen, die spezielle Aktionen
        f"ur diesen User ausf"uhrt.
        Mittels

\begin{verbatim}
          call %2.bat
\end{verbatim}

        kann man aus der logon.bat die gruppenabh"angige Batchdatei aufrufen
        und mit

\begin{verbatim}
          call %3.bat
\end{verbatim}

        die maschinenspezifische Batchdatei.
        In allen 3 F"allen lassen sich beliebig komplexe Szenarien realisieren,
        wenn man sich ein wenig mit Batchprogrammierung auskennt.
        Bitte recherchiert bei Interesse im Internet - ich bin in dem Fall
        der falsche Ansprechpartner f"ur Euch. Aber um Euch den Einstieg zu
        erleichtern, liegt eine Beispieldatei namens logon.bat im
        Verzeichnis /netlogon, die Ihr anpassen und unter dem erwarteten
        Namen abspeichern k"onnt.

        Noch einmal der Hinweis:
        Bearbeitet die Dateien auf einem Windows-Client, denn Zeilenenden im
        Unix-Format f"uhren dazu, dass die Logon-Skripte nicht verarbeitet
        werden k"onnen! Die Rechte der Batchdateien m"ussen nat"urlich so
        gesetzt werden, dass sie einen Zugriff (Lesen, Ausf"uhren) gestatten.

        Standardeinstellung: \texttt{SAMBA\_PDC\_LOGONSCRIPT='user'}


    \config{SAMBA\_PASSWORD\_SERVER}{SAMBA\_PASSWORD\_SERVER}{SAMBAPASSWORDSERVER}
    Nutzung eines externen Dom"anen-Passwort-Servers: z.B. 'NT-SERVER'

        "Uber SAMBA\_PASSWORD\_SERVER kann der NETBIOS-Name eines externen
        Passwortservers eingetragen werden, der die Authentifizierung
        "ubernimmt. Dazu wird ein Primary Domain Controller auf Basis von
        Windows NT 4.0 oder h"oher oder ein eisfair{} mit Samba als PDC
        genutzt. Dazu muss der eisfair{}-Client aber erst einmal Mitglied
        dieser Dom"ane werden.

        Das passiert in 2 Schritten:
        Als erstes wird auf dem Primary Domain Controller eisfair{} mit
        dem Server Manager unter dem Men"u-Punkt

\begin{verbatim}
          Computer
          Neuer Computer
\end{verbatim}

        hinzugef"ugt. Dann wird mit dem Men"u-Punkt

\begin{verbatim}
          Samba Domain Handling
          Add eisfair Samba Server into an Windows NT Domain
\end{verbatim}

        im Samba-Service-Men"u (siehe Dokumentation weiter unten) eisfair{}
        in die NT-Dom"ane integriert.

        In diesem Fall kann man mehrere Namen hinterlegen, z.B. den
        Primary Domain Controller und einen oder mehrere Backup Domain Controller
        (BDC). Dazu tr"agt man die Namen mit Komma und Leerzeichen getrennt
        hintereinander ein, z.B.:

\begin{verbatim}
          SAMBA_PASSWORD_SERVER='NT-PDC, NT-BDC1'
\end{verbatim}

        Es ist auch m"oglich, hier einfach

\begin{verbatim}
          SAMBA_PASSWORD_SERVER='*'
\end{verbatim}

        einzusetzen. Damit werden von Samba der PDC und die BDC's
        selbstst"andig ermittelt.

        Noch ein paar Hinweise und Warnungen:
        Tragt niemals den NETBIOS-Namen von eisfair{} selbst hier ein, da dann
        versucht wird, gegen einen Domain Controller auf eisfair{} zu
        authentifizieren, der hier gar nicht l"auft!
        Tragt nur einen Passwortserver ein, dem Ihr absolut vertraut, denn Samba
        ist in diesem Fall nur so sicher, wie der externe Passwortserver!

        L"auft ein Samba im Netz mit 4.9.x als PDC und l"auft ein anderer
        Rechner mit Samba 4.9.x als Member-Server (SAMBA\_PASSWORD\_SERVER ist
        nicht leer) und man m"ochte auf die Freigaben des Member-Servers von
        einem Windows-Rechner zugreifen, der nicht in die Dom"ane integriert
        wurde, kann man sich nicht mehr wie bisher m"oglich mit Benutzer und
        Passwort authentifizieren, sondern man muss zwingend

\begin{verbatim}
          Domaene\Benutzer
\end{verbatim}

        und Passwort verwenden.
        Da die User auf dem externen Passwortserver authentifiziert werden,
        darf kein lokaler Unix-Account auf eisfair{}-Client f"ur sie
        existieren. Die lokalen User werden jetzt vom Dienst winbindd auf dem
        auf eisfair{}-Client verf"ugbar gemacht.

        Hatte jemand vorher (vor Samba 4.9.x) schon SAMBA\_PASSWORD\_SERVER
        gesetzt, wurden erfolgreich authentifizierte User automatisch als
        System-User angelegt. Das muss man nun r"uckg"angig machen:

        Zuerst m"ussen die von solcherart angelegten System-Usern abgelegten
        Dateien den Usern auf dem PDC "ubereignet werden. Dann sollten diese
        System-User auf dem Member-Server gel"oscht werden.
        Alle folgenden Informationen beziehen sich jeweils auf den Member-Server:

        Anzeige der Samba-User:

\begin{verbatim}
          pdbedit -Lw | grep -v "^.*$:" | sort -t: -k2n
\end{verbatim}

        Hier darf keine Ausgabe mehr erfolgen, wenn alles bereinigt wurde!

        Anzeige der durch "altere Versionen automatisch angelegten System-User:

\begin{verbatim}
          getent passwd | grep 'samba_auto_user'
\end{verbatim}

        Hier darf keine Ausgabe mehr erfolgen, wenn alles bereinigt wurde!

        Anzeige der Samba-User des PDC (SAMBA\_PASSWORD\_SERVER):

\begin{verbatim}
          wbinfo -u
\end{verbatim}

        Anzeige der Dom"anengruppen des PDC (SAMBA\_PASSWORD\_SERVER):

\begin{verbatim}
          wbinfo -g
\end{verbatim}

        Anzeige der Informationen eines spezifischen Users des PDC
        (SAMBA\_PASSWORD\_SERVER):

\begin{verbatim}
          getent passwd DOMAENE\\USERNAME
\end{verbatim}

        Standardeinstellung: \texttt{SAMBA\_PASSWORD\_SERVER=''}


    \config{SAMBA\_RECYCLE\_BIN}{SAMBA\_RECYCLE\_BIN}{SAMBARECYCLEBIN}
    Aktiviere einen Papierkorb pro Freigabe: 'yes' oder 'no'

        Hiermit kann ein Papierkorb pro Freigabe aktiviert werden, in
        den gel"oschte Dateien mitsamt ihrem Pfad relativ zum Freigabepfad
        verschoben werden.
        Der Papierkorb ist ein Verzeichnis namens samba\_recycle\_bin, das
        durch die Samba-Konfiguration mit den Rechten 0777 nobody:nogroup
        angelegt wird. Wenn jemand dieses Verzeichnis l"oscht, wird es beim
        L"oschen von Dateien oder Verzeichnissen mit den Rechten 0777 und
        dem Eigent"umer und der Gruppe des l"oschenden Users erneut angelegt.
        In diesem Verzeichnis samba\_recycle\_bin wird f"ur jeden effektiven
        User beim L"oschen ein Unterverzeichnis mit dessen Namen angelegt.
        Wer effektiver User ist, wird unter anderem durch das Usermapping
        und

        \jumplabel{SAMBA\_SHARE\_x\_FORCE\_USER}{SAMBASHARExFORCEUSER}

        bestimmt.

\achtung{
        Aus mehreren Gr"unden muss ich vor Aktivierung dieser Funktion warnen.
        Der Papierkorb f"ur Freigaben hat nicht die Eigenschaften des von
        Windows bekannten Papierkorbes. Er weiss nichts von dem auf der
        Festplatte noch zur Verf"ugung stehenden Platz und kann im Gegensatz
        zum Windows-Papierkorb nicht auf eine maximale Gr"osse in Prozent
        anteilig der Festplattengr"osse eingestellt werden.
        Er hat daher auch keine Funktion, die durch endg"ultiges L"oschen
        von Elementen im Papierkorb automatisch so viel Speicherplatz
        freigibt, dass die zuletzt gel"oschten Dateien und Ordner in den
        Papierkorb verschoben werden k"onnten.
        Gel"oschte Dateien werden lediglich anhand Ihres Alters mittels
        Cron-Jobs endg"ultig gel"oscht, wobei mit

        \jumplabel{SAMBA\_RECYCLE\_BIN\_HOLD\_DAYS}{SAMBARECYCLEBINHOLDDAYS}

        die Anzahl von Tagen bestimmt wird, nach der endg"ultig gel"oscht
        wird. Dieser Cron-Job l"auft nachts um 03:15 Uhr, um den Server
        tags"uber mit dem zeitintensiven und leistungshungrigen find-Skript
        nicht so stark zu belasten. F"ahrt jemand seinen Server jeden Abend
        vor diesem Zeitpunkt herunter, werden alte Dateien nie gel"oscht
        und die Festplatte l"auft im Laufe der Zeit voll. Um das zu
        verhindern, muss das Skript /var/install/bin/samba-recycle-cron
        ab und an von Hand gestartet oder in der Cron Administration
        ein Job mit passendem Zeitpunkt angelegt werden.
        Bei Einsatz von Quotas f"uhrt ein L"oschen von Dateien mit aktiviertem
        Papierkorb nicht mehr automatisch dazu, dass Platz freigemacht wird.
        Jeder User muss Dateien in den einzelnen Papierk"orben der Freigaben
        noch einmal l"oschen, um seine Quota wieder zu unterschreiten.
}

        Generell gilt also:
        Aktiviert den Papierkorb nur, wenn Ihr ausreichend Platz auf allen
        Partitionen habt, Quotas nicht einsetzt und Euer Server permanent
        l"auft.

        Standardeinstellung: \texttt{SAMBA\_RECYCLE\_BIN='no'}


    \config{SAMBA\_RECYCLE\_BIN\_HOLD\_DAYS}{SAMBA\_RECYCLE\_BIN\_HOLD\_DAYS}{SAMBARECYCLEBINHOLDDAYS}
    (ben"otigt SAMBA\_RECYCLE\_BIN='yes')

    Anzahl von Tagen, nach der Dateien im Papierkorb gel"oscht werden

        Hiermit kann eine Anzahl von Tagen eingestellt werden, nach der
        Dateien in den Papierk"orben der Freigaben als veraltet gelten und
        durch ein nachts um 03:15 Uhr laufendes Cron-Skript gel"oscht werden.
        L"auft der Server zu diesem Zeitpunkt nicht, sollte man den Papierkorb
        abschalten oder das Skript

\begin{verbatim}
          /var/install/bin/samba-recycle-cron
\end{verbatim}

        nach Bedarf von Hand starten oder in der Cron Administration
        einen Job mit passendem Zeitpunkt anlegen.
        In der Standardeinstellung gelten Dateien in den Papierk"orben
        nach 7 Tagen als veraltet und werden durch das Cron-Skript
        gel"oscht.
        Die je nach Eurer Konfiguration "uber das Dateisystem verstreuten
        Papierkorb-Verzeichnisse k"onnen mit folgendem Befehl angezeigt
        werden:

\begin{verbatim}
          find / -path '/proc' -prune -o -name samba_recycle_bin -type d \
          -print
\end{verbatim}

        Wenn die Notwendigkeit besteht, alle Papierk"orbe mitsamt Inhalt
        zu l"oschen und Ihr Euch mit dem vorigen Befehl versichert habt, dass
        auch wirklich nur die gew"unschten Papierk"orbe von dem find-Befehl
        erfasst werden, l"oscht folgender Befehl unwiederbringlich (achtet
        unbedingt darauf, keine wichtigen Dateien oder Verzeichnisse zu
        verlieren!):

\begin{verbatim}
          find / -path '/proc' -prune -o -name samba_recycle_bin -type d \
          -print -exec rm -rf {} \; 2>/dev/null
\end{verbatim}

        Standardeinstellung: \texttt{SAMBA\_RECYCLE\_BIN\_HOLD\_DAYS='7'}


    \config{SAMBA\_PDF\_TARGET}{SAMBA\_PDF\_TARGET}{SAMBAPDFTARGET}
    Das Ziel f"ur erzeugte PDF-Dateien:

        Es gibt drei m"ogliche Ziele f"ur durch PDF-Drucker erzeugte
        PDF-Dateien, welche jeweils global, also f"ur alle PDF-Drucker gelten:

\begin{enumerate}

        \item
        Die Dateien werden im Home-Verzeichnis des druckenden Users abgelegt.
        Dazu ist 'homedir' einzutragen:

\begin{verbatim}
          SAMBA_PDF_TARGET='homedir'
\end{verbatim}

        \item
        Die Dateien werden in dem f"ur alle erreichbaren Public-Verzeichnis
        abgelegt.
        Dazu ist 'public' einzutragen:

\begin{verbatim}
          SAMBA_PDF_TARGET='public'
\end{verbatim}

        Bei manueller Konfiguration mittels

        \jumplabel{SAMBA\_MANUAL\_CONFIGURATION}{SAMBAMANUALCONFIGURATION}='yes'

        muss dazu nat"urlich eine solche Freigabe definiert sein.
        Wenn man annimmt, dass die dritte Freigabe die Public-Freigabe
        sein soll, dann w"urde die Freigabe-Definition so aussehen:

\begin{verbatim}
          SAMBA_SHARE_3_ACTIVE='yes'
          SAMBA_SHARE_3_NAME='public'
          SAMBA_SHARE_3_COMMENT='public directory on %h'
          SAMBA_SHARE_3_RW='yes'
          SAMBA_SHARE_3_BROWSE='yes'
          SAMBA_SHARE_3_PATH='/public'
          SAMBA_SHARE_3_USER=''
          SAMBA_SHARE_3_PUBLIC='yes'
          SAMBA_SHARE_3_READ_LIST=''
          SAMBA_SHARE_3_WRITE_LIST=''
          SAMBA_SHARE_3_FORCE_CMODE='0777'
          SAMBA_SHARE_3_FORCE_DIRMODE='0777'
          SAMBA_SHARE_3_FORCE_USER=''
          SAMBA_SHARE_3_FORCE_GROUP=''
\end{verbatim}

        \item
        Die Dateien werden dem druckenden User per Mail geschickt.
        Dazu ist 'mail' einzutragen:

\begin{verbatim}
          SAMBA_PDF_TARGET='mail'
\end{verbatim}

        F"ur diesen Fall sind nat"urlich ein installierter und korrekt
        konfigurierter Mailserver, ein eingerichteter Mail-Account f"ur den
        druckenden User sowie das Perl-Paket perl\_mime\_base64 zur
        Erzeugung der Mail-Anh"ange notwendig.
        Achtet bei grossen Dateien auch auf die Gr"ossenbeschr"ankungen f"ur
        Mails, welche in der Mailserverkonfiguration vorgegeben sind!

\end{enumerate}

        Da nicht alle User intern einen Mailserver einsetzen und bei manueller
        Konfiguration nicht unbedingt eine Public-Freigabe vorausgesetzt
        werden kann, wurde 'homedir' als Voreinstellung festgelegt.

        Standardeinstellung: \texttt{SAMBA\_PDF\_TARGET='homedir'}


    \config{SAMBA\_SERVERSTRING}{SAMBA\_SERVERSTRING}{SAMBASERVERSTRING}
    Der Kommentar des Samba-Servers in der Netzwerkumgebung:

        Hier kann man eine Zeichenkette eingeben, die in der Netzwerkumgebung
        als Kommentar/Beschreibung des Servers erscheint. Damit kann man dem
        Samba-Server eine individuelle Note verleihen.
        Wenn die Variable nicht gef"ullt ist, wird kein Kommentar
        angezeigt.

        Standardeinstellung: \texttt{SAMBA\_SERVERSTRING=}


    \config{SAMBA\_EXPERT\_EXEC}{SAMBA\_EXPERT\_EXEC}{SAMBAEXPERTEXEC}
    "Ubernahme der im Paket sambaexpert definierten Optionen: 'yes' oder 'no'

        Wenn diese Variable auf 'yes' gesetzt ist, werden die im zus"atzlichen
        Paket sambaexpert definierten Optionen in die Datei /etc/smb.conf
        "ubernommen, wobei gleichnamige Variablen "uberschrieben bzw.
        neue Variablen hinzugef"ugt werden.
        Das kommt denjenigen entgegen, die einzelne Parameter der
        Samba-Konfigurationsdatei direkt ver"andern wollen oder m"ussen,
        weil mein Paket nicht jede erdenkliche Konfiguration unterst"utzen
        kann und will.
        Dazu ist es erforderlich, dass das Paket sambaexpert korrekt
        installiert wurde und die gew"unschten Optionen vor dem Editieren der
        Samba-Konfiguration vorgenommen wurden.
        Da bei diesem Vorgang direkte Ver"anderungen in der Datei /etc/smb.conf
        vorgenommen werden und ich Fehler des Anwenders so nicht abfangen kann,
        werde ich niemandem Fragen zu daraus resultierenden Problemen
        beantworten. Bei Problemen ist es in jedem Fall ratsam, diese
        Option zu deaktivieren und zu "uberpr"ufen, ob der Fehler immer noch
        auftritt.
        Damit keiner vergisst, dass er sich ein potentielles Problem durch
        selbst definierte Parameter einhandelt, wird man mittels einer
        Meldung auf den Umstand hingewiesen, dass diese Option aktiviert ist.

        Noch einmal:
        Ich werde niemanden supporten, der diese Option setzt und Fragen dazu
        stillschweigend ignorieren.

        Standardeinstellung: \texttt{SAMBA\_EXPERT\_EXEC='no'}


    \config{SAMBA\_SMBWEBCLIENT}{SAMBA\_SMBWEBCLIENT}{SAMBASMBWEBCLIENT}
    (ben"otigt Apache und PHP)
    Installiere das PHP-Skript smbwebclient.php: 'yes' oder 'no'

        Durch Setzen des Parameters SAMBA\_SMBWEBCLIENT='yes' wird das PHP-Skript
        smbwebclient.php in das mit dem Parameter
        \jumplabel{SAMBA\_SMBWEBCLIENT\_PATH}{SAMBASMBWEBCLIENTPATH} definierte
        Verzeichnis kopiert (Default: /var/www/htdocs).

        Sinn des SMB-Webclients ist es, "uber einen Web-Browser Zugriff auf
        Samba-Ressourcen zu erlangen. So k"onnen Rechner, die keinen SMB-Client
        mitbringen oder sich in Netzen befinden, aus denen man keinen direkten
        Zugriff auf Samba zulassen m"ochte, trotzdem auf Freigaben zugreifen.

        Hier ein dicker Hinweis zu den m"oglichen Sicherheitsrisiken:

        Fehler in Apache-, PHP- oder Samba-Funktionen k"onnen zu ungewollten
        Zugriffen bis hin zur "Ubernahme des Servers f"uhren! Bei Bekanntwerden
        von Sicherheitsl"ucken in einer der 3 beteiligten Komponenten sollte man
        diese Zugriffsm"oglichkeit sofort deaktivieren.
        Eine weitere Gefahr stellen manuelle "Anderungen in den Dateien
        smbwebclient.php oder smb.conf dar. Auch mittels sambaexpert ist es z.B.
        m"oglich, unauthorisierten Zugriff auf Samba zu erm"oglichen. Daher
        sollten solche "Anderungen nur vorgenommen werden, wenn man sich "uber
        die Folgen im klaren und bereit ist, auftretende Schwierigkeiten
        allein zu meistern.

        Eine zus"atzliche Absicherungsm"oglichkeit bietet eine .htaccess-Datei
        "uber die Apache-Konfiguration. Leider kommt es durch die doppelte
        Abfrage von Benutzername und Passwort anscheinend zu Schwierigkeiten.
        Bei der Beseitigung dieser Schwierigkeiten kann ich nicht helfen, da ich
        weder Apache- noch PHP-Profi bin.
        Ich bitte deshalb, bei Fehlern oder Fragen bez"uglich smbwebclient.php
        folgende E-Mail-Adresse des Entwicklers des PHP-Skriptes zu benutzen:

        (E-MAIL \kmail{vmvarela@gmail.com})

        Die Homepage des Projektes befindet sich hier:

        \url{http://smbwebclient.sourceforge.net}

        Der SMB-Webclient besteht aus einem PHP-Script (smbwebclient.php), daher
        sind Apache und PHP Voraussetzung zum Einsatz des Clients. Weiterhin
        muss auf dem Rechner, auf dem das Script l"auft, ein 'echter' SMB-Client
        installiert sein, was durch mein installiertes Samba-Paket gegeben ist.
        Hilfreich ist, wenn man sich bereits grundlegend mit der
        Samba-/Apache-Konfiguration und mit der Rechte-Vergabe unter Linux
        besch"aftigt hat. Wenn nicht, ist der SMB-Webclient die Gelegenheit, dies
        endlich nachzuholen ;-)

        Der SMB-Webclient kann durch Aufruf von

\begin{verbatim}
          http://Name-des-eisfair-Servers/smbwebclient.php
\end{verbatim}

        im Browser gestartet werden, wobei Name-des-eisfair-Servers nat"urlich
        durch den Namen Eures eisfair{}-Servers bzw. dessen IP-Adresse ersetzt
        werden muss.
        Zun"achst wird hier die Anmeldung mittels einer in Samba definierten
        Benutzer-ID/Kennwort-Kombination verlangt.

        Nach erfolgreicher Anmeldung erscheint im Browser eine Liste mit den
        Freigaben, die dieser Server "uber Samba zur Verf"ugung stellt. Klickt man
        auf den Namen einer Freigabe, wird im Browser das Hauptverzeichnis
        dieser Freigabe angezeigt.
        Unterverzeichnisse und Dateien werden mit verschiedenen Symbolen
        "ahnlich denen des Explorers unter Windows dargestellt.
        In weiteren Spalten werden die Dateigr"osse, der Typ (Datei/Verzeichnis)
        und das Datum der letzen "Anderung angezeigt. Ein Klick auf ein
        Verzeichnis wechselt in dieses, ein Klick auf eine Datei l"adt diese
        herunter. Hinter dem Klappmen"u in der ersten Zeile des Browsers
        verbergen sich die Funktionen zum Erstellen eines neuen Verzeichnises
        (Neuer Ordner), zum Hochladen einer Datei (Neue Datei (hochladen)) und
        zum L"oschen der Dateien oder Verzeichnisse (Markierte Datei(en) l"oschen),
        die "uber die Checkbox jeweils links ausgew"ahlt wurden.
        Weitere Details der Funktionen sind selbsterkl"arend und von jedem, der
        einen Browser bedienen kann, zu beherrschen.

        Die Freigaben, auf die man zugreifen m"ochte, m"ussen im Setup des
        Samba-Paketes so konfiguriert sein, als solle der Benutzer, mit dem man
        sich angemeldet hat, z.B. von einem Windows-Rechner aus zugreifen.

        Durch das Samba-Setup wird smbwebclient.php so konfiguriert, dass alle
        Samba-Freigaben des eisfair{}-Servers sichtbar sind. Das l"asst sich durch
        eine "Anderung der Zeile

\begin{verbatim}
          var $cfgSambaRoot =
\end{verbatim}

        in smbwebclient.php "andern:

\begin{verbatim}
          var $cfgSambaRoot = 'domain/server/share';
\end{verbatim}

        Damit ist nur die einzelne Freigabe 'share' des Servers 'server' in der
        Domain 'domain' sichtbar.

        Beim Hochladen von Dateien ist zu beachten, dass die maximale Dateigr"osse
        von Dateien, die hochgeladen werden k"onnen, von zwei Parametern in der
        PHP-Konfiguration des Apache-Webservers abh"angt:

\begin{verbatim}
          Bei Verwendung von Apache1/PHP4:
          PHP_MAX_POST_SIZE='8M'
          PHP_MAX_UPLOAD_FILESIZE='8M'

          Bei Verwendung von Apache2/PHP5:
          PHP5_MAX_POST_SIZE='8M'
          PHP5_MAX_UPLOAD_FILESIZE='8M'
\end{verbatim}

        Hier sind also jeweils Uploads von bis zu 8Mbyte pro Datei m"oglich.
        In Tests stellte sich heraus, dass beim Hochladen von Dateien durch
        smbwebclient ab ca. 200MB selbst im lokalen Netz Performanceprobleme
        auftreten k"onnen. Dies kann sich je nach Leistungsf"ahigkeit der
        verwendeten Hardware unterscheiden.
        Wenn jemand etwas Anderes ertestet hat oder Abhilfe weiss, m"oge er sich
        bei mir melden.

        Standardeinstellung: \texttt{SAMBA\_SMBWEBCLIENT='no'}


    \config{SAMBA\_SMBWEBCLIENT\_PATH}{SAMBA\_SMBWEBCLIENT\_PATH}{SAMBASMBWEBCLIENTPATH}
    Installationspfad des PHP-Skriptes smbwebclient.php

        In diesen Pfad wird smbwebclient.php installiert. Der Pfad muss
        existieren und ein g"ultiges document-root von Apache sein.
        Aus Sicherheitsgr"unden werden die smbwebclient-Aufrufe auf das sichere
        https umgebogen. Das funktioniert leider nur sauber, wenn der Pfad
        /var/www/htdocs verwendet wird, SSL in Apache aktiviert ist und ein
        g"ultiges Zertifikat erstellt wurde.
        Bei Schwierigkeiten sollten diese Dinge "uberpr"uft werden.

        Standardeinstellung: \texttt{SAMBA\_SMBWEBCLIENT\_PATH='/var/www/htdocs'}


    \config{SAMBA\_OPLOCKS}{SAMBA\_OPLOCKS}{SAMBAOPLOCKS}
    Aktiviere Oplocking: 'yes' oder 'no'

        Durch Setzen von SAMBA\_OPLOCKS='yes' aktiviert man das clientseitige
        Zwischenspeichern von Dateien. Diese Option kann zu einem erheblichen
        Performancegewinn - aber auch zu dem genauen Gegenteil f"uhren.
        Eine genaue Betrachtung zu Vorteilen, Nachteilen und Risiken ist hier
        zu finden:

    \url{http://gertranssmb3.berlios.de/output/locking.html\#id2540840}
    \url{http://us1.samba.org/samba/docs/man/Samba3-HOWTO/locking.html\#id377839}

        Bisher war in den eisfair{}-Samba-Paketen das opportunistische Locking
        komplett deaktiviert. Mit SAMBA\_OPLOCKS='yes' wird das opportunistische
        Locking f"ur unkritische Dateien aktiviert. Problematische Dateien
        werden anhand ihrer Endungen ausgefiltert.

        Vom Oplocking ausgeschlossen sind Dateien nach folgendem Muster:

\begin{verbatim}
          /*.bak/*.cd*/*.cur/*.*db/*.db*/*.*dx/*.dxf/*.dwg/*.doc/
          /*.fpt/*.igs/*.ia*/*.id*/*.in*/*.ip*/*.log/*.mpp/*.ndx/
          /*.ntx/*.opt/*.ord/*.ppt/*.pst/*.qb*/*.sjb/*.sbs/*.slp/
          /*.st*/*.vsd/*.xl*/
\end{verbatim}

        Bei Schwierigkeiten oder sogar Datenverlusten ist diese Option
        mittels SAMBA\_OPLOCKS='no' zu deaktivieren!

        Standardeinstellung: \texttt{SAMBA\_OPLOCKS='no'}


    \config{SAMBA\_ACL\_XATTR}{SAMBA\_ACL\_XATTR}{SAMBAACLXATTR}
    Aktiviere das Modul acl\_xattr: 'yes' oder 'no'

        Achtung!
        Nur bei komplett neuen Installationen mit leeren Freigaben verwenden!

        Durch Setzen von SAMBA\_ACL\_XATTR='yes' aktiviert man das VFS-Modul
        acl\_xattr. Dieses Modul erlaubt eine genauere Abbildung der unter
        Windows verf"ugbaren Rechte mit Samba.

        Das Modul speichert die NTFS Access Control Lists (ACLs) in EAs
        (extended attributes). Dazu muss das darunter liegende Dateisystem EAs
        unterst"utzen und entsprechend gemountet sein.
        Die ACLs werden im EA security.NTACL der Datei oder des Verzeichnisses
        gespeichert. Dieses Attribut wird mittels

\begin{verbatim}
          getfattr -d filename
\end{verbatim}

        nicht angezeigt. Um sich den Inhalt anzeigen zu lassen, muss der Name
        explizit angegeben werden:

\begin{verbatim}
          getfattr -n security.NTACL filename
\end{verbatim}

        Dieses Modul setzt automatisch folgende Parameter:

\begin{verbatim}
          inherit acls = true
          dos filemode = true
          force unknown acl user = true
\end{verbatim}

        Unter eisfair wird ausserdem der Default von

\begin{verbatim}
          acl_xattr:ignore system acls = no
\end{verbatim}

        verwendet, der das Setzen und Verarbeiten sowohl der Windows- als
        auch der System-ACLs erlaubt. Zus"atzlich wird mit dem Default

\begin{verbatim}
          acl_xattr:default acl style = posix
\end{verbatim}

        gearbeitet, welcher basierend auf den System-ACLs f"ur User, Gruppe,
        und Alle eine Windows-ACL generiert, wenn die Datei oder das
        Verzeichnis noch keine security.NTACL besitzt.

        Wenn Ihr SAMBA\_ACL\_XATTR setzt, verwendet folgende Optionen in
        Freigaben nicht mehr:

        \jumplabel{SAMBA\_SHARE\_x\_READ\_LIST}{SAMBASHARExREADLIST}
        \jumplabel{SAMBA\_SHARE\_x\_WRITE\_LIST}{SAMBASHARExWRITELIST}
        \jumplabel{SAMBA\_SHARE\_x\_FORCE\_CMODE}{SAMBASHARExFORCECMODE}
        \jumplabel{SAMBA\_SHARE\_x\_FORCE\_DIRMODE}{SAMBASHARExFORCEDIRMODE}
        \jumplabel{SAMBA\_SHARE\_x\_FORCE\_USER}{SAMBASHARExFORCEUSER}
        \jumplabel{SAMBA\_SHARE\_x\_FORCE\_GROUP}{SAMBASHARExFORCEGROUP}

        Alle Manipulationen der Zugriffsrechte m"ussen mit Windows-Tools
        erfolgen! Lest dazu

        \url{https://wiki.samba.org/index.php/Setting_up_a_Share_Using_Windows_ACLs}

        Standardeinstellung: \texttt{SAMBA\_ACL\_XATTR='no'}


\end{description}


\subparagraph{Abschnitt \glqq{}Samba Advanced Configuration/User Mapping\grqq{}:}
%------------------------------------------------------

Der Abschnitt beginnt mit

\begin{verbatim}
#------------------------------------------------------------------------------
# Samba Advanced Configuration/User Mapping
#
#  ********************************* ATTENTION ******************************
#  *                                                                        *
#  *                The following Sections only have an Effect,             *
#  *                if you set SAMBA_MANUAL_CONFIGURATION='yes'             *
#  *                                                                        *
#  ******************************** ATTENTION *******************************
#
# Definition of User Mappings
#
# Set the number of Samba Usermap to create in SAMBA_USERMAP_N.
#
# Values below are only an example and are not used if
# SAMBA_USERMAP_N is '0'
#-----------------------------------------------------------------------------
\end{verbatim}

\achtung{
Die Angaben in diesem Abschnitt haben nur eine Wirkung, wenn

\jumplabel{SAMBA\_MANUAL\_CONFIGURATION}{SAMBAMANUALCONFIGURATION}='yes'

gesetzt wird!
}

In diesem Abschnitt werden Windows-Usernamen auf eisfair{}-Usernamen gemappt.
Das ist notwendig, wenn auf Windows-Seite Anmeldenamen mit Leerzeichen oder
Sonderzeichen verwendet werden. Mit solchen Usernamen kann eisfair{} nichts
anfangen, deshalb m"ussen diese Windows-Namen auf konforme eisfair{}-Usernamen
gemappt werden.
Es ist ausserdem empfehlenswert, System-User und Samba-User nur in
Kleinbuchstaben anzulegen!

Die Umsetzung der Namen wird in der Datei

\begin{verbatim}
   /etc/user.map
\end{verbatim}

vorgenommen, die aus diesem Abschnitt der Konfiguration erzeugt wird.
Die Kommentare in der Datei mit dem \# am Anfang verdeutlichen den Aufbau:

Rechts stehen einer oder mehrere Windows-Anmeldenamen mit oder ohne
Leerzeichen, links steht ein Samba-Benutzername.

\begin{verbatim}
   root = "Administrator"
\end{verbatim}

Wenn gegen einen externen Passwortserver authentifziert wird, steht vor den
Windows-Anmeldenamen ausserdem der Name der Dom"ane:

\begin{verbatim}
   root = "DOM\Administrator"
\end{verbatim}

Der Windows-Anmeldename \glqq{}Administrator\grqq{} wird hier auf den
Samba-Benutzer \glqq{}root\grqq{} umgesetzt. Es ist deswegen nicht notwendig
(und sogar falsch), \glqq{}Administrator\grqq{} als Samba-Benutzer anzulegen.
\glqq{}root\grqq{} hingegen muss als Samba-User angelegt worden sein, da dessen
Samba-Passwort zur "Uberpr"ufung herangezogen wird, wenn man sich vom Client aus
als \glqq{}Administrator\grqq{} einloggt.

Beispiel:
Wenn auf einem Client ein Windows-Anmeldename \glqq{}Jim Knopf\grqq{} existiert
und mit diesem User auf Samba-Freigaben zugegriffen werden soll, so muss ein
eisfair{}-User und Samba-User eingerichtet werden, der den Unix-Konventionen
gehorcht und kein Leerzeichen beinhaltet. In diesem Beispiel entscheiden wir uns
f"ur den eisfair{}-Namen \glqq{}jimknopf\grqq{}.
Dieser User wird wie "ublich als normaler eisfair{}-User und Samba-User
eingerichtet. Per Usermapping muss Samba nun noch mitgeteilt werden, dass
Anmeldeversuche des Windows-Users \glqq{}Jim Knopf\grqq{} auf den eisfair{}-User
und Samba-User \glqq{}jimknopf\grqq{} umgebogen werden sollen.
Das zeigt das zweite Mapping der Beispielkonfiguration.

Achtung!
Es muss in jedem Fall ein Mapping von \glqq{}Administrator\grqq{} auf \glqq{}root\grqq{}
durchgef"uhrt werden!
Wenn Ihr weitere Windows-User auf \glqq{}root\grqq{} mappen wollt, m"usst Ihr
dieses Beispiel erweitern. Dabei ist es wichtig, dass die Erweiterungen unter
der bisherigen Definition erfolgen, also in etwa so:

\begin{verbatim}
   SAMBA_USERMAP_1_ACTIVE='yes'
   SAMBA_USERMAP_1_EISNAME='root'
   SAMBA_USERMAP_1_WINNAME_N='2'
   SAMBA_USERMAP_1_WINNAME_1='Administrator'
   SAMBA_USERMAP_1_WINNAME_2='xyz'
\end{verbatim}

Das heisst, die Reihenfolge \glqq{}Administrator\grqq{} und dann erst alle
anderen User muss erhalten bleiben!
Wenn gegen einen externen Passwortserver authentifiziert wird, wird automatisch
in /etc/user.map der Name der Dom"ane vor die Windows-Usernamen gesetzt.

\begin{description}
    \config{SAMBA\_USERMAP\_N}{SAMBA\_USERMAP\_N}{SAMBAUSERMAPN}
    Erstellung einer bestimmten Anzahl von Usermappings: z.B. '2'

        "Uber SAMBA\_USERMAP\_N wird die Anzahl der zu erstellenden bzw. zu
        benutzenden Usermappings eingestellt. Bei einem Mapping ist eine '1'
        anzugeben, bei zwei Mappings eine '2' usw.

        Wird hier eine 2 eingegeben, m"ussen mindestens die folgenden Variablen

\begin{verbatim}
          SAMBA_USERMAP_1_ACTIVE
          SAMBA_USERMAP_1_EISNAME
          SAMBA_USERMAP_1_WINNAME_N
          SAMBA_USERMAP_1_WINNAME_1
\end{verbatim}

        und

\begin{verbatim}
          SAMBA_USERMAP_2_ACTIVE
          SAMBA_USERMAP_2_EISNAME
          SAMBA_USERMAP_2_WINNAME_N
          SAMBA_USERMAP_2_WINNAME_1
\end{verbatim}

        existieren und sinnvoll gef"ullt werden, wobei die Anzahl zu mappenden
        Windows-Namen variabel ist.

        Standardeinstellung: \texttt{SAMBA\_USERMAP\_N='2'}


    \config{SAMBA\_USERMAP\_x\_ACTIVE}{SAMBA\_USERMAP\_x\_ACTIVE}{SAMBAUSERMAPxACTIVE}
    Soll das Mapping aktiv sein: 'yes' oder 'no'

        Mit SAMBA\_USERMAP\_x\_ACTIVE wird bestimmt, ob ein Mapping
        aktiv ist oder nicht.
        M"ochte man ein Mapping vor"ubergehend deaktivieren, so setzt man
        die Variable auf 'no'.

        Standardeinstellung: \texttt{SAMBA\_USERMAP\_1\_ACTIVE='yes'}


    \config{SAMBA\_USERMAP\_x\_EISNAME}{SAMBA\_USERMAP\_x\_EISNAME}{SAMBAUSERMAPxEISNAME}
        Mit SAMBA\_USERMAP\_x\_EISNAME wird der Name des x'ten eisfair{}-Users
        eingestellt, auf den gemappt werden soll. Dieser Name muss schon als
        eisfair{}- und Samba-User existieren, vorher also angelegt worden sein.

        Standardeinstellung: \texttt{SAMBA\_USERMAP\_1\_EISNAME='root'}


    \config{SAMBA\_USERMAP\_x\_WINNAME\_N}{SAMBA\_USERMAP\_x\_WINNAME\_N}{SAMBAUSERMAPxWINNAMEN}
        Mit SAMBA\_USERMAP\_x\_WINNAME\_N wird eingestellt, wie viele
        Windows-Usernamen auf den x'ten eisfair{}-User gemappt werden sollen.
        Mitunter macht es Sinn, mehrere Windows-User auf einen eisfair{}-User
        umsetzen zu lassen. Dazu legt man hier die Anzahl der Windows-Usernamen
        fest.
        Im ersten Mapping, welches zwingend notwendig ist, m"ochten wir einen
        Windows-Usernamen auf den eisfair{}-User \glqq{}root\grqq{} mappen
        lassen, n"amlich \glqq{}Administrator\grqq{}.
        Demzufolge muss mit den n"achsten Variablen auch nur ein Username
        definiert werden.

        Standardeinstellung: \texttt{SAMBA\_USERMAP\_1\_WINNAME\_N='1'}


    \config{SAMBA\_USERMAP\_x\_WINNAME\_y}{SAMBA\_USERMAP\_x\_WINNAME\_y}{SAMBAUSERMAPxWINNAMEy}
        Mit SAMBA\_USERMAP\_x\_WINNAME\_y wird der y'te Windows-Username
        eingestellt, der auf den x'ten eisfair{}-Usernamen gemappt wird.
        Um sich das besser vorstellen zu k"onnen, hier das erste Beispiel:

\begin{verbatim}
          SAMBA_USERMAP_1_ACTIVE='yes'
          SAMBA_USERMAP_1_EISNAME='root'
          SAMBA_USERMAP_1_WINNAME_N='1'
          SAMBA_USERMAP_1_WINNAME_1='Administrator'
\end{verbatim}

        Im zweiten Beispiel werden zwei Windows-Usernamen auf den zweiten
        eisfair{}-Usernamen gemappt:

\begin{verbatim}
          SAMBA_USERMAP_2_ACTIVE='yes'
          SAMBA_USERMAP_2_EISNAME='jimknopf'
          SAMBA_USERMAP_2_WINNAME_N='2'
          SAMBA_USERMAP_2_WINNAME_1='Jim Knopf'
          SAMBA_USERMAP_2_WINNAME_2='Jim Jeremy Knopf'
\end{verbatim}

          Ein beliebter Fehler besteht darin, das Mapping zu deaktivieren bzw.
          eine weitere Variable SAMBA\_USERMAP\_x\_WINNAME\_y zu definieren
          aber SAMBA\_USERMAP\_x\_WINNAME\_N nicht hochzuz"ahlen.

\end{description}


\subparagraph{Abschnitt \glqq{}Samba Advanced Configuration/Samba Shares\grqq{}:}
%------------------------------------------------------

Der Abschnitt wird eingeleitet mit

\begin{verbatim}
#------------------------------------------------------------------------------
# Samba Advanced Configuration/Samba Shares
#
#  ********************************* ATTENTION ******************************
#  *                                                                        *
#  *                The following Sections only have an Effect,             *
#  *                if you set SAMBA_MANUAL_CONFIGURATION='yes'             *
#  *                                                                        *
#  ******************************** ATTENTION *******************************
#
# Definition of Samba Shares
#
# Set the number of Samba Shares to create in SAMBA_SHARE_N.
#
# Values below are only an example and are not used if
# SAMBA_SHARE_N is '0'
#------------------------------------------------------------------------------
\end{verbatim}

\achtung{
Die Angaben in diesem Abschnitt haben nur eine Wirkung, wenn

\jumplabel{SAMBA\_MANUAL\_CONFIGURATION}{SAMBAMANUALCONFIGURATION}='yes'

gesetzt wird!
}


\begin{description}
    \config{SAMBA\_SHARE\_N}{SAMBA\_SHARE\_N}{SAMBASHAREN}
    Erstellung einer bestimmten Anzahl von Freigaben: z.B. '2'

        "Uber SAMBA\_SHARE\_N wird die Anzahl der zu erstellenden bzw. zu
        benutzenden Freigaben eingestellt. Wenn die Freigaben nicht
        existieren, werden sie automatisch angelegt und wenn sie existieren,
        werden sie einfach benutzt.
        Werden die Freigaben schon vorher manuell angelegt, so ist darauf zu
        achten, dass die Rechte so gestaltet werden, dass ein Zugriff der
        vorgesehenen User und Gruppen m"oglich ist.

        Wird hier eine 2 eingegeben, m"ussen die folgenden Variablen

\begin{verbatim}
          SAMBA_SHARE_1_ACTIVE
          SAMBA_SHARE_1_NAME
          SAMBA_SHARE_1_COMMENT
          SAMBA_SHARE_1_RW
          SAMBA_SHARE_1_BROWSE
          SAMBA_SHARE_1_PATH
          SAMBA_SHARE_1_USER
          SAMBA_SHARE_1_PUBLIC
          SAMBA_SHARE_1_READ_LIST
          SAMBA_SHARE_1_WRITE_LIST
          SAMBA_SHARE_1_FORCE_CMODE
          SAMBA_SHARE_1_FORCE_DIRMODE
          SAMBA_SHARE_1_FORCE_USER
          SAMBA_SHARE_1_FORCE_GROUP
\end{verbatim}

        und

\begin{verbatim}
          SAMBA_SHARE_2_ACTIVE
          SAMBA_SHARE_2_NAME
          SAMBA_SHARE_2_COMMENT
          SAMBA_SHARE_2_RW
          SAMBA_SHARE_2_BROWSE
          SAMBA_SHARE_2_PATH
          SAMBA_SHARE_2_USER
          SAMBA_SHARE_2_PUBLIC
          SAMBA_SHARE_2_READ_LIST
          SAMBA_SHARE_2_WRITE_LIST
          SAMBA_SHARE_2_FORCE_CMODE
          SAMBA_SHARE_2_FORCE_DIRMODE
          SAMBA_SHARE_2_FORCE_USER
          SAMBA_SHARE_2_FORCE_GROUP
\end{verbatim}

        vorhanden und mit sinnvollen Werten gef"ullt sein.

        Standardeinstellung: \texttt{SAMBA\_SHARE\_N='0'}


    \config{SAMBA\_SHARE\_x\_ACTIVE}{SAMBA\_SHARE\_x\_ACTIVE}{SAMBASHARExACTIVE}
    Soll die Freigabe aktiv sein: 'yes' oder 'no'

        Mit SAMBA\_SHARE\_x\_ACTIVE wird bestimmt, ob eine Freigabe
        aktiv ist oder nicht.
        M"ochte man eine Freigabe vor"ubergehend deaktivieren, so setzt man
        die Variable auf 'no'.

        Standardeinstellung: \texttt{SAMBA\_SHARE\_1\_ACTIVE='yes'}


    \config{SAMBA\_SHARE\_x\_NAME}{SAMBA\_SHARE\_x\_NAME}{SAMBASHARExNAME}
        Mit SAMBA\_SHARE\_x\_NAME wird der Name der x'ten Freigabe eingestellt.
        Unter diesem Namen ist die Freigabe zu erreichen bzw. in der
        Netzwerkumgebung von Windows-Rechnern sichtbar (siehe auch
        SAMBA\_SHARE\_x\_BROWSE weiter unten).

        Trotzdem eine Kombination aus 12 Buchstaben und Zahlen ohne Umlaute
        sowie der Bindestrich f"ur den Freigabenamen hinterlegbar ist, sollte
        man sich aus DOS-Kompatibilit"atsgr"unden auf maximal 8 Zeichen
        beschr"anken, z.B.

\begin{verbatim}
          SAMBA_SHARE_1_NAME='share1'
\end{verbatim}

        Das Programm eischk, welches die Konfiguration vor dem Abspeichern
        "uberpr"uft, gibt bei l"angeren Namen eine Warnung aus:

\begin{verbatim}
          Checking configuration file ...

          (/etc/config.d/samba:274) problematical value of variable
              SAMBA_SHARE_4_NAME: '01234-567890' (More than 8 characters will
              break compatibility with DOS clients!)
\end{verbatim}

        An 'problematical' erkennt man, dass das lediglich eine Warnung ist.
        Das Abspeichern der Konfiguration ist trotz dieser Warnung m"oglich.

        Freigabenamen m"ussen im Netzwerk eindeutig sein, d"urfen also nicht
        doppelt vorkommen. Ausserdem ist es keine gute Idee Freigabenamen
        zu vergeben, die identisch mit einem User- oder Gruppennamen oder
        mit dem NETBIOS-Namen eines Rechners sind.

        Standardeinstellung: \texttt{SAMBA\_SHARE\_1\_NAME='share1'}


    \config{SAMBA\_SHARE\_x\_RW}{SAMBA\_SHARE\_x\_RW}{SAMBASHARExRW}
    Soll die Freigabe beschreibbar sein: 'yes' oder 'no'

        "Uber SAMBA\_SHARE\_x\_RW wird eingestellt, ob die x'te Freigabe
        beschreibbar sein soll.

        Wird hier 'no' gew"ahlt, k"onnen Dateien von dieser Freigabe gelesen
        aber nicht dorthin gespeichert werden. Das ist vor allem bei Dateien
        sinnvoll, die man anderen zur Verf"ugung stellen m"ochte aber dabei
        unbedingt verhindern will, dass diese Dateien ver"andert oder sogar
        gel"oscht werden.

        Wird 'yes' gew"ahlt, ist diese Freigabe f"ur alle in den Variablen

\begin{verbatim}
          SAMBA_SHARE_x_USER
\end{verbatim}

        eingestellten User bzw. bei

\begin{verbatim}
          SAMBA_SHARE_x_PUBLIC='yes'
\end{verbatim}

        f"ur alle definierten Samba-User les- und beschreibbar.

        Achtung!
        Die Wirkung dieser Variable wird durch

        \jumplabel{SAMBA\_SHARE\_x\_READ\_LIST}{SAMBASHARExREADLIST}

        und

        \jumplabel{SAMBA\_SHARE\_x\_WRITE\_LIST}{SAMBASHARExWRITELIST}

        beeinflusst und eventuell aufgehoben!

        Standardeinstellung: \texttt{SAMBA\_SHARE\_x\_RW='yes'}


    \config{SAMBA\_SHARE\_x\_BROWSE}{SAMBA\_SHARE\_x\_BROWSE}{SAMBASHARExBROWSE}
    Soll die x'te Freigabe sichtbar sein: 'yes' oder 'no'

        Mit SAMBA\_SHARE\_x\_BROWSE wird eingestellt, ob die x'te Freigabe in der
        Netzwerkumgebung sichtbar sein soll oder nicht. M"ochte man verhindern,
        dass andere User in der Netzwerkumgebung die Freigabe sehen k"onnen, setzt
        man

\begin{verbatim}
          SAMBA_SHARE_x_BROWSE='no'
\end{verbatim}

        Nutzer, die wissen, dass die Freigabe existiert, k"onnen trotzdem
        darauf zugreifen, indem sie z.B. unter Start/Ausf"uhren

\begin{verbatim}
          \\eisfair\sharename
\end{verbatim}

        eingeben. Dabei ist \glqq{}eisfair\grqq{} durch den Namen des eisfair{}-Rechners
        zu ersetzen - wenn er davon abweicht - und \glqq{}sharename\grqq{} mit dem Namen,
        den man in SAMBA\_SHARE\_x\_NAME eingetragen hat.

        Standardeinstellung: \texttt{SAMBA\_SHARE\_x\_BROWSE='yes'}


    \config{SAMBA\_SHARE\_x\_PATH}{SAMBA\_SHARE\_x\_BROWSE}{SAMBASHARExPATH}
    Der Pfad zur x'ten Freigabe

        "Uber SAMBA\_SHARE\_x\_PATH wird der Pfad zur x'ten Freigabe
        eingestellt.

        Dazu ein Beispiel:

        Das vordefinierte public-Verzeichnis ist so definiert:

\begin{verbatim}
          SAMBA_SHARE_3_ACTIVE='yes'
          SAMBA_SHARE_3_NAME='public'
          SAMBA_SHARE_3_COMMENT='public directory on %h'
          SAMBA_SHARE_3_RW='yes'
          SAMBA_SHARE_3_BROWSE='yes'
          SAMBA_SHARE_3_PATH='/public'
          SAMBA_SHARE_3_USER='user1 user2'
          SAMBA_SHARE_3_PUBLIC='yes'
          SAMBA_SHARE_3_READ_LIST=''
          SAMBA_SHARE_3_WRITE_LIST=''
          SAMBA_SHARE_3_FORCE_CMODE='0777'
          SAMBA_SHARE_3_FORCE_DIRMODE='0777'
          SAMBA_SHARE_3_FORCE_USER=''
          SAMBA_SHARE_3_FORCE_GROUP=''
\end{verbatim}

        Durch die Angaben

\begin{verbatim}
          SAMBA_SHARE_3_NAME='public'
          SAMBA_SHARE_3_PATH='/public'
\end{verbatim}

        wird das Verzeichnis namens \glqq{}public\grqq{} unter / erstellt und freigeben.
        Als Freigabename wird der Inhalt der Variablen

\begin{verbatim}
          SAMBA_SHARE_3_NAME
\end{verbatim}

        , also in diesem Fall

\begin{verbatim}
          public
\end{verbatim}

        benutzt. Wenn das Verzeichnis nicht existiert, wird es automatisch
        angelegt und wenn es existiert, wird es einfach benutzt, damit schon
        abgelegte Daten erhalten bleiben. Es gibt im Moment keine M"oglichkeit,
        einmal erstellte Verzeichnisse "uber die Samba-Konfiguration zu
        l"oschen, da bei einer Fehleingabe die schon abgelegten Dateien
        gel"oscht werden w"urden.

        Die im Verzeichnis liegenden Dateien k"onnen "uber den Explorer
        gel"oscht werden, wenn die Freigabe in der Variablen

        \jumplabel{SAMBA\_SHARE\_x\_RW}{SAMBASHARExRW}

        schreibbar definiert wurde; das Verzeichnis selbst nur "uber die
        Kommandozeile.


    \config{SAMBA\_SHARE\_x\_USER}{SAMBA\_SHARE\_x\_USER}{SAMBASHARExUSER}
    Die User der x'ten Freigabe

        Mit dieser Variable wird definiert, welche User oder Gruppen auf die
        x'te Freigabe zugreifen d"urfen. Mehrere User werden hintereinander
        geschrieben und durch ein Leerzeichen getrennt, Gruppen werden mit
        einem + davor angegeben.
        Ein Beispiel:

\begin{verbatim}
          SAMBA_SHARE_x_USER='user1 user2 +samba'
\end{verbatim}

        Auf die Freigabe haben also der \glqq{}user1\grqq{}, der \glqq{}user2\grqq{} und die Gruppe
        \glqq{}samba\grqq{} Zugriff. Wird die Variable nicht gef"ullt, hat nur der User
        \glqq{}root\grqq{} Zugriff.
        Aber Achtung! Eine Besonderheit gibt es. Wird die folgende Variable

        \jumplabel{SAMBA\_SHARE\_x\_PUBLIC}{SAMBASHARExPUBLIC}

        auf 'yes' gesetzt, dominiert sie "uber den Eintrag in

\begin{verbatim}
          SAMBA_SHARE_x_USER
\end{verbatim}

        Es haben dann wieder alle Benutzer Zugriff!


    \config{SAMBA\_SHARE\_x\_PUBLIC}{SAMBA\_SHARE\_x\_PUBLIC}{SAMBASHARExPUBLIC}
        Wird diese Variable auf 'yes' gesetzt, haben alle registrierten Samba-
        User auf die Freigabe Zugriff. Diese Variable dominiert "uber

        \jumplabel{SAMBA\_SHARE\_x\_USER}{SAMBASHARExUSER}


    \config{SAMBA\_SHARE\_x\_READ\_LIST}{SAMBA\_SHARE\_x\_READ\_LIST}{SAMBASHARExREADLIST}
    Die User der x'ten Freigabe mit ausschliesslich lesendem Zugriff

        Mit dieser Variable wird definiert, welche User oder Gruppen auf die
        x'te Freigabe ausschliesslich lesend zugreifen d"urfen, wobei
        unerheblich ist, was in

\begin{verbatim}
          SAMBA_SHARE_x_RW
\end{verbatim}

        definiert wurde. Die F"ullung dieser Variable setzt also

\begin{verbatim}
          SAMBA_SHARE_x_RW='yes'
\end{verbatim}

        f"ur die angegebenen User und Gruppen ausser Kraft.
        Mehrere User werden hintereinander geschrieben und durch ein
        Leerzeichen getrennt, Gruppen werden mit einem + davor angegeben.

        Ein Beispiel:

\begin{verbatim}
          SAMBA_SHARE_x_RW='yes'
          SAMBA_SHARE_x_READ_LIST='user1 user2 +samba'
\end{verbatim}

        Trotzdem die Freigabe schreibbar definiert wurde, d"urfen user1,
        user2 und die Gruppe samba nur lesen.
        Bei der Erstellung der Samba-Konfiguration wird "uberpr"uft, ob
        die hier angegebenen User oder Gruppen tats"achlich existieren.
        Ist das nicht der Fall, so wird diese Freigabe mit einer Warnung
        "ubersprungen und ist damit nicht erreichbar. Wer eine solche
        Warnung erh"alt, sollte peinlichst genau kontrollieren, ob
        er sich bei den User- oder Gruppennamen nicht verschrieben hat.

        Siehe auch:

        \jumplabel{SAMBA\_SHARE\_x\_WRITE\_LIST}{SAMBASHARExWRITELIST}

        Standardeinstellung: \texttt{SAMBA\_SHARE\_x\_READ\_LIST=}


    \config{SAMBA\_SHARE\_x\_WRITE\_LIST}{SAMBA\_SHARE\_x\_WRITE\_LIST}{SAMBASHARExWRITELIST}
    Die User der x'ten Freigabe mit schreibendem Zugriff

        Mit dieser Variable wird definiert, welche User oder Gruppen
        auf die x'te Freigabe schreibend zugreifen d"urfen, wobei
        unerheblich ist, was in

\begin{verbatim}
          SAMBA_SHARE_x_RW
\end{verbatim}

        definiert wurde. Die F"ullung dieser Variable setzt also

\begin{verbatim}
          SAMBA_SHARE_x_RW='no'
\end{verbatim}

        f"ur die angegebenen User und Gruppen ausser Kraft.

        Mehrere User werden hintereinander geschrieben und durch ein
        Leerzeichen getrennt, Gruppen werden mit einem + davor angegeben.

        Ein Beispiel:

\begin{verbatim}
          SAMBA_SHARE_x_RW='no'
          SAMBA_SHARE_x_WRITE_LIST='user1 user2 +samba'
\end{verbatim}

        Trotzdem die Freigabe nur lesbar definiert wurde, d"urfen user1,
        user2 und die Gruppe samba auch schreiben.
        Ist ein User sowohl in

\begin{verbatim}
          SAMBA_SHARE_x_READ_LIST
\end{verbatim}

        als auch in

\begin{verbatim}
          SAMBA_SHARE_x_WRITE_LIST
\end{verbatim}

        enthalten, bekommt er schreibenden Zugriff.
        Bei der Erstellung der Samba-Konfiguration wird "uberpr"uft, ob
        die hier angegebenen User oder Gruppen tats"achlich existieren.
        Ist das nicht der Fall, so wird diese Freigabe mit einer Warnung
        "ubersprungen und ist damit nicht erreichbar. Wer eine solche
        Warnung erh"alt, sollte peinlichst genau kontrollieren, ob
        er sich bei den User- oder Gruppennamen nicht verschrieben hat.

        Siehe auch:

        \jumplabel{SAMBA\_SHARE\_x\_READ\_LIST}{SAMBASHARExREADLIST}

        Standardeinstellung: \texttt{SAMBA\_SHARE\_x\_WRITE\_LIST=}


    \config{SAMBA\_SHARE\_x\_FORCE\_CMODE}{SAMBA\_SHARE\_x\_FORCE\_CMODE}{SAMBASHARExFORCECMODE}
    Dateirechte f"ur neue Dateien der x'ten Freigabe

        Samba baut auf dem Sicherheitssystem des darunter liegenden Linux-
        Systems auf. Sobald eine Verbindung aufgebaut wird, nimmt der Server
        f"ur diese Verbindung die Dateirechte des eingeloggten Benutzers an.
        Der Benutzer kann also auch weiterhin keine Dinge tun, die ihm unter
        Linux verboten sind.
        Samba ver"andert die Rechte bestehender Linux-Dateien nicht. Wenn aber
        eine Datei neu erstellt wird, muss Samba wissen, welche Rechte der
        Eigent"umer, die Gruppe und alle andere Benutzer bekommen sollen. "Uber
        diese Variable werden diese Rechte eingestellt aber noch weiter
        verarbeitet - es kann also sein, dass sie nicht wirklich auf dem
        Linux-Dateisystem ankommen.
        Beispiel:

\begin{verbatim}
          SAMBA_SHARE_1_FORCE_CMODE='0600'
\end{verbatim}

        Die Rechtemaske wird wie bei chmod in Oktal-Schreibweise angegeben. Wer
        weiterf"uhrende Informationen ben"otigt, muss sich darum selbst bem"uhen
        ;o)


    \config{SAMBA\_SHARE\_x\_FORCE\_DIRMODE}{SAMBA\_SHARE\_x\_FORCE\_DIRMODE}{SAMBASHARExFORCEDIRMODE}
    Rechte f"ur neue Verzeichnisse der x'ten Freigabe

        F"ur neue Verzeichnisse in der x'ten Freigabe werden die hier
        angegebenen Zugriffsrechte zugewiesen. Auch hier gilt, dass diese
        Zugriffsrechte erst noch weiter verarbeitet werden, siehe

        \jumplabel{SAMBA\_SHARE\_x\_FORCE\_CMODE}{SAMBASHARExFORCECMODE}

        Beispiel:

\begin{verbatim}
          SAMBA_SHARE_1_FORCE_DIRMODE='0700'
\end{verbatim}


    \config{SAMBA\_SHARE\_x\_FORCE\_USER}{SAMBA\_SHARE\_x\_FORCE\_USER}{SAMBASHARExFORCEUSER}
    Eigent"umer von Dateien und Verzeichnissen "uberschreiben

        Normalerweise geh"oren in einer Freigabe angelegte Dateien und
        Verzeichnisse dem angemeldeten Benutzer - er ist der Eigent"umer.
        Mitunter ist das aber nicht gewollt, z.B. wenn man Dateien f"ur
        den Webserver per Samba in die entsprechenden Verzeichnisse kopieren
        will. Um als User xyz diese Dateien per Samba kopieren zu k"onnen und
        sie dabei dem User www zu "ubereignen, setzt man in der entsprechenden
        Freigabe

\begin{verbatim}
          SAMBA_SHARE_x_FORCE_USER='www'
\end{verbatim}

        Wird die Variable

        \jumplabel{SAMBA\_SHARE\_x\_FORCE\_GROUP}{SAMBASHARExFORCEGROUP}

        dabei nicht gef"ullt, so wird von Samba neben dem Eigent"umer
        gleichzeitig auch die prim"are Gruppe der angelegten Dateien auf den
        in

\begin{verbatim}
          SAMBA_SHARE_x_FORCE_USER
\end{verbatim}

        definierten User gesetzt. Siehe auch die Dokumentation zu
        \jumplabel{SAMBA\_SHARE\_x\_FORCE\_CMODE}{SAMBASHARExFORCECMODE} und
        \jumplabel{SAMBA\_SHARE\_x\_FORCE\_GROUP}{SAMBASHARExFORCEGROUP}

        Aber eine Ausnahme gibt es:
        Ist man als User \glqq{}root\grqq{} bei der Freigabe angemeldet oder wird der
        Benutzer, mit dem man sich angemeldet hat, auf \glqq{}root\grqq{} gemappt
        (/etc/user.map), geh"oren die Dateien trotz dieser Einstellung immer
        \glqq{}root\grqq{}!
        Bei der Erstellung der Samba-Konfiguration wird "uberpr"uft, ob
        der hier angegebene User tats"achlich existiert.
        Ist das nicht der Fall, so wird diese Freigabe mit einer Warnung
        "ubersprungen und ist damit nicht erreichbar. Wer eine solche
        Warnung erh"alt, sollte peinlichst genau kontrollieren, ob
        er sich bei dem Usernamen nicht verschrieben hat.

        Standardeinstellung: \texttt{SAMBA\_SHARE\_x\_FORCE\_USER=}


    \config{SAMBA\_SHARE\_x\_FORCE\_GROUP}{SAMBA\_SHARE\_x\_FORCE\_GROUP}{SAMBASHARExFORCEGROUP}
    Eigent"umer-Gruppe von Dateien und Verzeichnissen "uberschreiben

        Normalerweise werden in einer Freigabe angelegte Dateien und
        Verzeichnisse der prim"aren Gruppe des angemeldeten Benutzers
        zugeordnet.
        Will am das "andern, setzt man in der entsprechenden Freigabe

\begin{verbatim}
          SAMBA_SHARE_x_FORCE_GROUP
\end{verbatim}

        auf den Gruppennamen der gew"unschten Gruppe. Ist auch die Variable

\begin{verbatim}
          SAMBA_SHARE_x_FORCE_USER
\end{verbatim}

        gef"ullt, so dominiert die in

\begin{verbatim}
          SAMBA_SHARE_x_FORCE_GROUP
\end{verbatim}

        definierte Gruppe "uber die prim"are Gruppe des Users in

\begin{verbatim}
          SAMBA_SHARE_x_FORCE_USER
\end{verbatim}

        Siehe die Dokumentation zu

        \jumplabel{SAMBA\_SHARE\_x\_FORCE\_CMODE}{SAMBASHARExFORCECMODE}
        und
        \jumplabel{SAMBA\_SHARE\_x\_FORCE\_USER}{SAMBASHARExFORCEUSER}

        Bei der Erstellung der Samba-Konfiguration wird "uberpr"uft, ob
        die hier angegebene Gruppe tats"achlich existiert.
        Ist das nicht der Fall, so wird diese Freigabe mit einer Warnung
        "ubersprungen und ist damit nicht erreichbar. Wer eine solche
        Warnung erh"alt, sollte peinlichst genau kontrollieren, ob
        er sich bei dem Gruppenamen nicht verschrieben hat.

        Standardeinstellung: \texttt{SAMBA\_SHARE\_x\_FORCE\_GROUP=}


\end{description}


\subparagraph{Abschnitt \glqq{}Samba Advanced Configuration/Samba DFS roots\grqq{}:}
%------------------------------------------------------

Der Abschnitt wird eingeleitet mit

\begin{verbatim}
#------------------------------------------------------------------------------
# Samba Advanced Configuration/Samba DFS roots
#
#  ********************************* ATTENTION ******************************
#  *                                                                        *
#  *                The following Sections only have an Effect,             *
#  *                if you set SAMBA_MANUAL_CONFIGURATION='yes'             *
#  *                                                                        *
#  ******************************** ATTENTION *******************************
#
# Definition of Samba DFS roots
#
# Values below are only an example and are not used if
# SAMBA_DFSROOT_N is '0'
#------------------------------------------------------------------------------
\end{verbatim}

\achtung{
Die Angaben in diesem Abschnitt haben nur eine Wirkung, wenn

\jumplabel{SAMBA\_MANUAL\_CONFIGURATION}{SAMBAMANUALCONFIGURATION}='yes'

gesetzt wird!
}


\begin{description}
    \config{SAMBA\_DFSROOT\_N}{SAMBA\_DFSROOT\_N}{SAMBADFSROOTN}
    Erstellung einer bestimmten Anzahl von DFS-roots: z.B. '2'

        "Uber SAMBA\_DFSROOT\_N wird die Anzahl der zu erstellenden bzw. zu
        benutzenden DFS-roots eingestellt.
        Zur Erzeugung einer sauberen DFS-Konfiguration ist es notwendig, nach
        jeder "Anderung die Verzeichnisse mit den Links komplett zu l"oschen
        und wieder neu anzulegen. Deshalb werden die DFS-roots automatisch
        in einer zur Laufzeit nur lesbar gemounteten Image-Datei angelegt,
        damit nicht direkt in die DFS-roots oder in ein Container-Verzeichnis
        f"ur die Links Dateien gespeichert werden k"onnen.

        Wird hier eine 2 eingegeben, m"ussen die folgenden Variablen

\begin{verbatim}
          SAMBA_DFSROOT_1_ACTIVE
          SAMBA_DFSROOT_1_NAME
          SAMBA_DFSROOT_1_COMMENT
          SAMBA_DFSROOT_1_RW
          SAMBA_DFSROOT_1_BROWSE
          SAMBA_DFSROOT_1_USER
          SAMBA_DFSROOT_1_PUBLIC
          SAMBA_DFSROOT_1_READ_LIST
          SAMBA_DFSROOT_1_WRITE_LIST
          SAMBA_DFSROOT_1_FORCE_CMODE
          SAMBA_DFSROOT_1_FORCE_DIRMODE
          SAMBA_DFSROOT_1_FORCE_USER
          SAMBA_DFSROOT_1_FORCE_GROUP
          SAMBA_DFSROOT_1_DFSLNK_N
          SAMBA_DFSROOT_1_DFSLNK_1_ACTIVE
          SAMBA_DFSROOT_1_DFSLNK_1_SUBPATH
          SAMBA_DFSROOT_1_DFSLNK_1_NAME
          SAMBA_DFSROOT_1_DFSLNK_1_UNC_N
          SAMBA_DFSROOT_1_DFSLNK_1_UNC_1_PATH
\end{verbatim}

        und

\begin{verbatim}
          SAMBA_DFSROOT_2_ACTIVE
          SAMBA_DFSROOT_2_NAME
          SAMBA_DFSROOT_2_COMMENT
          SAMBA_DFSROOT_2_RW
          SAMBA_DFSROOT_2_BROWSE
          SAMBA_DFSROOT_2_USER
          SAMBA_DFSROOT_2_PUBLIC
          SAMBA_DFSROOT_2_READ_LIST
          SAMBA_DFSROOT_2_WRITE_LIST
          SAMBA_DFSROOT_2_FORCE_CMODE
          SAMBA_DFSROOT_2_FORCE_DIRMODE
          SAMBA_DFSROOT_2_FORCE_USER
          SAMBA_DFSROOT_2_FORCE_GROUP
          SAMBA_DFSROOT_2_DFSLNK_N
          SAMBA_DFSROOT_2_DFSLNK_1_ACTIVE
          SAMBA_DFSROOT_2_DFSLNK_1_SUBPATH
          SAMBA_DFSROOT_2_DFSLNK_1_NAME
          SAMBA_DFSROOT_2_DFSLNK_1_UNC_N
          SAMBA_DFSROOT_2_DFSLNK_1_UNC_1_PATH
\end{verbatim}

        vorhanden und mit sinnvollen Werten gef"ullt sein.

        Standardeinstellung: \texttt{SAMBA\_DFSROOT\_N='0'}


    \config{SAMBA\_DFSROOT\_x\_ACTIVE}{SAMBA\_DFSROOT\_x\_ACTIVE}{SAMBADFSROOTxACTIVE}
    Soll das DFS-root aktiv sein: 'yes' oder 'no'

        Mit SAMBA\_DFSROOT\_x\_ACTIVE wird bestimmt, ob ein DFS-root
        aktiv ist oder nicht.
        M"ochte man ein DFS-root vor"ubergehend deaktivieren, so setzt man
        die Variable auf 'no'.

        Standardeinstellung: \texttt{SAMBA\_DFSROOT\_1\_ACTIVE='yes'}


    \config{SAMBA\_DFSROOT\_x\_NAME}{SAMBA\_DFSROOT\_x\_NAME}{SAMBADFSROOTxNAME}
        Mit SAMBA\_DFSROOT\_x\_NAME wird der Name des x'ten DFS-roots
        eingestellt. Unter diesem Namen ist das DFS-root zu erreichen bzw.
        in der Netzwerkumgebung von Windows-Rechnern sichtbar (siehe auch
        SAMBA\_DFSROOT\_x\_BROWSE weiter unten).

        Da es f"ur DFS-Freigaben keinen DOS Client gibt, muss keine R"ucksicht
        auf DOS-Kompatibilit"at des Namens genommen werden.

\begin{verbatim}
          SAMBA_DFSROOT_1_NAME='dfs1'
\end{verbatim}

        DFS-root-Namen m"ussen im Netzwerk eindeutig sein, d"urfen also nicht
        doppelt vorkommen. Auserdem ist es keine gute Idee DFS-root-Namen
        zu vergeben, die identisch mit einem User- oder Gruppennamen oder
        mit dem NETBIOS-Namen eines Rechners sind.

        Standardeinstellung: \texttt{SAMBA\_DFSROOT\_1\_NAME='dfs1'}


    \config{SAMBA\_DFSROOT\_x\_RW}{SAMBA\_DFSROOT\_x\_RW}{SAMBADFSROOTxRW}
    Soll das DFS-root beschreibbar sein: 'yes' oder 'no'

        "Uber SAMBA\_DFSROOT\_x\_RW wird eingestellt, ob das x'te DFS-root
        beschreibbar sein soll.

        Wird hier 'no' gew"ahlt, k"onnen Dateien von diesem DFS-root gelesen
        aber nicht dorthin gespeichert werden. Das ist vor allem bei Dateien
        sinnvoll, die man anderen zur Verf"ugung stellen m"ochte aber dabei
        unbedingt verhindern will, dass diese Dateien ver"andert oder sogar
        gel"oscht werden.

        Wird 'yes' gew"ahlt, ist dieses DFS-root f"ur alle in den Variablen

\begin{verbatim}
          SAMBA_DFSROOT_x_USER
\end{verbatim}

        eingestellten User bzw. bei

\begin{verbatim}
          SAMBA_DFSROOT_x_PUBLIC='yes'
\end{verbatim}

        f"ur alle definierten Samba-User les- und beschreibbar.

\achtung{
        Hinweis zur Zugriffsberechtigungen und Datei-Rechten:

        Abgesehen vom Erteilen der erforderlichen Berechtigungen, werden vom
        DFS-Dienst keine weiteren Sicherheitsmassnahmen neben denen
        implementiert, die im Samba-Paket zur Verf"ugung stehen.
        Berechtigungen f"ur ein Ziel beziehen sich nicht auf die DFS-
        Topologie.
        Angenommen, es ist eine DFS-Verkn"upfung mit dem Namen
        MarketingDocs vorhanden (weiter unten in den Variablen
        SAMBA\_DFSROOT\_x\_DFSLNK\_N und folgenden definiert), und Sie
        verf"ugen "uber die entsprechenden Berechtigungen f"ur den Zugriff auf
        ein bestimmtes Ziel (weiter unten definiert in der Variablen
        SAMBA\_DFSROOT\_x\_DFSLNK\_y\_UNC\_z\_PATH), auf das MarketingDocs
        zeigt:
        In diesem Fall k"onnen Sie auf alle anderen Ziele in der Gruppe der
        Ziele zugreifen, auch wenn Sie nicht zum Zugriff auf die anderen
        Ziele berechtigt sind. Durch die Berechtigung zum Zugreifen auf diese
        Ziele wird jedoch festgelegt, ob Sie auf die Informationen in diesen
        Zielen zugreifen k"onnen. Dieser Zugriff wird durch die
        Standardsteuerelemente f"ur die Sicherheit des Samba-Paketes oder des
        jeweiligen Freigabe-Servers festgelegt. Wenn ein Benutzer versucht,
        auf ein Ziel und dessen Inhalte zuzugreifen, wird die Sicherheit von
        dem zugrunde liegenden Dateisystem erzwungen. Dabei bietet ein
        FAT-Volume nur Sicherheit f"ur Dateien auf Freigabeebene, w"ahrend bei
        einem NTFS-Datentr"ager die vollst"andige Sicherheit des Samba-Paketes
        zur Verf"ugung steht. Zur Wahrung der Sicherheit sollten Sie auf
        Windows-Rechnern NTFS und Dateifreigabeberechtigungen verwenden, um
        durch DFS verwendete freigegebene Ordner zu sichern, sodass nur
        autorisierte Benutzer auf diese zugreifen k"onnen.
}

        Achtung!
        Die Wirkung dieser Variable wird durch

        \jumplabel{SAMBA\_DFSROOT\_x\_READ\_LIST}{SAMBADFSROOTxREADLIST}

        und

        \jumplabel{SAMBA\_DFSROOT\_x\_WRITE\_LIST}{SAMBADFSROOTxWRITELIST}

        beeinflusst und eventuell aufgehoben!

        Standardeinstellung: \texttt{SAMBA\_DFSROOT\_x\_RW='yes'}


    \config{SAMBA\_DFSROOT\_x\_BROWSE}{SAMBA\_DFSROOT\_x\_BROWSE}{SAMBADFSROOTxBROWSE}
    Soll das x'te DFS-root sichtbar sein: 'yes' oder 'no'

        Mit SAMBA\_DFSROOT\_x\_BROWSE wird eingestellt, ob das x'te DFS-root in der
        Netzwerkumgebung sichtbar sein soll oder nicht. M"ochte man verhindern,
        dass andere User in der Netzwerkumgebung das DFS-root sehen k"onnen, setzt
        man

\begin{verbatim}
          SAMBA_DFSROOT_x_BROWSE='no'
\end{verbatim}

        Nutzer, die wissen, dass die DFS-Freigabe existiert, k"onnen trotzdem
        darauf zugreifen, indem sie z.B. unter Start/Ausf"uhren

\begin{verbatim}
          \\eisfair\dfsname
\end{verbatim}

        eingeben. Dabei ist \glqq{}eisfair\grqq{} durch den Namen des eisfair{}-Rechners
        zu ersetzen - wenn er davon abweicht - und \glqq{}dfsname\grqq{} mit dem Namen,
        den man in SAMBA\_DFSROOT\_x\_NAME eingetragen hat.

        Standardeinstellung: \texttt{SAMBA\_DFSROOT\_x\_BROWSE='yes'}


    \config{SAMBA\_DFSROOT\_x\_USER}{SAMBA\_DFSROOT\_x\_USER}{SAMBADFSROOTxUSER}
    Die User des x'ten DFS-roots

        Mit dieser Variable wird definiert, welche User oder Gruppen auf das
        x'te DFS-root zugreifen d"urfen. Mehrere User werden hintereinander
        geschrieben und durch ein Leerzeichen getrennt, Gruppen werden mit
        einem + davor angegeben.
        Ein Beispiel:

\begin{verbatim}
          SAMBA_DFSROOT_x_USER='user1 user2 +samba'
\end{verbatim}

        Auf das DFS-root haben also der \glqq{}user1\grqq{}, der \glqq{}user2\grqq{} und die Gruppe
        \glqq{}samba\grqq{} Zugriff. Wird die Variable nicht gef"ullt, hat nur der User
        \glqq{}root\grqq{} Zugriff.
        Aber Achtung! Eine Besonderheit gibt es. Wird die folgende Variable

        \jumplabel{SAMBA\_DFSROOT\_x\_PUBLIC}{SAMBADFSROOTxPUBLIC}

        auf 'yes' gesetzt, dominiert sie "uber den Eintrag in

\begin{verbatim}
          SAMBA_DFSROOT_x_USER
\end{verbatim}

        Es haben dann wieder alle Benutzer Zugriff!
        Siehe auch den Hinweis zu Zugriffsberechtigungen und Datei-Rechten
        unter dem Punkt

        \jumplabel{SAMBA\_DFSROOT\_x\_RW}{SAMBADFSROOTxRW}


    \config{SAMBA\_DFSROOT\_x\_PUBLIC}{SAMBA\_DFSROOT\_x\_PUBLIC}{SAMBADFSROOTxPUBLIC}
        Wird diese Variable auf 'yes' gesetzt, haben alle registrierten Samba-
        User auf die Freigabe Zugriff. Diese Variable dominiert "uber

        \jumplabel{SAMBA\_DFSROOT\_x\_USER}{SAMBADFSROOTxUSER}

        Siehe auch den Hinweis zu Zugriffsberechtigungen und Datei-Rechten
        unter dem Punkt

        \jumplabel{SAMBA\_DFSROOT\_x\_RW}{SAMBADFSROOTxRW}


    \config{SAMBA\_DFSROOT\_x\_READ\_LIST}{SAMBA\_DFSROOT\_x\_READ\_LIST}{SAMBADFSROOTxREADLIST}
    Die User des x'ten DFS-roots mit ausschliesslich lesendem Zugriff

        Mit dieser Variable wird definiert, welche User oder Gruppen auf das
        x'te DFS-root ausschliesslich lesend zugreifen d"urfen, wobei
        unerheblich ist, was in

\begin{verbatim}
          SAMBA_DFSROOT_x_RW
\end{verbatim}

        definiert wurde. Die F"ullung dieser Variable setzt also

\begin{verbatim}
          SAMBA_DFSROOT_x_RW='yes'
\end{verbatim}

        f"ur die angegebenen User und Gruppen ausser Kraft.
        Mehrere User werden hintereinander geschrieben und durch ein
        Leerzeichen getrennt, Gruppen werden mit einem + davor angegeben.

        Ein Beispiel:

\begin{verbatim}
          SAMBA_DFSROOT_x_RW='yes'
          SAMBA_DFSROOT_x_READ_LIST='user1 user2 +samba'
\end{verbatim}

        Trotzdem das DFS-root schreibbar definiert wurde, d"urfen user1,
        user2 und die Gruppe samba nur lesen.
        Bei der Erstellung der Samba-Konfiguration wird "uberpr"uft, ob
        die hier angegebenen User oder Gruppen tats"achlich existieren.
        Ist das nicht der Fall, so wird diese Freigabe mit einer Warnung
        "ubersprungen und ist damit nicht erreichbar. Wer eine solche
        Warnung erh"alt, sollte peinlichst genau kontrollieren, ob
        er sich bei den User- oder Gruppennamen nicht verschrieben hat.

        Siehe auch:

        \jumplabel{SAMBA\_DFSROOT\_x\_WRITE\_LIST}{SAMBADFSROOTxWRITELIST}

        Standardeinstellung: \texttt{SAMBA\_DFSROOT\_x\_READ\_LIST=}


    \config{SAMBA\_DFSROOT\_x\_WRITE\_LIST}{SAMBA\_DFSROOT\_x\_WRITE\_LIST}{SAMBADFSROOTxWRITELIST}
    Die User des x'ten DFS-roots mit schreibendem Zugriff

        Mit dieser Variable wird definiert, welche User oder Gruppen
        auf das x'te DFS-root schreibend zugreifen d"urfen, wobei
        unerheblich ist, was in

\begin{verbatim}
          SAMBA_DFSROOT_x_RW
\end{verbatim}

        definiert wurde. Die F"ullung dieser Variable setzt also

\begin{verbatim}
          SAMBA_DFSROOT_x_RW='no'
\end{verbatim}

        f"ur die angegebenen User und Gruppen ausser Kraft.

        Mehrere User werden hintereinander geschrieben und durch ein
        Leerzeichen getrennt, Gruppen werden mit einem + davor angegeben.

        Ein Beispiel:

\begin{verbatim}
          SAMBA_DFSROOT_x_RW='no'
          SAMBA_DFSROOT_x_WRITE_LIST='user1 user2 +samba'
\end{verbatim}

        Trotzdem das DFS-root nur lesbar definiert wurde, d"urfen user1,
        user2 und die Gruppe samba auch schreiben.
        Ist ein User sowohl in

\begin{verbatim}
          SAMBA_DFSROOT_x_READ_LIST
\end{verbatim}

        als auch in

\begin{verbatim}
          SAMBA_DFSROOT_x_WRITE_LIST
\end{verbatim}

        enthalten, bekommt er schreibenden Zugriff.
        Bei der Erstellung der Samba-Konfiguration wird "uberpr"uft, ob
        die hier angegebenen User oder Gruppen tats"achlich existieren.
        Ist das nicht der Fall, so wird diese Freigabe mit einer Warnung
        "ubersprungen und ist damit nicht erreichbar. Wer eine solche
        Warnung erh"alt, sollte peinlichst genau kontrollieren, ob
        er sich bei den User- oder Gruppennamen nicht verschrieben hat.

        Siehe auch

        \jumplabel{SAMBA\_DFSROOT\_x\_READ\_LIST}{SAMBADFSROOTxREADLIST}

        und den Hinweis zu Zugriffsberechtigungen und Datei-Rechten
        unter dem Punkt

        \jumplabel{SAMBA\_DFSROOT\_x\_RW}{SAMBADFSROOTxRW}

        Standardeinstellung: \texttt{SAMBA\_DFSROOT\_x\_WRITE\_LIST=}


    \config{SAMBA\_DFSROOT\_x\_FORCE\_CMODE}{SAMBA\_DFSROOT\_x\_FORCE\_CMODE}{SAMBADFSROOTxFORCECMODE}
    Dateirechte f"ur neue Dateien des x'ten DFS-roots

        Samba baut auf dem Sicherheitssystem des darunter liegenden
        Linux-Systems auf. Sobald eine Verbindung aufgebaut wird, nimmt der
        Server f"ur diese Verbindung die Dateirechte des eingeloggten Benutzers
        an. Der Benutzer kann also auch weiterhin keine Dinge tun, die ihm unter
        Linux verboten sind.
        Samba ver"andert die Rechte bestehender Linux-Dateien nicht. Wenn aber
        eine Datei neu erstellt wird, muss Samba wissen, welche Rechte der
        Eigent"umer, die Gruppe und alle andere Benutzer bekommen sollen. "Uber
        diese Variable werden diese Rechte eingestellt aber noch weiter
        verarbeitet - es kann also sein, dass sie nicht wirklich auf dem
        Linux-Dateisystem ankommen.
        Beispiel:

\begin{verbatim}
          SAMBA_DFSROOT_1_FORCE_CMODE='0600'
\end{verbatim}

        Die Rechtemaske wird wie bei chmod in Oktal-Schreibweise angegeben. Wer
        weiterf"uhrende Informationen ben"otigt, muss sich darum selbst bem"uhen
        ;o)


    \config{SAMBA\_DFSROOT\_x\_FORCE\_DIRMODE}{SAMBA\_DFSROOT\_x\_FORCE\_DIRMODE}{SAMBADFSROOTxFORCEDIRMODE}
    Rechte f"ur neue Verzeichnisse des x'ten DFS-roots

        F"ur neue Verzeichnisse im x'ten DFS-root werden die hier
        angegebenen Zugriffsrechte zugewiesen. Auch hier gilt, dass diese
        Zugriffsrechte erst noch weiter verarbeitet werden, siehe

        \jumplabel{SAMBA\_DFSROOT\_x\_FORCE\_CMODE}{SAMBADFSROOTxFORCECMODE}

        Beispiel:

\begin{verbatim}
          SAMBA_DFSROOT_1_FORCE_DIRMODE='0700'
\end{verbatim}


    \config{SAMBA\_DFSROOT\_x\_FORCE\_USER}{SAMBA\_DFSROOT\_x\_FORCE\_USER}{SAMBADFSROOTxFORCEUSER}
    Eigent"umer von Dateien und Verzeichnissen "uberschreiben

        Normalerweise geh"oren in einem DFS-root angelegte Dateien und
        Verzeichnisse dem angemeldeten Benutzer - er ist der Eigent"umer.
        Mitunter ist das aber nicht gewollt, z.B. wenn man Dateien f"ur
        den Webserver per Samba in die entsprechenden Verzeichnisse kopieren
        will. Um als User xyz diese Dateien per Samba kopieren zu k"onnen und
        sie dabei dem User www zu "ubereignen, setzt man in der entsprechenden
        Freigabe

\begin{verbatim}
          SAMBA_DFSROOT_x_FORCE_USER='www'
\end{verbatim}

        Wird die Variable

        \jumplabel{SAMBA\_DFSROOT\_x\_FORCE\_GROUP}{SAMBADFSROOTxFORCEGROUP}

        dabei nicht gef"ullt, so wird von Samba f"ur neu angelegte Dateien neben
        dem Eigent"umer aus

\begin{verbatim}
          SAMBA_DFSROOT_x_FORCE_USER
\end{verbatim}

        gleichzeitig auch die GID der angelegten Dateien auf die GID der
        prim"aren Gruppe des Users aus

\begin{verbatim}
          SAMBA_DFSROOT_x_FORCE_USER
\end{verbatim}

        gesetzt.
        Siehe auch die Dokumentation zu

        \jumplabel{SAMBA\_DFSROOT\_x\_FORCE\_CMODE}{SAMBADFSROOTxFORCECMODE} und
        \jumplabel{SAMBA\_DFSROOT\_x\_FORCE\_GROUP}{SAMBADFSROOTxFORCEGROUP}

        Aber eine Ausnahme gibt es:
        Ist man als User \glqq{}root\grqq{} beim DFS-root angemeldet oder wird der
        Benutzer, mit dem man sich angemeldet hat, auf \glqq{}root\grqq{} gemappt
        (/etc/user.map), geh"oren die Dateien trotz dieser Einstellung immer
        \glqq{}root\grqq{}!
        Bei der Erstellung der Samba-Konfiguration wird "uberpr"uft, ob
        der hier angegebene User tats"achlich existiert.
        Ist das nicht der Fall, so wird dieses DFS-root mit einer Warnung
        "ubersprungen und ist damit nicht erreichbar. Wer eine solche
        Warnung erh"alt, sollte peinlichst genau kontrollieren, ob
        er sich bei dem Usernamen nicht verschrieben hat.

        Standardeinstellung: \texttt{SAMBA\_DFSROOT\_x\_FORCE\_USER=}


    \config{SAMBA\_DFSROOT\_x\_FORCE\_GROUP}{SAMBA\_DFSROOT\_x\_FORCE\_GROUP}{SAMBADFSROOTxFORCEGROUP}
    Eigent"umer-Gruppe von Dateien und Verzeichnissen "uberschreiben

        Normalerweise werden in einem DFS-root angelegte Dateien und
        Verzeichnisse der prim"aren Gruppe des angemeldeten Benutzers
        zugeordnet.
        Will am das "andern, setzt man in dem entsprechenden DFS-root

\begin{verbatim}
          SAMBA_DFSROOT_x_FORCE_GROUP
\end{verbatim}

        auf den Gruppennamen der gew"unschten Gruppe. Ist auch die Variable

\begin{verbatim}
          SAMBA_DFSROOT_x_FORCE_USER
\end{verbatim}

        gef"ullt, so dominiert die in

\begin{verbatim}
          SAMBA_DFSROOT_x_FORCE_GROUP
\end{verbatim}

        definierte Gruppe "uber die prim"are Gruppe des Users in

\begin{verbatim}
          SAMBA_DFSROOT_x_FORCE_USER
\end{verbatim}

        Siehe die Dokumentation zu

        \jumplabel{SAMBA\_DFSROOT\_x\_FORCE\_CMODE}{SAMBADFSROOTxFORCECMODE}
        und
        \jumplabel{SAMBA\_DFSROOT\_x\_FORCE\_USER}{SAMBADFSROOTxFORCEUSER}

        Bei der Erstellung der Samba-Konfiguration wird "uberpr"uft, ob
        die hier angegebene Gruppe tats"achlich existiert.
        Ist das nicht der Fall, so wird dieses DFS-root mit einer Warnung
        "ubersprungen und ist damit nicht erreichbar. Wer eine solche
        Warnung erh"alt, sollte peinlichst genau kontrollieren, ob
        er sich bei dem Gruppenamen nicht verschrieben hat.

        Standardeinstellung: \texttt{SAMBA\_DFSROOT\_x\_FORCE\_GROUP=}


    \config{SAMBA\_DFSROOT\_x\_DFSLNK\_N}{SAMBA\_DFSROOT\_x\_DFSLNK\_N}{SAMBADFSROOTxDFSLNKN}
    Erstellung einer bestimmten Anzahl von DFS-Links: z.B. '2'

        "Uber SAMBA\_DFSROOT\_x\_DFSLNK\_N wird die Anzahl der im entsprechenden
        DFS-root zu erstellenden bzw. zu benutzenden DFS-Links eingestellt.
        Wird hier eine 2 eingegeben, m"ussen die folgenden Variablen

\begin{verbatim}
          SAMBA_DFSROOT_1_DFSLNK_1_ACTIVE
          SAMBA_DFSROOT_1_DFSLNK_1_SUBPATH
          SAMBA_DFSROOT_1_DFSLNK_1_NAME
          SAMBA_DFSROOT_1_DFSLNK_1_UNC_N
\end{verbatim}

        und

\begin{verbatim}
          SAMBA_DFSROOT_1_DFSLNK_2_ACTIVE
          SAMBA_DFSROOT_1_DFSLNK_2_SUBPATH
          SAMBA_DFSROOT_1_DFSLNK_2_NAME
          SAMBA_DFSROOT_1_DFSLNK_2_UNC_N
\end{verbatim}

        vorhanden und mit sinnvollen Werten gef"ullt sein.


    \config{SAMBA\_DFSROOT\_x\_DFSLNK\_y\_ACTIVE}{SAMBA\_DFSROOT\_x\_DFSLNK\_y\_ACTIVE}{SAMBADFSROOTxDFSLNKyACTIVE}
    Soll der DFS-Link aktiv sein: 'yes' oder 'no'


        Mit SAMBA\_DFSROOT\_x\_DFSLNK\_y\_ACTIVE wird bestimmt, ob ein DFS-Link
        aktiv ist oder nicht. M"ochte man einen DFS-Link vor"ubergehend
        deaktivieren, so setzt man die Variable auf 'no'.

        Standardeinstellung: \texttt{SAMBA\_DFSROOT\_x\_DFSLNK\_y\_ACTIVE='yes'}


    \config{SAMBA\_DFSROOT\_x\_DFSLNK\_y\_SUBPATH}{SAMBA\_DFSROOT\_x\_DFSLNK\_y\_SUBPATH}{SAMBADFSROOTxDFSLNKySUBPATH}
    Unterverzeichnis f"ur diesen DFS-Link

        Mit dieser Variable kann ein Unterverzeichnis erstellt werden, in dem
        der DFS-Link angelegt werden soll. Dieses Unterverzeichnis befindet
        sich physisch in der zur Laufzeit nur lesbar gemounteten Image-Datei
        und darf nicht den gleichen Namen haben, wie ein auf dieser Ebene
        angebrachter DFS-Link.
        Aber es ist bei mehreren DFS-Links m"oglich, die verschiedenen
        Unterverzeichnisse ein St"uck des Weges gemeinsam gehen zu lassen.

        Beispiel:

\begin{verbatim}
          SAMBA_DFSROOT_1_DFSLNK_1_SUBPATH='sport'
          SAMBA_DFSROOT_1_DFSLNK_2_SUBPATH='sport/fussball'
          SAMBA_DFSROOT_1_DFSLNK_3_SUBPATH='sport/handball'
\end{verbatim}

        Das sieht nachher so aus:

\begin{verbatim}
          \\eisfair\dfsname\sport
          \\eisfair\dfsname\sport\fussball
          \\eisfair\dfsname\sport\handball
\end{verbatim}

        Dabei ist \glqq{}eisfair\grqq{} durch den Namen des eisfair{}-Rechners
        zu ersetzen - wenn er davon abweicht - und \glqq{}dfsname\grqq{} mit dem Namen,
        den man in SAMBA\_DFSROOT\_x\_NAME eingetragen hat.


    \config{SAMBA\_DFSROOT\_x\_DFSLNK\_y\_NAME}{SAMBA\_DFSROOT\_x\_DFSLNK\_y\_NAME}{SAMBADFSROOTxDFSLNKyNAME}
    Name f"ur diesen DFS-Link

        Mit dieser Variable wird der Name des DFS-Links bestimmt. Dieser Name
        muss eindeutig sein, darf also nicht identisch mit einem eventuell
        auf gleicher Ebene vorhandenen Unterverzeichnis oder einem anderen
        Link sein.

        Um beim obigen Beispiel zu bleiben:

\begin{verbatim}
          SAMBA_DFSROOT_1_DFSLNK_1_SUBPATH='sport'
          SAMBA_DFSROOT_1_DFSLNK_2_SUBPATH='sport/fussball'
          SAMBA_DFSROOT_1_DFSLNK_3_SUBPATH='sport/handball'
\end{verbatim}

        Das so aussieht:

\begin{verbatim}
          \\eisfair\dfsname\sport
          \\eisfair\dfsname\sport\fussball
          \\eisfair\dfsname\sport\handball
\end{verbatim}

        Hier darf SAMBA\_DFSROOT\_1\_DFSLNK\_1\_NAME also nicht 'fussball' oder
        'handball' genannt werden - wohl aber 'tennis', 'abcdef' etc.


    \config{SAMBA\_DFSROOT\_x\_DFSLNK\_y\_UNC\_N}{SAMBA\_DFSROOT\_x\_DFSLNK\_y\_UNC\_N}{SAMBADFSROOTxDFSLNKyUNCN}
    Einbindung einer bestimmten Anzahl von DFS-Zielen

        "Uber SAMBA\_DFSROOT\_x\_DFSLNK\_y\_UNC\_N wird die Anzahl der DFS-Ziele
        eingestellt, auf die SAMBA\_DFSROOT\_x\_DFSLNK\_y zeigt.
        Normalerweise wird hier eine 1 eingegeben. Bei 2 und mehr kann ein
        Lastenausgleich (load balancing) erzielt werden, falls
        Replikations-Server im Netz sind.
        Wird hier eine 1 eingegeben, muss die folgende Variable
        SAMBA\_DFSROOT\_x\_DFSLNK\_y\_UNC\_z\_PATH
        vorhanden und sinnvoll gef"ullt sein.


    \config{SAMBA\_DFSROOT\_x\_DFSLNK\_y\_UNC\_z\_PATH}{SAMBA\_DFSROOT\_x\_DFSLNK\_y\_UNC\_z\_PATH}{SAMBADFSROOTxDFSLNKyUNCzPATH}
    UNC-Pfad zu diesem DFS-Ziel

        In dieser Variable wird der UNC-Pfad zu diesem DFS-Ziel
        untergebracht.

        M"oglich ist die Angabe aller Freigaben, die "uber einen UNC-Pfad
        erreichbar sind, also

\begin{verbatim}
          //servername/freigabe
\end{verbatim}

        bzw.

\begin{verbatim}
          //servername/pfad/freigabe
\end{verbatim}

        oder

\begin{verbatim}
          //192.168.10.12/freigabe
\end{verbatim}

        bzw.

\begin{verbatim}
          //192.168.10.12/pfad/freigabe
\end{verbatim}

        oder auch lokal

\begin{verbatim}
          //eisfairname/freigabe
\end{verbatim}

        bzw.

\begin{verbatim}
          //127.0.0.1/pfad/freigabe
\end{verbatim}

\end{description}


\subparagraph{Abschnitt \glqq{}Samba Advanced Configuration/Samba Printers\grqq{}:}
%--------------------------------------------------------

Der Abschnitt wird eingeleitet mit

\begin{verbatim}
#------------------------------------------------------------------------------
# Samba Advanced Configuration/Samba Printers
#
#  ********************************* ATTENTION ******************************
#  *                                                                        *
#  *                The following Sections only have an Effect,             *
#  *                if you set SAMBA_MANUAL_CONFIGURATION='yes'             *
#  *                                                                        *
#  ********************************* ATTENTION ******************************
#
# Definition of Samba Printers
#
# Set the number of Samba Printer to use in SAMBA_PRINTER_N.
#
# Values below are only an example and are not used if
# SAMBA_PRINTER_N is '0'
#------------------------------------------------------------------------------
\end{verbatim}

\achtung{
Die Angaben in diesem Abschnitt haben nur eine Wirkung, wenn

\jumplabel{SAMBA\_MANUAL\_CONFIGURATION}{SAMBAMANUALCONFIGURATION}='yes'

gesetzt wird!
}


\begin{description}
    \config{SAMBA\_PRINTER\_N}{SAMBA\_PRINTER\_N}{SAMBAPRINTERN}
    Erstellung einer bestimmten Anzahl von Freigaben f"ur Drucker: z.B. '2'

        "Uber SAMBA\_PRINTER\_N wird die Anzahl der zu benutzenden Freigaben
        f"ur Drucker eingestellt. Dazu ist es allerdings vorher notwendig, das
        Paket lprng von mir zu installieren:

\begin{verbatim}
          Package administration
          Install new package
          Printer and File Services
          LPRng Print Services
\end{verbatim}

        Bei einem zu nutzenden Drucker ist

\begin{verbatim}
          SAMBA_PRINTER_N='1'
\end{verbatim}

        einzutragen. Bei 2 Druckern ist SAMBA\_PRINTER\_N zu inkrementieren, also

\begin{verbatim}
          SAMBA_PRINTER_N='2'
\end{verbatim}

        Weiterhin m"ussen dann auch die korrespondierenden Einstellungen

\begin{verbatim}
          SAMBA_PRINTER_1_ACTIVE
          SAMBA_PRINTER_1_NAME
          SAMBA_PRINTER_1_TYPE
          SAMBA_PRINTER_1_PDF_QUALITY
          SAMBA_PRINTER_1_PDF_OWNERPASS
          SAMBA_PRINTER_1_PDF_USERPASS
          SAMBA_PRINTER_1_PDF_PERMS
          SAMBA_PRINTER_1_PDF_MESSAGES
          SAMBA_PRINTER_1_CAPNAME
          SAMBA_PRINTER_1_COMMENT
          SAMBA_PRINTER_1_CLIENTDRIVER
          SAMBA_PRINTER_1_BROWSE
          SAMBA_PRINTER_1_USER
          SAMBA_PRINTER_1_PUBLIC
\end{verbatim}

        und

\begin{verbatim}
          SAMBA_PRINTER_2_ACTIVE
          SAMBA_PRINTER_2_NAME
          SAMBA_PRINTER_2_TYPE
          SAMBA_PRINTER_2_PDF_QUALITY
          SAMBA_PRINTER_1_PDF_OWNERPASS
          SAMBA_PRINTER_1_PDF_USERPASS
          SAMBA_PRINTER_1_PDF_PERMS
          SAMBA_PRINTER_1_PDF_MESSAGES
          SAMBA_PRINTER_2_CAPNAME
          SAMBA_PRINTER_2_COMMENT
          SAMBA_PRINTER_2_CLIENTDRIVER
          SAMBA_PRINTER_2_BROWSE
          SAMBA_PRINTER_2_USER
          SAMBA_PRINTER_2_PUBLIC
\end{verbatim}

        vorhanden und mit sinnvollen Werten gef"ullt sein.

        Standardeinstellung: \texttt{SAMBA\_PRINTER\_N='0'}


    \config{SAMBA\_PRINTER\_x\_ACTIVE}{SAMBA\_PRINTER\_x\_ACTIVE}{SAMBAPRINTERxACTIVE}
    Soll der Drucker aktiv sein: 'yes' oder 'no'

        Mit SAMBA\_PRINTER\_x\_ACTIVE wird bestimmt, ob ein Drucker aktiv ist
        oder nicht.
        M"ochte man einen Drucker vor"ubergehend deaktivieren, so setzt man
        die Variable auf 'no'.

        Standardeinstellung: \texttt{SAMBA\_PRINTER\_1\_ACTIVE='yes'}


    \config{SAMBA\_PRINTER\_x\_NAME}{SAMBA\_PRINTER\_x\_NAME}{SAMBAPRINTERxNAME}
    Der Name der x'ten Druckerfreigabe

        "Uber diese Variable wird der Name der Druckerfreigabe eingestellt. Der
        Drucker ist unter diesem Namen in der Netzwerkumgebung zu sehen und
        ansprechbar.

        Trotzdem eine Kombination aus 12 Buchstaben und Zahlen ohne Umlaute
        sowie der Bindestrich f"ur den Druckernamen hinterlegbar ist, sollte
        man sich aus DOS-Kompatibilit"atsgr"unden auf maximal 8 Zeichen
        beschr"anken, z.B.

\begin{verbatim}
          SAMBA_PRINTER_1_NAME='Laserjet'
\end{verbatim}

        Das Programm eischk, welches die Konfiguration vor dem Abspeichern
        "uberpr"uft, bem"angelt l"angere Namen folgerichtig:

\begin{verbatim}
          Checking configuration file ...

          (/etc/config.d/samba:343) problematical value of variable
              SAMBA_PRINTER_3_NAME: 'printerlong' (More than 8 characters will
              break compatibility with DOS clients!)
\end{verbatim}

        An 'problematical' erkennt man, dass das lediglich eine Warnung ist.
        Das Abspeichern der Konfiguration ist trotz dieser Warnung m"oglich.


    \config{SAMBA\_PRINTER\_x\_TYPE}{SAMBA\_PRINTER\_x\_TYPE}{SAMBAPRINTERxTYPE}
    Um welchen Druckertyp handelt es sich:

        Durch diese Variable muss festgelegt werden, um welche Art von Drucker
        es sich handelt.
        Das Samba-Paket unterscheidet 3 Arten von Druckern: Drucker, die mittels
        LPRng konfiguriert werden und deshalb in der Datei /etc/printcap stehen,
        PDF-Drucker, die "uber /var/install/bin/samba-print-pdf angesprochen
        werden und Fax-Drucker.

\begin{tabular}{p{3cm}|p{9cm}}
        Einstellung    &Druckertyp \\
\hline
        printcap       &F"ur Drucker, die mittels LPRng konfiguriert wurden \\
        pdf            &F"ur Drucker, die PDF-Dateien erzeugen \\
        fax            &F"ur Drucker, "uber die Hyla- oder eisfax angesprochen wird \\
\end{tabular}


    \config{SAMBA\_PRINTER\_x\_PDF\_QUALITY}{SAMBA\_PRINTER\_x\_PDF\_QUALITY}{SAMBAPRINTERxPDFQUALITY}
    Mit welcher Qualit"at sollen PDF-Dateien erzeugt werden:

        Durch diese Variable wird festgelegt, mit welcher Qualit"at
        PDF-Dateien erzeugt werden.
        Diese Variable wird nur ausgewertet, wenn

    \jumplabel{SAMBA\_PRINTER\_x\_TYPE}{SAMBAPRINTERxTYPE}='pdf'

        gesetzt ist.

        Dabei gilt:
        Qualitativ hochwertigere Dateien sind gleichzeitig gr"osser.

        Es werden wie beim Vorbild Acrobat Distiller verschiedene
        Qualit"atsstufen unterst"utzt:

\begin{tabular}{p{3cm}|p{9cm}}
        Einstellung    &Auswirkung \\
\hline
        ''             &Leer bei Verwendung von ghostpdf.ppd als Druckertreiber \\
        default        &Bester Kompromiss zwischen Qualit"at und Gr"osse \\
        screen         &Schlechteste Qualit"at aber daf"ur kleine Dateien \\
        ebook          &Mittlere Qualit"at und mittlere Gr"osse der Dateien \\
        printer        &Bessere Qualit"at, gr"ossere Dateien \\
        prepress       &Beste Qualit"at, daf"ur aber sehr grosse Dateien \\
\end{tabular}

        Die Qualit"at ebook ist erst ab der Version 8 von Ghostscript verf"ugbar.


    \config{SAMBA\_PRINTER\_x\_PDF\_OWNERPASS}{SAMBA\_PRINTER\_x\_PDF\_OWNERPASS}{SAMBAPRINTERxPDFOWNERPASS}
    Das Eigent"umerpasswort f"ur erzeugte PDF-Dateien:

        Ghostscript ab Version 8 unterst"utzt die Vergabe von
        Eigent"umerpassworten f"ur PDF-Dateien. Dieses Passwort ist f"ur das
        weitere Editieren der PDF-Dateien mit Software zur Bearbeitung von
        PDF-Dateien notwendig, wenn es bei der Erstellung vergeben wurde.
        Diese Variable wird nur ausgewertet, wenn

    \jumplabel{SAMBA\_PRINTER\_x\_TYPE}{SAMBAPRINTERxTYPE}='pdf'

        gesetzt ist.

        M"ochte man

    \jumplabel{SAMBA\_PRINTER\_x\_PDF\_USERPASS}{SAMBAPRINTERxPDFUSERPASS}

        setzen, ist es notwendig, auch diese Variable hier zu f"ullen.


    \config{SAMBA\_PRINTER\_x\_PDF\_USERPASS}{SAMBA\_PRINTER\_x\_PDF\_USERPASS}{SAMBAPRINTERxPDFUSERPASS}
    Das Passwort zum "Offnen erzeugter PDF-Dateien:

        Ghostscript ab Version 8 unterst"utzt die Vergabe von
        User-Passworten f"ur PDF-Dateien. Dieses Passwort ist f"ur das
        "Offnen der PDF-Dateien mit dem Acrobar-Reader notwendig, wenn es
        bei der Erstellung vergeben wurde.
        Diese Variable wird nur ausgewertet, wenn

    \jumplabel{SAMBA\_PRINTER\_x\_TYPE}{SAMBAPRINTERxTYPE}='pdf'

        gesetzt ist.

        Weitere Voraussetzung ist die Vergabe von

    \jumplabel{SAMBA\_PRINTER\_x\_PDF\_OWNERPASS}{SAMBAPRINTERxPDFOWNERPASS}


    \config{SAMBA\_PRINTER\_x\_PDF\_PERMS}{SAMBA\_PRINTER\_x\_PDF\_PERMS}{SAMBAPRINTERxPDFPERMS}
    Mit welchen Berechtigungen sollen die PDF-Dateien erzeugt werden:

        Ghostscript ab Version 8 unterst"utzt bei verschl"usselten PDF-Dateien
        die Vergabe von Berechtigungen. Diese Berechtigungen steuern
        Ausdruck, "Anderungen des Inhaltes, Kopieren des Inhalts und das
        Hinzuf"ugen und "Andern von Kommentaren.
        Diese Variable wird nur ausgewertet, wenn

    \jumplabel{SAMBA\_PRINTER\_x\_TYPE}{SAMBAPRINTERxTYPE}='pdf'

        und

    \jumplabel{SAMBA\_PRINTER\_x\_PDF\_OWNERPASS}{SAMBAPRINTERxPDFOWNERPASS}

        gesetzt sind.
        Der Wert der Variablen SAMBA\_PRINTER\_x\_PDF\_PERMS wird wie
        folgt berechnet:

        Der Standard-Wert ist -4. Hierbei besteht keine Beschr"ankung des
        Dokumentes.
        Um die gew"unschte Kombination der Berechtigungen zu erhalten, ist
        der entsprechende Wert (s.u.) vom Standard-Wert zu subtrahieren.

\begin{verbatim}
          1. -4  = Drucken
          2. -8  = Aendern
          3. -16 = Kopieren des Inhaltes
          4. -32 = Hinzufuegen und Aendern von Kommentaren
\end{verbatim}

\begin{tabular}{p{3cm}|p{9cm}}
        Einstellung    &Auswirkung \\
\hline
        ''             &wie -4,          alle erlaubt \\
        -4             &wie '',          alle erlaubt \\
        -8             &alle ausser 1         erlaubt \\
        -12            &alle ausser 2         erlaubt \\
        -16            &alle ausser 1,2       erlaubt \\
        -20            &alle ausser 3         erlaubt \\
        -24            &alle ausser 1,3       erlaubt \\
        -28            &alle ausser 2,3       erlaubt \\
        -32            &alle ausser 1,2,3     erlaubt \\
        -36            &alle ausser 4         erlaubt \\
        -40            &alle ausser 1,4       erlaubt \\
        -44            &alle ausser 2,4       erlaubt \\
        -48            &alle ausser 1,2,4     erlaubt \\
        -52            &alle ausser 3,4       erlaubt \\
        -56            &alle ausser 1,3,4     erlaubt \\
        -60            &alle ausser 2,3,4     erlaubt \\
        -64            &nichts                erlaubt \\
\end{tabular}

        Standardeinstellung: \texttt{SAMBA\_PRINTER\_x\_PDF\_PERMS=}


    \config{SAMBA\_PRINTER\_x\_PDF\_MESSAGES}{SAMBA\_PRINTER\_x\_PDF\_MESSAGES}{SAMBAPRINTERxPDFMESSAGES}
    Sollen bei der Erzeugung von PDF-Dateien NETBIOS-Nachrichten versendet werden: 'yes' oder 'no'

        Mit SAMBA\_PRINTER\_x\_PDF\_MESSAGES wird bestimmt, ob bei der Erzeugung
        von PDF-Dateien NETBIOS-Nachrichten versendet werden sollen oder nicht.
        M"ochte man keine Nachrichten versenden, so setzt man die Variable auf 'no'.
        Das kann zum Beispiel in Terminal-Server-Umgebungen n"utzlich sein, da
        die Nachrichten immer an die IP-Adresse bzw. den NETBIOS-Namen des
        Rechners versendet werden, der den Druckjob abgeschickt hat. Da auf einem
        Terminal-Server der Terminal-Server selbst der absendende Rechner ist,
        erhalten hier alle Nutzer mit offener Terminal-Sitzung die
        Benachrichtigungen, die eigentlich nur f"ur einen bestimmten Benutzer
        gedacht sind.
        Schaltet man die Benachrichtigungen hier ab, erh"alt man allerdings auch
        keine Fehlermeldungen mehr.
        NETBIOS-Nachrichten werden auf Clients mit aktiviertem Nachrichtendienst
        ausgegeben.
        Der Nachrichtendienst ist auf Windows-NT, Windows-2000 und Windows XP
        normalerweise aktiviert und muss anderenfalls nachinstalliert/aktiviert
        werden.
        Unter Windows-9x-Clients wie Windows 98 oder Windows ME muss dazu das
        Programm WinPopUp laufen.
        Unter Windows Vista/7/8/10 existiert kein Nachrichtendienst mehr!

        Standardeinstellung: \texttt{SAMBA\_PRINTER\_x\_PDF\_MESSAGES='yes'}


    \config{SAMBA\_PRINTER\_x\_CAPNAME}{SAMBA\_PRINTER\_x\_CAPNAME}{SAMBAPRINTERxCAPNAME}
    Der Name der x'ten Druckers in der Datei /etc/printcap

        Hiermit muss der Name des x'ten Druckers in der Datei /etc/printcap
        angegeben werden, damit die fertig gespoolte Datei auf dem richtigen
        Drucker ausgegeben werden kann. Wer bei dieser Angabe einen Fehler
        macht, wird keinen Ausdruck erhalten, obwohl die Windows-Clients der
        Meinung sind, korrekt gedruckt zu haben.
        Diese Variable wird nur ausgewertet, wenn

    \jumplabel{SAMBA\_PRINTER\_x\_TYPE}{SAMBAPRINTERxTYPE}='printcap'

        gesetzt ist.
        Lokale parallele Drucker werden in der Datei /etc/printcap beginnend mit
        pr1 durchnummeriert (pr1, pr2, pr3), USB-Drucker mit usbpr1 (usbpr1,
        usbpr2, usbpr3, ...) und Remote-Drucker beginnend mit repr1 (repr1,
        repr2, repr3, repr4 usw.).
        Die Druckerdefinitionen f"ur eisfax und die PDF-Drucker befinden sich
        nicht in /etc/printcap, deshalb muss die Variable dabei leer bleiben!
        Beispiel:

\begin{verbatim}
          SAMBA_PRINTER_1_CAPNAME='pr1'
\end{verbatim}


    \config{SAMBA\_PRINTER\_x\_COMMENT}{SAMBA\_PRINTER\_x\_COMMENT}{SAMBAPRINTERxCOMMENT}
    Der Kommentar der x'ten Druckers in der Netzwerkumgebung

        In dieser Variable kann der in der Netzwerkumgebung angezeigte
        Kommentar konfiguriert werden. Die Variable \glqq{}\%h\grqq{} wird von Samba dabei
        durch den Hostnamen des eisfair{}-Rechners ersetzt.
        Beispiel:

\begin{verbatim}
          SAMBA_PRINTER_1_COMMENT='Laserjet on %h'
\end{verbatim}


    \config{SAMBA\_PRINTER\_x\_CLIENTDRIVER}{SAMBA\_PRINTER\_x\_CLIENTDRIVER}{SAMBAPRINTERxCLIENTDRIVER}
    Soll f"ur den x'ten Drucker der Treiber auf dem Client genutzt werden:
    'yes' oder 'no'

        Diese Variable muss immer dann auf 'yes' gesetzt werden, wenn man auf
        den Clients lokal einen Druckertreiber f"ur den Zugriff auf den/die
        Drucker an eisfair{} installiert und den automatischen Treiber-Download
        von Samba nicht benutzt. Das Hinterlegen von Treibern auf dem Server
        funktioniert mit dieser Einstellung nicht!
        Daraus ergibt sich, dass die Variable genau dann auf 'no' gesetzt werden
        muss, wenn man den automatischen Treiber-Download von Samba benutzt.
        Setzt man hier 'no' aber benutzt einen lokalen Treiber auf den Clients,
        kommt es zu Schwierigkeiten mit der Drucker-Status-Abfrage, wenn man
        auf Windows-NT/-2000/-XP Mitglied der Gruppe der Administratoren ist
        und auf eisfair{} in der /etc/user.map nicht auf den User 'root'
        umgesetzt wird.

        Standardeinstellung: \texttt{SAMBA\_PRINTER\_x\_CLIENTDRIVER='yes'}


    \config{SAMBA\_PRINTER\_x\_BROWSE}{SAMBA\_PRINTER\_x\_BROWSE}{SAMBAPRINTERxBROWSE}
    Soll der x'te Drucker sichtbar sein: 'yes' oder 'no'

        Mit SAMBA\_PRINTER\_x\_BROWSE wird eingestellt, ob der x'te Drucker
        sichtbar sein soll oder nicht. M"ochte man verhindern, dass andere User
        in der Netzwerkumgebung den Drucker sehen k"onnen, setzt man

\begin{verbatim}
          SAMBA_PRINTER_x_BROWSE='no'
\end{verbatim}

        Nutzer, die wissen, dass der Drucker existiert, k"onnen trotzdem darauf
        zugreifen, indem sie z.B. bei der Konfiguration als Netzwerkpfad

          {\textbackslash}{\textbackslash}eisfair{\textbackslash}printer

        eingeben. Dabei ist \glqq{}eisfair\grqq{} durch den Namen des eisfair{}-Rechners
        zu ersetzen - wenn er davon abweicht - und \glqq{}printer\grqq{} mit dem Namen,
        den man in SAMBA\_PRINTER\_x\_NAME eingetragen hat.

        Standardeinstellung: \texttt{SAMBA\_PRINTER\_x\_BROWSE='yes'}


    \config{SAMBA\_PRINTER\_x\_USER}{SAMBA\_PRINTER\_x\_USER}{SAMBAPRINTERxUSER}
    Die User des x'ten Druckers

        Mit dieser Variable wird definiert, welche User oder Gruppen auf den
        x'ten Drucker zugreifen d"urfen. Mehrere User werden hintereinander
        geschrieben und durch ein Leerzeichen getrennt, Gruppen werden mit
        einem + davor angegeben.
        Ein Beispiel:

\begin{verbatim}
          SAMBA_PRINTER_1_USER='user1 user2 +samba'
\end{verbatim}

        Auf die Druckerfreigabe haben also der User \glqq{}user1\grqq{}, der User
        \glqq{}user2\grqq{} und die Gruppe \glqq{}samba\grqq{} Zugriff.
        Wird die Variable nicht gef"ullt, hat nur der User \glqq{}root\grqq{} Zugriff.
        Aber Achtung! Eine Besonderheit gibt es. Wird die Variable

        \jumplabel{SAMBA\_PRINTER\_1\_PUBLIC}{SAMBAPRINTERxPUBLIC}

        auf 'yes' gesetzt, dominiert sie "uber den Eintrag in

\begin{verbatim}
          SAMBA_PRINTER_1_USER
\end{verbatim}

        Es haben dann wieder alle Benutzer Zugriff!
        Bei der Erstellung der Samba-Konfiguration wird "uberpr"uft, ob
        die hier angegebenen User oder Gruppen tats"achlich existieren.
        Ist das nicht der Fall, so wird diese Freigabe mit einer Warnung
        "ubersprungen und ist damit nicht erreichbar. Wer eine solche
        Warnung erh"alt, sollte peinlichst genau kontrollieren, ob
        er sich bei den User- oder Gruppennamen nicht verschrieben hat.


    \config{SAMBA\_PRINTER\_x\_PUBLIC}{SAMBA\_PRINTER\_x\_PUBLIC}{SAMBAPRINTERxPUBLIC}
    Sollen alle Samba-Benutzer Zugriff haben: 'yes' oder 'no'

        Wird diese Variable auf 'yes' gesetzt, haben alle registrierten Samba-
        User auf den Drucker Zugriff. Diese Variable dominiert "uber

\begin{verbatim}
          SAMBA_PRINTER_x_USER='yes'
\end{verbatim}

\end{description}



\subparagraph{Abschnitt \glqq{}Samba Advanced Configuration/Samba Mounts\grqq{}:}
%--------------------------------------------------------

Der Abschnitt wird eingeleitet mit

\begin{verbatim}
#------------------------------------------------------------------------------
# Samba Advanced Configuration/Samba Mounts
#
#  ********************************* ATTENTION ******************************
#  *                                                                        *
#  *                The following Sections only have an Effect,             *
#  *                if you set SAMBA_MANUAL_CONFIGURATION='yes'             *
#  *                                                                        *
#  ********************************* ATTENTION ******************************
#
# Definition of Samba Mounts
#
# Set the number of Samba Mounts to use in SAMBA_MOUNT_N.
#
# Values below are only an example and are not used if
# SAMBA_MOUNT_N is '0'
#------------------------------------------------------------------------------
\end{verbatim}

\achtung{
Die Angaben in diesem Abschnitt haben nur eine Wirkung, wenn

\jumplabel{SAMBA\_MANUAL\_CONFIGURATION}{SAMBAMANUALCONFIGURATION}='yes'

gesetzt wird!
}

\begin{description}
    \config{SAMBA\_MOUNT\_N}{SAMBA\_MOUNT\_N}{SAMBAMOUNTN}
    Definition einer bestimmten Anzahl von einzumountenden Freigaben anderer
    Rechner: z.B. '2'

        "Uber SAMBA\_MOUNT\_N wird die Anzahl der zu mountenden Freigaben
        anderer SMB-Server eingestellt. Diese Freigaben werden bei korrekter
        Definition beim Starten von Samba mit den weiter unten stehenden
        Optionen gemountet und beim Beenden von Samba wieder dismountet.
        Bei einer zu nutzenden Freigabe ist

\begin{verbatim}
          SAMBA_MOUNT_N='1'
\end{verbatim}

        einzutragen. Bei 2 Freigaben ist SAMBA\_MOUNT\_N zu inkrementieren, also

\begin{verbatim}
          SAMBA_MOUNT_N='2'
\end{verbatim}

        Weiterhin m"ussen dann auch die korrespondierenden Einstellungen

\begin{verbatim}
          SAMBA_MOUNT_1_ACTIVE
          SAMBA_MOUNT_1_SERVER
          SAMBA_MOUNT_1_SHARE
          SAMBA_MOUNT_1_POINT
          SAMBA_MOUNT_1_USER
          SAMBA_MOUNT_1_PASS
          SAMBA_MOUNT_1_RW
          SAMBA_MOUNT_1_UID
          SAMBA_MOUNT_1_GID
          SAMBA_MOUNT_1_FMASK
          SAMBA_MOUNT_1_DMASK
          SAMBA_MOUNT_1_IOCHARSET
\end{verbatim}

        und

\begin{verbatim}
          SAMBA_MOUNT_2_ACTIVE
          SAMBA_MOUNT_2_SERVER
          SAMBA_MOUNT_2_SHARE
          SAMBA_MOUNT_2_POINT
          SAMBA_MOUNT_2_USER
          SAMBA_MOUNT_2_PASS
          SAMBA_MOUNT_2_RW
          SAMBA_MOUNT_2_UID
          SAMBA_MOUNT_2_GID
          SAMBA_MOUNT_2_FMASK
          SAMBA_MOUNT_2_DMASK
          SAMBA_MOUNT_2_IOCARSET
\end{verbatim}

        vorhanden und mit sinnvollen Werten gef"ullt sein.

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


    \config{SAMBA\_MOUNT\_x\_ACTIVE}{SAMBA\_MOUNT\_x\_ACTIVE}{SAMBAMOUNTxACTIVE}
    Soll die Mount-Definition aktiv sein: 'yes' oder 'no'

        Mit SAMBA\_MOUNT\_x\_ACTIVE wird bestimmt, ob diese
        Definition zum Einmounten von Freigaben anderer SMB-Server aktiv
        ist oder nicht.
        M"ochte man eine Mount-Definition vor"ubergehend deaktivieren, so
        setzt man die Variable auf 'no'.

        Standardeinstellung: \texttt{SAMBA\_MOUNT\_1\_ACTIVE='yes'}


    \config{SAMBA\_MOUNT\_x\_SERVER}{SAMBA\_MOUNT\_x\_SERVER}{SAMBAMOUNTxSERVER}
    Der NETBIOS-Name des x'ten Servers der einzumountenden Freigabe

        "Uber diese Variable wird der NETBIOS-Name des Servers eingestellt,
        der die Freigabe zur Verf"ugung stellt.
        Es versteht sich sicherlich von selbst, dass ein Server im Netzwerk
        nicht gefunden werden kann, dessen Name hier falsch angegeben wurde.
        Wenn die Freigabe nicht gemountet werden kann, sollte man
        zuallererst kontrollieren, ob die Angabe hier richtig ist.
        Die Konfiguration von SAMBA\_MOUNT\_x\_SERVER ist in jedem Fall
        zwingend erforderlich.


    \config{SAMBA\_MOUNT\_x\_SHARE}{SAMBA\_MOUNT\_x\_SHARE}{SAMBAMOUNTxSHARE}
        Mit SAMBA\_MOUNT\_x\_SHARE wird der Name der x'ten einzumountenden
        Freigabe eingestellt. Diesen Namen habt Ihr bei Erstellung der
        Freigabe auf dem entfernten Rechner konfiguriert und er muss hier
        genau so hinterlegt werden.
        Es versteht sich von selbst, dass keine Verbindung zu einer Freigabe
        im Netzwerk hergestellt werden kann, die namentlich nicht existiert.
        Wenn die Freigabe nicht gemountet werden kann, sollte man also
        "uberpr"ufen, ob die Angabe hier richtig ist.
        Die Konfiguration von SAMBA\_MOUNT\_x\_SHARE ist in jedem Fall
        zwingend erforderlich.


    \config{SAMBA\_MOUNT\_x\_POINT}{SAMBA\_MOUNT\_x\_POINT}{SAMBAMOUNTxPOINT}
    Der Punkt im Verzeichnisbaum, in den die Freigabe eingemountet werden
    soll: z.B. '/mountpoint1'

        Die entfernte Freigabe muss in den Verzeichnisbaum eingehangen werden.
        In dieser Variable definiert man, an welcher Stelle das geschehen soll.
        Dazu ist ein absoluter Pfad beginnend mit dem '/' anzugeben.
        M"ochte man die Freigabe also unter

\begin{verbatim}
          /mountpoint1
\end{verbatim}

        in den Verzeichnisbaum einbinden, ist beim ersten Mount

\begin{verbatim}
          SAMBA_MOUNT_1_POINT='/mountpoint1'
\end{verbatim}

        anzugeben. Wenn das Verzeichnis nicht existiert, wird es automatisch
        angelegt und wenn es existiert, wird es einfach benutzt. Es gibt im
        Moment keine M"oglichkeit, einmal erstellte Verzeichnisse "uber die
        Samba-Konfiguration zu l"oschen.
        Beachtet ausserdem, dass nicht zwei verschiedene Freigaben unter
        dem selben Mountpoint eingehangen werden k"onnen. Hat man also f"ur
        den Mountpoint der ersten entfernten Freigabe

\begin{verbatim}
          SAMBA_MOUNT_1_POINT='/mountpoint1'
\end{verbatim}

        gesetzt, darf dieser Mountpoint f"ur weitere Freigaben nicht mehr
        benutzt werden.
        Die Konfiguration von SAMBA\_MOUNT\_x\_POINT ist in jedem Fall
        zwingend erforderlich.


    \config{SAMBA\_MOUNT\_x\_USER}{SAMBA\_MOUNT\_x\_USER}{SAMBAMOUNTxUSER}
    Die User f"ur die Anmeldung an der x'ten Freigabe

        Mit dieser Variable wird der Benutzername definiert, mit welchem
        auf die entfernte Freigabe zugegriffen wird.
        Wenn der Zugriff auf die entfernte Freigabe nur mittels Benutzername
        gestattet ist, muss dieser Benutzername hier angegeben werden.
        Ein Beispiel:

\begin{verbatim}
          SAMBA_MOUNT_x_USER='user1'
\end{verbatim}

        Die Angabe ist optional, also nur unter der oben beschriebenen
        Voraussetzung notwendig.


    \config{SAMBA\_MOUNT\_x\_PASS}{SAMBA\_MOUNT\_x\_PASS}{SAMBAMOUNTxPASS}
    Das Passwort f"ur die Anmeldung an der x'ten Freigabe

        Wurde die entfernte Freigabe mit einem Passwort oder mit einer
        Kombination von Benutzernamen und Passwort gesichert, so ist das
        Passwort in dieser Variable wie folgt anzugeben:

\begin{verbatim}
          SAMBA_MOUNT_x_PASS='geheim'
\end{verbatim}

        Die Angabe ist optional, also nur unter den oben beschriebenen
        Voraussetzungen notwendig.


    \config{SAMBA\_MOUNT\_x\_RW}{SAMBA\_MOUNT\_x\_RW}{SAMBAMOUNTxRW}
    Soll die eingemountete Freigabe beschreibbar sein: 'yes' oder 'no'

        "Uber SAMBA\_MOUNT\_x\_RW wird eingestellt, ob die x'te eingemountete
        Freigabe beschreibbar sein soll.

        Wird hier 'no' gew"ahlt, k"onnen Dateien von dieser Freigabe gelesen
        aber nicht dorthin gespeichert werden. Das ist vor allem bei Dateien
        sinnvoll, die man anderen zur Verf"ugung stellen m"ochte aber dabei
        unbedingt verhindern will, dass diese Dateien ver"andert oder sogar
        gel"oscht werden.


    \config{SAMBA\_MOUNT\_x\_UID}{SAMBA\_MOUNT\_x\_UID}{SAMBAMOUNTxUID}
    Welchem User sollen die Dateien der eingemounteten Freigabe geh"oren?

        "Uber SAMBA\_MOUNT\_x\_UID wird bestimmt, wer der Besitzer der
        eingemounteten Dateien ist. Das bedarf einer n"aheren Erkl"arung:

        Das cifs-Modul, welches nicht zu Samba geh"ort, sondern Bestandteil
        des Kernels ist, hat leider ein paar Einschr"ankungen.
        So ist es unter anderem nicht m"oglich, Berechtigungen der entfernten
        Dateien im lokalen Dateisystem abzubilden.
        Deshalb m"ussen ersatzweise andere Berechtigungen definiert werden.
        Das macht man mittels der Variablen

\begin{verbatim}
          SAMBA_MOUNT_x_UID

          und

          SAMBA_MOUNT_x_GID
\end{verbatim}

        Werden diese nicht gef"ullt, so geh"oren die Dateien dem User und der
        Gruppe 'root', mit dem die Freigabe gemountet wird.
        Wenn man eingemountete Dateien als einfacher User nicht bearbeiten
        kann, dann weiss man jetzt, warum das so ist.
        Die Variable kann wie folgt gef"ullt werden:

\begin{verbatim}
          SAMBA_MOUNT_x_UID='user1'

          oder

          SAMBA_MOUNT_x_UID='2002'
\end{verbatim}

        Im ersten Beispiel wurde ein existierender Benutzername angegeben, im
        zweiten Beispiel die numerische User-Id.
        Die Angabe ist optional, also nur unter den oben beschriebenen
        Voraussetzungen notwendig.


    \config{SAMBA\_MOUNT\_x\_GID}{SAMBA\_MOUNT\_x\_GID}{SAMBAMOUNTxGID}
    Welcher Gruppe sollen die Dateien der eingemounteten Freigabe geh"oren?

        "Uber SAMBA\_MOUNT\_x\_GID wird bestimmt, welche Gruppe der Besitzer
        der eingemounteten Dateien ist.
        Siehe dazu die Erkl"arungen unter

        \jumplabel{SAMBA\_MOUNT\_x\_UID}{SAMBAMOUNTxUID}

        Die Variable kann wie folgt gef"ullt werden:

\begin{verbatim}
          SAMBA_MOUNT_x_GID='users'

          oder

          SAMBA_MOUNT_x_GID='100'
\end{verbatim}

        Im ersten Beispiel wurde ein existierender Gruppenname angegeben, im
        zweiten Beispiel die numerische Gruppen-Id.
        Die Angabe ist optional, also nur unter den oben beschriebenen
        Voraussetzungen notwendig.


    \config{SAMBA\_MOUNT\_x\_FMASK}{SAMBA\_MOUNT\_x\_FMASK}{SAMBAMOUNTxFMASK}
    Welche Rechte sollen neu erzeugte Dateien in der eingemounteten Freigabe
    erhalten?

        "Uber SAMBA\_MOUNT\_x\_FMASK wird eingestellt, welche Rechte Dateien
        erhalten, die in der eingemounteten Freigabe neu erstellt werden.
        Wird die Variable nicht gef"ullt, so werden die Rechte basierend auf
        der aktuellen umask des mountenden Users gesetzt.

        Die Variable kann wie folgt gef"ullt werden:

\begin{verbatim}
          SAMBA_MOUNT_x_FMASK='0755'
\end{verbatim}


    \config{SAMBA\_MOUNT\_x\_DMASK}{SAMBA\_MOUNT\_x\_DMASK}{SAMBAMOUNTxDMASK}
    Welche Rechte sollen neu erzeugte Verzeichnisse in der eingemounteten
    Freigabe erhalten?

        Siehe dazu die Erkl"arungen unter

        \jumplabel{SAMBA\_MOUNT\_x\_FMASK}{SAMBAMOUNTxFMASK}

        Die Variable kann wie folgt gef"ullt werden:

\begin{verbatim}
          SAMBA_MOUNT_x_DMASK='0755'
\end{verbatim}


    \config{SAMBA\_MOUNT\_x\_IOCHARSET}{SAMBA\_MOUNT\_x\_IOCHARSET}{SAMBAMOUNTxIOCHARSET}
    Angabe des Character-Sets

        Mit SAMBA\_MOUNT\_x\_IOCHARSET wird eingestellt, welches charset auf
        eisfair{}-Seite f"ur die Umsetzung von Codepages zu Character-Sets f"ur
        die x'te einzumountende Freigabe benutzt werden soll.
        Die Variable kann mit folgenden Werten gef"ullt werden:

\begin{verbatim}
          iso8859-1
          iso8859-2
          iso8859-3
          iso8859-4
          iso8859-5
          iso8859-6
          iso8859-7
          iso8859-8
          iso8859-9
          iso8859-14
          iso8859-15
          koi8-r
          koi8-ru
          utf8
\end{verbatim}

        Bei einer Environment-Einstellung wie

\begin{verbatim}
          LC_CTYPE='de_DE.UTF-8'
\end{verbatim}

        sollte korrespondierend

\begin{verbatim}
          SAMBA_MOUNT_x_IOCHARSET='utf8'
\end{verbatim}

        gesetzt werden - anderenfalls

\begin{verbatim}
          SAMBA_MOUNT_x_IOCHARSET='iso8859-15'
\end{verbatim}


\end{description}




Der n"achste Eintrag im Men"u

\begin{verbatim}
   Samba Configuration Handling
\end{verbatim}

heisst

\begin{verbatim}
   Show all Samba Variables
\end{verbatim}

und gibt ausf"uhrliche Informationen zur aktiven Konfiguration aus.
Daf"ur werden diese Informationen gesammelt und gemeinsam angezeigt.
Zur Zeit wird der Inhalt der Datei

\begin{verbatim}
   /etc/user.map
\end{verbatim}

ausgegeben, in welcher Windows-Benutzer auf eisfair{}-Benutzer
umgesetzt werden, sowie alle von Samba verwendeten Parameter der
Datei

\begin{verbatim}
   /etc/smb.conf
\end{verbatim}

und auch alle Voreinstellungen von Samba, die dort nicht explizit
gesetzt wurden aber trotzdem wirksam sind.

Der n"achste Eintrag im Men"u

\begin{verbatim}
   Samba Configuration Handling
\end{verbatim}

heisst

\begin{verbatim}
   Samba Advanced configuration file handling
\end{verbatim}

und ist weitgehend selbsterkl"arend.




\paragraph{Samba-Service-Men"u Punkt 3: Samba User Handling}
%------------------------------------------------------

 Hier finden wir folgende Men"u-Punkte:

\begin{verbatim}
   1: List Samba User

   2: Add Samba User

   3: Remove Samba User

   4: Activate Existing Samba User

   5: Deactivate Existing Samba User

   6: Change Samba Password of existing Samba User

   0: Exit
\end{verbatim}

 Um sich einen "Uberblick "uber schon existierende Samba-User zu verschaffen,
 w"ahlt man

\emph{1: List Samba User}

 Zus"atzlich zum Namen wird die UID des dem Samba-User zugeordneten
 eisfair{}-Users (es k"onnen nur Samba-User angelegt werden, die schon als
 eisfair{}-User existieren), der Status des Passwortes (gesetzt oder nicht)
 und der augenblickliche Status des Samba-Accounts (aktiviert oder nicht)
 ausgegeben.

 Damit die Benutzer der Windows-Clients den Sambaserver nutzen k"onnen, m"ussen
 sie beim Sambaserver bekannt sein. Als Samba-User k"onnen nur bereits bekannte
 (angelegte) User des eisfair{}-Systems angelegt werden. M"ochte man also einen
 Samba-User anlegen, der noch nicht als eisfair{}-User existiert, so wird das
 nicht gelingen!
 eisfair{}-User werden nicht im Samba-Men"u angelegt, sondern im
 eisfair{}-Setup-Men"u unter

\begin{verbatim}
   4: User administration
\end{verbatim}

\begin{verbatim}
   2: Add a new user
\end{verbatim}

 Wenn man sicher ist, dass der entsprechende eisfair{}-User existiert, kann
 man unter

\marklabel{SAMBADDUSER}{Add Samba User}\emph{2: Add Samba User}

 die Samba-User anlegen.


 Hier werden Benutzername und das Passwort des anzulegenden Users abgefragt.
 Das sind die Daten, mit denen man sich am Windows-Client anmeldet.

 Ein paar Hinweise dazu:
 Es ist unbedingt der User \glqq{}root\grqq{} als Samba-User anzulegen (als
 eisfair{}-User existiert \glqq{}root\grqq{} schon).
 F"ur jeden Benutzer muss bei der Windows-Anmeldung zwingend ein Passwort
 hinterlegt sein und der Samba-User muss das identische Passwort haben!
 Unter Windows XP sollte unbedingt die schnelle Benutzerumschaltung deaktiviert
 werden.
 Benutzernamen mit Leerzeichen kann man beim Anlegen der Samba-User genauso wenig
 verwenden, wie bei den eisfair{}-Usern. Verwendet man solch einen Namen auf
 seinem Windows-Client zur Anmeldung, muss man einen Namen ohne Leerzeichen
 als eisfair{}-User und als Samba-User einrichten und zu diesem Namen hier ein
 Passwort definieren. Siehe dazu:

        \jumplabel{SAMBA\_USERMAP\_N}{SAMBAUSERMAPN}

 Um User als Samba-User zu entfernen, w"ahlt man den Eintrag

\emph{3: Remove Samba User}

 und gibt den Namen des zu entfernenden Samba-Users ein. Dabei wird nach Angabe
 des Usernamens der entsprechende Samba-User gel"oscht (das bezieht sich nicht
 auf den Account auf der Ebene des eisfair{}-Systems, sondern nur auf Samba).


 Um einen schon angelegten aber vor"ubergehend deaktivierten Samba-User zu
 aktivieren, w"ahlt man

\emph{4: Activate Existing Samba User}

 Noch einmal:
 Man kann nur schon als System-User und Samba-User angelegte User aktivieren!
 Das ist nur notwendig, wenn ein User vor"ubergehend deaktiviert worden ist.


 Um einen schon angelegten (und damit automatisch aktivierten) Samba-User zu
 deaktivieren, w"ahlt man

\emph{5: Deactivate Existing Samba User}

 Noch einmal:
 Man kann nur schon als System-User und Samba-User angelegte User deaktivieren!
 Damit wird nur der Zugriff "uber Samba ausgeschlossen.
 Das macht nur Sinn, wenn der User zeitweise keinen Zugriff "uber die
 Netzwerkumgebung erhalten soll.

\emph{6: Change Samba Password of existing Samba User}

 Hiermit kann das Samba-Passwort existierender Samba-User ge"andert werden.


\paragraph{Samba-Service-Men"u Punkt 4: Samba Server Handling}
%--------------------------------------------------------

 Dieser Punkt des Samba-Service-Men"us "offnet ein Untermen"u mit den
 folgenden M"oglichkeiten:

\begin{verbatim}
   1: Show Status of Samba

   2: Stop Samba

   3: Stop Samba delayed

   4: Start Samba

   5: Restart Samba

   6: Reload Samba

   0: Exit
\end{verbatim}

 Die Punkte sind selbsterkl"arend.
 Der Unterschied zwischen 'Restart' und 'Reload' besteht darin, dass Samba
 bei 'Restart' komplett beendet und neu gestartet wird, w"ahrend 'Reload' nur
 die Konfiguration neu einliest - bestehende Verbindungen werden dabei nicht
 gekappt. Eine Ausnahme bilden die auf eisfair{} eingemounteten Freigaben
 anderer Rechner. Diese werden sowohl bei 'Restart' als auch bei 'Reload'
 beendet und wieder neu aufgebaut.


\paragraph{Samba-Service-Men"u Punkt 5:  Samba Domain Handling}
%--------------------------------------------------------

 Hier findet man folgende Men"u-Punkte:

\begin{verbatim}
   1: Samba PDC Workstation Configuration (NT, 2000, XP)

   2: Add eisfair Samba Server into an Windows NT Domain

   3: Save Samba SID to /root/MACHINE.SID

   4: Restore Samba SID from /root/MACHINE.SID

   0: Exit
\end{verbatim}


\subparagraph{Samba PDC Workstation Configuration (NT, 2000, XP)}
%--------------------------------------------------


\emph{1: List Samba Workstations}

Mit dem ersten Punkt kann man sich die erzeugten Workstation-Accounts
anzeigen lassen.


\emph{2: Add Samba Workstation}

Mit dem zweiten Punkt kann man manuell Workstation-Accounts anlegen, die f"ur
den Zugriff von Windows-NT-, Windows-2000- oder Windows-XP-Clients auf den als
Primary Domain Controller (PDC) konfigurierten eisfair{}-Samba-Server ben"otigt
werden (Windows-9x-Clients m"ussen nicht eingetragen werden!).
Da das fehleranf"allig ist (Gross- und Kleinschreibung der NETBIOS-Namen ist zu
beachten), sollte man das aber lieber Samba selbst "uberlassen, welches bei
korrekter Konfiguration diese Accounts automatisch erzeugt.

\emph{3: Remove Samba Workstation}

Der dritte Punkt erlaubt es, Workstation-Accounts zu l"oschen; damit ist von
diesen Clients aus kein Zugriff mehr auf den als PDC konfigurierten
eisfair{}-Samba-Server m"oglich.
Das sollte man sich jedoch gut "uberlegen, denn auch wenn manuell wieder ein
Account mit dem selben NETBIOS-Namen erzeugt wird, so ist es doch ein neuer
Account und die Workstation kann sich erst wieder an der Dom"ane anmelden,
wenn sie ihr neu hinzugef"ugt wurde!


\subparagraph{Add eisfair Samba Server into an Windows NT Domain}
%--------------------------------------------------

Hier kann man den eisfair{}-Rechner in eine Windows-NT-4.0-Dom"ane integrieren.
Das ist nur sinnvoll, wenn man in seinem Netzwerk eine solche Dom"ane hat und
die auf den eisfair{}-Samba-Server zugreifenden Benutzer in dieser Dom"ane
authentifizieren m"ochte.

Bevor man diesen Punkt ausf"uhren kann, muss man auf dem Primary Domain
Controller den eisfair{}-Rechner mit dem Server Manager unter dem Men"u-Punkt

\begin{verbatim}
   Computer
   Neuer Computer
\end{verbatim}

als neuen Rechner hinzugef"ugen (Maschinenkonto).
Bei einer Windows-2000-Dom"ane muss ausserdem f"ur dieses Maschinenkonto
folgende Eigenschaft aktiviert werden:

\glqq{}Windows NT 3.5x/4.0-Computern die Verwendung dieses Kontos gestatten\grqq{}

Dann w"ahlt man den Eintrag

\begin{verbatim}
   Add eisfair Samba Server into an Windows NT Domain
\end{verbatim}

Hierbei ist zu beachten, dass zum erfolgreichen Hinzuf"ugen zur Dom"ane die
Samba-Dienste gestoppt werden m"ussen! Beim Aufruf wird "uberpr"uft, ob Samba
l"auft. Wenn das der Fall, wird das Skript mit einer entsprechenden Warnung
beendet.
Man sollte mit der Ausf"uhrung also warten, bis keine Clients mehr auf den
eisfair{}-Samba-Server zugreifen. Dann kann man Samba stoppen und diesen
Men"u-Punkt ausf"uhren.

Zuallererst wird dann der Benutzernamen und das Passwort des
Administrator-Accounts auf dem Primary Domain Controller (NT 4.0) abgefragt,
da nur dieser Maschinen zur Dom"ane hinzuf"ugen darf. Das Passwort wird aus
Sicherheitsgr"unden bei der Eingabe auf dem Bildschirm nicht angezeigt - man
muss es also blind eintippen!
Dann muss der NETBIOS-Name des Primary Domain Controllers (NT 4.0) angegeben
werden und zum Schluss der Name der Dom"ane.

Wenn alles geklappt hat, erh"alt man die erfreuliche Meldung

\begin{verbatim}
   Joined domain YYY.
\end{verbatim}

, wenn nicht

\begin{verbatim}
   Error connecting to XXX
   Unable to join domain YYY.
\end{verbatim}

, wobei XXX f"ur den Namen des Primary Domain Controllers steht und YYY f"ur den
Namen der Dom"ane. Wenn man Erfolg hatte, muss nun noch die Samba-Konfiguration
editiert werden (Edit Samba Configuration):

Die Variable

\jumplabel{SAMBA\_PASSWORD\_SERVER}{SAMBAPASSWORDSERVER}

muss mit dem NETBIOS-Namen des Primary Domain Controllers oder mit '*' gef"ullt
werden, siehe auch die Erl"auterungen unter

\jumplabel{SAMBA\_PASSWORD\_SERVER}{SAMBAPASSWORDSERVER}.


\subparagraph{Save Samba SID to /root/MACHINE.SID}
%-----------------------------------

Muss man irgendwann einmal den Hostnamen des eisfair{}-Rechners "andern und
l"auft dieser als Primary Domain Controller, so hat das einen unsch"onen
Nebeneffekt:

Clients , welche schon zur Dom"ane hinzugef"ugt waren, k"onnen sich nicht
mehr an dieser anmelden.

Woran das liegt?

Beim Hinzuf"ugen zur Dom"ane bekommt der Client vom PDC eine Sicherheits-ID
mitgeteilt und speichert diese ab. Diese Sicherheits-ID wird aber von Samba
nach einer "Anderung des Hostnamens neu generiert. Da nun die SID des PDC und
der Clients nicht mehr "ubereinstimmen, kann sich von den Clients niemand mehr
an der Dom"ane anmelden.

Normalerweise muss man nun alle Clients wieder m"uhsam neu in der Dom"ane
anmelden:
Jede einzelne Workstation muss tempor"ar in eine Arbeitsgruppe mit anderem Namen
als dem Dom"anen-Namen aufgenommen und hinterher wieder neu in die Dom"ane
integriert werden. Das erfordert ein zweimaliges Booten der Clients und kann bei
vielen Maschinen sehr zeitaufwendig werden...

Eleganter ist daher folgende Methode:
Vor einer "Anderung des Hostnamens von eisfair{} speichert man die SID und stellt
diese hinterher wieder her. Mit diesem Men"u-Punkt wird die vor den Blicken
anderer zu sch"utzende SID im Home-Verzeichnis von root in der Datei

\begin{verbatim}
   /root/MACHINE.SID
\end{verbatim}

abgespeichert.


\subparagraph{Restore Samba SID from /root/MACHINE.SID}
%----------------------------------------

Hiermit wird die SID aus der Datei

\begin{verbatim}
   /root/MACHINE.SID
\end{verbatim}

in die Samba-Datenbank zur"uckgesichert.


\paragraph{Samba-Service-Men"u Punkt 6: SMB Filesystem Handling}
%----------------------------------------------------------

Hier findet man:

\begin{verbatim}
   1: List Mounted SMB Filesystems

   2: Mount SMB Filesystems

   3: Mount predefined SMB Filesystems

   4: Dismount SMB Filesystems

   0: Exit
\end{verbatim}

Diese Punkte sind dazu gedacht, Freigaben von SMB-Servern (das k"onnen Rechner
fast beliebiger Betriebssysteme sein, die das SMB-Protokoll unterst"utzen)
in das Dateisystem von eisfair{} einzumounten und wieder zu dismounten.


1: List Mounted SMB Filesystems

Hier werden, wenn vorhanden, die eingemounteten Freigaben angezeigt. Den
Mountpoint (das Verzeichnis, in welches gemountet wurde) findet man unter
dem gleichnamigen Eintrag.


2: Mount SMB Filesystems

Um diesen Punkt benutzen zu k"onnen, muss Samba gestartet sein. Ist das nicht
der Fall, erh"alt man eine entsprechende Warnung und das Skript wird beendet.
L"auft Samba, wird zuerst der NETBIOS-Name des Rechners angegeben, dessen
Freigabe man einbinden will. Diese Eingabe ist nicht case-sensitiv, was
bedeutet, dass nicht auf die Gross- und Kleinschreibung geachtet werden muss.
Wird der SMB-Server nicht gefunden, erh"alt man sofort eine entsprechende
Fehlermeldung.
Als n"achstes ist der Name der Freigabe einzugeben. Auch diese Eingabe ist
nicht case-sensitiv. Hier kann leider nicht gepr"uft werden, ob die Freigabe
existiert, da je nach Einstellung ein Benutzername und ein Passwort f"ur die
Abfrage der Shares notwendig ist.
Nun ist das Verzeichnis anzugeben, in welches man die Freigabe einmounten
m"ochte. Hier ist ein absoluter Pfad im Dateisystem anzugeben. Solch ein Pfad
muss immer mit einem '/', z.B.:

\begin{verbatim}
   /mountpoint
\end{verbatim}

beginnen!
Das Verzeichnis wird automatisch erstellt, wenn es nicht vorhanden ist.
Wenn es schon vorhanden ist, kann es nur benutzt werden, wenn sich keinerlei
Dateien oder Verzeichnisse darin befinden.
Ist das Verzeichnis nicht leer, erh"alt man eine Fehlermeldung. Ist das
Verzeichnis nicht leer, weil man hier schon eine Freigabe eingemountet hat,
erh"alt man die M"oglichkeit, die schon gemountete Freigabe zu trennen, um die
neue Freigabe statt dessen einmounten zu k"onnen. Das sollte man nur tun, wenn
man sicher ist, dass niemand mehr auf diese Dateien zugreift!
"Ubergeht man die Frage mit Enter, so wird als Mountpoint die Vorgabe

\begin{verbatim}
   /mountpoint
\end{verbatim}

verwendet.
Nun m"ussen f"ur den Zugriff Benutzername und Passwort angegeben werden,
wenn diese f"ur die Freigabe definiert wurden. Diese Angaben sind
case-sensitiv! Das Passwort wird aus Sicherheitsgr"unden bei der Eingabe
auf dem Bildschirm nicht angezeigt - man muss es also blind eintippen!

In n"achsten Schritt wird abgefragt, ob die Freigabe nur lesbar (ro)
oder auch schreibbar eingemountet werden soll (rw). Bet"atigen von
Enter verwendet die Voreinstellung 'rw'.

Als n"achstes wird gefragt, unter welcher User-Id die Freigabe gemountet
werden soll. Bet"atigen von Enter verwendet die Voreinstellung 'root'.

Danach wird die Group-Id abgefragt. Auch hier "ubernimmt ein einfaches
Enter die Voreinstellung 'root'.
In den n"achsten Schritten folgen file mask, directory mask und iocharset.

Wenn alle Angaben korrekt waren, kann man nun in dem Verzeichnis (Mountpoint)
mit den Dateien arbeiten, als ob sie lokal auf dem Rechner liegen w"urden.

Achtung:
Wurden die Dateien ohne Schreibschutz freigegeben, kann man sie nat"urlich
auf dem entfernten Rechner l"oschen, indem man sie im Dateisystem auf eisfair{}
l"oscht. L"oscht man z.B. das Verzeichnis, in welches die Freigabe
eingemountet wurde, werden ohne Schreibschutz s"amtliche Dateien dieser
Freigabe auf dem entfernten Rechner gel"oscht!


3: Mount predefined SMB Filesystems

Hiermit kann man in der Samba-Konfiguration vordefinierte Mounts einmountet,
unabh"angig davon, ob sie aktiv sind oder nicht.


4: Dismount SMB Filesystems

Hier"uber kann man die eingemounteten Freigaben wieder dismounten.
Man hat die Wahl zwischen zwei Optionen:

1. Option

Alle Freigaben trennen. Dazu gibt man

\begin{verbatim}
   all
\end{verbatim}

ein.

2. Option

Einzelne Freigaben trennen. Dazu gibt man die exakten Namen der
Verzeichnisse an, in die sie gemountet wurden, getrennt durch ein
Leerzeichen. Dazu ist es notwendig, auch das f"uhrende '/' mit anzugeben.
Die Eingabe ist case-sensitiv - Gross- und Kleinschreibung muss
also beachtet werden, also z.B.:

\begin{verbatim}
   /mountpoint1 /MOUNTPOINT2
\end{verbatim}


\paragraph{Samba-Service-Men"u Punkt 7: Send Message to SMB Hosts}
%------------------------------------------------------------

Unter

6: Send Message to SMB Hosts

kann man interaktiv Nachrichten an SMB-Hosts versenden.
Bei Auswahl dieses Eintrags erscheint folgende Ausgabe:


\begin{verbatim}
   Send Message to SMB Hosts

   To which SMB Hosts the message should be send?

   Choice 1
   --------
   All SMB Hosts on configured Subnets on eisfair - type 'all'.

   Choice 2
   --------
   eisfair Samba Clients with active connections - type 'active'.

   Choice 3
   --------
   One ore more active SMB Hosts, type NETBIOS Names
   separated with a blank, for instance 'client1 client2':
\end{verbatim}

Wie man hier sieht, gibt es im ersten Schritt 3 Auswahlm"oglickeiten:

\begin{enumerate}
\item
Das Versenden von Nachrichten an alle SMB-Rechner an den konfigurierten Netzen
des eisfair{}-Rechners. Da Samba bei Erstellung seiner Konfiguration auf die Datei

\begin{verbatim}
       /etc/config.d/base
\end{verbatim}

zugreift, werden alle Netzwerkkarten, die hier konfiguriert sind, auch in die
Samba-Konfiguration eingetragen. Hieraus wird nun die Information gewonnen, in
welchen Netzen nach SMB-Rechnern gesucht werden muss und an alle diese Rechner
(bis auf den eisfair{}-Rechner selbst) die noch zu definierende Nachricht verschickt.
Dabei werden die ermittelten Broadcast-Adressen und die NETBIOS-Namen der
Rechner ausgegeben, an die die Nachricht verschickt wurde.
Um diese Option zu w"ahlen, ist

\begin{verbatim}
       all
\end{verbatim}

einzugeben.

\item
Das Versenden von Nachrichten an alle eisfair{}-Samba-Clients mit aktiven
Verbindungen zu eisfair{} - damit sind nicht alle Clients gemeint, die sich am
Server angemeldet haben, sondern nur die, die wirklich noch Verbindungen zum
Server offen halten. Hierzu ist

\begin{verbatim}
       active
\end{verbatim}

einzugeben.

\item
Das Versenden von Nachrichten an einen oder mehrere aktive SMB-Hosts.
Die Rechner sind mit ihren NETBIOS-Namen anzugeben. Mehrere Rechner m"ussen
durch ein Leerzeichen getrennt angegeben werden.
Wurden die erforderlichen Angaben gemacht, kommen wir zum 2. Schritt:

\begin{verbatim}
       Send Message to SMB Hosts

       Which Message should be send?
       For instance 'eisfair-Samba-Server is going down in 3 Minutes ...':
\end{verbatim}

Hier gibt man nun die Nachricht ein, die gesendet werden soll.
Diese Nachricht wird nur auf Clients mit aktiviertem Nachrichtendienst
ausgegeben. Der Nachrichtendienst ist auf Windows-NT, Windows-2000 und
Windows XP normalerweise aktiviert und muss anderenfalls
nachinstalliert/aktiviert werden.
Unter Windows-9x-Clients wie Windows 98 oder Windows ME muss dazu das
Programm WinPopUp laufen.
Unter Windows Vista/7/8/10 existiert kein Nachrichtendienst mehr!
Das Skript, welches hier verwendet wird, kann man auch per Kommandozeile
mittels

\begin{verbatim}
       /var/install/bin/samba-netsend
\end{verbatim}

aufrufen.
\end{enumerate}


\paragraph{Samba-Service-Men"u Punkt 7: Read Samba Documentation}
%-----------------------------------------------------------

Mit diesem Men"u-Punkt wird die hier vorliegende Dokumentation zum Lesen mittels
more oder einem anderen konfigurierten Pager ge"offnet.
more ist ein Programm, welches es erlaubt, auch l"angere Textdateien, wie diese
Dokumentation, komfortabel zu lesen. Mittels Leertaste bl"attert man ganze
Seiten weiter und mittels Entertaste einzelne Zeilen. Zum Verlassen der
Dokumentation dr"uckt man die Taste 'q'.


\section{Client-Konfiguration}

\subsection{Konfiguration der Windows-Clients}
%=====================================

Auf den Windows-Rechnern muss das Netzwerkprotokoll TCP/IP installiert und
konfiguriert sein. Als Standardeinstellung ist unter Windows 9x/Me \glqq{}NETBIOS
over TCP/IP\grqq{} aktiviert, das Protokoll, welches Samba benutzt.
Unter Windows NT/2000/XP/7/8/10 muss diese Einstellung explizit vorgenommen werden!


\subsection{4.1.1 WIN 9x/ME}
%---------------

Das Protokoll TCP/IP muss installiert und konfiguriert werden. Als
Standardeinstellung ist unter Windows 9x/Me \glqq{}NETBIOS over TCP/IP\grqq{}
aktiviert, das Protokoll, welches Samba benutzt.
Alle nicht genutzten Netzwerkprotokolle sollten entfernt werden, z.B. NETBUI,
IPX/SPX, Fritz-Web, T-Online-Speedmanager usw. \dots
Die Datei- und Druckerfreigabe sollte installiert werden - damit kann man
kontrollieren, ob der eigene Rechner im Netzwerk auftaucht.
Der \glqq{}Client f"ur Microsoftnetzwerke\grqq{} sollte installiert und konfiguriert werden.
Die verschiedenen Clients m"ussen unterschiedliche NETBIOS-Namen erhalten:
Unter
/Start /Einstellungen /Systemsteuerung /Netzwerk /Lasche Identifikation /Rechnername
muss ein im Netzwerk einmaliger NETBIOS-Name vergeben werden.
Unter /Start /Einstellungen /Systemsteuerung /Lasche Identifikation /Arbeitsgruppe
muss der Arbeitsgruppename identisch zu der Einstellung von Samba gew"ahlt
werden (\jumplabel{SAMBA\_WORKGROUP}{SAMBAWORKGROUP}).
Personal Firewalls sollten deaktiviert bzw. richtig konfiguriert sein:
Die Ports 137-139 m"ussen freigeschaltet sein!

Um Samba mit WIN9x zu nutzen, ist es sinnvoll, in der Systemsteuerung ein
Benutzerprofil anzulegen. Das bringt neben der Vorbereitung auf Samba im
Dom"anen-Modus und damit verbundenen \glqq{}Roaming Profiles\grqq{} den Vorteil, dass bei
mehreren Benutzern am Client-Rechner jeder seine eigenen Einstellungen f"ur
Desktop, Startmen"u usw. einrichten kann. Ausserdem kann man hierbei nachholen,
ein Passwort f"ur seine Anmeldung zu vergeben.

L"auft Samba als PDC, so ist in den Eigenschaften des \glqq{}Client f"ur Microsoftnetzwerke\grqq{}
unter \glqq{}Anmeldebest"atigung\grqq{} ein Haken f"ur \glqq{}An Windows NT-Dom"ane anmelden\grqq{}
zu setzen, unter \glqq{}Windows NT-Dom"ane\grqq{} ist der Namen der Samba-Dom"ane
anzugeben. Um die Benutzerkonten der Dom"ane f"ur eigene Freigaben nutzen zu k"onnen,
muss unter \glqq{}Netzwerk /Zugriffssteuerung\grqq{} von \glqq{}Zugriffssteuerung auf Freigabeebene\grqq{}
auf \glqq{}Zugriffssteuerung auf Benutzerebene\grqq{} umgeschaltet werden.
Die Benutzerkonten werden von Samba als PDC bezogen. Um die Benutzerliste
beziehen zu k"onnen, muss man bereits als Dom"anen-Benutzer angemeldet sein!


\subsection{WIN-NT}
%------------

please fill in


\subsection{Windows 2000}
%--------------

Das Protokoll TCP/IP muss installiert und konfiguriert werden.
Folgende Dienste sind auf dem Rechner f"ur Samba notwendig/sinnvoll:

\begin{itemize}
\item
Arbeitsstationsdienst
\item
Computerbrowser
\item
Nachrichtendienst
\item
Server
\end{itemize}

Alle nicht genutzten Netzwerkdienste sollten beendet und nicht automatisch
gestartet werden, z.B. NETBUI, NWLink IPX/SPX, Fritz-Web,
T-Online-Speedmanager.
Der \glqq{}Client f"ur Microsoft-Netzwerke\grqq{} sollte installiert und konfiguriert
werden.
Die verschiedenen Clients m"ussen unterschiedliche NETBIOS-Namen erhalten:
Unter
/Start /Einstellungen /Systemsteuerung /System /Eigenschaften /Computername
muss ein im Netzwerk einmaliger NETBIOS-Name vergeben werden. Unter
/Start /Einstellungen /Systemsteuerung /System /Eigenschaften /Arbeitsgruppe
muss der Arbeitsgruppename identisch zu der Einstellung von Samba gew"ahlt werden
(\jumplabel{SAMBA\_WORKGROUP}{SAMBAWORKGROUP}).
Personal Firewalls sollten deaktiviert bzw. richtig konfiguriert sein:
Die Ports 137-139 m"ussen freigeschaltet sein!


\subsection{Windows XP}
%------------

Das Protokoll TCP/IP muss installiert und konfiguriert werden.
Folgende Dienste sind auf dem Rechner f"ur Samba notwendig/sinnvoll:

\begin{itemize}
\item
Arbeitsstationsdienst
\item
Computerbrowser
\item
Nachrichtendienst
\item
Server
\end{itemize}

Alle nicht genutzten Netzwerkdienste sollten beendet und nicht automatisch
gestartet werden, z.B. NETBUI, NWLink IPX/SPX, Fritz-Web,
T-Online-Speedmanager usw. ...
Der \glqq{}Client f"ur Microsoft-Netzwerke\grqq{} sollte installiert und konfiguriert
werden.
Die verschiedenen Clients m"ussen unterschiedliche NETBIOS-Namen erhalten:
Unter
/Start /Einstellungen /Systemsteuerung /System /Eigenschaften /Computername muss
ein im Netzwerk einmaliger NETBIOS-Name vergeben werden.
Unter
/Start /Einstellungen /Systemsteuerung /System /Eigenschaften /Arbeitsgruppe muss
der Arbeitsgruppename identisch zu der Einstellung von Samba gew"ahlt werden
(\jumplabel{SAMBA\_WORKGROUP}{SAMBAWORKGROUP}).
Personal Firewalls sollten deaktiviert bzw. richtig konfiguriert sein:
Die Ports 137-139 m"ussen freigeschaltet sein!


\section{Einrichtung der Windows-Clients f"ur den Druck "uber Samba}
%==============================================================

Um "uber Samba auf an eisfair{} angeschlossene lokale Drucker oder auf
Remote-Drucker oder auf die speziellen Freigaben von eisfax oder von
PDF-Druckern drucken zu k"onnen, m"ussen die Client-Rechner daf"ur konfiguriert
werden. Daf"ur sind folgende Schritte notwendig:

Ausdruck auf physikalisch vorhandene Drucker

\begin{enumerate}
\item
F"ur den Ausdruck auf physikalisch vorhandene Drucker wurde mindestens ein
funktionst"uchtiger Drucker an eine funktionst"uchtige parallele oder USB-
Schnittstelle des eisfair{}-Rechners angeschlossen oder es wurde der
entsprechende Remotedrucker korrekt im Netzwerk verf"ugbar gemacht und
konfiguriert (bitte konsultiert dazu die entsprechende Handb"ucher oder
Webseiten, denn ich kenne Eure Drucker nicht!).
\item
Es wurde das Paket lprng von mir installiert:

\begin{verbatim}
       Package administration
       Install new package
       Printer and File Services
       Line Printer Daemon
\end{verbatim}

\item
Das Paket lprng wurde korrekt konfiguriert.
\item
Die weitere Konfiguration ist unter \glqq{}Weitere Konfiguration\grqq{} beschrieben.
\end{enumerate}

Ausdruck auf die speziellen Druckerfreigaben von eisfax und von PDF-Druckern
zur Erstellung von PDF-Dateien

\begin{enumerate}
\item
F"ur den Ausdruck auf die Freigabe von eisfax muss das Paket eisfax
installiert und korrekt konfiguriert worden sein.
\item
Ausserdem ist ein installiertes Ghostscript ab Version 1.0.2 notwendig.
\item
F"ur den Ausdruck auf die Freigaben von PDF-Druckern muss das Paket
Ghostscript ab Version 1.0.2 installiert sein.
\item
Die weitere Konfiguration ist unter \glqq{}Weitere Konfiguration\grqq{} beschrieben.
\end{enumerate}


Weitere Konfiguration

\begin{enumerate}
\item
Es wurde hinterher eine neue Sambakonfiguration "uber das Samba-Service-Men"u
erstellt (Hinweise dazu finden sich unter Punkt 3.2.2)
\item
Dabei wurde entweder

\jumplabel{SAMBA\_MANUAL\_CONFIGURATION}{SAMBAMANUALCONFIGURATION}='yes'

oder

\jumplabel{SAMBA\_MANUAL\_CONFIGURATION}{SAMBAMANUALCONFIGURATION}='no'

gew"ahlt.
Bei SAMBA\_MANUAL\_CONFIGURATION='no' sind die lokalen Druckernamen f"ur
Parallel-Drucker beginnend mit pr1, die lokalen USB-Drucker beginnend mit
usbpr1 und die entfernten Druckernamen beginnend mit repr1 durchnummeriert,
bei SAMBA\_MANUAL\_CONFIGURATION='yes' habt Ihr die Druckernamen mittels

\jumplabel{SAMBA\_PRINTER\_x\_NAME}{SAMBAPRINTERxNAME}

selbst bestimmt.
\end{enumerate}


Nun lokalisiert man "uber die Netzwerkumgebung den eisfair{}-Server und
wechselt per Doppelklick auf seinen Namen dort hin. Wenn alles korrekt
konfiguriert wurde, sind neben den normalen Freigaben auch die
eisfair{}-Drucker hier zu sehen, deren Namen davon abh"angen, ob man bei
SAMBA\_MANUAL\_CONFIGURATION 'yes' oder 'no' gew"ahlt hat - siehe oben.
Um einen Treiber f"ur einen freigegebenen Samba-Drucker auf dem Client
zu installieren, f"uhrt man einen Doppelklick auf den entsprechenden
Samba-Drucker aus. Hat man vorher Drucker-Treiber f"ur die automatische
Installation auf eisfair{} hochgeladen (siehe weiter unten), wird automatisch
der passende Drucker-Treiber installiert. Anderenfalls wird folgende
Fehlermeldung angezeigt:

\glqq{}Es wurde kein Treiber gefunden. Im Netzwerk wurde kein Treiber gefunden.
Klicken Sie auf OK um manuell nach Treibern zu suchen. Klicken Sie andernfalls
auf Abbrechen, und setzen Sie sich mit dem Netzwerkadministrator in Verbindung,
oder sehen Sie auf der Webseite des Druckerhersteller nach.\grqq{}

Hier ist \glqq{}OK\grqq{} auszuw"ahlen!

Damit "offnet sich der Assistent f"ur die Drucker-Treiber-Installation. Die
weiteren Einstellungen sind vom Betriebssystem abh"angig:

Windows 9x/Me:

Hier w"ahlt man auf der linken Seite den Druckerhersteller und auf der rechten
Seite den Druckertyp aus und best"atigt mit \glqq{}Weiter\grqq{}.
F"ur eisfax- und PDF-Drucker muss hier zwingend ein Postscript-Druckertreiber
ausgew"ahlt werden. Ich arbeite erfolgreich mit dem Apple Color LW 12/660 PS
(Farbe) oder dem Apple LaserWriter 16/600 PS (Schwarz/Weiss).
F"ur PDF-Drucker ist es aber wahrscheinlich einfacher, als Treiber den im Verzeichnis

\begin{verbatim}
       /public/ghostscript_pdf_drivers
\end{verbatim}

liegenden Treiber anhand seiner inf-Datei auszuw"ahlen.
Auf dem n"achsten Konfigurationsbildschirm aktiviert man, wenn gew"unscht, dass
dieser Drucker der Standard-Drucker unter Windows werden soll.
Nach dem unvermeidlichen Klick auf \glqq{}Weiter\grqq{} verneint man die Frage, ob eine
Testseite gedruckt werden soll. Nach Bet"atigen von \glqq{}Fertigstellen\grqq{} und dem
Kopieren der Treiberdateien erscheint ein neues Icon f"ur diesen Drucker im
Druckerordner.
Auf der Lasche \glqq{}Details\grqq{} sind ausserdem die \glqq{}Spool-Einstellungen\grqq{} zu bearbeiten,
man setzt dort \glqq{}Druckauftr"age in Warteschlange stellen
(Druckvorgang schneller)\grqq{} und \glqq{}Druck nach letzter Seite beginnen\grqq{}. Unter
Datenformat w"ahlt man \glqq{}RAW\grqq{} und setzt ausserdem
\glqq{}Bidirektionale Unterst"utzung deaktivieren\grqq{}.

Im Druckertreiber f"ur eisfax setzt man unter
Druckeinstellungen/Erweitert/Postscriptoptionen
die TrueType-Downloadoption auf \glqq{}Bitmap\grqq{}.

Im Druckertreiber f"ur die PDF-Drucker setzt man unter
Druckeinstellungen/Erweitert/Grafik/TrueType-Schriftart
\glqq{}Als Softfont in den Drucker laden\grqq{}.
In
Optionen f"ur Dokument/PostScript-Optionen
setzt man die TrueType-Downloadoption auf \glqq{}Umriss\grqq{},
die PostScript-Ausgabeoption auf \glqq{}Portabilit"at optimieren\grqq{}.

Jetzt "ubernimmt man alle bisher gemachten Einstellungen mit der Schaltfl"ache
\glqq{}"Ubernehmen\grqq{} und verl"asst das komplette Konfigurationsfenster "uber \glqq{}OK\grqq{}, da
Windows 9x/Me die Einstellungen sonst nicht korrekt abspeichert.


Windows NT 4.0/2000/XP:

Hier w"ahlt man auf der linken Seite den Druckerhersteller und auf der rechten
Seite den Druckertyp aus und best"atigt mit \glqq{}Weiter\grqq{}.
F"ur eisfax- und PDF-Drucker muss hier zwingend ein Postscript-Druckertreiber
ausgew"ahlt werden. Ich arbeite unter Windows 2000 erfolgreich mit dem Apple
Color LW 12/660 PS (Farbe) oder dem Apple LaserWriter 16/600 PS (Schwarz/Weiss).
Unter Windows-NT-4.0 ist der HP Laserjet 9000 anscheinend besser geeignet.
F"ur PDF-Drucker ist es aber wahrscheinlich einfacher, als Treiber den im Verzeichnis

\begin{verbatim}
       /public/ghostscript_pdf_drivers
\end{verbatim}

liegenden Treiber anhand seiner inf-Datei auszuw"ahlen.
Auf dem n"achsten Konfigurationsbildschirm aktiviert man, wenn gew"unscht, dass
dieser Drucker der Standard-Drucker unter Windows werden soll.
Nach dem unvermeidlichen Klick auf \glqq{}Weiter\grqq{} verneint man die Frage, ob eine
Testseite gedruckt werden soll. Nach Bet"atigen von \glqq{}Fertigstellen\grqq{} und dem
Kopieren der Treiberdateien erscheint ein neues Icon f"ur diesen Drucker im
Druckerordner.
Auf der Lasche \glqq{}Anschl"usse\grqq{} deaktiviert man \glqq{}Bidirektionale Unterst"utzung
aktivieren\grqq{}. Auf der Lasche \glqq{}Erweitert\grqq{} bet"atigt man die Schaltfl"ache
\glqq{}Druckprozessor\grqq{} und stellt unter \glqq{}Druckprozessor\grqq{} \glqq{}WinPrint\grqq{}, unter
\glqq{}Standarddatentyp\grqq{} \glqq{}RAW\grqq{} ein und verl"asst diese Dialogbox mit \glqq{}OK\grqq{}
(bei Windows NT 4.0 ist hier noch ein H"akchen bei \glqq{}Raw-Datentyp immer spoolen\grqq{}
zu setzen).
Wieder auf der Lasche \glqq{}Erweitert\grqq{} aktiviert man \glqq{}"uber Spooler drucken, um
Druckvorg"ange schneller abzuschliessen\grqq{} und \glqq{}Drucken beginnen, nachdem
letzte Seite gespoolt wurde\grqq{}.
Bei \glqq{}Erweiterte Druckfunktionen aktivieren\grqq{} entfernt man den Haken, damit
diese Funktionen nicht genutzt werden.

Im Druckertreiber f"ur eisfax setzt man unter
Druckeinstellungen/Erweitert/Postscriptoptionen
die TrueType-Downloadoption auf \glqq{}Bitmap\grqq{}.

Im Druckertreiber f"ur die PDF-Drucker setzt man unter
Druckeinstellungen/Erweitert/Grafik/TrueType-Schriftart
\glqq{}Als Softfont in den Drucker laden\grqq{}.
In
Optionen f"ur Dokument/PostScript-Optionen
setzt man die TrueType-Downloadoption auf \glqq{}Umriss\grqq{},
die PostScript-Ausgabeoption auf \glqq{}Portabilit"at optimieren\grqq{}.

Jetzt "ubernimmt man alle bisher gemachten Einstellungen mit der Schaltfl"ache
\glqq{}"Ubernehmen\grqq{} und verl"asst das komplette Konfigurationsfenster "uber \glqq{}OK\grqq{}, da
Windows NT 4.0/2000/XP die Einstellungen sonst nicht korrekt abspeichert.


Windows Vista/7:

Hier w"ahlt man auf der linken Seite den Druckerhersteller und auf der rechten
Seite den Druckertyp aus und best"atigt mit \glqq{}Weiter\grqq{}.
F"ur eisfax- und PDF-Drucker muss hier zwingend ein Postscript-Druckertreiber
ausgew"ahlt werden. Einige User arbeiten unter Windows 7 erfolgreich mit dem Xerox
Phaser 6120 PS.
F"ur PDF-Drucker ist es aber wahrscheinlich einfacher, als Treiber den im Verzeichnis

\begin{verbatim}
       /public/ghostscript_pdf_drivers
\end{verbatim}

liegenden Treiber anhand seiner inf-Datei "uber \glqq{}Datentr"ager\grqq{} auszuw"ahlen.
Auf dem n"achsten Konfigurationsbildschirm aktiviert man, wenn gew"unscht, dass
dieser Drucker der Standard-Drucker unter Windows werden soll.
Nach dem unvermeidlichen Klick auf \glqq{}Weiter\grqq{} verneint man die Frage, ob eine
Testseite gedruckt werden soll. Nach Bet"atigen von \glqq{}Fertigstellen\grqq{} und dem
Kopieren der Treiberdateien erscheint ein neues Icon f"ur diesen Drucker im
Druckerordner.
Auf der Lasche \glqq{}Anschl"usse\grqq{} deaktiviert man \glqq{}Bidirektionale Unterst"utzung
aktivieren\grqq{}. Auf der Lasche \glqq{}Erweitert\grqq{} bet"atigt man die Schaltfl"ache
\glqq{}Druckprozessor\grqq{} und stellt unter \glqq{}Druckprozessor\grqq{} \glqq{}WinPrint\grqq{}, unter
\glqq{}Standarddatentyp\grqq{} \glqq{}RAW\grqq{} ein und verl"asst diese Dialogbox mit \glqq{}OK\grqq{}.
Wieder auf der Lasche \glqq{}Erweitert\grqq{} aktiviert man \glqq{}"uber Spooler drucken, um
Druckvorg"ange schneller abzuschliessen\grqq{} und \glqq{}Drucken beginnen, nachdem
letzte Seite gespoolt wurde\grqq{}.
Bei \glqq{}Erweiterte Druckfunktionen aktivieren\grqq{} entfernt man den Haken, damit
diese Funktionen nicht genutzt werden.

Im Druckertreiber f"ur eisfax setzt man unter
Druckeinstellungen/Erweitert/Postscriptoptionen
die TrueType-Downloadoption auf \glqq{}Bitmap\grqq{}.

Im Druckertreiber f"ur die PDF-Drucker setzt man unter
Druckeinstellungen/Erweitert/Grafik/TrueType-Schriftart
\glqq{}Als Softfont in den Drucker laden\grqq{}.
In
Optionen f"ur Dokument/PostScript-Optionen
setzt man die TrueType-Downloadoption auf \glqq{}Umriss\grqq{},
die PostScript-Ausgabeoption auf \glqq{}Portabilit"at optimieren\grqq{}.

Jetzt "ubernimmt man alle bisher gemachten Einstellungen mit der Schaltfl"ache
\glqq{}"Ubernehmen\grqq{} und verl"asst das komplette Konfigurationsfenster "uber \glqq{}OK\grqq{}.


Windows 8/8.1/10:

Hier w"ahlt man auf der linken Seite den Druckerhersteller und auf der rechten
Seite den Druckertyp aus und best"atigt mit \glqq{}Weiter\grqq{}.
F"ur eisfax- und PDF-Drucker muss hier zwingend ein Postscript-Druckertreiber
ausgew"ahlt werden. Bisher ist mir nicht bekannt, welcher Treiber f"ur
Windows 8/8.1/10 geeignet ist. Testet deswegen die Beschreibung f"ur PDF-Drucker
auch mit eisfax und gebt Feedback.
F"ur PDF-Drucker sollte man als Treiber den im Verzeichnis

\begin{verbatim}
       /public/ghostscript_pdf_drivers
\end{verbatim}

liegenden Treiber anhand seiner inf-Datei "uber \glqq{}Datentr"ager\grqq{} ausw"ahlen.
Auf dem n"achsten Konfigurationsbildschirm aktiviert man, wenn gew"unscht, dass
dieser Drucker der Standard-Drucker unter Windows werden soll.
Nach dem unvermeidlichen Klick auf \glqq{}Weiter\grqq{} verneint man die Frage, ob eine
Testseite gedruckt werden soll. Nach Bet"atigen von \glqq{}Fertigstellen\grqq{} und dem
Kopieren der Treiberdateien erscheint ein neues Icon f"ur diesen Drucker im
Druckerordner.
Auf der Lasche \glqq{}Anschl"usse\grqq{} deaktiviert man \glqq{}Bidirektionale Unterst"utzung
aktivieren\grqq{}. Auf der Lasche \glqq{}Erweitert\grqq{} bet"atigt man die Schaltfl"ache
\glqq{}Druckprozessor\grqq{} und stellt unter \glqq{}Druckprozessor\grqq{} \glqq{}WinPrint\grqq{}, unter
\glqq{}Standarddatentyp\grqq{} \glqq{}RAW\grqq{} ein und verl"asst diese Dialogbox mit \glqq{}OK\grqq{}.
Wieder auf der Lasche \glqq{}Erweitert\grqq{} aktiviert man \glqq{}"uber Spooler drucken, um
Druckvorg"ange schneller abzuschliessen\grqq{} und \glqq{}Drucken beginnen, nachdem
letzte Seite gespoolt wurde\grqq{}.
Bei \glqq{}Erweiterte Druckfunktionen aktivieren\grqq{} entfernt man den Haken, damit
diese Funktionen nicht genutzt werden.

Im Druckertreiber f"ur eisfax setzt man unter
Druckeinstellungen/Erweitert/Postscriptoptionen
die TrueType-Downloadoption auf \glqq{}Bitmap\grqq{}.

Im Druckertreiber f"ur die PDF-Drucker setzt man unter
Druckeinstellungen/Erweitert/Grafik/TrueType-Schriftart
\glqq{}Als Softfont in den Drucker laden\grqq{}.
In
Optionen f"ur Dokument/PostScript-Optionen
setzt man die TrueType-Downloadoption auf \glqq{}Umriss\grqq{},
die PostScript-Ausgabeoption auf \glqq{}Portabilit"at optimieren\grqq{}.

Jetzt "ubernimmt man alle bisher gemachten Einstellungen mit der Schaltfl"ache
\glqq{}"Ubernehmen\grqq{} und verl"asst das komplette Konfigurationsfenster "uber \glqq{}OK\grqq{}.


Noch ein Hinweis dazu:

Auf dem Windows-Rechner muss das Netzwerkprotokoll TCP/IP installiert und
konfiguriert sein. Als Standardeinstellung muss dabei unter Windows
\glqq{}NETBIOS over TCP/IP\grqq{} aktiviert sein, das Protokoll, welches Samba benutzt.


\section{Hinweise f"ur fortgeschrittene User}
%======================================

\subsection{Hochladen von Druckertreibern f"ur die automatische Installation}
%----------------------------------------------------------------

Um bei gr"osseren Netzwerken die Installation der Druckertreiber zu
vereinfachen und dem Netzverwalter zu ersparen, per Turnschuh-Administration
bei z.B. 400 Clients die Druckertreiber an jedem Arbeitsplatz von Hand zu
installieren, ist es m"oglich, mittels Samba eine automatische
Treiberinstallation auf den Clients zu realisieren.
Die Vorgehensweise ist dabei leider etwas kompliziert. Wer das hier nicht
sehr genau liest, wird es nicht schaffen und ist selbst daran schuld.
Mehr, als ich hier beschreibe, weiss ich auch nicht und kann deswegen in
einem solchen Fall auch nicht helfen...
Die vorliegende Beschreibung wurde mit Windows 2000 Workstation, Windows XP
Professional und Windows 7 Ultimate erstellt, es kann also sein, dass etwaige
Abweichungen bei Euch darauf zur"uckzuf"uhren sind, dass Ihr andere Versionen
einsetzt. Ihr m"usst in diesem Fall also notgedrungen etwas improvisieren.

Zu den Voraussetzungen:

Der Upload der Treiber kann nur "uber NT-basierende Betriebssysteme
vorgenommen werden. Dazu geh"oren Windows NT 4.0, Windows 2000, Windows XP,
Windows 7, Windows 8 und Windows 10.
Der Benutzer, welcher die Treiber hochladen will, muss "uber Samba zwingend
mit der User-ID (UID) 0 bei eisfair{} angemeldet sein. Die UID 0 hat neben
dem User \glqq{}eis\grqq{} vor allem der User \glqq{}root\grqq{}.
L"asst man seinen Windows Benutzernamen per /etc/user.map auf den User \glqq{}root\grqq{}
mappen und ist der User \glqq{}root\grqq{} als Samba-Benutzer angelegt worden, hat man
diese Voraussetzung also schon einmal erf"ullt. Die /etc/user.map setzt in der
Standardeinstellung den Windows-User \glqq{}Administrator\grqq{} auf den
eisfair{}-User \glqq{}root\grqq{} um:

\begin{verbatim}
   root = "Administrator"
\end{verbatim}

Auf dem NT-basierenden Client, von welchem aus die Druckertreiber hochgeladen
werden sollen, m"ussen die entsprechenden Treiber schon einmal installiert
worden sein, da man sich hiermit erspart, die relevanten Treiberdateien
m"uhsam zu extrahieren und selbst zusammenzustellen.
Wurde der Druckertreiber dabei f"ur den Zugriff auf den Netzwerkdrucker an
eisfair{} eingerichtet, muss der Drucker selbst aber aus dem Druckerordner
gel"oscht werden (ohne die Treiberdateien l"oschen zu lassen), da ein Upload
nur funktioniert, wenn die Zuordnung des lokalen Treibers zum Netzwerkdrucker
an eisfair{} auf dem Client nicht mehr existiert!
In den Drucker-Freigaben muss die Variable

\jumplabel{SAMBA\_PRINTER\_x\_CLIENTDRIVER}{SAMBAPRINTERxCLIENTDRIVER}

auf 'no' gesetzt sein, da eben nicht der lokale Treiber auf dem Client verwendet
werden soll. Daraus ergibt sich, dass die automatische Samba-Konfiguration per

\jumplabel{SAMBA\_MANUAL\_CONFIGURATION}{SAMBAMANUALCONFIGURATION}='no'

nicht genutzt werden kann!
Ich erw"ahne es ungern - aber da es wahrscheinlich doch wieder Leute gibt,
denen das nicht klar ist:
Um erfolgreich Treiber hochladen zu k"onnen, muss Samba gestartet sein ;o)


Nach diesen Vorbereitungen kann der Upload beginnen.


Windows 2000:

Man lokalisiert "uber die Netzwerkumgebung den eisfair{}-Server und wechselt
per Doppelklick auf seinen Namen dort hin. Jetzt navigiert man zum Verzeichnis
\glqq{}Drucker\grqq{}, in dem man alle durch Samba angebotenen Drucker sieht.
Nun markiert man den Drucker, f"ur welchen man einen Treiber hochladen will
und w"ahlt im Kontextmen"u (rechte Maustaste) den Punkt \glqq{}Eigenschaften\grqq{}
aus. Daraufhin wird folgende Fehlermeldung angezeigt:

\glqq{}Die Ger"ateeinstellungen k"onnen nicht angezeigt werden. Der Treiber f"ur den
angegebenen Drucker ist nicht installiert. Es werden nur Spoolereigenschaften
angezeigt. M"ochten Sie den Treiber jetzt installieren?\grqq{}

Hier ist \glqq{}Nein\grqq{} auszuw"ahlen!

Bei Manipulationen in dem folgenden Eigenschafts-Dialog bitte nicht in Panik
geraten, wenn der Zugriff sehr lange dauert (die Lasche \glqq{}Anschl"usse\grqq{} ist z.B.
so ein Kandidat, auch das Schliessen des kompletten Dialoges mittels \glqq{}OK\grqq{}).
Der Rechner ist nicht abgest"urzt, es dauert nur etwas ...

Auf der Lasche \glqq{}Erweitert\grqq{} kann nun mit \glqq{}Neuer Treiber\grqq{} der korrekte
Treiber f"ur den Drucker ausw"ahlt und hochgeladen werden.
Dazu best"atigt man die erste Seite des Assistenten mit \glqq{}Weiter\grqq{}, w"ahlt
auf der linken Seite den Druckerhersteller und auf der rechten Seite den
Druckertyp aus, navigiert nach dem Klick auf \glqq{}Weiter\grqq{}, \glqq{}Fertigstellen\grqq{} und
\glqq{}OK\grqq{} mittels \glqq{}Durchsuchen\grqq{} zum Windows-Verzeichnis (\%WINDIR\%) und dort
zum Verzeichnis INF, also z.B. nach

   C:{\textbackslash}WINNT{\textbackslash}INF

und l"adt per Klick auf \glqq{}"Offnen\grqq{} und \glqq{}OK\grqq{} den Treiber hoch. Eventuell muss
dabei noch die Installation eines unsignierten Treibers zugelassen werden.
Dann schliesst man den kompletten Eigenschaften-Dialog mit \glqq{}OK\grqq{}, was sehr
lange dauern kann.


Windows XP:

Man lokalisiert "uber die Netzwerkumgebung den eisfair{}-Server und wechselt
per Doppelklick auf seinen Namen dort hin. Jetzt navigiert man zum Verzeichnis
\glqq{}Drucker und Faxger"ate\grqq{}, in dem man alle durch Samba angebotenen Drucker sieht.
Nun markiert man den Drucker, f"ur welchen man einen Treiber hochladen will,
und w"ahlt im Kontextmen"u (rechte Maustaste) den Punkt \glqq{}Eigenschaften\grqq{}
aus. Daraufhin wird folgende Fehlermeldung angezeigt:

\glqq{}Der Druckertreiber '' ist nicht installiert. Auf manche Druckereigenschaften
kann ohne die Installation des Druckertreibers nicht zugegriffen werden.
M"ochten Sie den Treiber jetzt installieren?\grqq{}

Hier ist \glqq{}Nein\grqq{} auszuw"ahlen!

Bei Manipulationen in dem folgenden Eigenschafts-Dialog bitte nicht in Panik
geraten, wenn der Zugriff sehr lange dauert (die Lasche \glqq{}Anschl"usse\grqq{} ist z.B.
so ein Kandidat, auch das Schliessen des kompletten Dialoges mittels \glqq{}OK\grqq{}).
Der Rechner ist nicht abgest"urzt, es dauert nur etwas ...

Auf der Lasche \glqq{}Erweitert\grqq{} kann nun mit \glqq{}Neuer Treiber\grqq{} der korrekte
Treiber f"ur den Drucker ausw"ahlt und hochgeladen werden.
Dazu best"atigt man die erste Seite des Assistenten mit \glqq{}Weiter\grqq{}, w"ahlt
auf der linken Seite den Druckerhersteller und auf der rechten Seite den
Druckertyp aus, und w"ahlt dann \glqq{}Weiter\grqq{}, \glqq{}Fertigstellen\grqq{}, um
den Kopiervorgang zu starten. Eventuell muss dabei noch die Installation eines
unsignierten Treibers zugelassen werden.
Dann schliesst man den kompletten Eigenschaften-Dialog mit \glqq{}OK\grqq{}, was sehr
lange dauern kann.

Treiber f"ur Betriebssysteme, die nicht NT-basiert sind, wie Windows 9x/Me,
m"ussen "uber die Lasche \glqq{}Freigabe\grqq{} und dort "uber \glqq{}Zus"atzliche Treiber\grqq{}
hochgeladen werden. Das ist sehr viel komplizierter, da man dabei Zugriff auf
eine Partition dieses Betriebssystems mit dem dort installierten Treiber haben
muss.

Den Weg mit einem installierten Treiber und dem Inf-Verzeichnis kann man sich
sparen, wenn man alle ben"otigten Treiberdateien und die inf-Datei des
Druckertreibers in ein Verzeichnis kopiert. Mir ist leider kein einfaches
Verfahren bekannt, die relevanten Dateien f"ur seinen Treiber zu extrahieren.


Windows 7:

Man lokalisiert "uber die Netzwerkumgebung den eisfair{}-Server und wechselt
per Doppelklick auf seinen Namen dort hin. Wenn in den Ordner-Optionen
\glqq{}Immer Men"us anzeigen\grqq{} aktiviert ist, sieht man im Men"u einen Eintrag
\glqq{}Remotedrucker anzeigen\grqq{}. Wenn nicht, ist das Men"u mit der Alt-Taste
einzublenden. Dann w"ahlt man \glqq{}Remotedrucker anzeigen\grqq{} aus und sieht darin
alle durch Samba angebotenen Drucker.
Nun markiert man den Drucker, f"ur welchen man einen Treiber hochladen will,
und w"ahlt im Kontextmen"u (rechte Maustaste) den Punkt \glqq{}Eigenschaften\grqq{}
aus. Daraufhin wird folgende Fehlermeldung angezeigt:

\glqq{}Der Druckertreiber '' ist nicht installiert. Auf manche Druckereigenschaften
kann ohne die Installation des Druckertreibers nicht zugegriffen werden.
M"ochten Sie den Treiber jetzt installieren?\grqq{}

Hier ist \glqq{}Nein\grqq{} auszuw"ahlen!

Bei Manipulationen in dem folgenden Eigenschafts-Dialog bitte nicht in Panik
geraten, wenn der Zugriff sehr lange dauert (die Lasche \glqq{}Anschl"usse\grqq{} ist z.B.
so ein Kandidat, auch das Schliessen des kompletten Dialoges mittels \glqq{}OK\grqq{}).
Der Rechner ist nicht abgest"urzt, es dauert nur etwas ...

Auf der Lasche \glqq{}Erweitert\grqq{} kann nun mit \glqq{}Neuer Treiber\grqq{} der korrekte
Treiber f"ur den Drucker ausw"ahlt und hochgeladen werden.
Dazu best"atigt man die erste Seite des Assistenten mit \glqq{}Weiter\grqq{}, w"ahlt
auf der linken Seite den Druckerhersteller und auf der rechten Seite den
Druckertyp aus, und w"ahlt dann \glqq{}Weiter\grqq{}, \glqq{}Fertigstellen\grqq{}, um
den Kopiervorgang zu starten. Eventuell muss dabei noch die Installation eines
unsignierten Treibers zugelassen werden.
Dann schliesst man den kompletten Eigenschaften-Dialog mit \glqq{}OK\grqq{}, was sehr
lange dauern kann.

Treiber f"ur Betriebssysteme, die nicht NT-basiert sind, wie Windows 9x/Me,
m"ussen "uber die Lasche \glqq{}Freigabe\grqq{} und dort "uber \glqq{}Zus"atzliche Treiber\grqq{}
hochgeladen werden. Das ist sehr viel komplizierter, da man dabei Zugriff auf
eine Partition dieses Betriebssystems mit dem dort installierten Treiber haben
muss.

Den Weg mit einem installierten Treiber und dem Inf-Verzeichnis kann man sich
sparen, wenn man alle ben"otigten Treiberdateien und die inf-Datei des
Druckertreibers in ein Verzeichnis kopiert. Mir ist leider kein einfaches
Verfahren bekannt, die relevanten Dateien f"ur seinen Treiber zu extrahieren.

\section{Hinweise zur Fehlersuche}
%===========================

Bei Fehlern bitte "uberpr"ufen:
\begin{itemize}
\item
Client f"ur Microsoftnetzwerke installiert und konfiguriert?
\item
Protokoll TCP/IP installiert und konfiguriert?
\item
alle unn"otigen Netzwerkprotokolle entfernt (NETBUI, IPX/SPX, Fritz-Web,
T-Online-Speedmanager)?
\item
den verschiedenen Rechnern verschiedene (NetBIOS!-)Namen gegeben?
\item
Datei -und Druckerfreigabe installiert?
\item
Personal Firewalls und Windows-eigene Firewall richtig konfiguriert oder
deaktiviert (Ports 137-139 m"ussen freigeschaltet sein!)?
\item
NetBIOS "uber TCP/IP konfiguriert (nur ab Win2k notwendig)?
\item
identischen Arbeitsgruppennamen auf allen Rechnern konfiguriert?
\end{itemize}
