Testing Couchbase Server

Testing the connection to Couchbase Server can be performed in a number of different ways.

Connecting to the Couchbase web console on a node via a web browser provides basic confirmation that your node is available.
You can also use the couchbase-cli command to query your Couchbase Server node to confirm that the node is available.

The Couchbase web console uses the same port as smart clients when communicating with Couchbase Server.
If you can connect to the Couchbase web console from a particular machine then administration and database clients on the same machine can also connect to the core cluster port and perform operations.
The Couchbase web console will warn if the web browser loses connectivity to the node.

To verify that clients can connect to your node, you can use either the cbworkloadgen command, or telnet.

The cbworkloadgen command is a python program which performs basic operations (reads and writes) against the Couchbase Server cluster.

Using telnet only checks the memcached compatibility ports and the memcached text-only protocol.

Testing with telnet

The simplest method to determine whether Couchbase Server is running is to use Telnet to connect to the server with the memcached text protocol.

Telnet must be installed on your server to connect to Couchbase Server using this method.
It is supplied as standard on most platforms, or can be obtained as a separate package and installed via your operating system’s standard package manager.

You should not use the Telnet method for communicating with your server within your application.
Instead, use one of the Couchbase Server SDKs.