I know that Summer 2016 is long gone, but I promised one more blog post about building the CouchCase. This part was the easiest, since clustering Couchbase Server nodes together is really easy.


First, a little information about how I networked the Intel Compute Sticks. On the router in the CouchCase, I’ve pegged each network adapter to a specific IP address. How to do this is going to vary from router to router, so consult your manual.

Here’s a snapshot of STICK1, STICK2, and STICK3 all pegged to three IP addresses and attached to the router.

Compute sticks running Couchbase Server attached to a router


The first time you setup Couchbase Server, you are creating a cluster with a single node. So, if you’ve done this, as far as setting up an entire cluster, you are most of the way there.

Next, install Couchbase Server on another machine (or VM or whatever). Instead of selecting “Start a new Cluster”, select “Join a cluster now”. Enter the IP address of the first node you created, as well as the username/password information that you set it to be.

Join a Couchbase node to a Couchbase cluster

s Once you do that, you should get a message saying “This server has been associated with the cluster and will join on the next rebalance operation.”

A Couchbase node has been successfully joined to a Couchbase cluster

A rebalance operation is necessary for Couchbase to figure out all the details of which node a given document should live on. For more information, check out the documentation on Rebalancing a Cluster.

A rebalance is a background operation, and should not interfere with the operation of nodes that are already working. This means that if you need to add capacity to your database, you don’t have to take down your website or schedule a 'maintenence window' or anything like that.

Once the rebalance is complete, you should see a list of nodes:

List of nodes in a Couchbase cluster

CouchCase is going on the road

There are a few finishing cosmetic touches, but CouchCase is ready to go on the road. In fact, look for it at the upcoming CodeMash conference in January 2017: “Are You Ready for Chaos? Horizontal Scaling in a Briefcase”. If you have any questions or suggestions, I’d love to hear from you. I’m on Twitter as @mgroves.


Posted by Matthew Groves

Matthew D. Groves is a guy who loves to code. It doesn't matter if it's C#, jQuery, or PHP: he'll submit pull requests for anything. He has been coding professionally ever since he wrote a QuickBASIC point-of-sale app for his parent's pizza shop back in the 90s. He currently works as a Senior Product Marketing Manager for Couchbase. His free time is spent with his family, watching the Reds, and getting involved in the developer community. He is the author of AOP in .NET, Pro Microservices in .NET, a Pluralsight author, and a Microsoft MVP.

One Comment

  1. […] session was partly a demonstration of the CouchCase project that I worked on in the summer, but also a demonstration of the CAP Theorum and Couchbase in […]

Leave a reply