From 1b994c717e2e970ad665c49642459c1e34459b28 Mon Sep 17 00:00:00 2001 From: drebs Date: Thu, 7 Sep 2017 18:07:45 -0300 Subject: [doc] add documentation about migration --- docs/index.rst | 1 + docs/migrations.rst | 22 ++++++++++++++++++++++ 2 files changed, 23 insertions(+) create mode 100644 docs/migrations.rst diff --git a/docs/index.rst b/docs/index.rst index 722aeeda..c90a0bdb 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -18,6 +18,7 @@ all user's devices that access a LEAP provider. auth reference development + migrations Indices and tables ================== diff --git a/docs/migrations.rst b/docs/migrations.rst new file mode 100644 index 00000000..abbb39ad --- /dev/null +++ b/docs/migrations.rst @@ -0,0 +1,22 @@ +Migrations +========== + +Some updates of Soledad need manual intervention for database migration because +of changes to the storage backend. In all such cases, we will document the +steps needed for migration in this page. + +Soledad Server 0.8 to 0.9 - Couch Database schema migration needed +------------------------------------------------------------------ + +Starting with Soledad Server 0.9.0, the CouchDB database schema was changed to +improve speed of the server side storage backend. Because of that, this script +has to be run for all Leap providers that used to provide email using Soledad +Server < 0.9.0. + +The migration script can be found: + +* In `the Soledad repository `_. +* In ``/usr/share/soledad-server/migration/0.8-to-0.9/`` when the ``soledad-server`` debian package is installed. + +Instructions for migration can be found in the ``README.md`` file. Make sure to read it carefully and backup your data before starting the migration process. + -- cgit v1.2.3