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.
