[Couchdb Wiki] Update of "Running CouchDB in Dev Mode" by RogerBinns

[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 "Running CouchDB in Dev Mode" page has been changed by RogerBinns.
The comment on this change is: Tidy up older information, add new info (bootstrap) and give details about what to do on Ubuntu 9.10.
http://wiki.apache.org/couchdb/Running%20CouchDB%20in%20Dev%20Mode?action=diff&rev1=5&rev2=6

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

  ## page was renamed from Running_Couchdb_in_Dev_Mode
- This only applies if you need to make changes to the CouchDB server or to the Futon web front-end. 
+ This only applies if you need to make changes to the CouchDB server or to the Futon web front-end.
  
  === Prerequisites ===
  You need to have installed CouchDB from source. See [[Installing_from_source]].
@@ -10, +10 @@

  The following commands set up a CouchDB configuration that points to the location of your SVN checkout.
  
  Run these commands:
+ 
  {{{
  $ cd YOUR_COUCHDB_CHECKOUT_DIRECTORY
+ $ ./bootstrap
+ $ ./configure
- $ make dev 
+ $ make dev
  }}}
+ You can change defaults such as port number and passwords in `./etc/couchdb/local_dev.ini`. Now start CouchDB by calling this command:
  
- Now start CouchDB by calling this command:
  {{{
  $ utils/run
  }}}
+ Your CouchDB server has been started as a foreground process.  You should see messages similar to this:
  
- Your CouchDB server has been started as a foreground process. You can make it a background process by calling this instead:
  {{{
- $ utils/run &
+ Apache CouchDB 0.11.0b885334 (LogLevel=info) is starting.
+ Apache CouchDB has started. Time to relax.
+ [info] [<0.32.0>] Apache CouchDB has started on http://127.0.0.1:5984/
- }}}.
+ }}}
+ You can change to background, reset config files, redirect output etc via command line arguments.  (Note only one dash in front of help.)
  
- You should see the following message:
  {{{
+ $ utils/run -help
- Apache CouchDB 0.9.0a729754-incubating (LogLevel=error) is starting.
- Apache CouchDB has started. Time to relax.
  }}}
  
+ === Ubuntu 9.10 ===
+ 
+ This is how you can run the dev version side by side with the Ubuntu version. The main difficulties are Javascript engine paths as documented by [[http://mattgoodall.blogspot.com/2009/09/build-couchdb-on-ubuntu-910-karmic.html|Matt Goodall]].  You need to specify `LD_RUN_PATH=/usr/lib/xulrunner-1.9.1.5` before every command as well as provide extra parameters to configure.
+ 
+ Get all the needed build time packages:
+ 
+ {{{
+ $ sudo apt-get install libtool help2man erlang-nox erlang-dev libicu-dev xulrunner-dev libcurl4-openssl-dev build-essential
+ }}}
+ 
+ Checkout source code and build it:
+ {{{
+ $ svn co http://svn.apache.org/repos/asf/couchdb/trunk couchdb
+ $ cd couchdb
+ $ ./bootstrap
+ $ LD_RUN_PATH=/usr/lib/xulrunner-1.9.1.5 ./configure --with-js-lib=/usr/lib/xulrunner-devel-1.9.1.5/lib/ --with-js-include=/usr/lib/xulrunner-devel-1.9.1.5/include
+ $ LD_RUN_PATH=/usr/lib/xulrunner-1.9.1.5 make dev
+ }}}
+ 
+ Now edit `./etc/default/local_dev.ini` and change the port.  I use 5984 (default) for the Ubuntu install and 5985 for this dev version.
+ 
+ {{{
+ $ LD_RUN_PATH=/usr/lib/xulrunner-1.9.1.5 utils/run
+ }}}
+