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.

Nach dem Upgrade müssen die Benutzer-Ids im Container angepasst werden. Mit dem Kommando

univention-app shell benno-mailarchiv

wird eine Shell im Docker-Container von Benno MailArchiv zur Verfügung gestellt. In dieser Shell können jetzt die Benutzer-Ids angepasst werden.

univention-app shell benno-mailarchiv chown -R benno:benno /srv/benno/{archive,inbox,system}
univention-app shell chgrp www-data /etc/benno-web univention-app shell chgrp www-data /etc/benno-web/benno.conf univention-app shell 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.

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.

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-mailarchiv /etc/init.d/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: 192.168.1.117/benno.kunde.de Build-Info: 2012-05-24 16:21:08

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

Finally, the system should be restarted.