Tine20 App Migration

From Univention Wiki

Revision as of 08:59, 19 January 2017 by Botner (talk | contribs)
Jump to: navigation, search

Starting with version 2015.11.15 the Tine20 App for UCS is available as Docker App. New installations automatically using this Docker App.

To update an existing non-Docker Tine20 App to the new Docker Tine20 App a manual migration has to be done. Basically, Tine20 on the server (Docker host) is removed and installed in a new Docker container. Directories with Tine20 data are mapped into the container and the container continues to use the database on the Docker host.

The following steps are necessary to migrate the non-Docker Tine20 App to Docker:

Check if docker works on the host

Run the following command to verify docker works, before starting the migration:

docker run hello-world

If this test fails, please contact the Univention Support or check the Univention Forum [1] for more information.

Save settings and prepare Tine20 App removal

touch /etc/postgres-tine20.secret
chmod 600 /etc/postgres-tine20.secret
php -r '$config = require "/etc/tine20/config.inc.php";
        echo $config["database"]["password"];' > /etc/postgres-tine20.secret
cp /etc/tine20/config.inc.php /etc/tine20/config.inc.php.bak
apt-mark manual univention-postgresql

Remove Tine20 App

univention-app remove tine20
ucr unset appcenter/prudence/docker/tine20

Install Tine20 Docker App

univention-app update
univention-app register
univention-app install tine20

Verify mail settings in Tine20 setup

Open the /tine20/setup.php URL on the Docker host (username: tine20setup, password: see file /etc/tine20setup.secret on Docker host) and verify the mail settings (IMAP, SMTP, Sieve).

Also check the new /etc/tine20/config.inc.php in the Docker container (the original config can be found in /etc/tine20/config.inc.php.bak on the Docker Host).

Set Mail Home Server on UCS accounts

If the UCS mailstack is used for email, verify that the attribute Mail Home Server is set on all UCS accounts, which are supposed to use the UCS mail server in Tine20.

Further configurations or modifications of UCR settings have to be done in the container from now on. Use the following command to change into the new Tine20 App container:

univention-app shell tine20
Personal tools