Page Comparison

This page provides the guidelines to install and run CouchDB server on your machine along with the Lucene search engine.

Erlang and other dependencies:

To configure and build Couchdb you would need Erlang V. 5.6 or higher. If you are using Ubuntu 8.10 and higher the package with the proper version is already included in synaptic so you can simple apt-get it (howto: is described below). This is the complete list of dependencies that you need to have for Erlang/Couchdb:

...

• Download and unpack the latest version of Erlang from their website (current latest version is R13B01):

  Code Block
  wget http://erlang.org/download/otp_src_R13B01.tar.gz tar -xzf otp_src_R13B01.tar.gz

• Next go into the unpacked directory, configure and build Erlang:

  Code Block
  cd otp_src_R13B01 ./configure make sudo make install

• The building step will take a while and once you are done you can check if Erlang is installed and you have a proper version (greater then or equal to 5.6):

  Code Block
  erl -V

  In case you get an error or wrong version (might happen if you still have other Erlang package installed) you might want to create a link to the new built:

  Code Block
  sudo ln -s /path/to/new-built-erlang/bin/erl /usr/bin/erl

  Check again and make sure that the version is updated.

Couchdb:

Great! By now you should have all necessary packages and dependencies installed and you are ready to go on with installing Couchdb.
There are 2 options to reach the step when you are ready to configure and build Couchdb:

...

Great, so Couchdb is installed next step is to do the same if couchdb-lucene.

Couchdb-Lucene

To install couchdb-lucene make sure you have git as well as maven2 installed on your maching first. If not install it by typing:

...

After finishing building you should have an assembled jar file in the target sub-directory called couchdb-lucene-*-jar-with-dependencies.jar.

Setting up Couchdb-Lucene

Great we are getting closer and next steps will let us set up lucene search engine with our Couch database.
The file we are going to modify contains various configuration options of the database and it is located in /usr/local/etc/couchdb/local.ini (the same file where we changed the ip address before). These are the options that need to be added or modified:

...

curl http://"your_database_ip":5984/database_name/_fti/design_doc/view_name?q=Query

couchdb-python

Download all dependencies:

sudo aptitude install python-simplejson
sudo aptitude install python-httplib2

...

wget http://peak.telecommunity.com/dist/ez_setup.py
sudo python ez_setup.py
wget "path to downloaded .egg file"
sudo easy_install "path to downloaded .egg file"

pouch

couchdbkit

Installing and running CouchDB on Windows

 CouchDB Wiki

Installing and running CouchDB on Mac OS X

 Setting up CouchDB on Mac OS X