poll "pop.server.tld" proto pop3 user "archiv@mydomain.tld" pass "topsecret" smtphost "localhost/2500" [...]]]> z.B. auf dem Server, auf dem OpenBenno läuft, für einen unprivilegierten user (benno) in dessen Home-Verzeichnis die Datei “.fetchmailrc” mit folgendem Inhalt erstellen:

poll "pop.server.tld"
proto pop3
user "archiv@mydomain.tld"
pass "topsecret"
smtphost "localhost/2500"
options ssl

Das “option ssl” ist natuerlich optional. Das angegebene Postfach ist das mit den geammelten Emails, welche archiviert werden sollen.

Per crontab -e für diesen User einen Cronjob einrichten, um Emails stündlich abzuholen:

0 */1 * * * /usr/bin/fetchmail

oder

aptitude install openjdk-6-jdk

useradd -s /bin/false benno

Wir brauchen ein Archivverzeichnis (NAS, Server, lokal) und ein schnelles Indexverzeichnis (möglichst lokal, ca. 20% der Archivgröße). Das Indexverzeichnis kann unter dem Archivverzeichnis liegen. z.B.

mkdir -p /srv/mailarchive/ mkdir -p /srv/mailarchive/index mkdir -p /srv/mailarchive/userdb mkdir -p /var/log/benno

chown benno /srv/mailarchive/ chown benno /srv/mailarchive/index chown benno /srv/mailarchive/userdb chown [...]]]> 1. Java JDK 6 (JRE reicht nicht)

aptitude install sun-java6-jdk


oder

aptitude install openjdk-6-jdk

2. Benutzer anlegen

useradd -s /bin/false benno

3. Verzeichnisse anlegen

Wir brauchen ein Archivverzeichnis (NAS, Server, lokal) und ein schnelles Indexverzeichnis (möglichst lokal, ca. 20% der Archivgröße). Das Indexverzeichnis kann unter dem Archivverzeichnis liegen.
z.B.

mkdir -p /srv/mailarchive/
mkdir -p /srv/mailarchive/index
mkdir -p /srv/mailarchive/userdb
mkdir -p /var/log/benno


chown benno /srv/mailarchive/
chown benno /srv/mailarchive/index
chown benno /srv/mailarchive/userdb
chown benno /var/log/benno

B. Archivierungs- und Indizierungsdienst

Dieser kann auf einem oder mehreren Rechnern laufen. Bitte beachten: das Archiv muss an einer zentralen Stelle liegen; das Indexverzeichnis muss unterschiedlich sein für jeden einzeln Indizierungsserver.

1. bennocore-current-gpl.zip (unter “Download”) herunterladen und in tmp entpacken

cd tmp
unzip bennocorecurrent-gpl.zip
mkdir -p /opt/bennocore
cp -r lib/ bennocore.jar bennoadmin.jar /opt/bennocore


Für Standard (SMTP/Fetchmail)
cp -r scripts/init.d/benno-smtp /etc/init.d
cp -r scripts/etcdefault/benno-smtp /etc/default
update-rc.d benno-smtp defaults

Alternativ: Für das Auslesen eines Maildirs

cp -r scripts/init.d/benno-maildir /etc/init.d
cp -r scripts/etcdefault/benno-maildir /etc/default
update-rc.d benno-maildir defaults

Alternativ (experimentell): über direktes Auslesen einer POP3(s)-Mailbox.
Siehe
java -jar /opt/bennocore/bennoadmin.jar

für Hilfe

Diese Funktion ist in benno-admin implementiert:
java -jar /opt/bennocore/

Für den Import aus einem Maildir noch/etc/default/benno-maildir und evtl. Pfade anpassen.

2. Starten:

/etc/init.d/benno-smtp start

Jetzt läuft ein SMTP-Server auf Port 2500. Dieser kann nun z.B. mittels Fetchmail, von einem Postfach gefüttert wird, der Kopien aller Mails enthält.

C. Weboberfläche einrichten

1. Tomcat 5.5 (oder höher) installieren

aptitude install tomcat5.5

2. bennosearch-current-gpl.zip (unter “Download”) herunterladen und in tmp entpacken

3. bennosearch.war kopieren


cp bennosearch.war /var/lib/tomcat5.5/webapps

4. Authentifizierung/Authorisierung

aptitude install python-pysqlite2
cp scripts/UserDetails /srv/mailarchive/userdb
cp scripts/userdetails.py /srv/mailarchive/userdb
chown -R tomcat55 /srv/mailarchive/userdb




Standardmäßig werden die Benutzerdaten in eine SQLite Datenbank (UserDetails) gespeichert. Für andere Mechanismen muss userdetails.py angepasst werden.

5. Pfade konfigurieren (optional, ab 1.0.6)

Die Standardpfade sind /srv/mailarchive/repo für das Repository und /srv/mailarchive/index für den Index.
Wenn sie etwas eigenes einstellen wollen oder müssen, können sie das folgendermaßen einstellen.
mkdir -p /etc/benno/
cp scripts/etcbenno/archive.properties /etc/benno/

und die entsprechende Datei editieren

vi /etc/benno/archive.properties


6. Mails versenden aus der Oberfläche (optional, ab 1.0.7)

Um diese Funktion freizuschalten, müssen die entsprechenden Zeilen in der Konfigurationsdatein (v.a. mailsendhandler.host) auskommentiert und evtl. angegepaßt werden.
mkdir -p /etc/benno/
cp scripts/etcbenno/archive.properties /etc/benno/

und die entsprechende Datei editieren

vi /etc/benno/archive.properties


7. Tomcat Security anpassen/ausschalten

Bei manchen Installationen ist der Sicherheitsmechanismus von Tomcat6 archiviert. Dies führt zu Problemen bei Zugriff auf Dateien außerhalb des Containers ,z.B. das Repository. Dessen Aufgabe übernimmt hier das serverunabhängige Spring Security Framework. Falls BennoSearch die einzige Applikation auf dem Application Server ist, kann der Mechanismus komplett abgestellt werden. Bei Ubuntu und Debian in /etc/default/tomcat5.5:
TOMCAT5_SECURITY=NO
Gegebenenfalls muss hier die Variable $JAVA_HOME auf den Pfad der installierten JAVA-Version gesetzt werden.

8. Tomcat ggf. neu starten

9. Zugriff auf die Weboberfläche mit

http://localhost:8180/bennosearch

Je nach Konfiguration der Distribution kann Tomcat auch an Port 8080 gebunden sein. In diesem Falle erfolgt der Zugriff mit:

http://localhost:8080/bennosearch

Der Standardbenutzer für die erste Anmeldung ist admin, Passwort:passwd
Bitte in der Benutzerverwaltung ändern.

Weitere Merkmale von Open Benno MailArchiv: