Mailing-List: contact commits-help@couchdb.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@couchdb.apache.org
MIME-Version: 1.0
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: quoted-printable
From: Apache Wiki <wikidiffs@apache.org>
To: Apache Wiki <wikidiffs@apache.org>
Date: Thu, 06 May 2010 22:44:39 -0000
Message-ID: <20100506224439.14131.35463@eos.apache.org>
Subject: 
 =?utf-8?q?=5BCouchdb_Wiki=5D_Update_of_=22Installing=5Fon=5FUbuntu=22_by_?=
 =?utf-8?q?Linicks?=

Dear Wiki user,

You have subscribed to a wiki page or wiki category on "Couchdb Wiki" for c=
hange notification.

The "Installing_on_Ubuntu" page has been changed by Linicks.
http://wiki.apache.org/couchdb/Installing_on_Ubuntu?action=3Ddiff&rev1=3D15=
&rev2=3D16

--------------------------------------------------

- CouchDB has an Ubuntu package for Ubuntu 8.10 (Intrepid Ibex) and 9.04 (J=
aunty Jackalope) - just do:
+ =3D=3D Batteries Included =3D=3D
+ Newer versions of Ubuntu have CouchDB  included in their respective softw=
are repositories.  You can install CouchDB with the '''Synaptic GUI''', or =
from the command line with the '''apt''' or '''aptitude''' utilities, which=
 ever you prefer.  However, to get the newest version of CouchDB you may ha=
ve to install from source, or other package repositories that have newer pr=
e-built CouchDB packages.
+ =

+ Example 1:
  =

  {{{
- aptitude install couchdb
+ sudo aptitude install couchdb
  }}}
- =3D=3D From Source =3D=3D
+ =3D=3D Installing From Source =3D=3D
- If you want the latest version of Couchdb but everything else from the re=
positories then:
+ This is a basic outline of the steps required to build CouchDB from sourc=
e on Ubuntu.  Like many things, there are multiple ways to achieve the same=
 task. With that in mind, these steps may or may not be the best method for=
 you.
  =

+  * Install CouchDBs first set of dependencies: sudo apt-get build-dep cou=
chdb
-  * In Synaptic select couchdb, this will also select the dependencies (er=
lang etc.) then unselect couchdb and apply the dependencies
-  * sudo apt-get build-dep couchdb
-  * sudo apt-get install libmozjs-dev libicu-dev libcurl4-gnutls-dev libto=
ol
+  * Install CouchDBs second set of dependencies: sudo apt-get install libm=
ozjs-dev libicu-dev libcurl4-gnutls-dev libtool
-  * download the latest couchdb .tar.gz file
-  * tar -zxvf apache-couchdb-0.9.0.tar.gz
-  * cd apache-couchdb-0.9.0
-  * ./configure
-  * make
-  * sudo make install
+  '''(*NOTICE*: In Ubuntu 10.04, libmozjs-dev is no longer available.  You=
 should use xulrunner-dev instead)'''
+  * Then download the latest CouchDB source file.  The wget utility is a u=
seful utility for this. For example: wget http://mirrors.axint.net/apache/c=
ouchdb/0.11.0/apache-couchdb-0.11.0.tar.gz
+  * Untar (decompress) the source file: tar -zxvf apache-couchdb-*.*.*.tar=
.gz
+  * Change into the expanded directory: cd apache-couchdb-*.*.*
+  * Configure the build: ./configure (You may need to specify build option=
s like the installation directory, etc.  Please reference the example(s) be=
low.)
+  * Build or Compile the source: make  (You shouldn't have any errors when=
 this process is done.  If you do you should fix them before moving to the =
next step.)
+  * Install your newly built CouchDB: sudo make install
+  * Once the installation completes successfully, you will need to make su=
re that there is a CouchDB user, and that the CouchDB user owns the necessa=
ry files and directories.
+  * Now you can run CouchDB manually by changing into the /bin folder of t=
he installed directory, and running the following command: "sudo -u couchdb=
 ./couchdb "
+  * Once the server is running you can browse to http://localhost:5984/_ut=
ils.  This should take you to the Futon Web GUI.
+  * To be thorough, you should run the built in tests to ensure that Couch=
DB is working properly.  To run the tests, click on the "Test Suite" link o=
n the right hand side of the Futon Web GUI, then click on "Run All" to exec=
ute all of the built in tests.  All of tests should run without error on Ub=
untu.
+  * Once CoucDB is working properly you can add CouchDB to your startup sc=
ripts if desired.
  =

+ Note: If you installed all the dependencies of Couchdb from synaptic, but=
 not Couchdb itself, some of the dependencies may think they are not requir=
ed and the update manager may suggest that they are removed. Should you rem=
ove these dependencies, CouchDB may fail to start, perhaps with an error su=
ch as:
- now you can run "sudo couchdb" and browse to http://localhost:5984/_utils=
 to check it is all working
- =

- Because you installed all the dependencies of Couchdb from synaptic, but =
not Couchdb itself some of the dependencies may think they are not required=
 and update manager may suggest that they are removed. Should you do this C=
ouchdb will fail to start, perhaps with an error such as
  =

  {{{
  {"init terminating in do_boot",{undef,[{crypto,start,[]},{erl_eval,do_app=
ly,5},{init,start_it,1},{init,start_em,1}]}}
@@ -28, +34 @@

  If this happens simply re-install the dependencies (possibly erlang-nox b=
ut it could vary)
  =

  =3D=3D Ubuntu 10.04 =3D=3D
- To install couchdb from source on Ubuntu 10.04 follow these steps
+ Installing CouchDB from source on Ubuntu 10.04 (Example 1)
  =

  {{{
  sudo su
@@ -56, +62 @@

  # {"couchdb":"Welcome","version":"0.11.0"}
  }}}
  =3D=3D Additional Notes =3D=3D
- =

  In Ubuntu 10.04 you may get an error similar to this:
  =

  {{{
  OS Process Error <0.4649.0> :: {os_process_error,{exit_status,127}}
  /opt/couchdb/lib/couchdb/bin/couchjs: error while loading shared librarie=
s: libmozjs.so: cannot open shared object file: No such file or directory
  }}}
- =

  This is can be resolved by creating an xulrunner configuration as follows:
  =

  {{{
- sudo vi /etc/ld.so.conf.d/xulrunner.conf =

+ sudo vi /etc/ld.so.conf.d/xulrunner.conf
  }}}
+ Then add the following lines to the file (You may need to change the libr=
ary version to match whats installed):
  =

- Then add the following lines to the file (You may need to change the libr=
ary version to match whats installed):
  {{{
  /usr/lib/xulrunner-1.9.2.3
  /usr/lib/xulrunner-devel-1.9.2.3
  }}}
+ Once the configuration files is created and saved, you will need to run l=
dconfig:
  =

- Once the configuration files is created and saved, you will need to run l=
dconfig:
  {{{
  sudo /sbin/ldconfig
  }}}
- =

  This solution is referenced in this bug report @ https://bugs.launchpad.n=
et/ubuntu/+source/xulrunner-1.9/+bug/557275
  =

- =

  =3D=3D External Articles =3D=3D
+  * [[http://www.owengriffin.com/posts/2010/04/27/CouchDB_0.11_and_CouchAp=
p_Notes.html#comment-48272833|CouchDB 0.11 and CouchApp Notes]]
   * [[http://barkingiguana.com/2008/06/28/installing-couchdb-080-on-ubuntu=
-804|Installing CouchDB 0.8.0 on Ubuntu 8.04]]
   * [[http://japhr.blogspot.com/2009/03/yak-shaving-is-new-dependency-hell=
.html|Installing Couchdb 0.9 on Ubuntu 9.04]]
   * [[http://depth-first.com/articles/2010/01/28/pubcouch-install-couchdb-=
on-ubuntu-karmic-from-source|Install CouchDB on Ubuntu Karmic From Source]]=
 ''Unfortunately, the Karmic CouchDB binary distribution is broken''