User tools

Website tools


benno pop3

Differences

The differences between two versions are shown here.

Link to this comparison view

Both sides of the previous revisionPrevious revision
Next revision
Previous revision
benno-pop3 [2017/08/04 12:49] – Anpassung für Installation aus Debian-Paket lwsystemsbenno-pop3 [2024/12/17 11:57] (current) – [Konfiguration] lwsystems
Zeile 3: Zeile 3:
 ==== Beschreibung  ==== ==== Beschreibung  ====
  
-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// installiert.+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:
  
 +  apt install benno-pop3
 ==== Konfiguration ==== ==== Konfiguration ====
  
Zeile 13: Line 14:
 # benno-pop3.conf # 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 host = pop3.lw-systems.net
 user = mailimport user = mailimport
Zeile 18: Zeile 30:
 </code> </code>
  
-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.+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!
  
 <code> <code>
Zeile 24: Zeile 36:
 # #
 # #
-*/15 * * * * benno [ -x /usr/sbin/benno-pop3 ] && /usr/sbin/benno-pop3 -c /etc/benno/benno-pop3.conf -d -s -S+*/15 * * * * benno [ -x /usr/sbin/benno-pop3 ] && /usr/sbin/benno-pop3 -c /etc/benno-pop3/benno-pop3.conf -d -s -S
 </code> </code>
 +
  
 ==== Aufrufparameter ==== ==== Aufrufparameter ====
- 
-Falls mehrere Mailboxen importiert werden sollen, kann der Connector auch mit den entsprechenden Kommanozeilenparametern gestartet werden. 
  
 <code> <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> </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''
 +
 +
benno-pop3.1501850999.txt.gz · Zuletzt geändert: 2017/08/04 12:49 von lwsystems