Install Enterprise Analytics on Red Hat Enterprise
- concept
Enterprise Analytics 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 Enterprise Analytics on Red Hat Enterprise Linux using Couchbase-provided RPM packages.
Before You Install
Enterprise Analytics 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 Enterprise Analytics on Red Hat Enterprise.
This method involves downloading and installing a small meta package from Couchbase, which yum
uses to automatically download and install Enterprise Analytics and dependencies.
-
Download the meta package.
curl -O https://packages.couchbase.com/releases/couchbase-release/couchbase-release-1.0.noarch.rpm
-
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 Enterprise Analytics installation packages and dependencies. -
Install the latest release or a specific release of Enterprise Analytics.
-
To install the latest release:
sudo yum install enterprise-analytics
You’ll be prompted to start the download of Enterprise Analytics, plus any dependencies, as well as import several GPG keys.
-
To install a specific release:
-
List the available releases.
yum list --showduplicates enterprise-analytics
Available releases are listed with their full
version-build
number:enterprise-analytics.x86_64 2.0.0-1060
-
Specify a release to install it.
sudo yum install enterprise-analytics-version-build
Using the example listing from the previous step, the resulting installation command would be:
sudo yum install enterprise-analytics-2.0.0-1060
You’ll be prompted to start the download of Enterprise Analytics (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, Enterprise Analytics 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 Enterprise Analytics, and check the current status. On earlier operating systems, useservice
. For more information, see Enterprise Analytics Startup and Shutdown.
-
-
Install Using RPM Package
Install Enterprise Analytics on Red Hat Enterprise using a full RPM package provided by Couchbase.
-
Download the appropriate package from the Couchbase downloads page.
-
Install Enterprise Analytics.
sudo yum upgrade ./package-name.rpm
If any Enterprise Analytics dependencies are missing on your system,
yum
automatically downloads and installs them as part of the installation process.Once installation is complete, Enterprise Analytics 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 Enterprise Analytics, and check the current status. On earlier operating systems, useservice
. For more information, see Enterprise Analytics Startup and Shutdown.
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 Enterprise Analytics, 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.