beginning of troubleshooting.md

1 files changed, 60 insertions, 0 deletions

diff --git a/docs/platform/troubleshooting.md b/docs/platform/troubleshooting.md
new file mode 100644
index 0000000..e9b31e9
--- /dev/null
+++ b/docs/platform/troubleshooting.md
@@ -0,0 +1,60 @@
+Webapp node
+===========
+
+Places to look for errors:
+
+* /var/log/apache2/error.log
+* /srv/leap/webapp/log/production.log
+* /var/log/syslog (watch out for stunnel issues)
+
+* is haproxy ok ? 
+
+
+    curl -X  GET "http://127.0.0.1:4096"
+
+* is couchdb access through stunnel ok ? 
+
+
+    curl -X  GET "http://127.0.0.1:4000"
+
+* check couchdb acl
+
+
+    mkdir /etc/couchdb
+    cat /srv/leap/webapp/config/couchdb.yml.admin  # see username and password
+    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"
+    
+
+Couchdb node
+============
+
+* Membership ok ?
+
+
+    curl --netrc-file /etc/couchdb/couchdb.netrc 'http://127.0.0.1:5984/_membership'
+
+
+* User `_design doc` available ?
+
+
+    curl --netrc-file /etc/couchdb/couchdb.netrc -X  GET "http://127.0.0.1:4096/users/_design/User"
+
+
+
+MX node
+=======
+
+* query leap-mx for useraccount 
+
+
+    postmap -v -q  "joe@dev.bitmask.net" tcp:localhost:2244
+
+
+* query leap-mx for mailalias
+
+
+    postmap -v -q  "joe@dev.bitmask.net" tcp:localhost:4242