diff options
author | Jan Lehnardt <jan@apache.org> | 2012-01-30 19:47:00 +0100 |
---|---|---|
committer | Jan Lehnardt <jan@apache.org> | 2012-02-06 19:47:54 +0100 |
commit | 9c966cb02d86b7b0430522f4807522fc2c77cd68 (patch) | |
tree | 0c746c4e96b03344e4fb284e835359a21cba83e1 | |
parent | 71a0f583b586914c2009cceafb0102aa6fb52fb0 (diff) | |
download | couchdb-9c966cb02d86b7b0430522f4807522fc2c77cd68.tar.gz |
Backport INSTALL.Unix updates from master.
-rw-r--r-- | INSTALL.Unix | 57 |
1 files changed, 44 insertions, 13 deletions
diff --git a/INSTALL.Unix b/INSTALL.Unix index becbf0611..baf9d060b 100644 --- a/INSTALL.Unix +++ b/INSTALL.Unix @@ -3,10 +3,27 @@ Apache CouchDB README.Unix A high-level guide to Unix-like systems, inc. Mac OS X and Ubuntu. +Troubleshooting +--------------- + +There is a troubleshooting guide: + + http://wiki.apache.org/couchdb/Troubleshooting + +There is a wiki for general documentation: + + http://wiki.apache.org/couchdb/ + +There are collection of friendly mailing lists: + + http://couchdb.apache.org/community/lists.html + +Please work through these in order if you experience any problems. + Dependencies ------------ -You will need the following installed: +You should have the following installed: * Erlang OTP (>=R12B5) (http://erlang.org/) * ICU (http://icu.sourceforge.net/) @@ -14,24 +31,21 @@ You will need the following installed: * Mozilla SpiderMonkey (1.7) (http://www.mozilla.org/js/spidermonkey/) * GNU Make (http://www.gnu.org/software/make/) * GNU Compiler Collection (http://gcc.gnu.org/) - -It is recommended that you install Erlang OTP R12B-5 or above where possible. - -Optional dependencies: - * libcurl (http://curl.haxx.se/libcurl/) + * help2man (http://www.gnu.org/s/help2man/) -This only affects the command line JavaScript test suite which -most users do not use. +It is recommended that you install Erlang OTP R12B-5 or above where possible. +You will only need libcurl if you plan to run the JavaScript test suite. And +help2man is only need if you plan on installing the CouchDB man pages. Ubuntu ~~~~~~ -See +For up to date instructions, please see: http://wiki.apache.org/couchdb/Installing_on_Ubuntu -for updated instructions on how to install on Ubuntu. +Unfortunately, it seems that installing dependancies on Ubuntu is troublesome. Debian-based Systems ~~~~~~~~~~~~~~~~~~~~ @@ -55,9 +69,26 @@ You can install the build tools by running: You can install the other dependencies by running: - sudo port install icu erlang spidermonkey curl + brew install erlang icu4c spidermonkey curl + +You may want to link ICU so that CouchDB can find the header files automatically: + + brew link icu4c + +The same is true for recent versions of Erlang: + + brew link erlang + +You will need Homebrew installed to use the `brew` command. + +Learn more about Homebrew at: + + http://mxcl.github.com/homebrew/ -You will need MacPorts installed to use the `port` command. +Some versions of Mac OS X ship a problematic OpenSSL library. If you're +experiencing troubles with CouchDB crashing intermittently with a segmentation +fault or a bus error, you will need to install your own version of OpenSSL. See +the troubleshooting guide, mentioned above, for more information. Installing ---------- @@ -109,7 +140,7 @@ To check that everything has worked, point your web browser to: http://127.0.0.1:5984/_utils/index.html -From here you should run the test suite. +From here you should run the test suite in Firefox. Security Considerations ----------------------- |