The Benno MailArchiv plugin for Zarafa/Kopano allows you to access emails archived in Benno MailArchiv within the Kopano web app. The plugin seamlessly integrates email search functionality into both the Kopano web app and the desktop app.

System requirements:

• Benno Core from 2.2.5 / Benno Rest from 2.2.5
• from Kopano Webapp 3.0 onwards
• from Zarafa Webapp 2.0

Hinweis:Der Begriff „Kopano“ kann synonym mit „Zarafa“ verwendet werden. Die Informationen über dieses Plugin gelten also für die Kopano WebApp ab v3.0 und ebenso die Zarafa Webapp ab Version 2.0.

• Laden Sie die aktuelle Version des Benno MailArchiv Plugins für Zarafa/Kopano herunter:
  https://www.benno-mailarchiv.de/download/plugin/
• Entpacken Sie Kopano_Benno_*.tar.gz auf Ihrem Zarafa/Kopano-Server. Der darin enthaltene Ordner „benno“ enthält das Benno MailArchiv Plugin für Zarafa/Kopano.
• Der Ordner „benno“ muss auf dem Kopano-Server in den Pfad „/usr/share/kopano-webapp/plugins/“ verschoben werden (analog „…/zarafa-webapp/plugins/“)
• Sollte im „plugins“-Ordner bereits eine ältere Version des Benno MailArchiv Plugins für Zarafa/Kopano existieren, muss der alte „benno“-Plugin Ordner vor dem Verschieben gelöscht werden.
• Der Ordnername „benno“ darf nicht verändert werden, da das Plugin ansonsten nicht einwandfrei funktioniert.
• Erforderlichenfalls müssen die Berechtigungen des Benno Plugins Order (benno/*) so angepasst werden, dass diese ausführbar sind. Grundsätzlich sollte das Plugin jedoch so funktionieren, wie es gepackt bzw. ausgeliefert wurde.

• Log out of the Zarafa/Kopano web app and log back in.
• In the web app, under Settings → Plugins, activate the "Benno" plugin (please reload the page after being prompted).

• Im Ordner „benno“ die Datei „settings.ini“ mit einem Texteditor (bspw. vim, nano usw.) öffnen.
• Die dort enthaltenen Standardwerte mit den passenden Werten für Ihr Netzwerk bzw. Ihren Benno MailArchiv Server eintragen.
• Nach dem Ändern und Speichern der Datei aus der Zarafa/Kopano WebApp aus- und wieder einloggen.

In the Zarafa/Kopano WebApp, under Settings in the left-hand bar, click on the (new) menu item "Benno" and enter the following values:

• Serveradresse: Bspw. http(s)://
  <benno-hostname> bitte mit dem Hostnamen (oder der IP-Adresse) Ihres Benno MaiArchiv-Servers ersetzen.
• Benno Container: e.g., BennoContainer.
  This is the default setting. If you have configured multiple containers in Benno MailArchiv, please enter the relevant container name here. (In the current version, only the container specified here is usable.)
• Einträge: Anzahl Treffer je Seite
  nach eigenem Geschmack einstellbar.

If a user manually changes (or adds) the server address and other settings in their web app settings, this change takes precedence over the system-wide default settings in the settings.ini file. The settings.ini file then no longer applies to that user.

The user in Benno MailArchiv must have the same login credentials as the user in Zarafa/Kopano. For example, if the user Meier logs into Benno MailArchiv with the credentials "meier:password", the same login credentials must also be valid for Zarafa/Kopano (in this case, "meier:password"). This is automatically ensured if Benno MailArchiv and Zarafa/Kopano use the same authentication source (e.g., Microsoft Active Directory, LDAP, etc.).

In der waagerechten Menüleiste der Zarafa/Kopano WebApp am oberen Rand des Browserfensters taucht nun ergänzend zu den Menüpunkten HEUTE, MAIL, KALENDER, … der zusätzliche Menüpunkt BENNO auf. Durch das Anklicken dieses Menüpunktes gelangt man in Suche nach E-mails über das Plugin. Es erscheint die Suchoberfläche des Plugins. Hier können Anwender nun in Benno MailArchiv suchen. Suchen werden durch klicken auf das Symbol „Lupe“ oder einfach durch Druck der Enter-Taste gestartet.

In den nächsten Versionen des Plugins werden folgende Features implementiert:

• Konversationssuche
• Containerwahl
• Suchen speichern