Install Aerospike on Linux

Aerospike Database is optimized for 64-bit Linux distributions, and comes packaged as Red Hat Package Manager (RPM) packages, Debian packages, binary and source tarballs.

See the platform support page for information about the versions currently supported.

Tools requirements

Aerospike tools run on 64-bit Linux distributions, including Red Hat Enterprise Linux (RHEL) and its binary compatible variants, Ubuntu, Debian, Amazon Linux, and Oracle Linux. See Platform support and compatibility for more information.

Prerequisites

Caution

Aerospike Database is not supported on systems with SELinux in Enforcing mode. If you are using SELinux, it must be permanently disabled or permanently set to Permissive mode. See the RHEL documentation for more information.

Debian

• To install, you must have root access or permission to run sudo.
• Verify that you have the libcurl4 package installed.

Ubuntu

• To install, you must have root access or permission to run sudo.
• Verify that you have the libcurl or libcurl-minimal package installed.

RHEL

• SELinux must be permanently disabled or permanently set to Permissive mode.
• To install, you must have root access or permission to run sudo.
• Verify that you have the libcurl4 package installed.
• For RHEL 8 (Database 5.7.0+), “stripped-down” or non-standard OS versions must meet specific dependencies before installing Aerospike EE. See CentOS 8 package dependencies for the required list.
• Starting with Database 8.1.1, OpenSSL version 1.1.0 or later is required.

Note

Some RHEL 7 and RHEL 8 variants for 64-bit ARM have changed their default kernels to a 64K memory page size, and are therefore no longer supported. Aerospike users with deployments on these operating system versions must upgrade to one whose kernel has a 4K page size. Amazon Linux 2 and Amazon Linux 2023 for 64-bit ARM are safe.

Download Aerospike Database

Download the Aerospike Database software manually from the download page. Make sure to read the release notes of the version you are downloading. Alternatively, you can automate downloading versions of the server from the artifact repository. See the FAQ on downloads for details.

Aerospike Community, Enterprise, and Federal edition downloads are available for all supported Linux distributions, and use the following naming convention: aerospike-server-EDITION_VERSION_tools-TOOLS-VERSION_DISTRO_ARCHITECTURE.tgz

See Supported Linux versions to learn which Linux versions and distributions support your Aerospike release.

Base URL:

https://download.aerospike.com/artifacts/aerospike-server-edition/server-version/

Example download command:

wget -O aerospike.tgz https://download.aerospike.com/artifacts/aerospike-server-enterprise/6.2.0.0/aerospike-server-enterprise_6.2.0.0_tools-8.0.2_el8_x86_64.tgz

Note

It is not necessary to use homogeneous versions or distributions of Linux for all nodes in a cluster, but all nodes must run on supported Linux distributions. In addition, using heterogeneous OS versions might cause troubleshooting to be difficult, because of an increased number of variables to consider.

Extract the package

To extract the contents of the package, run the following:

tar -xvf aerospike.tgz

The contents are extracted to a directory with a name similar to the following, where community_or_enterprise depends on the version of the server you downloaded:

The directory includes:

• license.txt — licenses for Aerospike and other software included in the package
• Tools RPM — Aerospike command-line tools and utilities
• Server RPM — the Aerospike Database package

Install

To install the server and the tools packages, run the following from the command line:

cd aerospike-server-enterprise-*
sudo ./asinstall

For a description of files and directories that are installed, see Directory Structure.

Alternatively, you can install the packages directly.

Debian

sudo dpkg -i aerospike-server-edition_version-1distro_architecture.deb

sudo dpkg -i aerospike-tools_version-distro_architecture.deb

Ubuntu

sudo dpkg -i aerospike-server-edition_version-1distro_architecture.deb

sudo dpkg -i aerospike-tools_version-distro_architecture.deb

RHEL

sudo rpm -Uvh aerospike-server-edition_version-1distro_architecture.rpm

sudo rpm -Uvh aerospike-tools_version-distro_architecture.rpm

Next steps

The Aerospike-included init script /etc/init.d/aerospike manages the Aerospike Database Daemon /usr/bin/asd.

In addition, the Aerospike database can be controlled with standard systemctl commands. For details, see Aerospike Daemon Management.

Configure Aerospike

Installation establishes the server’s default configuration. An in-memory test namespace is configured by default. See Configure Aerospike Database to modify and tune the configuration.

Add devices and more

To add SSDs, make sure to read about setup and initialization.

Configure EE feature-key file

Caution

Aerospike EE requires a feature-key file to start up and optionally enable gated features, such as compression.

Starting with Database 6.1.0, the feature-key file for a single-node cluster is provided, so the server will start up automatically.

Configure logging

To configure logging for the Aerospike database, see Log management.