Tine20 App Migration
From Univention Wiki
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  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
Check Tine20 database type
Tine20 supports both, mysql and postgresql, as database backends. The Docker version of the Tine20 App only supports postgresql. If the Tine20 App installation uses mysql, please contact the Univention Forum  or the Univention Support.
To check if Tine20 uses mysql, use the following command:
mysql -u root --password=$(< /etc/mysql.secret) tine20
Remove Tine20 App
univention-app remove tine20 univention-run-join-scripts ucr unset appcenter/prudence/docker/tine20
Install Tine20 Docker App
univention-app update univention-app register univention-app install tine20 univention-run-join-scripts
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