Starting with UCS version 4.3, all apps from the Univention Appcenter are installed in Docker containers. The Benno MailArchiv app itself runs in a Docker container, while the transaction and configuration data continue to be stored directly on the host system.

Unfortunately, Univention does not currently offer an automatic migration path to update an existing app (< version 4.3) to a container app (>= UCS 4.3).

To upgrade Benno MailArchiv to UCS 4.3, please proceed as follows.

1. Backup
2. Upgrade to the latest version
3. Disable SMTP
4. Uninstall the app
5. Upgrade to UCS 4.3
6. UCR configuration
7. Re-installation
8. Adjust permissions
9. Enable SMTP
10. Update and install the license file
11. Reboot

Before updating, a backup of the entire system (including movement data) should be created!

The UCS system can only be updated up to UCS 4.2 with the Benno MailArchiv app installed. A direct upgrade to UCS 4.3 is not possible.

During the upgrade, the system is in a state where emails submitted via SMTP are not cached for archiving. Therefore, the SMTP connection to the host should be disabled.

Per Appcenter wird die Benno MailArchiv App deinstalliert. Die archivierten E-Mails werden dabei NICHT gelöscht. Der Pfad mit dem Repository und Index (/srv/benno/archive) bleibt erhalten.

However, the MILTER Daemon is removed from the Postfix configuration, so that incoming or outgoing emails are no longer passed to Benno MailArchiv.

The system can now be updated to the latest Univention version.

The Benno MailArchiv app is still blocked in the App Center to prevent accidental upgrades.

The following command will remove this lock.

ucr unset appcenter/prudence/docker/benno-mailarchiv

The Benno MailArchiv app can now be installed again as a Docker app in the Appcenter.

univention-app shell benno-mailarchiv chown -R benno:benno /srv/benno/{archive,inbox,system} univention-app shell benno-mailarchiv chgrp www-data /etc/benno-web univention-app shell benno-mailarchiv chgrp www-data /etc/benno-web/benno.conf univention-app shell benno-mailarchiv chgrp www-data/etc/benno-web/rest.conf

During the installation of Benno MailArchiv, the connection to Postfix is ​​automatically set up via MILTER Daemon.

Nach erfolgreichem Upgrade kann die SMTP-Verbindung wieder aktiviert werden. Hier ist darauf zu achten, daß die Anbindung in der master.cf vom Postfix per TCP-Socket erfolgte.

The environment (and therefore also the network environment) of the Docker container in which the Benno services run from UCS 4.3 onwards is different from that of the UCS system itself. After the migration from UCS 4.2 to UCS 4.3 described here, the license file for Benno MailArchiv must be recreated and configured on the host.

ACHTUNG Bei weiteren Updates des UCS-Systems können sich diese Daten ändern. Derzeit sollten die Lizenz-Informationen nach einem Update vom UCS geprüft und ggfs. eine neue Lizenz mit den geänderten Daten angefordert werden. Wir arbeiten daran, dieses Verfahren zukünftig zu automatisieren.

Determine the data required for licensing (host info). Open a Docker shell on the UCS system using the two commands below and determine the host info:

univention app shell benno mail archive service benno rest info

You will receive a multi-line screen output showing your IP address and the FQDN (Fully Qualified Domain Name) of your Benno MailArchiv host, e.g.:

Host Info: Host Info: 172.17.0.1/benno-15552681.kunde.de bennorest: 2.4.5 (180312131432) bennocore: 2.4.4 (180309175446)

HINWEIS: Erscheint hier statt IP-Adresse und FQDN etwas anderes (Fehlermeldung), müssen Sie die Namensauflösung prüfen.

The further procedure (requesting and installing the license file) is described here

The license file can be copied directly to /etc/benno/benno.lic .

Finally, the system should be restarted.