From 66480aac94e60131c1b6f16fdc5dde04dc6f2bc4 Mon Sep 17 00:00:00 2001 From: "Stefano J. Attardi" Date: Mon, 23 Aug 2010 16:59:37 -0400 Subject: Added troubleshooting section. --- README.md | 18 +++++++++++++----- 1 file changed, 13 insertions(+), 5 deletions(-) (limited to 'README.md') 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: -- cgit v1.2.3