improved troubleshooting.md

1 files changed, 49 insertions, 8 deletions

diff --git a/docs/platform/troubleshooting.md b/docs/platform/troubleshooting.md
index 3fb2ada..a3473a8 100644
--- a/docs/platform/troubleshooting.md
+++ b/docs/platform/troubleshooting.md
@@ -12,13 +12,13 @@ Is haproxy ok ?
 ---------------
 
 
-    curl -X  GET "http://127.0.0.1:4096"
+    curl -s -X  GET "http://127.0.0.1:4096"
 
 Is couchdb accessible through stunnel ?
 ---------------------------------------
 
 
-    curl -X  GET "http://127.0.0.1:4000"
+    curl -s -X  GET "http://127.0.0.1:4000"
 
 
 Check couchdb acl
@@ -30,8 +30,8 @@ Check couchdb acl
     echo "machine 127.0.0.1 login admin password <PASSWORD>" > /etc/couchdb/couchdb-admin.netrc
     chmod 600 /etc/couchdb/couchdb-admin.netrc
 
-    curl --netrc-file /etc/couchdb/couchdb-admin.netrc -X GET "http://127.0.0.1:4096"
-    curl --netrc-file /etc/couchdb/couchdb-admin.netrc -X GET "http://127.0.0.1:4096/_all_dbs"
+    curl -s --netrc-file /etc/couchdb/couchdb-admin.netrc -X GET "http://127.0.0.1:4096"
+    curl -s --netrc-file /etc/couchdb/couchdb-admin.netrc -X GET "http://127.0.0.1:4096/_all_dbs"
     
 
 Couchdb node
@@ -47,29 +47,51 @@ Places to look for errors
 Bigcouch membership
 -------------------
 
-* Do all nodes show up both in and ?
+* All nodes configured for the provider should appear here:
 
 
-    curl --netrc-file /etc/couchdb/couchdb.netrc 'http://127.0.0.1:5984/_membership'
+    curl -s --netrc-file /etc/couchdb/couchdb.netrc -X GET 'http://127.0.0.1:5986/nodes/_all_docs'
+
+* All configured nodes should show up under "cluster_nodes", and the ones online and communicating with each other should appear under "all_nodes". This example output shows the configured cluster nodes `couch1.bitmask.net` and `couch2.bitmask.net`, but `couch2.bitmask.net` is currently not accessible from `couch1.bitmask.net`
+
+
+    curl -s --netrc-file /etc/couchdb/couchdb.netrc 'http://127.0.0.1:5984/_membership'
+    {"all_nodes":["bigcouch@couch1.bitmask.net"],"cluster_nodes":["bigcouch@couch1.bitmask.net","bigcouch@couch2.bitmask.net"]}
 
 
 
 Databases
 ---------
 
+* Following output shows all neccessary DBs that should be present. Note that the `user-0123456....` DBs are the data stores for a particular user. 
+
+
+    curl -s --netrc-file /etc/couchdb/couchdb.netrc -X GET 'http://127.0.0.1:5984/_all_dbs' 
+    ["customers","identities","sessions","shared","tickets","tokens","user-0","user-9d34680b01074c75c2ec58c7321f540c","user-9d34680b01074c75c2ec58c7325fb7ff","users"]
+
+
+
 Design Documents
 ----------------
 
 * Is User `_design doc` available ?
 
 
-    curl --netrc-file /etc/couchdb/couchdb.netrc -X  GET "http://127.0.0.1:5984/users/_design/User"
+    curl -s --netrc-file /etc/couchdb/couchdb.netrc -X  GET "http://127.0.0.1:5984/users/_design/User"
 
 
 
 MX node
 =======
 
+Places to look for errors
+-------------------------
+
+* `/var/log/mail.log`
+* `/var/log/leap_mx.log`
+* `/var/log/syslog` (watch out for stunnel issues)
+
+
 Query leap-mx
 -------------
 
@@ -77,11 +99,30 @@ Query leap-mx
 
 
     postmap -v -q  "joe@dev.bitmask.net" tcp:localhost:2244
-
+    ...
+    postmap: dict_tcp_lookup: send: get jow@dev.bitmask.net
+    postmap: dict_tcp_lookup: recv: 200 
+    ...
 
 * for mailalias
 
 
     postmap -v -q  "joe@dev.bitmask.net" tcp:localhost:4242
+    ...
+    postmap: dict_tcp_lookup: send: get joe@dev.bitmask.net
+    postmap: dict_tcp_lookup: recv: 200 f01bc1c70de7d7d80bc1ad77d987e73a
+    postmap: dict_tcp_lookup: found: f01bc1c70de7d7d80bc1ad77d987e73a
+    f01bc1c70de7d7d80bc1ad77d987e73a
+    ...
+
+
+
+Mailspool
+---------
+
+* Any file in the mailspool longer for a few seconds ?
+
 
+    ls -la /var/mail/vmail/Maildir/cur/
 
+