Open Benno Mailarchiv

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 entpacke

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/

2. /etc/default/benno-maildir (opt. /etc/default/benno-maildir) anpassen und evtl. Pfade anpassen.

3. 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 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

8. Tomcat ggf. neu starten

9. Zugriff auf die Weboberfläche mit

http://localhost:8180/bennosearch

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