From 47c37ee1d4cb6a59e6a8e0bce114e6defdfa6fc7 Mon Sep 17 00:00:00 2001
From: varac <varacanero@zeromail.org>
Date: Mon, 9 Nov 2015 14:40:30 +0100
Subject: added bigcouch to couchdb migration doc

---
 pages/docs/platform/services/couchdb.md | 68 ++++++++++++++++++++++++++++++++-
 1 file changed, 66 insertions(+), 2 deletions(-)

(limited to 'pages/docs/platform/services')

diff --git a/pages/docs/platform/services/couchdb.md b/pages/docs/platform/services/couchdb.md
index 7bf4e7c..842a822 100644
--- a/pages/docs/platform/services/couchdb.md
+++ b/pages/docs/platform/services/couchdb.md
@@ -26,8 +26,18 @@ If you add a node, or remove one node from the cluster,
 
 . make sure you have a backup of all DBs !
 
-    /srv/leap/couchdb/scripts/couchdb_dumpall.sh
+. put the webapp into [maintenance mode](https://leap.se/en/docs/platform/services/webapp#maintenance-mode)
+. Stop all services that access the database:
 
+  * leap-mx
+  * postfix
+  * soledad-server
+  * nickserver
+
+. dump the dbs:
+
+    cd /srv/leap/couchdb/scripts
+    time ./couchdb_dumpall.sh
 
 . delete all dbs
 . shut down old node
@@ -53,7 +63,52 @@ If you add a node, or remove one node from the cluster,
 
 . restore the backup
 
-     /srv/leap/couchdb/scripts/couchdb_restoreall.sh
+    cd /srv/leap/couchdb/scripts
+    time ./couchdb_restoreall.sh
+
+
+### Migrating from bigcouch to plain couchdb
+
+. make sure you have a backup of all DBs !
+
+. put the webapp into [maintenance mode](https://leap.se/en/docs/platform/services/webapp#maintenance-mode)
+. Stop all services that access the database:
+
+  * leap-mx
+  * postfix
+  * soledad-server
+  * nickserver
+
+. dump the dbs:
+
+    cd /srv/leap/couchdb/scripts
+    time ./couchdb_dumpall.sh
+
+. stop bigcouch
+
+    /etc/init.d/bigcouch stop
+
+. remove bigcouch
+
+    apt-get remove bigcouch
+
+. configure couch node to use plain couchdb instead of bigcouch. See section "Use plain couchdb instead of bigcouch" below for details.
+. deploy to all couch nodes
+
+    leap deploy development +couchdb
+
+. restore the backup
+
+    cd /srv/leap/couchdb/scripts
+    time ./couchdb_restoreall.sh
+
+. start services again that were stopped in the beginning
+
+. check if everything is working, including running the test on your deployment machine:
+
+    leap test
+
+. Remove old bigcouch data dir `/opt` after you double checked everything is in place
 
 
 ### Re-enabling blocked account
@@ -86,3 +141,12 @@ Beware that this returns the uncompacted disk size (see http://wiki.apache.org/c
 
     echo "`curl --netrc -s -X GET 'http://127.0.0.1:5984/user-dcd6492d74b90967b6b874100b7dbfcf'|json_pp|grep disk_size|cut -d: -f 2`/1024"|bc
 
+## Use plain couchdb instead of bigcouch
+
+Use this in your couchdb node config:
+
+    "couch": {
+      "master": true,
+      "pwhash_alg": "pbkdf2"
+    }
+
-- 
cgit v1.2.3