A newer version of this documentation is available.

View Latest

Amazon Linux 2 Installation

Instructions for installing Couchbase Server on Amazon Linux 2.

Amazon Linux 2 is supported with Couchbase Server 6.0.1+. See Supported Operating Systems for details.

Installing Using rpm

Install Couchbase Server on Amazon Linux 2 using the rpm command-line tool with the downloaded RPM package.

See Supported Operating Systems for details.

Disable Transparent Huge Pages (THP)

Newer Linux distributions are known to have the Transparent Huge Pages (THP) feature enabled by default. THP can cause issues in database software, including Couchbase Server. THP can cause nodes to lose cluster heartbeats, resulting in erroneous automatic fail overs. Disabling Transparent Huge Pages (THP) prior to installing Couchbase Server is strongly encouraged.

Complete the Installation

You must be logged in as root (superuser) or use the sudo command to complete the installation. Use the following command to install the Couchbase Server package:

rpm --install couchbase-server-enterprise-version-amzn2.x86_64.rpm

where version is the version number of the downloaded package.

After the rpm command completes, the Couchbase Server service starts automatically.

After installation is completed, the installation process displays a message similar to the following:

    Minimum RAM required : 4 GB
    System RAM configured : 8174464 kilobytes
    Minimum number of processors required :  4 cores
    Number of processors on the system : 4 cores

    Starting couchbase-server[ OK ]

    You have successfully installed Couchbase Server.
    Browse to http://host_name:8091/ to configure your server.
    Refer to http://couchbase.com for additional resources.

    Update your firewall configuration
    to allow connections to the following ports:

    11211, 11210, 11209, 4369, 8091, 8092 and from 21100 to 21299.

    By using this software you agree to the End User License Agreement.
    See /opt/couchbase/LICENSE.txt.

After the installation is completed, use the service command to manage the Couchbase Server service, including checking the current status. Refer to the Amazon Linux 2 documentation for instructions.

To perform the initial Couchbase Server setup, open a web browser and access the Couchbase Web Console.

Installing as non-root, non-sudo

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-amzn2.x86_64.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