Für ein einfache und schnelle Installation siehe auch: Kurzanleitung zur Installation
Информация и процедуры, описанные в данном руководстве по установке, относятся к версии 2.x программы Benno MailArchiv.
Данное руководство по установке решения для архивирования электронной почты Benno MailArchiv описывает все необходимые шаги, которые следует выполнить последовательно для правильной установки приложения Benno MailArchiv на серверную систему. Это руководство по установке действительно исключительно для версии программного обеспечения Benno MailArchiv 2.x.
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.
ВАЖНОЕ ЗАМЕЧАНИЕ:
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!
Для настройки архивирования электронной почты, соответствующего требованиям немецких общепринятых принципов бухгалтерского учета (GoBD), абсолютно необходимы дополнительные нетехнические и организационные меры, выходящие за рамки самого программного обеспечения. В частности, необходимо создать соответствующую процедурную документацию, отвечающую требованиям GoBD. Эта процедурная документация не будет далее обсуждаться в данном руководстве по установке или в этой вики.
Eine geeignete Verfahrensdokumentation 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.
Как наши сертифицированные партнеры, так и мы сами оказываем квалифицированную поддержку в создании процессной документации с учетом всех других соответствующих аспектов GoBD.
Более подробную информацию можно найти в наших двух аналитических отчетах:
Белая книга: Что означает соответствие требованиям GoBD?
Белая книга: Правовые аспекты архивирования электронной почты в соответствии с законодательством
По всем дополнительным вопросам обращайтесь по электронной почте: 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 hier beschrieben. Bei Bedarf steht Ihnen unser Professional Services-Team für weitere Einzelheiten hierzu gerne zur Verfügung.
Для работы Benno MailArchiv требуется операционная система Linux. Кроме того, Benno MailArchiv требует Java в качестве среды выполнения. Веб-приложение Benno MailArchiv требует PHP в качестве среды выполнения. Perl необходим для управления пользователями из командной строки. Все подробности описаны ниже.
Benno MailArchiv arbeitet auch auf relativ kleiner Hardware mit erstaunlicher Geschwindigkeit. Um ein geeigenetes Hardware-Sizing vozunehmen, sind die individuellen Voraussetzungen und Gegebenheiten zu prüfen. Einen Anhaltspunkt für die Performance kann dieser Blog-Beitrag geben. Hier wurden willkürlich E-Mails auf einem älteren Notebook archiviert und volltext-indexiert. Mit einem durchschnittlichen Durchsatz von 13,5 E-Mails pro Sekunde. Die Hardwareanforderungen für Benno MailArchiv sind im Wesentlichen von folgenden Parametern abhängig: Anzahl zu archivierender Mails je Zeiteinheit (bspw. Mailaufkommen bzw. gewünschter Durchsatz pro Minute) Durchschnittliche Anzahl und Größe der E-Mails Komprimierbarkeit der Attachements (JPEG-Bilder, ZIP-Dateien usw. sind bereits komprimierte Datendateien; Office-Dokumente und Textdateien lassen sich i.d.R. wesentlich besser komprimieren) Anzahl und Intensität gleichzeitiger Zugriffe auf die WebApp usw. Als Faustregel können folgende Mindestanforderungen gelten: CPU DualCore oder QuadCore RAM 4 GB Festplattenspeicher: nach Bedarf (Technologie beliebig (lokale HDDs, NAS, SAN o.ä.)
Die aktuell für die Installation von Benno MailArchiv freigegebenen Betriebssystemumgebungen finden Sie hier
Для работы бэкэнда Benno MailArchiv и REST-интерфейса требуется среда Java. Для этого на сервере должна быть установлена актуальная версия OpenJDK.
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.
Benno MailArchiv 2.x состоит из компонентов, указанных на приведенном выше рисунке. Эти компоненты разделены на следующие установочные пакеты:
Пакет benno-lib содержит библиотеки для базовой установки Benno MailArchiv.
Пакет benno-core предоставляет основные функции для Benno MailArchiv. Пакет benno-core необходим как для архивирования, так и для запросов к архиву через REST-интерфейс.
Пакет benno-archive включает функции импорта электронных писем в архив. benno-archive управляет каталогом очереди писем (по умолчанию: /srv/benno/inbox). Все найденные там файлы *.eml автоматически импортируются, архивируются, а затем (после успешного завершения операции архивирования) удаляются из каталога очереди писем.
Пакет benno-rest-lib предоставляет библиотеки для REST-интерфейса Benno MailArchiv.
Пакет benno-rest включает в себя REST-интерфейс Benno MailArchiv.
Die Benno MailArchiv-Pakete stehen im Download-Bereich der Web-Site von Benno MailArchiv zur Verfügung.
Раздел для загрузки находится в свободном доступе. Программное обеспечение можно загрузить в любое время. Использование Benno MailArchiv регулируется нашими действующими лицензионными условиями. Без действительного лицензионного ключа функциональность Benno MailArchiv ограничена.
Во время установки необходимо запросить у LWsystems действительный лицензионный ключ (подробности см. ниже). Лицензионный ключ дает пользователю право использовать программное обеспечение постоянно и без ограничений по времени. В течение (обычно одного года) периода технического обслуживания программного обеспечения можно в любое время установить последние версии пакета Benno MailArchiv 2.x. Если на существующий сервер установлены более новые версии программного обеспечения без действующего периода технического обслуживания, система переходит в демонстрационный режим (с ограниченной функциональностью) до тех пор, пока не будет установлен новый действительный лицензионный ключ для данной версии или не будет установлена более старая версия, совместимая с периодом технического обслуживания лицензионного ключа.
Для установки Benno MailArchiv на Debian, Ubuntu или UCS можно использовать систему управления пакетами соответствующего дистрибутива.
Benno MailArchiv steht als App im Appcenter von Univention zur Verfügung und kann direkt über die Weboberfläche der UMC installiert werden.
В системах на основе Debian используется GNU Privacy Guard (GPG) для проверки подлинности исходных кодов пакетов. Следующие команды добавляют ключ исходного кода пакета Benno MailArchiv в вашу систему:
wget -O /etc/apt/trusted.gpg.d/benno-mailarchiv-archive-key-40.asc \ https://www.benno-mailarchiv.de/download/benno-mailarchiv-archive-key-40.asc
Для установки Benno MailArchiv достаточно добавить в вашу систему Linux еще один источник пакетов. Системы под управлением Debian 13 (Trixie) или более поздних версий должны быть настроены с использованием текущего формата deb822
cat - >> /etc/apt/sources.list.d/benno-mailarchiv.sources <
cat - >> /etc/apt/sources.list.d/benno-mailarchiv.list <
После добавления источника пакета Benno MailArchiv в систему и ключа подписи в менеджер пакетов, необходимо обновить списки пакетов с помощью следующей команды: `apt-get update`. После этого Benno MailArchiv можно установить через менеджер пакетов Debian/Ubuntu/UCS
apt-get установить benno-archive benno-rest benno-web
Im Zuge der Installation werden automatisch die beiden Benutzer benno und bennorest angelegt. Das Benno MailArchiv Backend (Archivierung) läuft mit dem Benutzer benno, während der Benno Rest-Daemon mit dem Benutzerkonto bennorest läuft.
Die Beschreibung für die Installation auf beliebigen Linux-Distributionen finden sie unter Installation aus TGZ-Paketen.
Для запуска Benno MailArchiv в типичной однопользовательской среде необходимо выполнить следующие настройки конфигурации. Базовая настройка Benno MailArchiv выполняется с помощью следующих конфигурационных файлов: /etc/benno/benno.xml и /etc/benno-web/benno.conf
Benno MailArchiv wird im Zuge der Installation von Haus aus so installiert und eingerichtet, dass sofortige Betriebsbereitschaft vorliegt. Es ist lediglich eine Konfigurationseinstellung vorzunehmen, um Benno MailArchiv zu starten: Die Datei /etc/benno-web/rest.conf erstellen und hier eine Zeile der Form SHARED_SECRET = IhrPasswort eingragen. Bitte tragen Sie als Shared Secret eine mindestens 20 Zeichen lange Zeichenkette mit zufälligen Zahlen und Buchstaben Ihrer Wahl ein. Das Shared Secret darf keine deutschen Umlaute (ä, ö, ü, Ä, Ö, Ü, ß) und Sonderzeichen enthalten!
Создать файл можно, введя в консоли следующие команды:
echo 'verySecretAndSecurePassword' > /etc/benno/rest.secret history -c chown benno.benno /etc/benno/rest.secret chmod 0440 /etc/benno/rest.secret
Tragen Sie exakt das gleiche Shared Secret anschließend mit dem Prefix SHARED_SECRET = in die Datei /etc/benno-web/rest.conf ein.
echo 'SHARED_SECRET = wholeSecretAndSecurePassword' > /etc/benno-web/rest.conf history -c chgrp www-data /etc/benno-web/rest.conf chmod 0440 /etc/benno-web/rest.conf
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
Запуск REST-демона записывается в файл /var/log/benno/rest.log :
2012-03-21 13:42:19,848 INFO Запуск сервера Jetty из файла /etc/benno/jetty.xml
Если общий секретный ключ не установлен, в журнал будет записано следующее сообщение об ошибке:
2012-03-21 13:42:19,952 FATAL Общий секрет в /etc/benno/benno.xml не установлен.
Wichtiger Hinweis: Wenn sich die Shared Secrets in den beiden Dateien unterscheiden, startet zwar der REST-Daemon ohne Fehlermeldung, aber es ist kein Zugriff von der WebApp auf den Server möglich! In der WebApp erscheint dann die Fehlermeldung „Fehler bei der Abfrage des Benno MailArchiv Servers“
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 /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“ hier erläutert).
Для перевода Benno MailArchiv в обычный режим работы требуется действующая лицензия. Файл лицензии содержит различную информацию, включая сам лицензионный ключ.
Дополнительная информация о лицензировании:
Действующий лицензионный файл можно получить в любое время через веб-форму (см. ниже). Для заказа лицензионного файла выполните следующие действия:
Для этого выполните следующую команду:
benno-client --instance-id
Эта команда выводит идентификатор экземпляра системы, который вы указываете при запросе лицензии.
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.
Если электронное письмо, содержащее файл лицензии, было заархивировано системой Benno MailArchiv, лицензия будет автоматически распознана при следующем перезапуске Benno REST Demon.
Alternativ kann die anhängende Lizenzdatei benno.lic auch auf dem Benno MailArchiv System gespeichert werden.
Скопируйте файл лицензии в /etc/benno/benno.lic и, при необходимости, убедитесь, что права доступа к файлу установлены следующим образом:
-rw-r--r-- 1 root root 145 Jun 27 2:24 pm /etc/benno/benno.lic
Von einem Windows-Rechner können Sie die Lizenz per putty installieren.
После настройки файла лицензии необходимо перезапустить демон Benno REST для активации лицензии: /etc/init.d/benno-rest restart. Проверьте файл /var/log/benno/rest.log, чтобы убедиться, что лицензия распознана правильно. В файле журнала должна содержаться следующая запись:
2012-03-21 13:44:25,183 INFO Лицензия в /etc/benno/benno.lic действительна
Если файл лицензии отсутствует или недоступен для чтения, в журнал будет записано следующее сообщение об ошибке:
2012-03-21 13:44:25,183 INFO Не удалось проверить файл лицензии: /etc/benno/benno.lic (Нет такого файла или каталога)
Если проверка лицензии не пройдёт по другим причинам, в журнал будет записано следующее сообщение об ошибке:
2012-03-21 13:44:25,183 ПРЕДУПРЕЖДЕНИЕ Ошибка лицензии ПРОВЕРКА ЛИЦЕНЗИИ НЕ ПРОЙДЕНА
Программа Benno MailArchiv установлена и готова к использованию.
Какие следующие шаги?
Лицензионный файл создается на основе идентификатора экземпляра. Вы можете просмотреть его в веб-интерфейсе как администратор на странице информации или в консоли с помощью команды
benno-client --instance-id
тратить.
Для запуска Benno MailArchiv после установки не требуется никаких изменений в настройках! Benno MailArchiv готов к использованию сразу после установки. Электронные письма для архивирования необходимо скопировать в каталог /srv/benno/inbox. Они должны быть доступны для чтения пользователю "benno". Для начала работы Benno MailArchiv требуется действительный файл лицензии и настройка общего секрета для обеспечения безопасной связи между ядром и REST-сервером (см. предыдущие разделы).
Beim Import sehr großer E-Mail-Mengen (bspw. ab ca. 20.000 E-Mails pro Tag und mehr) kann die Java-VM nach längerer Laufzeit nahezu 100% einer CPU belegen. Nach geraumer Zeit werden dann keine keine E-Mails mehr importiert. Im Logfile werden Meldungen in Zusammenhang mit „OutOfMemoryError“ ausgegeben, bspw.: „2012-07-19 08:58:34,419 ERROR de.lwsystems.mailarchive.mailservice.DirectoryWatchService: java.lang.OutOfMemoryError: Java heap space“ Sollte diese Situation auftreten, kann sie einfach durch Zuordnung von mehr Speicher an den benno-archive Dienst behoben werden. Die maximale Speichergröße, die die Java VM alloziert, wird mit der Option „-Xmx“ eingestellt. Mit dem Parameter „-Xmx2500m“ wird dieser Wert bspw. auf 2.500 MB gesetzt. Der Wert kann in der Datei „/etc/default/benno-archive“ in der Variable JAVA_OPTIONS eingestellt werden:
START_ARCHIVE=yes JAVA_OPTIONS=' -server -Xmx2500m ' DAEMON_ADDRESS='127.0.0.1' DAEMON_PORT='2555' DAEMON_ARGS='-c /etc/benno/benno.xml' USER=benno
Пробел после значения также необходимо указать.
Die Konfiguration weiterer 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.
В Benno MailArchiv 2.0 для управления пользователями в однопользовательских установках доступен инструмент командной строки benno-useradmin. Эта программа позволяет управлять пользователями в локальной базе данных пользователей. Для использования benno-useradmin требуются пакеты perl, libdbi-perl и libdbd-sqlite2-perl. Команда является частью пакета benno-web. При установке в Debian, Ubuntu или UCS указанные зависимые пакеты устанавливаются автоматически.
Statt der Benno MailArchiv internen Benutzerdatenbank kann die Benutzerverwaltung auch über ein bestehendes LDAP-Directory vorgenommen werden. Für die LDAP-Anbindung steht ein separates Software-Modul zur Verfügung, dass in Benno MailArchiv 2.0.1 zum Standardumfang gehören wird. Die entsprechende Installations- bzw. Konfigurationsanleitung finden Sie hier. Die Anbindung an ODBC-Datenbanken statt LDAP ist ebenfalls möglich. Bitte sprechen Sie uns diesbzgl. bedarfsweise an.
Инструмент командной строки benno-useradmin в настоящее время предназначен для однопользовательских установок Benno MailArchiv. Многопользовательские установки в основном связаны с использованием и функционированием Benno MailArchiv Hosting Edition. Опыт показывает, что в таких случаях часто требуется индивидуальное подключение к соответствующей среде предоставления услуг или управления хостинг-провайдера/интернет-провайдера, которое мы внедряем индивидуально и в рамках конкретного проекта.
Команду benno-useradmin можно вызвать со следующими параметрами:
benno-useradmin [-h] [-l] [-u <username>] [-d|-E] [-D] [-p <password>] [-n <name>] [-e <email1,email2, ...>] -C [<container>] -c <file> config file (default /etc/benno-web/benno.conf) -l list all users -u <username> username (shows user data if no other options given) Add or change user data -p <password> password of the user -n <name> display name of the user -e <email,email> comma separated list of email addresses ('' deletes all) -C <container> container name (default BennoContainer) -d disable user -E enable user -D delete user -h this help -v print version number
benno-useradmin -u k.klaasen -p совершенно секретно -n «Клаас Клаасен» -e «k.klaasen@firma.com, klaas.klaasen@firma.com»
benno-useradmin -u k.klaasen -p newpw
benno-useradmin -u k.klaasen -e 'k.klaasen@firma.com, k.klaasen@firma2.com
Внимание! Адреса электронной почты всегда будут полностью заменены.
benno-useradmin -u k.klaasen
benno-useradmin -u k.klaasen -D
Der Zugriff auf die WebApp erfolgt über folgenden URI:
http://benno-server/benno
По умолчанию используется пользователь "admin". Перед первым доступом к системе установите пароль для этого пользователя и создайте соответствующие учетные записи с необходимыми правами.
benno-useradmin -u admin -p ЗАЩИТНЫЙ ПАРОЛЬ -e "адрес электронной почты@company.de"
Стандартный путь доступа к данным и сервисам Benno MailArchiv.
Это так называемый «каталог очереди» Benno MailArchiv. В этот каталог необходимо помещать отдельные письма для архивирования (одно письмо на файл). Benno MailArchiv обрабатывает файлы по отдельности. После успешной обработки (архивирования и индексирования) файлы писем удаляются из каталога. Файлы писем для архивирования должны иметь расширение .eml. Здесь можно хранить письма от всех клиентов. Benno MailArchiv автоматически распределяет письма по архивам различных клиентов на основе настроек конфигурации в файле /etc/benno/benno.xml.
Это стандартный каталог для хранения различных архивов и соответствующих им поисковых индексов.
Это каталог установки веб-приложения Benno MailArchiv.
Это каталог установки компонентов программы Benno MailArchiv (за исключением веб-приложения Benno MailArchiv).
Настройки конфигурации для бэкэнда Benno MailArchiv находятся в каталоге /etc/benno. Список конфигурационных файлов приведен ниже.
Содержит параметры конфигурации для пакетов benno-archive и benno-rest. В частности, здесь управляются различные клиенты и их соответствующие настройки, такие как пути к файлам и т. д.
Содержит параметры конфигурации для ведения журналов и различных уровней детализации benno-archive. Здесь вы можете настроить уровень детализации, с которым регистрируются различные операции архивирования. Ведение журналов может быть настроено на следующих уровнях: TRACE, DEBUG, INFO, WARN, ERROR, FATAL
Содержит параметры конфигурации для логирования и различных уровней детализации benno-rest. Здесь можно настроить уровень детализации логирования различных операций запроса к архиву. Логирование может быть настроено на следующих уровнях: TRACE, DEBUG, INFO, WARN, ERROR, FATAL
Это лицензионный файл для установки Benno MailArchiv. Он содержит тип лицензионного ключа (Standard Edition, Hosting Edition, Evaluation и т. д.), полное доменное имя хоста (FQDN), IP-адрес сервера и дату окончания текущего периода технического обслуживания. И, наконец, сам лицензионный ключ прилагается.
Содержит параметры конфигурации для встроенного HTTP-сервера benno-rest. В этом файле не требуется вносить никаких изменений в конфигурацию.
Содержит информацию о конфигурации запуска benno-archive, например, следует ли запускать службу автоматически при запуске сервера.
Содержит информацию о конфигурации запуска benno-rest, например, следует ли запускать службу автоматически при запуске сервера.
Конфигурационные файлы для веб-приложения Benno MailArchiv находятся в каталоге /etc/benno-web/benno.conf. Описание конфигурационных файлов приведено ниже.
Включает PHP-файлы веб-приложения Bennno MailArchiv.
Включает шаблоны HTML-интерфейса веб-приложения Bennno MailArchiv.
Включает в себя конфигурационные файлы для веб-интерфейса (см. ниже).
Содержит настройки разрешений для компонентов веб-приложения Benno MailArchiv. Не вносите никаких изменений в этот файл!
Die Datei benno.conf enthält die Konfigurationseinstellungen der Benno MailArchiv WebApp sowie das Shared Secret zur abgesicherten Kommunikation mit dem Backend.
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:
По умолчанию: MAIL_FROM = benno@localhost
Адаптировано (например): MAIL_FROM = benno@musterfirma.de
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.