couchdb-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Apache Wiki <wikidi...@apache.org>
Subject [Couchdb Wiki] Update of "Installing_on_Ubuntu" by MarcelloNuccio
Date Sat, 05 Feb 2011 08:09:37 GMT
Dear Wiki user,

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

The "Installing_on_Ubuntu" page has been changed by MarcelloNuccio.
The comment on this change is: Better instructions for Ubuntu 10.04 and later.
http://wiki.apache.org/couchdb/Installing_on_Ubuntu?action=diff&rev1=57&rev2=58

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

  == Batteries Included ==
- Newer versions of Ubuntu have CouchDB  included in their respective software 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 have to install from source, or other package repositories that have newer
pre-built CouchDB packages.
+ Newer versions of Ubuntu have CouchDB  included in their respective software repositories.
 You can install CouchDB with the '''Synaptic GUI''', or from the command line with the '''apt-get'''
or '''aptitude''' utilities, which ever you prefer.  However, to get the newest version of
CouchDB you may have to install from source, or other package repositories that have newer
pre-built CouchDB packages.
  
  '''Example 1:'''
  
  {{{
  sudo aptitude install couchdb
  }}}
+ 
  === Troubleshooting ===
+ 
  If the aptitude/apt-get installation gives an error message then couchdb might not have
access to its pid file.
  
  Fix:
@@ -21, +23 @@

  {{{
  sudo dpkg --configure couchdb
  }}}
+ 
+ 
  == Using the Ubuntu installer ==
+ 
  The easiest way to install the newest versions of CouchDB is using the ubuntu installer
located at: http://www.couch.io/get#ubuntu.
  
  It comes with all the libraries that CouchDB needs so there are no additional packages to
install.
  
+ 
  == Installing From Source ==
+ 
  This is a basic outline of the steps required to build CouchDB from source 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 (Example #2 below uses a javascript engine that
is installed from source, which may be preffered for minimal Ubuntu systems).
  
-  * Install CouchDBs first set of dependencies: sudo apt-get build-dep couchdb
+  * Install first set of dependencies: {{{sudo apt-get build-dep couchdb}}}
-  * Install CouchDBs second set of dependencies: sudo apt-get install libmozjs-dev libicu-dev
libcurl4-gnutls-dev libtool
-  '''(*NOTICE*: In Ubuntu 10.04, libmozjs-dev is no longer available.  You should use xulrunner-dev
instead and you will need to update xulrunner.conf (see below))'''
-  * Then download the latest CouchDB source file.  The wget utility is a useful utility for
this. For example: wget http://mirror.ox.ac.uk/sites/rsync.apache.org//couchdb/1.0.1/apache-couchdb-1.0.1.tar.gz
+  * Install second set of dependencies:
+    * Ubuntu '''up to 9.10''': {{{sudo apt-get install libmozjs-dev libicu-dev libcurl4-gnutls-dev
libtool}}}
+    * Ubuntu '''10.04 and later''': {{{sudo apt-get install xulrunner-dev libicu-dev libcurl4-gnutls-dev
libtool}}}
+      Then [[#xulrunner.conf|create /etc/ld.so.conf.d/xulrunner.conf]].
+  * Download CouchDB from [[http://couchdb.apache.org/downloads.html]].
-  * Untar (decompress) the source file: tar -zxvf apache-couchdb-*.*.*.tar.gz
+  * Untar (decompress) the source file: {{{tar -zxvf apache-couchdb-*.*.*.tar.gz}}}
-  * Change into the expanded directory: cd apache-couchdb-*.*.*
+  * Change into the expanded directory: {{{cd apache-couchdb-*.*.*}}}
+  * Configure the build: {{{./configure}}}
+    On Ubuntu '''10.04 and later''': {{{LDFLAGS="$(pkg-config mozilla-js --libs-only-L)"
CFLAGS="$(pkg-config mozilla-js --cflags)" ./configure}}}
-  * Configure the build: ./configure (You may need to specify build options like the installation
directory, etc.  Please reference the example(s) below.)
+    (You may need to specify build options like the installation directory, etc.  Please
reference the examples below.)
-  * 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.)
+  * Build or Compile the source: {{{make}}}
+  * Fix any error before moving to the next step.
-  * Install your newly built CouchDB: sudo make install
+  * Install your newly built CouchDB: {{{sudo make install}}}
   * Once the installation completes successfully, you will need to make sure that there is
a CouchDB user, and that the CouchDB user owns the necessary files and directories.
-  * Now you can run CouchDB manually by changing into the /bin folder of the installed directory,
and running the following command: "sudo -u couchdb ./couchdb "
+  * Now you can run CouchDB manually by changing into the {{{bin/}}} folder of the installation
directory, and running: {{{sudo -u couchdb ./couchdb}}}
-  * Once the server is running you can browse to http://localhost:5984/_utils.  This should
take you to the Futon Web GUI.
+  * Once the server is running you can browse to [[http://localhost:5984/_utils]].  This
should take you to the Futon Web GUI.
-  * To be thorough, you should run the built in tests to ensure that CouchDB is working properly.
 To run the tests, click on the "Test Suite" link on the right hand side of the Futon Web
GUI, then click on "Run All" to execute all of the built in tests.  All of tests should run
without error on Ubuntu.
+  * To be thorough, you should run the built in tests to ensure that CouchDB is working properly.
 To '''run the tests''', click on the [[http://localhost:5984/_utils/couch_tests.html?script/couch_tests.js|Test
Suite]] link on the right hand side of the Futon Web GUI, then click on "Run All" to execute
all of the built in tests.  ''All of tests should run without error on Ubuntu.''
-  * Once CoucDB is working properly you can add CouchDB to your startup scripts if desired.
+  * Once CouchDB is working properly you can add CouchDB to your startup scripts if desired.
  
- Note: If you installed all the dependencies of Couchdb from the Synaptic GUI, but not Couchdb
itself, some of the dependencies may think they are not required and the update manager may
suggest that they are removed. Should you remove these dependencies, CouchDB may fail to start,
perhaps with an error such as:
+ Note: If you installed all the dependencies of Couchdb from the Synaptic GUI, but not CouchDB
itself, some of the dependencies may think they are not required and the update manager may
suggest that they are removed. Should you remove these dependencies, CouchDB may fail to start,
perhaps with an error such as:
  
  {{{
  {"init terminating in do_boot",{undef,[{crypto,start,[]},{erl_eval,do_apply,5},{init,start_it,1},{init,start_em,1}]}}
@@ -173, +185 @@

  
  If you have previously built and installed from source it is likely that there will be a
previous version of the Erlang libraries (couch-x.x.x, erlang-oauth, etap, ibrowse-x.x.x,
mochiweb-xxx) in /usr/local/lib/couchdb/erlang/lib. These should be removed before doing 'sudo
make install' for the new version. If you only discover a problem (e.g., CouchDB crashes)
after doing the new install, the problem might be solved by manually removing everything in
/usr/local/lib/couchdb/erlang/lib and redoing 'sudo make install'.
  
+ <<Anchor(xulrunner.conf)>>
  ==== Problems with libmozjs and xulrunner? ====
  In Ubuntu 10.04 you may get an error similar to this:
  

Mime
View raw message