Please use the form below to provide your feedback. Because your feedback is valuable to us, the information you submit in this form is recorded in our issue tracking system (JIRA), which is publicly available. You can track the status of your feedback using the ticket number displayed in the dialog once you submit the form.

Install on Red Hat Enterprise

  • concept
Operational Insights can be installed on Red Hat Enterprise Linux for production and development use-cases. Root installations are supported.

Use the instructions on this page to install Operational Insights on Red Hat Enterprise Linux using Couchbase-provided RPM packages.

Before You Install

Operational Insights 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 your operating system version is supported.

  • You’re working from a clean system.

    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 log 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 Operational Insights on Red Hat Enterprise. This method involves downloading and installing a small meta package from Couchbase, which yum uses to automatically download and install Operational Insights and dependencies.

  1. Download the meta package.

    curl -O https://packages.couchbase.com/releases/couchbase-release/couchbase-release-1.0.noarch.rpm

  2. Install the meta package.

    sudo rpm -i ./couchbase-release-1.0.noarch.rpm

    The meta package installs the necessary information for yum to retrieve all of the necessary Operational Insights installation packages and dependencies.

  3. Install the latest release or a specific release of Operational Insights.

    • To install the latest release:

      sudo yum install operational-insights

      You’ll be prompted to start the download of Operational Insights, plus any dependencies, as well as import several GPG keys.

    • To install a specific release:

      • List the available releases.

        yum list --showduplicates operational-insights

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

        operational-insights.x86_64   2.0.0-1060

      • Specify a release to install it.

        sudo yum install operational-insights-version-build

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

        sudo yum install operational-insights-2.0.0-1060

        You’ll be prompted to start the download of Operational Insights (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, Operational Insights starts automatically. It starts automatically at run levels 2, 3, 4, and 5. It explicitly shuts down at run levels 0, 1, and 6. You can use the systemctl command to start and stop Operational Insights, and check the current status. On earlier operating systems, use service. For more information, see Start and Stop Operational Insights.

Install Using RPM Package

Install Operational Insights on Red Hat Enterprise using a full RPM package provided by Couchbase.

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

  2. Install Operational Insights.

    sudo yum upgrade ./package-name.rpm

    If any Operational Insights dependencies are missing on your system, yum automatically downloads and installs them as part of the installation process.

    Once installation is complete, Operational Insights starts automatically. It starts automatically at run levels 2, 3, 4, and 5. It explicitly shuts down at run levels 0, 1, and 6. You can use the systemctl command to start and stop Operational Insights, and check the current status. On earlier operating systems, use service. For more information, see Start and Stop Operational Insights.

Setting Max Process Limits

On Red Hat Enterprise, Couchbase recommends that you increase the maximum process limits for Couchbase.

TTo set the process limits, create a .conf file in the /etc/security/limits.d directory. For example, 91-couchbase.conf. Add the following values:

couchbase soft nproc 4096
couchbase hard nproc 16384

Next Steps

Following installation and start-up of Operational Insights, you must initialize and provision a node.

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

    For more information, see Create a Cluster.

  • If you already have an existing cluster, you must initialize and provision a node when you add it to the cluster.

    For more information, see Add a Node and Rebalance.

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

    For more information, see Initialize a Node.