Installing Apache CouchDB Databse with Ubuntu 15.04

By
Rajneesh Upadhyay

cc7a4487b4a69a8169ed62da74a6180b

 

 

Introduction:

Apache CouchDB is a database developed for the web, it uses JASON Documents to store the data, access your data with HTTP. You can index, combine and transfer your data with Java Script.  Very suitable for all modern web and mobile applications.

Features:
  • It is distributed, fault tolerant, and schema free document-oriented database.
  • Provides bi-directional conflict detection and resolution.
  • Comes with easy to manage web based administration console.
  • It is highly available and partition tolerant.
  • It comes with fault-tolerant engine that make sure safety of the user data.
Installation:

We will use Ubuntu 15.04 for instillation of Apache Couch DB, ErLang is a necessity  for  installation for Apache Couch DB, make sure http is install and actively running on the server.

Update the system:

apt-get update

Install tools required to compile Couch DB.

sudo apt-get install --yes build-essential curl git

unixmen@unixmen: ~_002

Install Erlang.

sudo apt-get install -y erlang-dev erlang-manpages erlang-base-hipe erlang-eunit erlang-nox erlang-xmerl erlang-inets

cdb2

Install other require libraries.

apt-get install -y libmozjs185-dev libicu-dev libcurl4-gnutls-dev libtool

cdb3

Install python.

 sudo apt-get install --yes python-software-properties python g++ make

cdb4

Download Couch DB.

mkdir couchdb && cd couchdb
wget http://apache.mirrors.tds.net/couchdb/source/1.6.1/apache-couchdb-1.6.1.tar.gz

Selection_003

Extract the package

gunzip /home/unixmen/couchdb/apache-couchdb-1.6.1.tar.gz
tar -xvf /home/unixmen/couchdb/apache-couchdb-1.6.1.tar

Configure Couch DB

cd apache-couchdb-1.6.1
./configure &&make
make install

Create a user ‘couchdb’

useradd -d /var/lib/couchdb couchdb

Assign appropriate permissions:

chown -R couchdb:couchdb /usr/local/var/lib/couchdb/
chown -R couchdb:couchdb /usr/local/var/log/couchdb/
chown -R couchdb:couchdb /usr/local/var/run/couchdb/

Selection_004

make couchdb to run as service:

cd /etc/init.d

Update init.d to run couchdb as service, by default.

ln -s /usr/local/etc/init.d/couchdb /etc/init.d

Selection_005

Test /etc/init.d/couchdb command to make sure is is effective or not.

Selection_006

Change the bind address for couch db configuration:

 nano /usr/local/etc/couchdb/default.ini && /etc/init.d/couchdb restart

search bind_address and change from 127.0.0.1 to 0.0.0.0

Selection_009

Open the browser and type http://127.0.01:5984

or type

curl http://127.0.0.1:5984/

You will see the welcome message.

 {"couchdb":"Welcome",

Selection_008

 

Selection_007

Have a look on default data base.

curl -X GET http://127.0.0.1:5984/_all_dbs

Sample output:

["_replicator","_users"]

Create a new data base ‘unixmen’.

 curl -X PUT http://127.0.0.1:5984/unixmen

Sample output:

{"ok":true}

Selection_010

Let us create one more database using GUI, open browser and type <ip_address_of_couchdb>/_utils

Apache CouchDB - Futon: Overview - Mozilla Firefox_011

Add data base ”rajneesh’  using gui:

Selection_012 Let’s delete database ‘unixmen’ using cli.

curl -X DELETE http://127.0.0.1:5984/unixmen

Sample output

{"ok":true}

Thats it!

In this tutorials we  tested  how to setup Apache Couch DB with Ubuntu 15.04 Desktop Version, will try in future to bring some more detailed administration related material for couchdb.

 

Have fun!