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

\chapter{Das Mail-panda-Paket}

    Dieses Paket ist als Zusatzpaket zum Mail-Paket zu verstehen und kann
    nicht eigenst"andig verwendet werden. D.h. die generelle Konfiguration
    der Funktionen erfolgt "uber die Konfigurationsdatei des Mail-Paketes.

\section{Die Einleitung}

    Dieses Paket enth"alt Mark Crispin's Panda-IMAP/UW-IMAP Programme
    (imap-2010 ist ein Fork des finalen imap-2007b-Programmzweigs der
    University of Washington), welche die Serverschnittstellen zum Abruf
    von lokal gespeicherten E-Mails durch einen POP3/IMAP4-Klienten
    (z.B. Mozilla Thunderbird\textregistered usw.) bereit stellen.

\section{Die Funktionen}

    Das Mail-panda-Paket besteht aus folgender Komponente:

    \begin{itemize}
        \item Ipop3d - wird f"ur den Abruf der auf dem Server abgelegten
            E-Mails genutzt.
            (\url{https://github.com/jonabbey/panda-imap})
        \item Imapd - wird f"ur den Abruf der auf dem Server abgelegten
            E-Mails genutzt.
            (\url{https://github.com/jonabbey/panda-imap})
    \end{itemize}

\section{Die Voraussetzungen}

    Dieses Paket ben"otigt zur korrekten Funktion ein installiertes und
    konfiguriertes Mail-Paket.

\section{Die Installation}

    Das Mail-panda-Paket wird "uber das Setup-Men"u installiert. Wird
    eine "altere Paketversion vorgefunden, so wird diese deinstalliert
    bevor die neuen Programmdateien installiert werden. Nach dem
    Installieren der Programmdateien wird direkt die Konfiguration des
    Mail-panda-Paketes aktualisiert und es werden die POP3/IMAP-Dienste
    neu gestartet.

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

    Das Men"u im Setup-Programm wird "uber 'Mail Services' -> 'Goto mail
    modules' angesprochen und ist wie folgt aufgebaut:

    \begin{itemize}
        \item Panda server administration
        \begin{itemize}
            \item View documentation: Anzeigen der Dokumentation
            \item Edit configuration: Bearbeiten der Konfiguration
            \item Advanced configuration file handling: Konfigurationen
                  verwalten
            \item Show status of Panda servers: Status der Panda-Server
                  anzeigen
            \item Stop Panda servers: Stoppen der Panda-Server
            \item Start Panda servers: Starten der Panda-Server
            \item View log messages: Logmeldungen anzeigen
            \item Return: Untermen"u verlassen
        \end{itemize}
        \item Return: Untermen"u verlassen
    \end{itemize}

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

\section{Die "Anderung der Konfiguration}

    Die Konfiguration kann "uber den Men"upunkt 'Edit configuration'
    ge"andert werden. Standardm"a"sig wird der Editor aufgerufen, der in
    der Environment-Konfiguration "uber die Variable 'EDITOR' festgelegt
    wurde. Nachdem der Editor beendet wurde wird abgefragt, ob die
    Konfiguration aktiviert werden soll. Wird dies best"atigt, werden
    "uber ein Skript die Anpassungen umgehend wirksam gemacht.

\section{Die Konfigurationsdatei}

    In der Konfigurationsdatei, die "uber das Men"u zug"anglich ist, sind
    folgende Parameter vorhanden; wer sie von Hand editieren will findet
    sie unter /etc/config.d/mail-panda.

\section{Die Parameter}
\begin{description}
%%  JED - show this description only in the help file
 %  \config{MAIL\_PANDA\_DO\_DEBUG}{MAIL\_PANDA\_DO\_DEBUG}{MAILPANDADODEBUG}
 %      Optionaler Parameter: Um den Debug-Modus zu aktivieren muss dieser
 %      Parameter auf den Wert `yes' gesetzt werden. Um den Debug-Modus zu
 %      deaktivieren  muss der Wert auf `no' gesetzt werde.
 %
 %      G"ultige Werte: yes, no
 %
 %      Standardeinstellung: \texttt{MAIL\_PANDA\_DO\_DEBUG='no'}

    \config{START\_MAIL\_PANDA}{START\_MAIL\_PANDA}{STARTMAILPANDA}
        Zur Aktivierung des Mail-panda-Paketes muss dieser Parameter
        auf den Wert `yes' gesetzt werden. Die Einstellung `no' schaltet
        das Mail-panda-Paket ab.

        \achtung{Die Panda-Dienste werden nur korrekt gestartet, wenn ein
            installiertes mail-Paket gefunden wurde, indem der Parameter
            POP3IMAP\_MAILBOX\_FORMAT auf den Wert 'mbox' bzw. 'mbx' gesetzt
            ist!}

        G"ultige Werte: yes, no

        Standardeinstellung: \texttt{START\_MAIL\_PANDA='no'}
\end{description}

\section{Verschiedenes}

\begin{description}
    \config{Die\ POP3/IMAP4-Dienste}{Die\ POP3/IMAP4-Dienste}{DiePOP3IMAP4Dienste}
        Verbindet sich ein E-Mail-Klient zum Panda-Server, so wird
        jeweils einer bzw. mehrere Dienste gestartet. Die Namen dieser
        Dienste in der Prozessliste h"angen dabei von dem gew"ahlten
        Verbindungsprotokoll POP3 oder IMAP4 ab. Dies gilt es zu
        ber"ucksichtigen, wenn man z.B.  mittels eines Monitorprogramms
        die laufenden Dienste "uberwachen m"ochte. Beispiel:

        \begin{verbatim}
POP3 : pop3d

IMAP4: imapd
        \end{verbatim}

    \config{Die\ E-Mail-Verzeichnisstruktur}{Die\ E-Mail-Verzeichnisstruktur}{Die E-Mail-Verzeichnisstruktur}
        Die physikalische Verzeichnisstruktur des Panda-Servers, in der
        die Nachrichten eines Postfaches abgelegt werden, entspricht der
        im E-Mail-Klienten angezeigten Baumstruktur. Alle Nachrichten
        eines Nachrichtenordners werden jeweils in einer zentralen MBOX-
        bzw. MBX-Datei abgespeichert.

        Beim Posteingang gilt es zu beachten, dass neue Nachrichten erst
        einmal in der Spool-Datei (\texttt{/var/spool/mail/<user>}) gespeichert
        werden. Erst beim Zugriff auf den Posteingang mit einem E-Mail-
        Klienten werden diese Nachrichten dann in die eigentliche
        Posteingangsdatei (\texttt{/home/<user>/.imapmail/INBOX})
        im Home-Verzeichnis eines Anwender tranferiert.

        \achtung{Unterordner im Postfach d"urfen \textbf{entweder weitere
            Unterverzeichnisse ODER aber weitere Nachrichtenordner enthalten}.
            Es ist nicht m"oglich gleichzeitig Unterordner und Nachrichten
            in einem Verzeichnis zu speichern.}

            Angezeigte Postfachstruktur im E-Mail-Klienten:

            \begin{verbatim}
\Posteingang (INBOX)
\Entwürfe    (Drafts)
\Gesendet    (Sent)
\Spam        (Spam)

\Ablage\Familie\Sohn
               \Tochter
       \Arbeit\Urlaub
              \Spesen
            \end{verbatim}

            Physikalische Postfachstruktur auf der Festplatte:

            \begin{verbatim}
/home/<user>/.imapmail/INBOX
                      /Drafts
                      /Sent
                      /Spam

                      /Ablage/Familie/Sohn
                                     /Tochter
                             /Arbeit/Urlaub
                                    /Spesen
            \end{verbatim}
\end{description}

