User tools

Website tools


Univention: Upgrade to UCS43

This is an old version of the document!


Benno MailArchiv Upgrade to UCS Version 4.3

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.

Upgrade to UCS 4.3

  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. Reboot

Backup

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

Upgrade to the latest version

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.

Disable SMTP

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.

Uninstall the app

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.

Upgrade

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

Configure UCR

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

Re-installation

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

Adjust permissions

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.

chown -R benno:benno /etc/benno
chgrp www-data /etc/benno-web
chgrp www-data /etc/benno-web/benno.conf
chgrp www-data /etc/benno-web/rest.conf
chown -R benno:benno /srv/benno

Enable SMTP

Nach erfolgreichem Upgrade kann die SMTP-Verbindung wieder aktiviert werden.

univention/upgrade_auf_ucs43.1532593703.txt.gz · Zuletzt geändert: 2018/07/26 08:28 von lwsystems