couchdb-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Garren Smith <gar...@apache.org>
Subject Re: [HOWTO]: Get the BigCouch Merge + Fauxton running for testing
Date Mon, 09 Jun 2014 08:23:35 GMT
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 <rok@kowalski.gd> 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
>

Mime
  • Unnamed multipart/alternative (inline, None, 0 bytes)
View raw message