Tine20 App Migration

From Univention Wiki

(Redirected from Tine App Migration)
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

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 [2] 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
Personal tools