Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- kopano [2017/06/01 07:03] – Externe Bearbeitung 127.0.0.1
+++ kopano [2023/04/05 07:32] (aktuell) – [Nutzung in Zarafa/Kopano] lwsystems
@@ Zeile 1: / Zeile 1: @@
+======  Benno MailArchiv Plugin für Kopano ======
+===== ### Die technische Unterstützung für dieses ### =====
+===== ### Plugins endet zum 31.12.2023 ### =====
 Das Benno MailArchiv Plugin für Zarafa/Kopano bietet die Möglichkeit, innerhalb der Kopano Webapp auf die in Benno MailArchiv archivierten E-Mails zuzugreifen. Das Plugin integriert die Suche nach E-Mails nahtlos in die Kopano WebApp und DeskApp.
 Systemvoraussetzungen:
-* Benno Core ab 2.2.5 / Benno Rest ab 2.2.5
+  * Benno Core ab 2.2.5 / Benno Rest ab 2.2.5
-* ab Kopano Webapp 3.0
+  * ab Kopano Webapp 3.0
-* ab Zarafa Webapp 2.0
+  * ab Zarafa Webapp 2.0
-Hinweis:
+//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.
-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.
-Installation:
+====== Installation ======
-) 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.
-Aktivierung des installierten Plugins:
+Das Plugin wird auf dem Kopano-Server über die Paketverwaltung installiert. Bei getrennten Servern für Benno und Kopano müssen die Benno Paketquellen ebenfalls auf dem Kopano-System konfiguriert werden.
-) Aus der Zarafa/Kopano Webapp aus- und wieder einloggen.
-) In der Webapp unter Einstellungen -> Plugins das Plugin "Benno" aktivieren (die Seite bitte nach der Aufforderung neu laden).
-Konfiguration des Zugangs zum Benno MailArchiv Server:
+<code bash>
+apt-get install benno-kopano-webapp-plugin
+</code>
-Variante A: Globale, serverweite Konfiguration
+Während der Installation wird die Serveradresse und Port des Benno REST APIs sowie der Container in dem die Mails gespeichert werden eingetragen.
-A1) Im Ordner "benno" die Datei "settings.ini" mit einem Texteditor (bspw. vim, nano usw.) öffnen.
-A2) Die dort enthaltenen Standardwerte mit den passenden Werten für Ihr Netzwerk bzw. Ihren Benno MailArchiv Server eintragen.
-A3) Nach dem Ändern und Speichern der Datei aus der Zarafa/Kopano WebApp aus- und wieder einloggen.
-Variante B: Benutzer-bezogene Konfiguration
+  * Serveradresse: Bspw. //%%http(s)://<benno-hostname>/benno/rest.php%%//\\ <benno-hostname> bitte mit dem Hostnamen (oder der IP-Adresse) Ihres Benno MaiArchiv-Servers ersetzen.
-B1) In der Zarafa/Kopano WebApp unter Einstellungen in der linken Leiste den (neuen) Menüpunkt "Benno" anklicken und dort bitte folgende Werte eintragen:
+  * Benno Container: Bspw. //BennoContainer//\\ Dies ist die Standardeinstellung. Sollten Sie mehrere Container in Benno MailArchiv konfiguriert haben, hier bitte den relevanten Containernamen eintragen. (In der aktuellen Version ist nur der hier angegebene Container nutzbar).
-Serveradresse: Bspw. http(s)://<benno-hostname>/benno/rest.php (<benno-hostname> bitte mit dem Hostnamen (oder der IP-Adresse) Ihres Benno MaiArchiv-Servers ersetzen)
+Nach der Installation des Plugins sollten sich die User der Zarafa/Kopano WebApp einmal aus- und wieder einloggen.
-Benno Container: Bspw. BennoContainer (Dies ist die Standardeinstellung. Sollten Sie mehrere Container in Benno MailArchiv konfiguriert haben, hier bitte den relevanten Containernamen eintragen. (In der aktuellen Version ist nur der hier angegebene Container nutzbar).
-Einträge: Anzahl Treffer je Seite (nach eigenem Geschmack einstellbar).
+===== Aktivierung des Plugins =====
+  * Aus der Zarafa/Kopano Webapp aus- und wieder einloggen.
+  * In der Webapp unter Einstellungen -> Plugins das Plugin "Benno" aktivieren (die Seite bitte nach der Aufforderung neu laden).
+====== Konfiguration ======
+===== Benutzer-bezogene Konfiguration =====
+In der Zarafa/Kopano WebApp unter Einstellungen in der linken Leiste den (neuen) Menüpunkt "Benno" anklicken und dort bitte folgende Werte eintragen:
+  * Serveradresse: Bspw. //%%http(s)://<benno-hostname>/benno/rest.php%%//\\ <benno-hostname> bitte mit dem Hostnamen (oder der IP-Adresse) Ihres Benno MaiArchiv-Servers ersetzen.
+  * Benno Container: Bspw. //BennoContainer//\\ Dies ist die Standardeinstellung. Sollten Sie mehrere Container in Benno MailArchiv konfiguriert haben, hier bitte den relevanten Containernamen eintragen. (In der aktuellen Version ist nur der hier angegebene Container nutzbar).
+  * Einträge: Anzahl Treffer je Seite\\ nach eigenem Geschmack einstellbar.
-Hinweis zur Variante A:
 Wenn ein Benutzer die Daten für Serveradresse usw. in seinen WebApp-Einstellungen manuell ändert (bzw. dort manuell welche hinzufügt), ist diese Änderung von der Priorität her höher als die systemweite Vorgabe aus der settings.ini. Die Daten aus der settings.ini haben dann für diesen Benutzer keine Gültigkeit mehr.
-Hinweis zur Benutzer-Authentifizierung:
+====== Benutzer-Authentifizierung ======
 Der Benutzer in Benno MailArchiv muss die gleichen Zugangsdaten wie der Benutzer in Zarafa/Kopano haben. Loggt sich z.B. der Benutzer Meier mit den Anmeldedaten "meier:passwort" in Benno MailArchiv ein, müssen die gleichen Zugangsadaten auch für Zarafa/Kopano gültig sein (hier also "meier:passwort").
 Soweit Benno MailArchiv und Zarafa/Kopano die gleiche Authentisierungsquelle (bspw. Microsoft ActiveDirectory, LDAP usw.) verwenden, ist dies automatisch gewährleistet.
-Nutzung des Benno MailArchiv Plugins für Zarafa/Kopano:
+====== Nutzung in Kopano ======
-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 der waagerechten Menüleiste der 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 (zukünftige Erweiterungen):
-- Konversationssuche
-- Containerwahl
-- Suchen speichern

Das Benno MailArchiv Wiki

Benutzer-Werkzeuge

Webseiten-Werkzeuge

Unterschiede

Seiten-Werkzeuge