Difference between revisions of "Etherpad-lite App Migration"

From Univention Wiki

Jump to: navigation, search
m
 
Line 26: Line 26:
  
 
== Remove native Etherpad-lite App ==
 
== Remove native Etherpad-lite App ==
 +
<pre>
 +
univention-app remove etherpad-lite
 +
univention-install univention-postgresql-9.1
 +
ucr unset appcenter/prudence/docker/etherpad-lite
 +
</pre>
  
 
+
== Install Docker Etherpad-lite App ==
== Upgrade Dudle App ==
 
 
<pre>
 
<pre>
 
univention-app update
 
univention-app update
univention-app upgrade dudle
+
univention-app install etherpad-lite
 
</pre>
 
</pre>
  
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.
+
Both, the native and the Docker App are using a PostgreSQL database on the Docker host. With this default configuration no data migration steps are necessary, the docker App continues to use the hosts etherpad-lite database.
  
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:
+
The Docker App start with a new settings.json, APIKEY.txt and SESSIONKEY.txt. Further configurations have to be done in the container from now on.  
 +
Use the following command to change into the new Etherpad-lite App container:
 
<pre>
 
<pre>
univention-app shell dudle
+
univention-app shell etherpad-lite
 
</pre>
 
</pre>

Latest revision as of 14:47, 2 August 2017


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

univention-app remove etherpad-lite
univention-install univention-postgresql-9.1
ucr unset appcenter/prudence/docker/etherpad-lite

Install Docker Etherpad-lite App

univention-app update
univention-app install etherpad-lite

Both, the native and the Docker App are using a PostgreSQL database on the Docker host. With this default configuration no data migration steps are necessary, the docker App continues to use the hosts etherpad-lite database.

The Docker App start with a new settings.json, APIKEY.txt and SESSIONKEY.txt. Further configurations have to be done in the container from now on. Use the following command to change into the new Etherpad-lite App container:

univention-app shell etherpad-lite
Personal tools