Run Couchbase Server on Linode: Part 2

Now we install Couchbase Server 5.0 on the Linode created in Part 1 of this series. The server software is installed using a Debian release package. After that a Couchbase cluster is initialized using the Admin Console.

We're on step 5 of these steps
  1. Create a Linode
  2. Deploy an Image
  3. Boot and Connect to the Linode
  4. Configure the Operating System
  5. Install Couchbase Server
  6. Verify the Installation
Part 1 covered steps 1 through 4, how to prepare your Linode for Couchbase. Part 3 will show how to verify the installation.

Install Couchbase Server

With Ubuntu we can use a Debian package to install Couchbase Server.  See this article for apt and yum-based installations.

Download Release Package

From the remote Linode, download the Debian release package for Couchbase.

> curl -O http://packages.couchbase.com/releases/couchbase-release/couchbase-release-1.0-4-amd64.deb



Install the Package

> sudo dpkg -i couchbase-release-1.0-4-amd64.deb

Confirm that the package is installed.

 > sudo apt-cache search couchbase


Update Packages


Update the apt packages to pull in the Couchbase Server packages.

 > sudo apt-get update

Confirm that the Couchbase Server packages were added.

 > sudo apt-cache search couchbase


You should see couchbase-server and couchbase-server-community in the search results.

Install Couchbase Server

Now we can install the server.

> sudo apt-get install couchbase-server

When prompted, enter Y to continue the installation.


Note that the installer warns us that there is an insufficient amount of RAM and there are too few cores -- 2 instead of 4.  That's okay as we're just experimenting.

Initialize the Cluster

Open the Couchbase Server Admin Console.  Get the hostname or IP address of your Linode and browser the console: https://linode_hostname.members.linode.com:8091.



Click on Setup New Cluster and complete the New Cluster form.
  • Cluster Name: linode-cb1
  • Admin Username: cbadmin


Press Next: Accept Terms and follow the instructions to accept the Terms and Conditions.


Press Configure Disk, Memory, Services

On the next screen we will set the hostname, disk paths, services and memory quotas, index storage setting and update notifications.

For the hostname, use the one you're using to access the server node, eg., linode_hostname.members.linode.com. The hostname is used to access the host from outside linode, so you can't use linode-cb1 unless configured your Linode with a registered top level domain.

For disk paths, set them as follows:
  • Data Disk Path: /opt/couchbase/var/lib/couchbase/data
  • Indexes Disk Path: /opt/couchbase/var/lib/couchbase/index
For more on file locations see the documentation.

Adjust the memory quota allocations:
  • Data Service: 1024
  • Index Service: 512
  • Search Service: 316
Set the Index Storage Setting to Standard Global Secondary.

Finally, check Enable software update notifications in the web console.


Press Save & Finish and you'll be taken to the dashboard.



More Tips

Troubleshooting 

dpkg will not work if the preinstall step determines the Ubuntu distribution is unsupported. To confirm this, extract the package

> dpkg-deb -e ./couchbase-release-1.0-2-amd64.deb deb-out2

Then check the preinstall script.

Alternate Download Options

If you don't want to use the apt repository, you can download the server from this webpage: Downloads. Pick the version, the target OS (e.g., Ubuntu 16.04) and then press Download. You'll have to move the file to your Linode.

Or use curl

> curl -O http://packages.couchbase.com/releases/5.0.0/couchbase-server-enterprise_5.0.0-ubuntu16.04_amd64.deb


Comments

Post a Comment

Popular posts from this blog

Run Couchbase Server on Linode: Part 1

Image
Linode  offers cloud hosting for virtual Linux servers in more than a few spots around the world.  I installed the latest Couchbase Server on a single VM, affectionately called a Linode, to get a feel for the install process and try out the new Couchbase Server 5.0 that introduces role-based access control. This article, in three parts, walks through the steps to install Couchbase Server 5.0 Enterprise Edition on a Linux VM or Linode running Ubuntu 16.04 LTS. Here are the steps: Create a Linode Deploy an Image Boot and Connect to the Linode Configure the Operating System Install Couchbase Server Verify the Installation This post describes steps 1 through 4, how to prepare a Linode for Couchbase. Part 2 will cover installing the Couchbase Server. Part 3 will show how to verify the installation. Create a Linode Linodes come in many sizes.  I picked the smallest multi-CPU option, a two CPU instance with 4 GB of RAM.  From the Linode Manager, ...
Read more

Run Couchbase Server on Linode: Part 3

Image
In the final post of this series I run Couchbase Server through a simple test, a pillow fight.  This will be short, only showing you how to setup a test bucket, create a test user and then run  cbc-pillowfight . Since it's a single node cluster and that node only has two CPUs, the test isn't evaluating performance. It will simply verify the installation. So we finish with step 6 of these steps Create a Linode Deploy an Image Boot and Connect to the Linode Configure the Operating System Install Couchbase Server Verify the Installation Part 1  covered how to prepare your Linode for Couchbase, steps 1-4. Part 2 described the installation process, step 5.  On to the verification. Verify the Installation Here are a few ways to test your cluster: Pillow fight Workload generator Custom test application The first two options are command line utilities from Couchbase. The third, a custom application, is needed if the testing must closely ...
Read more

Event Sourcing in a Highly Distributed Environment

Image
Event sourcing is a data management strategy that stores changes to a data model rather than just the model's current state. It uses an append-only event log to ensure zero data loss. By replaying events from the log, you can establish the current state of the model. These data integrity and replay benefits make event sourcing a useful technique for dealing with intermittently connected mobile devices . It also enables client applications to access and update data in a distributed environment without losing any updates . In this presentation I share my experience with event sourcing in a globally distributed web application. We use the technique to share data models between mobile and web-based clients of an online clinical decision support system. The application runs on multiple data centers around the world. A distributed event store, using the NoSQL database Couchbase , tracks article views and bookmark related events. Once in the database, the events can be queried ...
Read more