summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorStefano J. Attardi <stefano@attardi.org>2010-08-23 16:59:37 -0400
committerStefano J. Attardi <stefano@attardi.org>2010-08-23 16:59:37 -0400
commit66480aac94e60131c1b6f16fdc5dde04dc6f2bc4 (patch)
tree4fe1b3b7926adb624a032433a2aebb12e219a69a
parentd73aa005c545187fe5eb2f2bb5a14639f9238a84 (diff)
Added troubleshooting section.
-rw-r--r--README.md18
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: