Etherpad-lite App Migration

From Univention Wiki

Revision as of 14:36, 2 August 2017 by Botner (talk | contribs)
Jump to: navigation, search

Work in Progess

Starting with version 1.6.0 the Etherpad-lite App for UCS is available as Docker App. New installations automatically using this Docker App.

To update an existing non-Docker Etherpad-lite App to the new Docker Etherpad-lite App a manual migration has to be done.

The following steps are necessary to migrate the non-Docker Etherpad-lite 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.

Prepare native Etherpad-lite App

# backup etherpad-lite directory and database
cp -rf /opt/etherpad-lite /opt/etherpad-lite.backup
su postgres -c "pg_dump etherpad-lite" > /opt/etherpad-lite.database.backup

Remove native Etherpad-lite App

Upgrade Dudle App

univention-app update
univention-app upgrade dudle

During the upgrade all the App's data files and the config file config.rb are copied to the directory /var/lib/univention-appcenter/apps/dudle/data. This directory is mapped into the new Dudle container to provide the data and config to the new Docker Dudle App.

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 Dudle App container:

univention-app shell dudle
Personal tools