Differences

The differences between two versions are shown here.

--- benno-pop3 [2017/01/04 14:59] – [Installation] lwsystems
+++ benno-pop3 [2024/12/17 11:57] (current) – [Konfiguration] lwsystems
@@ Zeile 3: / Zeile 3: @@
 ==== Beschreibung  ====
-benno-pop3 ist ein POP3 Konnektor für Benno&nbsp;MailArchiv. Die E-Mails werden aus einem Postfach eines POP3-Servers abgeholt und atomar in das INBOX-Verzeichnis von Benno geschrieben. Das Programm kann über den URL [[http://www.benno-mailarchiv.de/download/contrib/benno-pop3|http://www.benno-mailarchiv.de/download/contrib/benno-pop3]] per //rechter Maustaste, speichern unter// heruntergeladen werden.
+benno-pop3 ist ein POP3 Konnektor für Benno MailArchiv. Die E-Mails werden aus einem Postfach eines POP3-Servers abgeholt und atomar in das INBOX-Verzeichnis von Benno geschrieben. Das Programm kann wird über das Paket //benno-pop3// mittels //apt// installiert:
-Das Programm wird unter ///usr/local/sbin/benno-pop3// gespeichert und der Dateimodus auf ausführbar gesetzt.
+  apt install benno-pop3
+==== Konfiguration ====
+In der Datei ''/etc/benno-pop3/benno-pop3.conf'' werden der Hostname sowie die Zugangsdaten für das Postfach eingetragen.
 <code bash>
-cp benno-pop3 /usr/local/sbin/
+#
-chmod 0755 /usr/local/sbin/benno-pop3
+# benno-pop3.conf
+#
+# user =
+# pass =
+# host = localhost
+# port = 110 | 995
+# runuser           = benno
+# numfetch          = 200
+# inbox             = /srv/benno/inbox
+#
+# extraheader_name  = X-BENNO-GW
+# extraheader_value =
+host = pop3.lw-systems.net
+user = mailimport
+pass = secret
 </code>
-==== Installation ====
+Danach wird der Cron-Job in der Datei ''/etc/cron.d/benno-pop3'' aktiviert. Hierfür wird das //#// Zeichen vor der Zeile mit dem Programmaufruf entfernt.\\ **Achtung!** Die E-Mails werden nach dem Import vom POP3 Server gelöscht!
-Vor der Installation müssen die Abhängigkeiten erfüllt sein. Benno-pop3 benötigt die folgenden Perl-Module
-  *File::Temp
-  *Mail::POP3Client
-Auf einem Debian System muss hierfür noch das Modul //libmail-pop3client-perl //installiert werden.
-Dann kann benno-pop3 als Cron-Job in der Datei ''/etc/cron.d/benno-pop3'' konfiguriert werden.
 <code>
@@ Zeile 28: / Zeile 36: @@
 #
 #
-*/15 * * * * benno [ -x /usr/local/sbin/benno-pop3 ] && /usr/local/sbin/benno-pop3 -c /etc/benno/benno-pop3.conf -d
+*/15 * * * * benno [ -x /usr/sbin/benno-pop3 ] && /usr/sbin/benno-pop3 -c /etc/benno-pop3/benno-pop3.conf -d -s -S
 </code>
-<code bash>
-#
-# benno-pop3.conf
-#
-host = mailgw.lw-systems.net
-user = mailimport
-pass = secret
-</code>
 ==== Aufrufparameter ====
 <code>
-Aufruf: benno-pop3 [-D] [-c <file>] [-u <user>] [-p <pass>] [-i host>] [-n <num>] [-s]
+Aufruf: benno-pop3 [-D] [-c >] [-A >] [-u <user>] [-p <pass>] [-i host>] [-n <num>] [-s] [-S]
-  -D         print debug messages
+  -D          print debug messages
-  -c <file>  path to config file (format: param = value)
+  -c <file>   path to config file (format: param = value)
-  -u <user>  pop3 username
+  -u <user>   pop3 username
-  -p <pass>  pop3 password
+  -p <pass>   pop3 password
-  -i <dir>   Benno inbox (/srv/benno/inbox)
+  -i <dir>    Benno inbox (/srv/benno/inbox)
-  -H <host>  hostname (localhost)
+  -H <host>   hostname (localhost)
-  -P <port>  port (110)
+  -M <mode>   file mode (default 0640)
-  -n <num>   fetch num mails per run (200)
+  -P <port>   port (110)
-  -d         delete mails on pop3 server
+  -R <userid> run as <userid> (default benno)
-  -s         ssl connect to pop3s (default port 993)
+  -n <num>    fetch num mails per run (200)
-  -v         verbose
+  -d          delete mails on pop3 server
+  -r <addr>   add address as X-REAL-RCPTTO header
+  -s          ssl connect to pop3s (default port 995)
+  -S suppress ssl certificate verification
+  -A <mode>   AUTH MODE: BEST (default) | PASS | APOP | CRAM-MD5
+  -X extra header name written to each mail (default: X-BENNO-GW)
+  -x extra header value written to each mail (setting enables)
+  -v          verbose
 </code>
+==== Abruf mehrerer Mailboxen ====
+When retrieving large mailboxes, a problem can occur where the import job is not yet finished when the next run starts. Depending on the POP3 server configuration, the emails may not yet be deleted, so the next run attempts to load the entire mailbox again. This can overload the POP3 server.
+For this reason, the program is designed so that only one job can run at a time.
+Für den Abruf mehrerer Mailboxen bietet sich ein serieller Abruf an. Hierfür wird ein kleines Script ''/etc/benno-pop3/fetch-serial'' erstellt, das die möglichen Konfigurationen der Reihe nach abarbeitet:
+<file bash>
+#!/bin/bash
+#
+# /etc/benno-pop3/fetch-serial
+CONFDIR=/etc/benno-pop3/
+ENABLED=''
+for CONFFILE in $(ls -1 ${CONFDIR}/*.conf); do
+    /usr/sbin/benno-pop3 -c "${CONFFILE}" -s -S -d
+    ENABLED=OK
+done
+[ ${ENABLED}x = x ] && echo "BENNO POP3 ERROR - No configuration enabled" && exit 1
+</file>
+This script calls all configuration files with the extension .conf from the directory one after the other.
+Then activate the x-flag:
+  chmod +x /etc/benno-pop3/fetch-serial
+and adjust the cron call:
+''*/15 * * * * benno [ -x /etc/benno-pop3/fetch-serial ] && /etc/benno-pop3/fetch-serial''

The Benno Mail Archive Wiki

User tools

Website tools

Differences

Page Tools