cbcluster

``
| | |
,---.|---.,---.| . .,---.|--- ,---.,---.
| | || | | |---.| |---'|
---'---'---'---'---'---'---'---'
`

cbcluster is a small immersive command line utility for interacting with
Couchbase Server clusters.

Development is ongoing to mirror some of the examples shown in the
REST API Reference documentation. The primary focus of this tool is
compact commands for quick cluster interaction.

Installation

With NPM:

`
npm install -g cbcluster
`

From this repository:

`
git clone https://github.com/brianshumate/cbcluster.git
cd cbcluster
npm install
npm link
`

Usage

Start cbcluster:

`
cbcluster
`

Get help:

`
cbcluster> help

Commands:

addn [options] Add node to existing cluster
bckt [options] Create bucket
ejct [options] Eject node from cluster
flvr [options] Fail over node
info [options] Get Couchbase Server information
init [options] Initialize node
name [options] Specify node name
rebl [options] Rebalance cluster
svcs [options] Specify node services
user [options] Specify administrator username and password
help [command] Provides help for a given command
exit [options] Exits this instance of cbcluster
`

You can also get help for individual commands with help .

$3

For the sake of convenience, cbcluster includes some sensible defaults
and the defaults (for e.g. bucket creation) which you will find in the
Couchbase Server web console user interface:

| Default setting | Value | Notes |
| ---------------------- | --------------- | ----------------------------|
| Administrator username | Administrator | [string] can be overridden with -u |
| Administrator password | couchbase | [string] can be overridden with -p |
| Node data path | /opt/couchbase/var/lib/couchbase/data | [string] can be overridden with -d |
| Node index path | /opt/couchbase/var/lib/couchbase/index | [string] can be overridden with -i |
| Node port | 8091 | [int] can be overridden with -x 18091 |
| Bucket type | membase | [string] can be overridden with -t memcached note that membase is the name for a couchbase style bucket; the other option is memcached |
| Per Node RAM Quota | 128 | [int] RAM quota per node for bucket (in megabytes) |
| Cache metadata | valueOnly | [string] can be overridden with -e fullEviction |
| Access control | sasl | [string] can be overridden with -a none |
| Bucket port | None | Set a bucket auth port number with -d 11242 |
| Replicas | 1 | [int] can be overridden with (2,3) -r 3 |
| Index replicas | 0 | [0 or 1] can be overridden with -i |
| Auto compaction | 0 | [0 or 1] can be overridden with -c |
| Flush | 0 | [0 or 1] can be overridden with -f |

All the above defaults can of course be overridden by command options.

$3

This example follows the Creating a new cluster documentation and covers most of the current abilities available in
cbcluster.

#### Couchbase Server Version

Determine the Couchbase Server version on a given cluster node:

`
cbcluster> vers -h cb1.local
SUCCESS: Couchbase Server node cb1.local version: 3.1.1-1807-rel-enterprise
`

#### Initialize Node

The first step in building a cluster is to initialize the node:

`
cbcluster> init -h cb3.local
SUCCESS: Initialized node: cb3.local
`

#### Specify Node Name

`
cbcluster> name -h cb3.local -n cb3.local
SUCCESS: Named node: cb3.local
`

#### Specify Node Services

`
cbcluster> svcs -h cb3.local -s kv,n1ql
SUCCESS: Specified services on node cb3.local: kv,n1ql
`

#### Specify Administrator Username and Password

`
user -h cb3.local -u Administrator -p tacotown
SUCCESS: Set administrator on node cb3.local: Administrator
`

#### Create Bucket

`
cbcluster> bckt -h cb3.local -p tacotown -n tacos -m 128 -s secretsalsa
SUCCESS: Created tacos bucket on node cb3.local
`

#### Fail Node Over and Rebalance Out

This example shows how to fail a node over, eject it from the cluster, and
then perform a rebalance; this makes the failed over node no longer a
cluster member.

`
cbcluster> flvr -h cb1.local -t cb2.local
SUCCESS: Node cb2.local failed over
cbcluster> ejct -h cb1.local -t cb2.local
SUCCESS: Node cb2.local ejected from cluster
cbcluster> rebl -h cb1.local -k cb1.local,cb3.local
SUCCESS: Cluster rebalancing
``

Notes

This project works with the following software:

* Couchbase Server 3.x-4.x
* Node.js 4.2.2

References

1. Creating a new cluster
2. Adding nodes to clusters
3. Buckets API
4. Removing nodes from clusters
5. Failing over nodes
6. Rebalancing nodes