[Couchdb Wiki] Update of "Installing_on_Ubuntu" by cdrx

[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 cdrx.
The comment on this change is: added section on system update.
http://wiki.apache.org/couchdb/Installing_on_Ubuntu?action=diff&rev1=30&rev2=31

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

  == Ubuntu 10.04 ==
  === Installing CouchDB from source on Ubuntu 10.04 (Example 1): ===
  Please see below in links for complete instructions on how to install CouchDB 0.11 specifically.
+ 
  {{{
  sudo su
  # Install dependencies required to build couchdb from source
@@ -62, +63 @@

  # {"couchdb":"Welcome","version":"0.11.0"}
  }}}
  === Additional Notes ===
- 
  ==== Problems with libmozjs and xulrunner? ====
  In Ubuntu 10.04 you may get an error similar to this:
  
@@ -88, +88 @@

  }}}
  This solution is referenced in this bug report @ https://bugs.launchpad.net/ubuntu/+source/xulrunner-1.9/+bug/557275
  
+ ==== System updates ====
+ When peforming system updates (using apt-get or package manager) please keep in mind that the /etc/ld.so.conf.d/xulrunner.conf file is not maintained by the system and will not be updated if a new version of xulrunner is deployed !
+ 
+ So please check the update content in order to determine if the xulrunner package is being updated.
+ 
+ If this is the case, follow the procedure in the previous section on order to update the xulrunner.conf file.
+ 
  ==== Don't forget to configure logging! ====
- 
  -''Setup log rotate:''
  
  First off, a lot of people run CouchDB from source which means that in 99% of all installs, the log rotation is not activated.
  
  To fix this (on Ubuntu/Debian), do the following:
+ 
  {{{
  sudo ln -s /usr/local/etc/logrotate.d/couch /etc/logrotate.d/couchdb
  }}}
- 
  ,,- Don't forget to change the path to match your installation.,,
  
  Make sure to familiarize yourself with log rotate. Depending on the space requirements and business of your installation, you should adjust your configuration so that you don't run out of disk space. If CouchDB is unable to log, it will crash.
@@ -107, +113 @@

  
  In most cases it's more than alright to just run with a log level of error.
  
- Add the following to your local.ini (in [log]): level = error
+ Add the following to your local.ini (in [log]): level = error Log directory
- Log directory
  
  If you are still running out of diskspace? Add the following to your local.ini (in [log]):
  
@@ -123, +128 @@

  These logging tips is based on the recommendations found here: [[http://till.klampaeckel.de/blog/archives/95-Operating-CouchDB.html|Operating CouchDB]]
  
  == Note on installing on  Ubuntu Desktop flavors ==
+ If you're *not* running Ubuntu server, but rather running some variant of Ubuntu desktop, I'd strongly recommend compiling from source and keeping the default prefix of /usr/local.  Ubuntu comes standard with couchdb-bin, and uses desktop-couch with tools like  Ubuntu One, gwibber, and evolution. But, it Lucid Lynx ships with version 0.10.0.  This is a long-term support item, but that doesn't mean Canonical will be releasing 0.11 anytime soon.
  
+ So, to install a parallel version of current CouchDB on an Ubuntu desktop system, you should download build from source, being careful to keep the default install prefix of "/usr/local", and following all of the above instructions about libraries and dependencies.
- If you're *not* running Ubuntu server, but rather running some variant
- of Ubuntu desktop, I'd strongly recommend compiling from source and
- keeping the default prefix of /usr/local.  Ubuntu comes standard with
- couchdb-bin, and uses desktop-couch with tools like  Ubuntu
- One, gwibber, and evolution. But, it Lucid Lynx ships with version
- 0.10.0.  This is a long-term support item, but that doesn't mean
- Canonical will be releasing 0.11 anytime soon.
  
+ Then, after installing CouchDB, you can still get it to start at boot as normal, but because 0.11.x is in /usr/local, just running
- So, to install a parallel version of current CouchDB on an Ubuntu
- desktop system, you should download build from source, being careful to keep the
- default install prefix of "/usr/local", and following all of the above instructions about libraries and dependencies.
- 
- 
- Then, after installing CouchDB, you can still get it to start at boot
- as normal, but because 0.11.x is in /usr/local, just running
  
  {{{
  sudo update-rc.d couchdb defaults
  }}}
+ is probably *not* going to do the right thing.  What is seems to do is look in the /etc/init.d directory, where it will likely find the 0.10 version of CouchDB.
  
+ Instead, you have force the system to use the version of CouchDB installed in /usr/local.  There should be an option to update-rc.d that will tell it to look in /usr/local/etc rather than /etc, but I couldn't find it.
- is probably *not* going to do the right thing.  What is seems to do is
- look in the /etc/init.d directory, where it will likely find the 0.10 version
- of CouchDB.
- 
- Instead, you have force the system to use the version of CouchDB
- installed in /usr/local.  There should be an option to
- update-rc.d that will tell it to look in /usr/local/etc rather than
- /etc, but I couldn't find it.
  
  A brute force way to make it work is to do something like:
  
@@ -160, +148 @@

   sudo ln -sf /usr/local/etc/init.d/couchdb /etc/init.d/couchdb
   sudo update-rc.d couchdb defaults
  }}}
- 
- 
- 
- 
  == External Articles ==
   * [[http://h.imagehost.org/download/0072/How-to_Install_CouchDB_and_CouchDB-Lucene_on_Ubunut_Lucid|Installing CouchDB and CouchDB-Lucene on Ubunut 10.04 Lucid Lynx- PDF]]
   * [[http://www.owengriffin.com/posts/2010/04/27/CouchDB_0.11_and_CouchApp_Notes.html#comment-48272833|CouchDB 0.11 and CouchApp Notes]]