Auto-tools/Projects/OrangeFactor/InstallationInstructions

Installing CouchDB and Orange Factor/WOO on Ubuntu

In order to replicate the existing public orange_factor app from couchone.com, you'll have to install at least version 1.0.1 of CouchDB, which isn't in Ubuntu. There is a further issue in that libmozjs is no longer a separate package in Ubuntu 10.04.

Tackling those problems in reverse order, you'll need to install xulrunner-dev to get libmozjs:

sudo apt-get install xulrunner-dev

# check which version of xulrunner you have installed by running "xulrunner-dev".
# Ubuntu 10.04 as of 19 Oct 2010 has 1.9.2.10; replace that in the following if you have a
# different version.

sudo vi /etc/ld.so.conf.d/xulrunner.conf
# add these two lines:
/usr/lib/xulrunner-1.9.2.10
/usr/lib/xulrunner-devel-1.9.2.10

sudo /sbin/ldconfig

Now you should be ready to install CouchDB. These instructions are taken from http://wiki.apache.org/couchdb/Installing_on_Ubuntu

sudo su
# Install dependencies required to build couchdb from source
apt-get build-dep couchdb
cd /opt
# download the latest release from http://couchdb.apache.org/downloads.html
# wget <url>
tar xvzf apache-couchdb-x.xx.x.tar.gz
cd apache-couchdb-x.xx.x

# see xulrunner directions below and do them this fixes problem where basic test suite fails to run.
# Note: To install couchdb in the default location use --prefix= in the configure statement
# Note: To check what XULRunner version you have installed use xulrunner -v
./configure --prefix= --with-js-lib=/usr/lib/xulrunner-devel-x.x.x.x/lib --with-js-include=/usr/lib/xulrunner-devel-x.x.x.x/include

# Now you can compile and install couchdb
make && make install
# Add couchdb user account
useradd -d /var/lib/couchdb couchdb
chown -R couchdb: /var/lib/couchdb /var/log/couchdb

# next two steps fix problems where adding admin hangs or setting admins in local.ini hangs the start. Also fixes problems with reader_acl test.
chown -R root:couchdb /etc/couchdb
chmod 664 /etc/couchdb/*.ini
chmod 775 /etc/couchdb/*.d

# start couchdb
/etc/init.d/couchdb start
# Start couchdb on system start
update-rc.d couchdb defaults

# Verify couchdb is running
curl http://127.0.0.1:5984/
# {"couchdb":"Welcome","version":"1.0.1"}

The "--prefix=" configure option will cause couchdb to be install as /bin/couchdb, which is kind of weird, but otherwise with, say, "--prefix=/usr" the /etc/ files will be installed as /usr/etc/. I think this is a bug with the installation stuff (I've certainly never seen a configure script behave like this), but regardless the above works.

At this point, you can replicate the existing database. Go to http://127.0.0.1:5984/_utils/index.html and hit the "Create Database" button at the top of the main panel. Use the name "orange_factor". Then go to "Replicator" in the right side bar. Choose to replicate changes from remote database http://jmaher.couchone.com/orange_factor to local database orange_factor. After a minute or two, you should see a status message. Go back to "Overview" and you should see a number of documents listed for orange_factor.

In order to install the app, we need to first install the python package couchapp. You'll need setuptools installed if you don't already have it:

sudo apt-get install python-setuptools

And then to install couchapp:

sudo easy_install -U couchapp

Now we grab the current version of the orange_factor code and install it locally. Go to whatever directory you usually keep your projects in, and run

couchapp clone http://jmaher.couchone.com/orange_factor/_design/woo
cd woo
couchapp push orange_factor

It'll print out a message about visiting your new app, but the real page will be http://127.0.0.1:5984/orange_factor/_design/woo/orange.html. After a few seconds' loading time, you should see graphs and stats!