Hier werden die Unterschiede zwischen zwei Versionen angezeigt.
Beide Seiten der vorigen RevisionVorhergehende ÜberarbeitungNächste Überarbeitung | Vorhergehende Überarbeitung | ||
installation [2017/09/19 13:17] – [Einrichtung des Shared Secret] lwsystems | installation [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: | ||
- | |||
- | 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 | + | Das Benno MailArchiv Backend sowie das REST-Interface benötigen zum Betrieb eine Java-Umgebung. Hierzu wird auf dem Server |
- | 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 | + | 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 |
Zeile 95: | Zeile 90: | ||
< | < | ||
===== 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: | ||
- | < | + | |
+ | < | ||
+ | wget -O / | ||
+ | https:// | ||
+ | </ | ||
===== 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/ | 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/ | ||
Zeile 105: | Zeile 105: | ||
- | ==== Debian 9 (Stretch) / Ubuntu 16.04 ==== | ||
- | |||
- | Ab Debian 9 und Ubuntu 16.04 muss zusätzlich das Paket // | ||
- | < | ||
- | apt-get install php-mbstring | ||
- | systemctl stop apache2 | ||
- | systemctl start apache2 | ||
- | </ | ||
===== Andere Linux-Distributionen | ===== Andere Linux-Distributionen | ||
Zeile 128: | Zeile 120: | ||
< | < | ||
- | echo 'SHARED_SECRET = ganzGeheimesUndSicheresPasswort' | + | echo ' |
history -c | history -c | ||
- | chgrp www-data | + | chown benno.benno |
- | chmod 0440 /etc/benno-web/rest.conf | + | chmod 0440 / |
</ | </ | ||
- | Tragen Sie exakt das gleiche Shared Secret anschließend in die Datei ''/ | + | Tragen Sie exakt das gleiche Shared Secret anschließend |
< | < | ||
- | echo ' | + | echo 'SHARED_SECRET = ganzGeheimesUndSicheresPasswort' |
history -c | history -c | ||
- | chown benno.benno | + | chgrp www-data |
- | chmod 0440 / | + | chmod 0440 /etc/benno-web/rest.conf |
</ | </ | ||
- | **Achtung** Hier bitte nur das Passwort ohne // | ||
- | Nachdem Sie das Shared Secret eingerichtet haben, muss der Benno REST-Daemon gestartet werden, damit ein Zugriff über die WebApp möglich ist: /// | + | |
+ | |||
+ | 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 /// | Der Start des REST-Daemon wird in der Datei /// | ||
Zeile 158: | 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, | + | 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 |
+ | 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:// | ||
=== Regulärer Betrieb === | === Regulärer Betrieb === | ||
Zeile 168: | 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. | + | === 1. Ermitteln Sie die zur Lizenzierung erforderlichen Daten (Instance-Id). === |
- | Führend | + | Führen |
- | | + | benno-client --instance-id |
| | ||
- | Sie erhalten eine zweizeilige Bildschirmausgabe mit Ihrer IP-Adresse und dem FQDN (Full Qualified Domain Name) Ihres Benno MailArchiv Hosts, bspw.: | + | Dieses Kommando gibt die Instance-ID des Systems aus, die Sie bei der Anforderung einer Lizenz angeben. |
- | < | + | |
- | Host-Info: 192.168.1.117/ | + | |
- | Build-Info: 2012-05-24 16:21:08 | + | |
- | </ | + | |
- | HINWEIS: Sollte hier eine andere Ausgabe als die vorgenannte Information erscheinen (bspw. eine Meldung wie die nachstehende), | + | |
- | === 2. Anfordern | + | === 2. Anfordern |
Nutzen Sie das folgende Webformular, | Nutzen Sie das folgende Webformular, | ||
+ | |||
+ | 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 // | ||
=== 3. Lizenzfile installieren | === 3. Lizenzfile installieren | ||
Zeile 209: | 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 |
< | < | ||
Zeile 227: | Zeile 219: | ||
<code bash> | <code bash> | ||
- | START_ARCHIVE=yes JAVA_OPTIONS=' | + | START_ARCHIVE=yes |
+ | JAVA_OPTIONS=' | ||
DAEMON_ADDRESS=' | DAEMON_ADDRESS=' | ||
- | DAEMON_PORT=' | + | DAEMON_PORT=' |
+ | DAEMON_ARGS=' | ||
USER=benno | USER=benno | ||
- | </ | + | </ |
+ | 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 / | Die Konfiguration weiterer [[mandanten-konfiguration|Mandanten]] in Benno MailArchiv erfolgt in der Konfigurationsdatei / | ||
Zeile 288: | Zeile 283: | ||
Der Standard-Benutzer ist " | Der Standard-Benutzer ist " | ||
- | benno-useradmin -u admin -p SICHERSPASSWORT | + | benno-useradmin -u admin -p SICHERESPASSWORT -e " |
====== Optionale Konfigurations-Einstellungen ====== | ====== Optionale Konfigurations-Einstellungen ====== | ||
Zeile 358: | 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 // | + | 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 // | ||
Default: '' | Default: '' | ||
Angepasst (beispielsweise): | Angepasst (beispielsweise): | ||
+ | |||
+ | === Installation des MTA === | ||
+ | |||
+ | |||
+ | Der Versand der E-Mail | ||
+ | |||
+ | ==== nächste Schritte ==== | ||
+ | |||
+ | * [[import|Import von E-Mails in das Archiv]] | ||
+ | |||