[Couchdb Wiki] Trivial Update of "Installing_on_Ubuntu" by RaymondKroeker

[Apache Wiki <wi...@apache.org>]

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 RaymondKroeker.
The comment on this change is: Mod the symlink target for logrotate to match actual file..
http://wiki.apache.org/couchdb/Installing_on_Ubuntu?action=diff&rev1=59&rev2=60

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

  {{{
  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:
@@ -23, +21 @@

  {{{
  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.couchone.com/get#ubuntu]].
+ The easiest way to install the newest versions of CouchDB is using the ubuntu installer located at: http://www.couchone.com/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 first set of dependencies: {{{sudo apt-get build-dep couchdb}}}
   * Install second set of dependencies:
-    * Ubuntu '''up to 9.10''': {{{sudo apt-get install libmozjs-dev libicu-dev libcurl4-gnutls-dev libtool}}}
+   * 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}}}
+   * 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]].
+    . Then [[#xulrunner.conf|create /etc/ld.so.conf.d/xulrunner.conf]].
-  * Download CouchDB from [[http://couchdb.apache.org/downloads.html]].
+  * Download CouchDB from http://couchdb.apache.org/downloads.html.
   * Untar (decompress) the source file: {{{tar -zxvf apache-couchdb-*.*.*.tar.gz}}}
   * 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}}} (You may need to specify build options like the installation directory, etc.  Please reference the examples below.)
-    On Ubuntu '''10.04 and later''': {{{LDFLAGS="$(pkg-config mozilla-js --libs-only-L)" CFLAGS="$(pkg-config mozilla-js --cflags)" ./configure}}}
-    (You may need to specify build options like the installation directory, etc.  Please reference the examples below.)
   * Build or Compile the source: {{{make}}}
   * Fix any error before moving to the next step.
   * 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 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 [[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 CouchDB is working properly you can add CouchDB to your startup scripts if desired.
  
@@ -186, +178 @@

  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:
  
@@ -233, +226 @@

  To fix this (on Ubuntu/Debian), do the following:
  
  {{{
- sudo ln -s /usr/local/etc/logrotate.d/couch /etc/logrotate.d/couchdb
+ sudo ln -s /usr/local/etc/logrotate.d/couchdb /etc/logrotate.d/couchdb
  }}}
  ,,- Don't forget to change the path to match your installation.,,