Thanks Robert. This was super useful. Just one thing to note is that port 15986 is the local node port. From what I undestand we should use port 15984.
Cheers Garren On Sat, Jun 7, 2014 at 10:49 PM, Robert Kowalski <[email protected]> wrote: > My experiences to get started with testing the BigCouch branch > plus how to get Fauxton with it running for the testing. We > need your Feedback, so please post any bugs you notice > to this ML. > > rebar is a dependency of BigCouch, so we have to install it first: > > git clone https://github.com/rebar/rebar > cd rebar > ./bootstrap > > # Add rebar to your PATH in your .bash_profile or .bashrc, e.g.: > > export PATH="/path/to/the/rebar/directory:$PATH" > > # restart your terminal or source your shell configs to get the > # PATH update > > # All the other dependencies for installing CouchDB from source > # are still needed, further details: > > http://docs.couchdb.org/en/latest/install/unix.html#dependencies > > # clone a fresh CouchDB > # (my usual CouchDB dev repo did not work, > # but I am messing around there) > git clone git://git.apache.org/couchdb.git > > # checkout the bigcouch-merge branch > cd couchdb > git co 1843-feature-bigcouch > > # compile > ./configure > make > > # I got this as my dev setup is older and Erlang was too old: > # ERROR: OTP release R16B03 does not match required regex > # R14B01|R14B03|R14B04|R16B02|R16B03-1|17 > # so I had to update my Erlang, on my Mac I am doing this with: > > brew update && brew upgrade erlang > > # I did another make: > make > > # after a successful make we can run: > ./dev/run > > # and if we point our browser to http://localhost:15986/ > # there is a welcome message! > > # getting Fauxton running > # ------------------------ > # Fauxton is not included in the BigCouch branch, so > # do a second clone of the couchdb repo, but stay at master, > # let the first couch run on 15986 > > # clone into couchdb-2 > git clone git://git.apache.org/couchdb.git couchdb-2 > cd ~/couchdb-2/src/fauxton > > # install Fauxton dependencies (you need node and npm installed): > npm i -g grunt grunt-cli > npm i > > # open couchdb-2/src/fauxton/tasks/couchserver.js > # in line 34, change the port of the target to 15986: > > var proxy_settings = options.proxy || { > target: { > host: 'localhost', > port: 15986, > https: false > } > }; > > # In your couchdb-2/src/fauxton/Gruntfile.js change the > # the port for the defaults to 15986: > > var defaults = { > dist: './dist/debug/', > port: 8000, > proxy: { > target: { > host: 'localhost', > port: 15986, > https: false > }, > // This sets the Host header in the proxy so that you can use > external > // CouchDB instances and not have the Host set to 'localhost' > changeOrigin: true > } > }; > > # go to couchdb-2/src/fauxton/ and run grunt dev: > grunt dev > > # you can now play with Fauxton and your BigCouch-Couch :) > # Fauxton listens on http://localhost:8000 > > > Best, > Robert >
