Added troubleshooting section.

1 files changed, 13 insertions, 5 deletions

diff --git a/README.md b/README.md
index 302bed89..73eea6c5 100644
--- a/README.md
+++ b/README.md
@@ -15,7 +15,7 @@ Clusters behave according to concepts outlined in [Amazon's Dynamo paper][4], na
 
 #### Prerequisites
 
-Cloudant Core has the same dependencies as CouchDB:
+Cloudant-dbcore has the same dependencies as CouchDB:
 
  * Erlang (R13B03 or higher)
  * ICU (4.2 is preferable)
@@ -37,10 +37,6 @@ To install Spidermonkey 1.9.2 from PPA:
     sudo apt-get install libmozjs-1.9.2
     sudo ln -s /usr/lib/libmozjs-1.9.2.so /usr/lib/libmozjs.so
 
-Odd cleanup tasks:
-
-    sudo rm /usr/lib/erlang/man/man5/modprobe.d.5
-
 #### Installing prerequisites on Mac OS X with [Homebrew][7]
 
     brew install erlang icu4c spidermonkey
@@ -112,6 +108,18 @@ _R_ - read quorum constant.  N writes have occurred for each document, as noted
 
 _W_ - write quorum constant.  When writing the N copies, the data store will respond to the write client after W successful writes have completed.  The remaining N-W writes are still being attempted in the background, but the client receives a 201 Created status and can resume execution.  W defaults to 2.  Lower W values mean more write throughput, and higher W values mean more data durability.
 
+### Troubleshooting
+
+#### `make install` fails with "read file info /usr/lib/erlang/man/man5/modprobe.d.5 failed"
+
+You can fix this by removing that file:
+
+   `sudo rm /usr/lib/erlang/man/man5/modprobe.d.5`
+
+#### Dbcore fails on startup with a "Can't set long node name!" error
+
+Cloudant-dbcore requires that your system be set up with a fully qualified domain name. Make sure tha the command `hostname -f` outputs a full hostname. If not, add the full hostname of your server to the `/etc/hosts` file.
+
 ### Contact
 
 Cloudant folks are usually hanging out in IRC.  Freenode, channel #cloudant.  We may also be reached: