summaryrefslogtreecommitdiff
path: root/README
diff options
context:
space:
mode:
authorNoah Slater <nslater@apache.org>2008-08-18 11:00:42 +0000
committerNoah Slater <nslater@apache.org>2008-08-18 11:00:42 +0000
commit3b0e591718716db7c7c5f894d655269223b33933 (patch)
treee54e843e31b77898e2e295cf8574a2b074c38a12 /README
parent76c62834d36aa0ad2da97aaa582198bfb4b6c547 (diff)
aesthetic reformatting
git-svn-id: https://svn.apache.org/repos/asf/incubator/couchdb/trunk@686725 13f79535-47bb-0310-9956-ffa450edef68
Diffstat (limited to 'README')
-rw-r--r--README94
1 files changed, 49 insertions, 45 deletions
diff --git a/README b/README
index 4cb64b5b..a59f295b 100644
--- a/README
+++ b/README
@@ -18,14 +18,15 @@ Building From Subversion
You can skip this section if you are installing from a release tarball.
-### Dependencies ###
+Dependencies
+~~~~~~~~~~~~
To build Apache CouchDB from checkout you need some of the following installed:
- * [GNU Automake][01] (>=1.6.3) (required)
- * [GNU Autoconf][02] (>=2.59) (required)
- * [GNU Libtool][03] (required)
- * [help2man][04] (optional)
+ * GNU Automake (>=1.6.3) (required) (http://www.gnu.org/software/automake/)
+ * GNU Autoconf (>=2.59) (required) (http://www.gnu.org/software/autoconf/)
+ * GNU Libtool (required) (http://www.gnu.org/software/libtool/)
+ * help2man (optional) (http://www.gnu.org/software/help2man/)
If you are running a Debian GNU/Linux system (or a derivative such as Ubuntu
GNU/Linux) you can install these dependencies using the `apt-get` command:
@@ -33,16 +34,17 @@ GNU/Linux) you can install these dependencies using the `apt-get` command:
apt-get install automake autoconf libtool help2man
The OS X version of these dependencies may be out of date so it is recommended
-that you use [MacPorts][05] to install newer versions using the `port` command:
+that you use MacPorts (http://www.macports.org/) to install newer versions using
+the `port` command:
port install automake autoconf libtool help2man
-### Bootstrapping ###
+Bootstrapping
+~~~~~~~~~~~~~
Note: You must repeat this step every time you update your Subversion checkout.
-Follow the [check out instructions][06] and bootstrap the pristine source by
-running the following command:
+Bootstrap the pristine source by running the following command:
./bootstrap
@@ -51,18 +53,21 @@ Installation And First Run
You will need the following installed:
- * [Erlang OTP][07] (>=R11B) (required)
- * [ICU][08] (required)
- * [OpenSSL][09] (required)
- * [Mozilla SpiderMonkey][10] (required)
- * [GNU Make][11] (required)
- * [GNU Compiler Collection][12] (required)
+ * Erlang OTP (>=R11B) (required) (http://erlang.org/)
+ * ICU (required) (http://icu.sourceforge.net/)
+ * OpenSSL (required) (http://www.openssl.org/)
+ * Mozilla SpiderMonkey (required) (http://www.mozilla.org/js/spidermonkey/)
+ * GNU Make (required) (http://www.gnu.org/software/make/)
+ * GNU Compiler Collection (required) (http://gcc.gnu.org/)
-### UNIX-like Operating Systems (inc. OS X) ###
+UNIX-like Operating Systems (inc. OS X)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-#### Dependencies ####
+Dependencies
+^^^^^^^^^^^^
-##### Debian-based (inc. Ubuntu) Systems #####
+Debian-based (inc. Ubuntu) Systems
+++++++++++++++++++++++++++++++++++
If you are running a Debian GNU/Linux system (or a derivative such as Ubuntu
GNU/Linux) you can install the dependencies using the `apt-get` command:
@@ -73,7 +78,8 @@ If you get an error regarding the `libicu38` or `libicu-dev` be sure to check
the version used by your distribution (using `apt-cache search libicu`) and
install those packages instead.
-##### OS X #####
+OS X
+++++
To install GNU Make and the GNU Compiler Collection on OS X you should install
the Xcode Tools metapackage by running the following command:
@@ -93,7 +99,8 @@ To update your `locate` database you may want to run the following command:
sudo /usr/libexec/locate.updatedb
-#### Installing ####
+Installing
+^^^^^^^^^^
Once you have satisfied dependencies you should run the following command:
@@ -129,7 +136,8 @@ it is available on your system.
More options can be found by reading the `INSTALL` file.
-#### Security Considerations ####
+Security Considerations
+^^^^^^^^^^^^^^^^^^^^^^^
It is not advisable to run Apache CouchDB as the superuser. We strongly
recommend that you create a specific user to run Apache CouchDB and own the
@@ -144,7 +152,9 @@ On many UNIX-like systems you can run the following command:
OS X provides the standard Accounts option from the System Preferences
application or you can optionally use the Workgroup Manager application which
-can be downloaded as part of the [Server Admin Tools][13].
+can be downloaded as part of the Server Admin Tools:
+
+ http://www.apple.com/support/downloads/serveradmintools1047.html
You should make sure that the `couchdb` user has a working POSIX shell and set
the home directory to `/usr/local/var/lib/couchdb` which is the Apache CouchDB
@@ -156,7 +166,8 @@ running the following commands:
chown -R couchdb /usr/local/var/lib/couchdb
chown -R couchdb /usr/local/var/log/couchdb
-#### Running Manually ####
+Running Manually
+^^^^^^^^^^^^^^^^
To start the Apache CouchDB server you should run the following command:
@@ -170,10 +181,14 @@ When Apache CouchDB starts it should eventually display the following message:
Relax.
-To check that everything has worked point your web browser to
-[http://localhost:5984/_utils/index.html][14] and run the test suite.
+To check that everything has worked, point your web browser to:
+
+ http://localhost:5984/_utils/index.html
-##### OS X #####
+From here you should run the test suite.
+
+OS X
+++++
If you get error when running Apache CouchDB that look like the following:
@@ -185,7 +200,8 @@ You should make sure that your `~/.profile` file contains the following line:
This should have been added for you by MacPorts but may be missing.
-#### Running as a Daemon ####
+Running as a Daemon
+^^^^^^^^^^^^^^^^^^^
Note: These instructions assume you have created the `couchdb` user. See the
specific system information included below to learn how to reconfigure this.
@@ -196,7 +212,8 @@ command manually to see the error messages it is displaying.
The `/usr/local/etc/logrotate.d/couchdb` file is provided as a logrotate
configuration that you can use to rotate Apache CouchDB's logs.
-##### SysV/BSD-style Systems #####
+SysV/BSD-style Systems
+++++++++++++++++++++++
Depending on your system the `couchdb` init script will be installed into a
direcory called `init.d` (for SysV-style systems) or `rc.d` (for BSD-style
@@ -221,7 +238,8 @@ GNU/Linux) you can configure your system using the following command:
sudo update-rc.d couchdb defaults
-##### OS X #####
+OS X
+++++
You can use the `launchctl` command to control the Apache CouchDB daemon.
@@ -242,21 +260,7 @@ If you wish the Apache CouchDB daemon to run as a system service you need to
copy the `/usr/local/Library/LaunchDaemons/org.apache.couchdb.plist` file into
your system wide `/Library/LaunchDaemons` directory.
-### Windows ###
+Windows
+~~~~~~~
Windows documentation is incomplete. Please submit suggestions.
-
-[01]: http://www.gnu.org/software/automake/
-[02]: http://www.gnu.org/software/autoconf/
-[03]: http://www.gnu.org/software/libtool/
-[04]: http://www.gnu.org/software/help2man/
-[05]: http://www.macports.org/
-[06]: http://incubator.apache.org/couchdb/community/code.html
-[07]: http://erlang.org/
-[08]: http://icu.sourceforge.net/
-[09]: http://www.openssl.org/
-[10]: http://www.mozilla.org/js/spidermonkey/
-[11]: http://www.gnu.org/software/make/
-[12]: http://gcc.gnu.org/
-[13]: http://www.apple.com/support/downloads/serveradmintools1047.html
-[14]: http://localhost:5984/_utils/index.html