Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- microsoft_exchange [2019/05/14 11:56] – [Konfiguration] lwsystems
+++ microsoft_exchange [2024/12/11 13:23] (aktuell) – [Fehlersuche] lwsystems
@@ Zeile 15: / Zeile 15: @@
 ===== benno-exchange =====
+Die E-Mails in der Journaling Mailbox von Microsoft liegen in einem speziellen [[microsoft_exchange_journaling-mailbox|Format]] vor.
-Das Programm //benno-exchange// läd die E-Mails aus der Journaling Mailbox per POP3 und konvertiert diese dann in das Standard E-Mail Format. Die für den Import aufbereitete E-Mail wird im Spoolverzeichnis von Benno MailArchiv gespeichert.
+Das Programm //benno-exchange// läd diese E-Mails per POP3 und konvertiert diese dann in das Standard E-Mail Format. Die für den Import aufbereitete E-Mail wird im Spoolverzeichnis von Benno MailArchiv gespeichert.
 ====== Installation ======
@@ Zeile 30: / Zeile 30: @@
 Bei der Installation werden die für die Anbindung benötigten Parameter abgefragt und in die Konfigurationsdatei ''/etc/benno-exchange/benno-exchange.conf'' eingetragen.
-==== tar.gz  ====
+Das Paket installiert den Cron-Job ''/etc/cron.d/benno-exchange'' der die E-Mails in 5 Minuten Abständen vom POP3 Server läd und nach dem Speichern vom Server löscht.
+==== sonstige Linux-Distributionen ====
-Zur Installation wird die aktuellste Version des Tar-Archiv von //benno-exchange// heruntergeladen und im Root des Filesystems entpackt. Hierbei werden die folgenden Dateien und Verzeichnisse in das System kopiert.
+Hier bietet sich die [[#Installation_aus_targz_paket|Installation aus einem .tar.gz Archiv]] an.
-  * /usr/sbin/benno-exchange
-  * /etc/cron.d/benno-exchange
-  * /etc/benno-exchange/benno-exchange.conf
-  * /usr/lib/benno-exchange/*
-  * /usr/share/doc/benno-exchange/*
-Zusätzlich werden noch die folgenden Dateien und Verzeichnisse entpackt. Diese können direkt gelöscht werden.
-  * /install/
-  * /install/predoinst.sh
-  * /install/doinst.sh
-  * /install/delete.sh
-=== Abhängigkeiten ===
-Zusätzlich werden noch die folgenden Perl-Module benötigt:
-  * //IO::Socket::SSL//
-  * //Mail::POP3Client//
-  * //MIME::Parser//
-==== Konfiguration ====
+===== Konfiguration =====
 In der Konfigurationsdatei ''/etc/benno-exchange/benno-exchange.conf'' (///opt/benno-exchange/benno-exchange.conf// beim tar.gz Paket) werden die entsprechenden Parameter eingestellt.
@@ Zeile 63: / Zeile 43: @@
 # Default settings
 #
-# 0 / 1 -> false / true
+# TRUE:  1 yes YES true  TRUE   ok OK
+# FALSE: 0 no  NO  false FALSE
 #
 #
-# DEBUG      = 0
+# DEBUG             = no
-# delete     = 0
+# delete            = no
-# ssl        = 0
+# force_delete      = yes
-# VERBOSE    = 0
+# force_delpop      = yes
-# host       = localhost
+# ssl               = no
-# port       = 110
+# VERBOSE           = no
-# inbox      = /srv/benno/inbox
+# host              = localhost
-# maxfiles   = 250
+# port              = 110
-# numfetch   = 200
+# inbox             = /srv/benno/inbox
-# type       = 2007 (für Exchange 2003 auf 2003 setzen, sonst Defaultwert 2007 lassen)
+# numfetch          = 1000
-# jcopy      = 0
+# type              = 2007
-# runuser    = benno
+# jcopy             = no
-# filemode   = 0640
+# runuser           = benno
-# authmode   = BEST
+# authmode          = BEST
-# statusfile = ''
+# statusfile        =
-# force_delete = 0
+# whitelist         = /path/to/file       # email address | @domain
-# extraheader_value = ''
+# extraheader_name  = X-BENNO-GW
+# extraheader_value =
+# ssl_version       =                     # TLSv1 | TLSv11 | TLSv12 | TLSv13
+#
+# pass = </etc/benno-exchange/password    # read password from first line of file
 host    = exchange.hostname
 user    = username
 pass    = password
-delete  = 1
+delete  = yes
-ssl     = 1
+ssl     = no
 </file>
+Beim Verbindungsaufbau wird die SSL Version dynamisch ausgehandelt. Daher wird die  Einstellung ssl_version nur bei speziellen Konfigurationen benötigt.
 Je nach Version des MS Exchange Servers werden die Journaling Mails in einem unterschiedlichen Format gespeichert. Mit "-t 2003" werden die Journaldateien von MS Exchange 2003 verarbeitet. Ohne Angabe von -t wird das Format der Version 2007 oder höher analysiert.
 ==== Fehlersuche ====
+Beim  Aufruf per Cron werden Logmeldungen per Facility "mail" (LOG_MAIL) geloggt und in der Standardkonfiguration nach ''/var/log/mail.log'' geschrieben. Auf aktuellen Systeme, bei denen das Logging per systemd-journald durchgeführt wird, können die Logmeldungen mittels
+  journalctl -ft benno-exchange
+eingesehen werden.
 Beim Problemen mit der Abholung sollte das Programm mit dem Schalter //-v// direkt auf der Konsole aufgerufen werden. Eventuelle  Fehler werden dann direkt ausgegeben.
@@ Zeile 101: / Zeile 94: @@
 /usr/sbin/benno-exchange -R benno -c /etc/benno-exchange/benno-exchange.conf -v
 </code>
-====== Journaling Mailbox  ======
-===== Konvertierung der Journal E-Mail =====
+Mit dem Kommandozeilenparameter //-D// werden Debug-Meldungen angezeigt.
+Bei Problemen mit der SSL-Verbindung zum Server sollte vor dem Aufruf die Umgebungsvariable //SSLDEBUG// gesetzt werden. Hier werden Angaben zum SSL-Handshake ausgegeben:
+<code bash>
+SSL_DEBUG=2 /usr/sbin/benno-exchange -R benno /etc/benno-exchange/benno-exchange.conf -v
+</code>
-Nach Einrichtung der Journaling Mailbox werden alle ein- und ausgehenden sowie interne E-Mails als Kopie in dieser Mailbox gespeichert. Die E-Mails werden hier in Form einer speziell formatierten "Journaling Mail" abgelegt.
-Die E-Mails aus der Journaling Mailbox können nicht direkt archiviert werden, da die relevante E-Mail im Anhang der Journaling Mail zu finden ist. Zum Import der E-Mails muss die Journaling Mail konvertiert werden. Hierbei werden die relevanten Meta-Daten aus dem Body der Journaling Mail als X-MAILFROM bzw. X-RCPTTO Header übergeben. Die Konvertierung erfolgt automatisch durch //benno-exchange//.
+====== Installation aus tar.gz Paket ======
-===== Struktur der Journal E-Mail  =====
-Im Body der Journaling Mail sind die Meta-Informationen
-  * Absender
-  * Empfänger (To, Cc und Bcc)
-  * Message-ID
-angegeben, während die ursprüngliche E-Mail //message/rfc822// im Anhang gespeichert ist.
-==== MS Exchange 2007 - 2015  ====
+Zur Installation wird die aktuellste Version des Tar-Archiv von //benno-exchange// heruntergeladen und im Root des Filesystems entpackt. Hierbei werden die folgenden Dateien und Verzeichnisse in das System kopiert.
-<code>
+  * /usr/sbin/benno-exchange
-# layer | type
+  * /etc/cron.d/benno-exchange
-# ------+--------------------
+  * /etc/benno-exchange/benno-exchange.conf
-# 0     | multipart/mixed
+  * /usr/lib/benno-exchange/*
-# 1     |     text/plain
+  * /usr/share/doc/benno-exchange/*
-# 1     |     message/rfc822
-</code>
-Die Journal E-Mail enthält die Envelope Daten ausschließlich im Format //text/plain.//
+Zusätzlich werden noch die folgenden Dateien und Verzeichnisse entpackt. Diese können direkt gelöscht werden.
+  * /install/
+  * /install/predoinst.sh
+  * /install/doinst.sh
+  * /install/delete.sh
+=== Abhängigkeiten ===
-==== MS Exchange 2003  ====
+Zusätzlich werden noch die folgenden Perl-Module benötigt:
-Die Journal E-Mail von MS Exchange 2003 ist etwas anders aufgebaut.
+  * //IO::Socket::SSL//
+  * //Mail::POP3Client//
-<code>
+  * //MIME::Parser//
-# layer | type
-# ------+--------------------------
-# 0     | multipart/mixed
-# 1     |     multipart/alternative
-# 2     |         text/plain
-# 2     |         text/html
-# 1     |     message/rfc822
-</code>
-Die Journal E-Mail besteht aus einem Body vom MIME-Type //multipart/mixed//. Dieser enthält einen Teil mit den Envelope-Informationen sowie einen Teil mit der eigentlichen E-Mail. Die Envelope-Informationen sind redundant im Format //text/plain// und //text/html// vorhanden.

Das Benno MailArchiv Wiki

Benutzer-Werkzeuge

Webseiten-Werkzeuge

Unterschiede

Seiten-Werkzeuge