Benutzer-Werkzeuge

Webseiten-Werkzeuge


installation

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen RevisionVorhergehende Überarbeitung
Nächste Überarbeitung
Vorhergehende Überarbeitung
installation [2018/05/28 13:26] – [Hinweis für Installationen mit sehr großem E-Mailaufkommen] lwsystemsinstallation [2024/01/23 09:32] (aktuell) – [Debian 9 (Stretch) / Ubuntu 16.04] lwsystems
Zeile 1: Zeile 1:
 ====== Installation ====== ====== Installation ======
  
 +Für ein einfache und schnelle Installation siehe auch: [[quick-install|Kurzanleitung zur Installation]]
 ===== Allgemeines ===== ===== Allgemeines =====
  
Zeile 36: Zeile 37:
  
 ===== Freigegebene Betriebssystemumgebungen  ===== ===== Freigegebene Betriebssystemumgebungen  =====
-Benno MailArchiv 2.x ist für folgende Betriebssysteme freigegeben: Debian GNU/Linux (das jeweilige stable Release) Univention Corporate Server (UCS), ab Version 4.x. 
- 
-Ubuntu Server wird in der Version 14.04 LTS und [[ubuntu|16.04 LTS]] unterstützt. 
-Erläuterungen zur Installation unter Ubuntu finden Sie [[ubuntu|hier]]. 
- 
-Auf Nachfrage: SuSE Linux Enterprise Server (SLES) RedHat Enterprise Linux (RHEL).  
- 
  
 +Die aktuell für die Installation von Benno MailArchiv freigegebenen Betriebssystemumgebungen finden Sie [[Betriebssystemumgebungen|hier]]
 ===== Benötigte Laufzeitumgebung  ===== ===== Benötigte Laufzeitumgebung  =====
 ==== Laufzeitumgebung für den Benno MailArchiv Server (Backend, Core und REST)  ==== ==== Laufzeitumgebung für den Benno MailArchiv Server (Backend, Core und REST)  ====
  
-Das Benno MailArchiv Backend sowie das REST-Interface benötigen zum Betrieb eine Java-Umgebung. Hierzu wird auf dem Server mindestens Java JDK Version benötigt.+Das Benno MailArchiv Backend sowie das REST-Interface benötigen zum Betrieb eine Java-Umgebung. Hierzu wird auf dem Server eine aktuelle OpenJDK Version benötigt.
  
-Laufzeitumgebung für die Benno MailArchiv WebApp Das Benno MailArchiv Frontend ist über PHP, HTML-Templates mit Cascading Style Sheets (CSS) realisiert. Zum Betrieb werden PHP5 sowie ein Apache2 Web-Server benötigt. +Laufzeitumgebung für die Benno MailArchiv WebApp Das Benno MailArchiv Frontend ist über PHP, HTML-Templates mit Cascading Style Sheets (CSS) realisiert. Zum Betrieb werden eine aktuelle PHP-Version sowie ein Web-Server benötigt. 
  
  
Zeile 95: Zeile 90:
 <code>deb http://www.benno-mailarchiv.de/download/debian /</code>  <code>deb http://www.benno-mailarchiv.de/download/debian /</code> 
 ===== GPG-Key zur Signaturprüfung der Paketverwaltung hinzufügen  ===== ===== GPG-Key zur Signaturprüfung der Paketverwaltung hinzufügen  =====
 +
 Debian-basierte Systeme verwenden GNU Privacy Guard (GPG) zur Prüfung der Authentizität der Paketquellen. Mit den folgenden Kommandos fügen Sie denn Benno MailArchiv Paketquellen-Key zu Ihrem System hinzu:  Debian-basierte Systeme verwenden GNU Privacy Guard (GPG) zur Prüfung der Authentizität der Paketquellen. Mit den folgenden Kommandos fügen Sie denn Benno MailArchiv Paketquellen-Key zu Ihrem System hinzu: 
-<code>wget -O - http://www.benno-mailarchiv.de/download/debian/benno.asc | apt-key add -</code> + 
 +<code bash> 
 +wget -O /etc/apt/trusted.gpg.d/benno-mailarchiv-archive-key-30.gpg \ 
 +  https://www.benno-mailarchiv.de/download/benno-mailarchiv-archive-key-30.gpg 
 +</code> 
 ===== Benno MailArchiv-Pakete installieren  ===== ===== Benno MailArchiv-Pakete installieren  =====
 Nach dem Sie dem System die Paketquelle für Benno MailArchiv und der Paketverwaltung den Signaturschlüssel hinzugefügt haben, müssen nun die Paketlisten mit folgendem Kommando aktualisiert werden: apt-get update Danach kann Benno MailArchiv über das Paketmanagement von Debian/Ubuntu/UCS installiert werden:  Nach dem Sie dem System die Paketquelle für Benno MailArchiv und der Paketverwaltung den Signaturschlüssel hinzugefügt haben, müssen nun die Paketlisten mit folgendem Kommando aktualisiert werden: apt-get update Danach kann Benno MailArchiv über das Paketmanagement von Debian/Ubuntu/UCS installiert werden: 
Zeile 105: Zeile 105:
  
  
-==== Debian 9 (Stretch) / Ubuntu 16.04 ==== 
- 
-Ab Debian 9 und Ubuntu 16.04 muss zusätzlich das Paket //php-mbstring// installiert werden. 
-<code> 
-apt-get install php-mbstring 
-systemctl stop apache2 
-systemctl start apache2 
-</code> 
  
 ===== Andere Linux-Distributionen  ===== ===== Andere Linux-Distributionen  =====
Zeile 148: Zeile 140:
  
  
-Nachdem Sie das Shared Secret eingerichtet haben, muss der Benno REST-Daemon gestartet werden, damit ein Zugriff über die WebApp möglich ist: ///etc/init.d/benno-rest start// +Nachdem Sie das Shared Secret eingerichtet haben, muss der Benno REST-Daemon gestartet werden, damit ein Zugriff über die WebApp möglich ist: //systemctl start benno-rest// 
  
 Der Start des REST-Daemon wird in der Datei ///var/log/benno/rest.log// protokolliert:  Der Start des REST-Daemon wird in der Datei ///var/log/benno/rest.log// protokolliert: 
Zeile 159: Zeile 151:
 ==== Lizenzfile  ==== ==== Lizenzfile  ====
  
-Nach Import der ersten E-Mail steht die volle Funktionalität des Systems für einen Zeitraum von 60 Tagen auch ohne Lizenzdatei zur Verfügung (Demo-Modus). Nach Ablauf des Demo-Zeitraums bzw. ohne gültiges Lizenzfile werden auch weiterhin E-Mails archiviert. Ist der Demo-Modus abgelaufen und keine gültige Lizenz installiert, ist der Zugriff auf die archivierten Mails (Suche und Anzeige) über die WebApp nur möglich, wenn Sie in der Datei ''[[benno.conf|/etc/benno/benno.conf]]'' die Benutzerberechtigungen deaktivieren. **Mit der Deaktivierung dieser Berechtigungen in der Konfigurationsdatei können ALLE Benutzer ALLE E-Mails im Archiv lesen!** +Nach Import der ersten E-Mail steht die volle Funktionalität des Systems für einen Zeitraum von 60 Tagen auch ohne Lizenzdatei zur Verfügung **(Demo-Modus)**. Nach Ablauf des Demo-Zeitraums bzw. ohne gültiges Lizenzfile werden auch weiterhin E-Mails archiviert. Ist der Demo-Modus abgelaufen und keine gültige Lizenz installiert, ist der Zugriff auf die archivierten Mails (Suche und Anzeige) über die WebApp nur möglich, wenn Sie in der Datei ''[[benno.conf|/etc/benno-web/benno.conf]]'' die Benutzerberechtigungen deaktivieren. Hierdurch wird Benno MailArchiv in den **Community Edition** Modus umgeschaltet. **Achtung! Mit der Deaktivierung dieser Berechtigungen in der Konfigurationsdatei können ALLE Benutzer ALLE E-Mails im Archiv lesen!**
  
 +Bitte beachten Sie, dass eine **kommerzielle Nutzung** der WebApp in der Community Edition lizenzrechtlich **ausgeschlossen** ist und einen Bruch der Lizenzbedingungen darstellt! Details zur Lizenzierung sind im Abschnitt „Lizenzen in Benno MailArchiv“ [[https://www.benno-mailarchiv.de/preise/|hier]] erläutert).
 === Regulärer Betrieb === === Regulärer Betrieb ===
  
Zeile 169: Zeile 161:
 Ein gültiges Lizenzfile kann jederzeit per Webformular (siehe unten) bezogen werden. Um das Lizenzfile zu bestellen, gehen Sie folgendermaßen vor:  Ein gültiges Lizenzfile kann jederzeit per Webformular (siehe unten) bezogen werden. Um das Lizenzfile zu bestellen, gehen Sie folgendermaßen vor: 
  
-=== 1. Ermitteln Sie die zur Lizenzierung erforderlichen Daten (Host-Info).  ===+=== 1. Ermitteln Sie die zur Lizenzierung erforderlichen Daten (Instance-Id).  ===
  
-Führend Sie dazu den folgenden Befehl aus:+Führen Sie dazu den folgenden Befehl aus:
  
-  /etc/init.d/benno-rest info+  benno-client --instance-id
      
-Sie erhalten eine zweizeilige Bildschirmausgabe mit Ihrer IP-Adresse und dem FQDN (Full Qualified Domain Name) Ihres Benno MailArchiv Hostsbspw.: +Dieses Kommando gibt die Instance-ID des Systems aus, die Sie bei der Anforderung einer Lizenz angeben.
-<code> +
-Host-Info: 192.168.1.117/benno.kunde.de +
-Build-Info: 2012-05-24 16:21:08 +
-</code> +
-HINWEIS: Sollte hier eine andere Ausgabe als die vorgenannte Information erscheinen (bspw. eine Meldung wie die nachstehende), //Cannot determine usable hostname or ip address// so liegt ein Fehler in der Namensauflösung vor. Bitte in diesem Fall unter der nächsten Ziffer („Prüfung der Namensauflösung“), weiter verfahren, um das Problem zu lösen +
  
-=== 2. Anfordern eines Lizenzfiles  ===+=== 2. Anfordern der Lizenz  ===
 Nutzen Sie das folgende Webformular, um ein gültiges Lizenzfile für Ihre Benno MailArchiv Installation zu erhalten: [[https://www.benno-mailarchiv.de/lizenz]]. Das Lizenzfile wird Ihnen per E-Mail zugesendet. Nutzen Sie das folgende Webformular, um ein gültiges Lizenzfile für Ihre Benno MailArchiv Installation zu erhalten: [[https://www.benno-mailarchiv.de/lizenz]]. Das Lizenzfile wird Ihnen per E-Mail zugesendet.
 +
 +Falls  die E-Mail, mit der Ihnen das Lizenzfile zugeschickt wurde, vom Benno MailArchiv System archiviert wurde, wird die Lizenz automatisch beim nächsten Neustart des Benno REST Demons erkannt.
 +
 +Alternativ kann die anhängende Lizenzdatei //benno.lic// auch auf dem Benno MailArchiv System gespeichert werden. 
  
 === 3. Lizenzfile installieren  === === 3. Lizenzfile installieren  ===
Zeile 210: Zeile 201:
 ==== Prüfung der Namensauflösung  ==== ==== Prüfung der Namensauflösung  ====
  
-Die korrekte Namensauflösung des Hosts, auf dem Benno MailArchiv betrieben wird, ist essentielle Voraussetzung für den Betrieb bzw. die Lizenzierung. Sollten Sie bei der Ermittlung der Informationen für die Bestellung des Lizenzkeys Probleme haben, liegen diese i.d.R. an folgenden Umständen, die einfach gelöst werden können: In der Datei /etc/hosts löst eine IP-Adresse „127.x.x.x“ auf den Hostnamen des Benno-Servers auf (für die IP-Adresse 127.x.x.x kann kein funktionierender Lizenzkey erstellt werden) Der Hostname und der FQDN des Benno-Servers sind in der Datei /etc/hosts nicht oder nicht richtig eingetragen Bitte prüfen Sie, ob der Hostname Ihres Servers in der Datei /etc/hosts korrekt eingerichtet ist. Folgendes Beispiel zeigt, wie eine korrekte Konfiguration beispielhaft aussieht +Die korrekte Namensauflösung des Hosts, auf dem Benno MailArchiv betrieben wird, ist essentielle Voraussetzung für den Betrieb bzw. die Lizenzierung. Sollten Sie bei der Ermittlung der Informationen für die Bestellung des Lizenzkeys Probleme haben, liegen diese i.d.R. an folgenden Umständen, die einfach gelöst werden können: In der Datei /etc/hosts löst eine IP-Adresse „127.x.x.x“ auf den Hostnamen des Benno-Servers auf (für die IP-Adresse 127.x.x.x (Loopback) kann **kein** funktionierender Lizenzkey erstellt werden) Der Hostname und der FQDN des Benno-Servers sind in der Datei /etc/hosts nicht oder nicht richtig eingetragen Bitte prüfen Sie, ob der Hostname Ihres Servers in der Datei /etc/hosts korrekt eingerichtet ist. Folgendes Beispiel zeigt, wie eine korrekte Konfiguration beispielhaft aussieht 
  
 <code> <code>
Zeile 229: Zeile 220:
 <code bash> <code bash>
 START_ARCHIVE=yes START_ARCHIVE=yes
-JAVA_OPTIONS=' -server -Xmx2500m'+JAVA_OPTIONS=' -server -Xmx2500m '
 DAEMON_ADDRESS='127.0.0.1' DAEMON_ADDRESS='127.0.0.1'
 DAEMON_PORT='2555' DAEMON_PORT='2555'
 DAEMON_ARGS='-c /etc/benno/benno.xml' DAEMON_ARGS='-c /etc/benno/benno.xml'
 USER=benno USER=benno
-</code> +</code> 
 +Das Leerzeichen nach dem Wert muss ebenfalls angegeben werden.
 ===== Konfiguration einer Multi-Mandantenumgebung  ===== ===== Konfiguration einer Multi-Mandantenumgebung  =====
 Die Konfiguration weiterer [[mandanten-konfiguration|Mandanten]] in Benno MailArchiv erfolgt in der Konfigurationsdatei /etc/benno/benno.xml. Je Mandant ist innerhalb der Struktur configuredarchives eine eigene XML-Struktur containerarchive … /containerarchive mit den Parametern und Daten des jeweiligen Mandanten einzurichten.  Die Konfiguration weiterer [[mandanten-konfiguration|Mandanten]] in Benno MailArchiv erfolgt in der Konfigurationsdatei /etc/benno/benno.xml. Je Mandant ist innerhalb der Struktur configuredarchives eine eigene XML-Struktur containerarchive … /containerarchive mit den Parametern und Daten des jeweiligen Mandanten einzurichten. 
Zeile 291: Zeile 283:
 Der Standard-Benutzer ist "admin". Bitte setzen Sie vor dem ersten Zugriff das Passwort dieses Benutzers und legen entsprechende Benutzerkonten mit entsprechenden Rechten an.  Der Standard-Benutzer ist "admin". Bitte setzen Sie vor dem ersten Zugriff das Passwort dieses Benutzers und legen entsprechende Benutzerkonten mit entsprechenden Rechten an. 
  
-  benno-useradmin -u admin -p SICHERSPASSWORT +  benno-useradmin -u admin -p SICHERESPASSWORT -e "emailadresse@firma.de"
  
 ====== Optionale Konfigurations-Einstellungen ====== ====== Optionale Konfigurations-Einstellungen ======
Zeile 361: Zeile 353:
 ==== Mailweiterleitung an externe Empfänger  ==== ==== Mailweiterleitung an externe Empfänger  ====
  
-In der WebApp können E-Mails jederzeit an eine beliebige Mailadresse weitergeleitet werden. Durch Klick auf die Schaltfläche „Mail weiterleiten“ kann die E-Mail an eine frei definierbare E-Mailadresse weitergeleitet werden. Standardmäßig wird die Mail mit dem Absender-Envelope //benno@localhost// versendet. Viele Mailserver bzw. MTAs MTA keine E-Mails von Absendern an, deren Domain kein FQDN ist, so dass Mails mit diesem Envelope häufig nicht bei externen Empfängern (also Empfängern außerhalb der eigenen Maildomäne) ankommen. Um E-Mails zuverlässig auch nach Extern weiterzuleiten, sollte der Wert der Einstellung MAIL_FROM geändert werden:+In der WebApp können E-Mails jederzeit an eine beliebige Mailadresse weitergeleitet werden. 
 +Durch Klick auf die Schaltfläche „Mail weiterleiten“ kann die E-Mail an eine frei definierbare E-Mailadresse weitergeleitet werden. Standardmäßig wird die Mail mit dem Absender-Envelope //benno@localhost// versendet. Viele Mailserver bzw. MTAs MTA keine E-Mails von Absendern an, deren Domain kein FQDN ist, so dass Mails mit diesem Envelope häufig nicht bei externen Empfängern (also Empfängern außerhalb der eigenen Maildomäne) ankommen. Um E-Mails zuverlässig auch nach Extern weiterzuleiten, sollte der Wert der Einstellung MAIL_FROM geändert werden:
  
 Default: ''MAIL_FROM = benno@localhost'' Default: ''MAIL_FROM = benno@localhost''
  
 Angepasst (beispielsweise): ''MAIL_FROM = benno@musterfirma.de'' Angepasst (beispielsweise): ''MAIL_FROM = benno@musterfirma.de''
 +
 +=== Installation des MTA ===
 +
 +
 +Der Versand der E-Mail  erfolgt durch den auf dem Archivierungssystem installierten MTA. Unter Debian / Ubuntu bietet es sich an, hier Postfix zu installieren. Im Konfigurationsdialog wird die Option "//Satellite System//" ausgewählt. Im nächsten Schritt wird hier der Smarthost abgefragt, der als Relay für die weitergeleitete E-Mail dient.
  
 ==== nächste Schritte ==== ==== nächste Schritte ====
installation.1527513978.txt.gz · Zuletzt geändert: 2018/05/28 13:26 von lwsystems