Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- installation [2017/07/27 13:35] – [Lizenzfile] lwsystems
+++ installation [2024/01/16 09:08] – [GPG-Key zur Signaturprüfung der Paketverwaltung hinzufügen] lwsystems
@@ Zeile 1: / Zeile 1: @@
 ====== Installation ======
+Für ein einfache und schnelle Installation siehe auch: [[quick-install|Kurzanleitung zur Installation]]
 ===== Allgemeines =====
 Die in dieser Installationsanleitung dargelegten Informationen und Vorgänge beziehen sich auf den Benno MailArchiv Release-Stand 2.x.
-Diese Installationsanleitung der E-Mail-Archivierungslösung Benno MailArchiv beschreibt alle erforderlichen und nacheinander auszuführenden Schritte für eine sachgerechte Installation der Anwendung Benno MailArchiv auf einem Serversystem. Diese Installationsanleitung ist ausschließlich gültig für die Softwareversion Benno MailArchiv 2.x. Die strikte Anwendung der Installationsanleitung ist insbes. erforderlich für den Aufbau einer Lösung für die gesetzeskonforme Archivierung aller handels- und steuerrechtlich relevanten E-Mails nach deutschem Recht. Sie ist Bestandteil der Verfahrensdokumentation zur gesetzeskonformen E-Mail-Archivierung, soweit eine solche implementiert wird.
+Diese Installationsanleitung der E-Mail-Archivierungslösung Benno MailArchiv beschreibt alle erforderlichen und nacheinander auszuführenden Schritte für eine sachgerechte Installation der Anwendung Benno MailArchiv auf einem Serversystem. Diese Installationsanleitung ist ausschließlich gültig für die Softwareversion Benno MailArchiv 2.x.
-**WICHTIGER HINWEIS:** //Wir weisen hiermit ausdrücklich daraufhin, dass eine gesetzeskonforme Archivierung aller handels- und steuerrechtlich relevanten E-Mails nach deutschem Recht nicht alleine durch die ausschließliche Beachtung und technisch korrekte Umsetzung der hier dargelegten Installationsschritte erreicht werden kann!//
+Die **strikte Anwendung** dieser detaillierten Installationsanleitung ist insbes. die Errichtung einer Lösung zur rechtssicheren bzw. GoBD-konforme Archivierung aller handels- und steuerrechtlich relevanten E-Mails nach deutschem Recht erforderlich. Diese Installationsanleitung ist Bestandteil der Verfahrensdokumentation zur gesetzeskonformen E-Mail-Archivierung, soweit eine solche implementiert wird.
-//Zur Einrichtung einer gesetzeskonformen E-Mail-Archivierung nach deutschem Recht sind weitergehende, nicht-technische bzw. organisatorische Maßnahmen zwingend erforderlich, die weder in dieser Installationsanleitung angedeutet noch dokumentiert sind. So sind bspw. die technischen und organisatorischen Umstände des Verfahrens „E-Mail-Archivierung“ im Zuge der Erstellung einer qualifizierten Verfahrensdokumentation zu behandeln. Eine geeignete Dokumentation kann nur durch qualifizierte Beratung und ausschließlich kunden-individuell erstellt werden. Bei Fragen hierzu wenden Sie sich gerne an unsere Benno MailArchiv Certified Partner oder direkt an uns. Sowohl unsere Certified Partner wie auch wir selbst unterstützen Sie qualifiziert bei der Umsetzung der erforderlichen Maßnahmen.//
+//**WICHTIGER HINWEIS:**//
-E-Mail: support@benno-mailarchiv.de
+//Wir weisen hiermit **ausdrücklich** daraufhin, dass eine GoBD-konforme bzw. rechtssichere Archivierung aller handels- und steuerrechtlich relevanten E-Mails nicht alleine durch die Beachtung und technisch korrekte Umsetzung der hier dargelegten Installationsschritte erreicht werden kann! Jegliche Softwareprodukte zur E-Mail Archivierung (wie Benno MailArchiv und alle anderen) stellen gemäß GoBD **nur einen Teil der Lösung** einer gesetzes- bzw. GoBD-konformen E-Mail-Archivierung dar, und sind nicht die Lösung selbst!//
-Diese Installationsanleitung beschreibt, wie Benno MailArchiv 2.x in einer typischen Single-Mandanten Konfiguration eingerichtet wird. Auf die Einrichtung und Verwaltung einer Multi-Mandanten Konfiguration wird nur insofern eingegangen, als die grundlegenden Aspekte angerissen werden. Bzgl. Fragen zur Implementierung einer Multi-Mandanten Umgebung steht unser Professional Service im Einzelfall gerne zur Verfügung. Diese Installationsanleitung ist als „Quick-Installation Guide“ zu verstehen, um auf schnellstem und direktem Weg Benno MailArchiv mit Standard-Parametern lauffähig zu installieren.
+//Zur Einrichtung einer E-Mail-Archivierung, die den Anforderungen der GoBD genügt, sind zwingend weitergehende, also über das reine Softwareprodukt hinausgehende, nicht-technische bzw. organisatorische Maßnahmen erforderlich. Konkret ist eine geeignete bzw. den Anforderungen der GoBD entsprechende Verfahrensdokumentation zu erstellen. Auf diese Verfahrensdokumentation wird weder in dieser Installationsanleitung noch in diesem Wiki weiter eingegangen.//
+//Eine geeignete Verfahrensdokumentation kann nur durch qualifizierte Beratung und ausschließlich kunden-individuell erstellt werden. Bei Fragen hierzu wenden Sie sich gerne an unsere [[https://www.benno-mailarchiv.de/benno-certified-partner/|Benno MailArchiv Certified Partner]] oder direkt an [[https://www.benno-mailarchiv.de/kontakt/|uns]].//
+//Sowohl unsere Certified Partner wie auch wir selbst unterstützen Sie qualifiziert bei der Erstellung der Verfahrensdokumentation und Berücksichtigung aller anderen relevanten Aspekte der GoBD.//
+//Detailliertere und weiterführende Informationen hierzu finden Sie in unseren beiden White Papers://
+//[[https://www.benno-mailarchiv.de/wp-content/uploads/2017/07/Was-bedeutet-GoBD-konform.pdf|White Paper Was bedeutet GoBD-konform?]]//
+//[[https://www.benno-mailarchiv.de/wp-content/uploads/2016/12/Paper-Rechtliche-Aspekte-zur-gesetzeskonformen-Mailarchivierung-2017.pdf|White Paper Rechtliche Aspekte zur gesetzeskonformen Mailarchivierung]]//
+Bei weitergehenden Fragen wenden Sie sich bitte per E-Mail an: support@benno-mailarchiv.de
+Diese Installationsanleitung beschreibt, wie Benno MailArchiv 2.x in einer typischen Single-Mandanten Konfiguration eingerichtet wird. Die Einrichtung und Verwaltung einer Multi-Mandanten Konfiguration wird [[mandanten-konfiguration|hier]] beschrieben. Bei Bedarf steht Ihnen unser Professional Services-Team für weitere Einzelheiten hierzu gerne zur Verfügung.
 ======  Betriebs- und Betriebssystemumgebung  ======
 Für den Betrieb von Benno MailArchiv ist das Betriebssystem Linux erforderlich. Zusätzlich benötigt Benno MailArchiv Java als Laufzeitumgebung. Für den Betrieb der Benno MailArchiv WebApp ist PHP als Laufzeitumgebung erforderlich. Für die Userverwaltung auf Kommandozeilen-Ebene wird perl benötigt. Alle diesbzgl. Details sind nachstehend detailliert erläutert.
@@ Zeile 23: / Zeile 37: @@
 ===== 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  =====
 ==== 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 7 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 82: / Zeile 90: @@
 <code>deb http://www.benno-mailarchiv.de/download/debian /</code>
 ===== 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:
-<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  =====
 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 92: / Zeile 105: @@
-==== Debian 9 (Stretch) ====
+==== Debian 9 (Stretch) / Ubuntu 16.04 ====
-Ab Debian 9 muss zusätzlich das Paket //php-mbstring// installiert werden.
+Ab Debian 9 und Ubuntu 16.04 muss zusätzlich das Paket //php-mbstring// installiert werden.
 <code>
 apt-get install php-mbstring
@@ Zeile 115: / Zeile 128: @@
 <code>
-echo 'SHARED_SECRET = ganzGeheimesUndSicheresPasswort' > /etc/benno-web/rest.conf
+echo 'ganzGeheimesUndSicheresPasswort' > /etc/benno/rest.secret
 history -c
-chgrp www-data /etc/benno-web/rest.conf
+chown benno.benno /etc/benno/rest.secret
-chmod 0440 /etc/benno-web/rest.conf
+chmod 0440 /etc/benno/rest.secret
 </code>
-Tragen Sie exakt das gleiche Shared Secret anschließend in die Datei ''/etc/benno/rest.secret'' ein.
+Tragen Sie exakt das gleiche Shared Secret anschließend mit dem **Prefix** //SHARED_SECRET =// in die Datei ''/etc/benno-web/rest.conf'' ein.
 <code>
-echo 'ganzGeheimesUndSicheresPasswort' > /etc/benno/rest.secret
+echo 'SHARED_SECRET = ganzGeheimesUndSicheresPasswort' > /etc/benno-web/rest.conf
 history -c
-chown benno.benno /etc/benno/rest.secret
+chgrp www-data /etc/benno-web/rest.conf
-chmod 0440 /etc/benno/rest.secret
+chmod 0440 /etc/benno-web/rest.conf
 </code>
-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:
@@ Zeile 144: / Zeile 159: @@
 ==== 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 ===
@@ Zeile 154: / Zeile 169: @@
 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 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 Hosts, bspw.:
+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.
+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  ===
@@ Zeile 195: / Zeile 209: @@
 ==== 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>
@@ Zeile 213: / Zeile 227: @@
 <code bash>
-START_ARCHIVE=yes JAVA_OPTIONS=' -server -Xmx2500m'
+START_ARCHIVE=yes
+JAVA_OPTIONS=' -server -Xmx2500m '
 DAEMON_ADDRESS='127.0.0.1'
-DAEMON_PORT='2555'DAEMON_ARGS='-c /etc/benno/benno.xml'
+DAEMON_PORT='2555'
+DAEMON_ARGS='-c /etc/benno/benno.xml'
 USER=benno
 </code>
+Das Leerzeichen nach dem Wert muss ebenfalls angegeben werden.
 ===== 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.
@@ Zeile 274: / Zeile 291: @@
 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 ======
@@ Zeile 344: / Zeile 361: @@
 ==== 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''
 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 ====
+  * [[import|Import von E-Mails in das Archiv]]

Das Benno MailArchiv Wiki

Benutzer-Werkzeuge

Webseiten-Werkzeuge

Unterschiede

Seiten-Werkzeuge