You are viewing the documentation for a prerelease version.

View Latest

Install Couchbase Server on Oracle Linux

Couchbase Server can be installed on Oracle Linux for production and development use-cases. Root and non-root installations are supported.

Use the instructions on this page to install Couchbase Server on Oracle Linux using Couchbase-provided RPM packages. The instructions support both Enterprise and Community editions.

If you’re upgrading an existing installation of Couchbase Server, refer to Upgrading Couchbase Server.

Before You Install

Couchbase Server works out-of-the-box with most OS configurations. However, the procedures on this page assume the following:

  • Your system meets the minimum requirements and that your operating system version is supported.

  • You’re working from a clean system and that you’ve uninstalled any previous versions of Couchbase Server.

    If you’re upgrading an existing installation of Couchbase Server, refer to Upgrading Couchbase Server.

  • Only the Red Hat Compatible Kernel (RHCK) is supported. The Unbreakable Enterprise Kernel (UEK) is not supported.

For production deployments, make sure to follow the deployment guidelines so that your systems and environment are properly sized and configured before installation.

Basic Installation

You must be logged in as root (superuser) or use sudo to run the installation commands.

Install Using Yum

The Red Hat package manager (yum) provides the simplest and most comprehensive way to install Couchbase Server on Oracle Linux. This method involves downloading and installing a small meta package from Couchbase, which yum can then use to automatically download and install Couchbase Server and all of its dependencies.

  1. Download the meta package.

    curl -O https://packages.couchbase.com/releases/couchbase-release/couchbase-release-1.0-6-x86_64.rpm
  2. Install the meta package.

    sudo rpm -i ./couchbase-release-1.0-6-x86_64.rpm

    The meta package installs the necessary information for yum to be able to retrieve all of the necessary Couchbase Server installation packages and dependencies.

  3. Install Couchbase Server.

    • Enterprise

    • Community

    To install the latest release
    sudo yum install couchbase-server

    You’ll be prompted to start the download of Couchbase Server (plus any dependencies), as well as import several GPG keys. For each of these prompts, type y to accept and continue.

    To install a specific release
    1. List the available releases.

      yum list --showduplicates couchbase-server

      Available releases are listed with their full version-build number:

      couchbase-server.x86_64   6.0.0-1693
    2. Specify a release to install it.

      sudo yum install couchbase-server-version-build

      Using the example listing from the previous step, the resulting installation command would be:

      sudo yum install couchbase-server-6.0.0-1693

      You’ll be prompted to start the download of Couchbase Server (plus any dependencies), as well as import several GPG keys. For each of these prompts, type y to accept and continue.

    To install the latest release
    sudo yum install couchbase-server-community

    You’ll be prompted to start the download of Couchbase Server (plus any dependencies), as well as import several GPG keys. For each of these prompts, type y to accept and continue.

    To install a specific release
    1. List the available releases.

      yum list --showduplicates couchbase-server-community

      Available releases are listed with their full version-build number:

      couchbase-server-community.x86_64   6.0.0-1693
    2. Specify a release to install it.

      sudo yum install couchbase-server-community-version-build

      Using the example listing from the previous step, the resulting installation command would be:

      sudo yum install couchbase-server-community-6.0.0-1693

      You’ll be prompted to start the download of Couchbase Server (plus any dependencies), as well as import several GPG keys. For each of these prompts, type y to accept and continue.

    Once installation is complete, Couchbase Server will start automatically (and will continue to start automatically at run levels 2, 3, 4, and 5, and explicitly shut down at run levels 0, 1, and 6). You can use the systemctl command (service on older operating systems) to start and stop the Couchbase Server service, as well as check the current status. Refer to Couchbase Server Startup and Shutdown for more information.

  4. Open a web browser and access the Couchbase Web Console to verify that the installation was successful and that the node is available.

Install Using RPM Package

Install Couchbase Server on Oracle Linux using a full RPM package provided by Couchbase.

  1. Download the appropriate package from the Couchbase downloads page.

  2. Install Couchbase Server.

    sudo yum install ./package-name.rpm

    If any Couchbase Server dependencies are missing on your system, yum will automatically download and install them as part of the installation process.

    Once installation is complete, Couchbase Server will start automatically (and will continue to start automatically at run levels 2, 3, 4, and 5, and explicitly shut down at run levels 0, 1, and 6). You can use the systemctl command (service on older operating systems) to start and stop the Couchbase Server service, as well as check the current status. Refer to Couchbase Server Startup and Shutdown for more information.

  3. Open a web browser and access the Couchbase Web Console to verify that the installation was successful and the node is available.

Installing as non-root, non-sudo

Installing on Oracle Linux as a non-root, non-sudo user on a single machine.

A non-sudo, non-root installation still runs Couchbase Server and all Couchbase command-line tools.

  1. Place the Couchbase Server RPM into a directory where Couchbase Server is to be installed.

  2. Go to that directory and extract the RPM:

    cd /home/me/couchbase-non-root/
    rpm2cpio couchbase-server-enterprise_version.rpm | cpio --extract --make-directories --no-absolute-filenames

    In the directory where the files were extracted, the opt and etc sub-directories are now available.

  3. After you extract the Couchbase Server installation files, go to the sub-directory:

    cd opt/couchbase
  4. Run the following script to complete the non-root Couchbase Server installation:

    ./bin/install/reloc.sh `pwd`

    This enables you to continue the installation as a non-root, non-sudo user.

  5. To run the server, use

    ./bin/couchbase-server \-- -noinput -detached
  6. To stop the server, use

    ./bin/couchbase-server -k

Next Steps

Following installation and start-up of Couchbase Server, a node must be initialized and provisioned.

  • If it is the first node in a deployment, initialization and provisioning happens all at once when you create a cluster of one.

    Refer to Create a Cluster

  • If you already have an existing cluster, the node is initialized and provisioned when you add it to the cluster.

  • Optionally, initialization can be performed explicitly and independently of provisioning, as a prior process, in order to establish certain configurations, such as custom disk-paths.