From 51079e57cd8735a9ccdc3a74a2090444ef80c865 Mon Sep 17 00:00:00 2001
From: Andrew Gaul <andrew@gaul.org>
Date: Thu, 6 Oct 2016 21:25:26 -0700
Subject: [PATCH] Created Tips (markdown)

---
 Tips.md | 30 ++++++++++++++++++++++++++++++
 1 file changed, 30 insertions(+)
 create mode 100644 Tips.md

diff --git a/Tips.md b/Tips.md
new file mode 100644
index 0000000..3644df8
--- /dev/null
+++ b/Tips.md
@@ -0,0 +1,30 @@
+# Authentication
+
+Authentication misconfiguration can cause spurious client failures.  Ensure that you have NTP enabled on all machines.  If all else fails you can disable s3proxy authentication via:
+
+```
+s3proxy.authorization=none
+```
+
+# curl debugging
+
+You can use `curl` to debug s3proxy when authentication is disabled (see above):
+
+* list containers in a storage account: `curl http://<proxy>/`
+* list blobs in a container: `curl http://<proxy>/<containername>`
+* add a new container: `curl -X PUT http://<proxy>/<newcontainername>`
+* add a new blob to a container: `curl -X PUT -T <filename> http://<proxy>/<containername>/<newblobname>`
+
+# Logging
+
+Debug logging reveals more information about requests:
+
+```
+java -DLOG_LEVEL=debug -jar s3proxy.jar
+```
+
+Trace logging shows the client requests and server responses:
+
+```
+java -DLOG_LEVEL=trace -jar s3proxy.jar
+```
\ No newline at end of file