A newer version of this documentation is available.

View Latest

Single Node Upgrade

To upgrade a single Couchbase Server node, first back up your data and then install the upgrade software package.

Use the cbbackup tool to back up your data.

Steps for upgrading a Couchbase Server node explained in this section are identical for an online upgrade (for a node that has been removed from the cluster) or an offline upgrade (for a node that has not yet been added to the cluster).
  1. Download the Couchbase Server package.

  2. Back up the cluster data.

  3. Back up the server-specific configuration files. While the upgrade scripts perform a backup of the configuration and data files, make your own backup of these files as best practice. The configuration files are found in /opt/couchbase/var/lib/couchbase/config/ by default.

  4. Stop the Couchbase Server service.

  5. Check your hostname configuration. If you have deployed Couchbase Server in a cloud service, or if you are using hostnames rather than IP addresses, you must verify that the hostname has been configured correctly and is resolvable before performing the upgrade.

  6. Perform the upgrade installation for your platform; see the Installationsection appropriate for your platform for detailed installation instructions.