This page provides the guidelines to install and run CouchDB server on your machine along with the Lucene search engine.
Environment: | Debian |
Environment: |
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):
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 erl -V
Check again and make sure that the version is updated.Code Block sudo ln -s /path/to/new-built-erlang/bin/erl /usr/bin/erl
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:
...
Code Block |
---|
curl http://"your_database_ip":5984/database_name/_fti/design_doc/view_name?q=Query |
couchdb-python
Download all dependencies:
Code Block |
---|
sudo aptitude install python-simplejson sudo aptitude install python-httplib2 |
...
Code Block |
---|
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" |