Skip to content


Subversion checkout URL

You can clone with
Download ZIP
The Membase Server Superdupervisor.
Erlang JavaScript HTML CSS Ruby Python Other

Merge remote-tracking branch 'couchbase/sherlock'

* couchbase/sherlock:
  Exclude header from master_events.log
  MB-16126 Collect stats archives to stats_archives.json
  Generalize find_dump_guts to find_script.
  Little helper function to add .exe to executables when needed.
  Reorder PATH directories.
  Add a script that dumps stats archives in json format.
  Add a escript-wrapper script.
  Include code path into initargs.
  Avoid converting app environment terms to strings.
  Extract functions that build initargs.

Change-Id: Iee869ae0c77d910573910a25a40c0391be2fce7b
latest commit cf2dc53933
@vzasade vzasade authored
Failed to load latest commit information.
cmake_modules [bp] create rebar.config, src/ and deps/ale/
deps Merge remote-tracking branch 'couchbase/sherlock'
doc MB-15761 introduce internal setting for using sha1 in certs
etc Increase default net_kernel verbosity.
include Merge remote-tracking branch 'couchbase/sherlock'
priv Add support for Karma/Jasmine unit tests & tests for mn_http.js
scripts Merge remote-tracking branch 'couchbase/sherlock'
src Merge remote-tracking branch 'couchbase/sherlock'
test Update supervisor2.
.gitignore Update .gitignore to ignore cluster run log files
CHANGES MB-8663 Mention where to find replication id.
CMakeLists.txt Merge remote-tracking branch 'couchbase/sherlock'
GNUmakefile Add support for Karma/Jasmine unit tests & tests for mn_http.js
LICENSE bug 1626 - apache license headers on files
README.markdown Typo - COUCHBASE_NUM_VBUCKET(S) to set vbucket cnt
cbbrowse_logs MB-8101: allow overriding of logs reports dir
cbcollect_info Exclude header from master_events.log.
cbreset_password MB-8974 suppress unnecessary error messages in cbreset_password
cluster_connect cluster_connect: shortcut to specify same services for all nodes
cluster_run MB-15556: Don't dont_suppress_stderr_logger on Windows.
configure MB-10807 Fix make test and make dialyzer. MB-14656: Print version and usage information Compile supervisor2 before everything else.


The Couchbase Server

This application represents the top of the hierarchy of all memcached smart services. It is an application in the Erlang OTP sense.


Build dependencies include...

  • erlang R14 (make sure to have functional crypto)


You should use top level make file and repo manifest as explained here:

Runtime dependencies

Before you start the server, you may need to do the following

  • Make sure the needed ports are not being used (these include 8091, 11211, 11212, etc).


After building everything via top level makefile you'll have couchbase-server script in your $REPO/install/bin (or other prefix if you specified so). You can run this script for normal single node startup.

During development it's convenient to have several 'nodes' on your machine. There's ./cluster_run script in root directory for achiving that. Feel free to ask --help. You normally need something like -n2 where 2 is number of nodes you want.

It'll start REST API on ports 9000...9000+n. memcached on ports 12000+2i and 11999-i and moxi ports on 12001+2i ports. CAPI (which was originally expected to be couch-compatible http API implementation) is 9500...9500+n

Note that blank nodes are not configured and need to be setup. I suggest trying web UI first to get the feeling of what's possible. Just visit REST API port(s) via browser. For development mode clusters it's port 9000 and higher. For production mode it's port 8091.

Other alternative is setting up and clustering nodes via REST API. couchbase-cli allows that. And you can easily write your own script(s).

There's ./cluster_connect script that eases cluster configuration for development clusters. Ask --help.

Sometimes during debugging/development you want smaller number of vbuckets. You can change vbuckets number by setting COUCHBASE_NUM_VBUCKETS environment variable to desired number of vbuckets before creating new couchbase bucket.

Other tools

Couchbase ships with a bunch of nice tools. Feel free to check $REPO/install/bin (or $PREFIX/bin). One of notable tools is mbstats. It allows you to query buckets for all kinds of internal stats.

Another notable tool is couchbase-cli. Script is called just couchbase.

Copyright (c) 2012, Couchbase, Inc.

Something went wrong with that request. Please try again.