Skip to main content

Install on Red Hat

These are steps to install Aerospike on Red Hat and Red Hat-derived operating systems. For precise details on supported OSes, see Enterprise Downloads.

Assumed skills

These instructions assume that you have the following skills or understanding:

  • Familiarity with the Linux operating system you are installing on.
  • Shell commands like wget or apt-get, tar, and editors.
  • TCP/IP networking.

Prerequisites

  • You must disable SELinux during the installation of the Aerospike database.
  • For CentOS 7, the Aerospike installation files are built with OpenSSL version 1.02. If you are running earlier versions of OpenSSL, installation of Aerospike will fail.
  • For CentOS 8, if you are running a non-standard version of the OS, such as a "stripped down" version to eliminate certain packages for security, Aerospike Enterprise Edition has certain dependencies that must be satisfied before installation. See CentOS 8 package dependencies below.
  • To install, you must have root access or permission to run sudo. As an alternative to root access, you can install the binary distribution.

Notational conventions

  • <aerospike_version> is the version number of the Aerospike database.
  • <centos_version> is the version number of CentOS. The value can be el7, or el8.

For Aerospike Database 5.1 and later, libcurl is required#

For Aerospike Database 5.1 and later, be sure to install the proper version of libcurl. For details, see Required - libcurl version for your Linux operating system.

Download Aerospike Database#

To download Aerospike Database, run one of the following commands:

note

If you do not have wget, use curl instead.

To download the latest version of Aerospike Database Enterprise Edition, run this command:

wget -O aerospike.tgz 'https://www.aerospike.com/enterprise/download/server/latest/artifact/<centos_version>'

Example:

wget -O aerospike.tgz 'https://www.aerospike.com/enterprise/download/server/latest/artifact/el8'

For version 4.5.x or earlier of the Aerospike Enterprise Edition, use the following command and your username and password:

wget -O aerospike.tgz 'https://www.aerospike.com/enterprise/download/server/4.5.3.5/artifact/<centos_version>' --user='userName' --password='passWord'

Extract the contents of 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:
aerospike-server-enterprise-<aerospike_version>-<centos_version>/

The directory includes:

  • license.txt — licenses for Aerospike and other software included in the package.
  • aerospike-tools-<aerospike_version>.<centos_version>.x86_64.rpmAerospike command-line tools and utilities.
  • aerospike-server-enterprise-<aerospike_version>.<centos_version>.x86_64.rpm — the Aerospike Database package.

Release Notes

For release notes and details on releases, see Download.

Install and Configure Aerospike#

CentOS 8 package dependencies#

If you running a non-standard version of CentOS 8, make sure the following packages required by the Aerospike Enterprise Edition are installed. The version numbers for some paackages are also shown.

  • /bin/sh
  • /usr/bin/env
  • config(aerospike-server-enterprise) = 4.8.0.5-1.el8
  • ld-linux-x86-64.so.2()(64bit)
  • ld-linux-x86-64.so.2(GLIBC_2.2.5)(64bit)
  • ld-linux-x86-64.so.2(GLIBC_2.3)(64bit)
  • libc.so.6()(64bit)
  • libc.so.6(GLIBC_2.14)(64bit)
  • libc.so.6(GLIBC_2.17)(64bit)
  • libc.so.6(GLIBC_2.2.5)(64bit)
  • libc.so.6(GLIBC_2.28)(64bit)
  • libc.so.6(GLIBC_2.3)(64bit)
  • libc.so.6(GLIBC_2.3.2)(64bit)
  • libc.so.6(GLIBC_2.3.4)(64bit)
  • libc.so.6(GLIBC_2.4)(64bit)
  • libc.so.6(GLIBC_2.6)(64bit)
  • libc.so.6(GLIBC_2.7)(64bit)
  • libc.so.6(GLIBC_2.8)(64bit)
  • libc.so.6(GLIBC_2.9)(64bit)
  • libcrypto.so.1.1()(64bit)
  • libcrypto.so.1.1(OPENSSL_1_1_0)(64bit)
  • libdl.so.2()(64bit)
  • libdl.so.2(GLIBC_2.2.5)(64bit)
  • libgcc_s.so.1()(64bit)
  • libgcc_s.so.1(GCC_3.0)(64bit)
  • libgcc_s.so.1(GCC_3.3)(64bit)
  • liblber-2.4.so.2()(64bit)
  • libldap-2.4.so.2()(64bit)
  • libm.so.6()(64bit)
  • libm.so.6(GLIBC_2.2.5)(64bit)
  • libpthread.so.0()(64bit)
  • libpthread.so.0(GLIBC_2.2.5)(64bit)
  • libpthread.so.0(GLIBC_2.3.2)(64bit)
  • libpthread.so.0(GLIBC_2.3.4)(64bit)
  • librt.so.1()(64bit)
  • librt.so.1(GLIBC_2.2.5)(64bit)
  • libssl.so.1.1()(64bit)
  • libssl.so.1.1(OPENSSL_1_1_0)(64bit)
  • libssl.so.1.1(OPENSSL_1_1_1)(64bit)
  • libstdc++.so.6()(64bit)
  • libstdc++.so.6(CXXABI_1.3)(64bit)
  • libstdc++.so.6(CXXABI_1.3.8)(64bit)
  • libstdc++.so.6(CXXABI_1.3.9)(64bit)
  • libstdc++.so.6(GLIBCXX_3.4)(64bit)
  • libstdc++.so.6(GLIBCXX_3.4.20)(64bit)
  • libstdc++.so.6(GLIBCXX_3.4.21)(64bit)
  • libstdc++.so.6(GLIBCXX_3.4.9)(64bit)
  • libz.so.1()(64bit)
  • libz.so.1(ZLIB_1.2.0)(64bit)
  • rpmlib(CompressedFileNames) <= 3.0.4-1
  • rpmlib(FileDigests) <= 4.6.0-1
  • rpmlib(PayloadFilesHavePrefix) <= 4.0-1
  • rpmlib(PayloadIsXz) <= 5.2-1
  • rtld(GNU_HASH)

Install Aerospike Database#

You must install via the command line.

To install the server and the tools packages, run the following:

cd aerospike-server-enterprise-<aerospike_version>-<centos_version>sudo ./asinstall

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

Problems during Installation#

If there are errors during the installation, see Troubleshooting. The Knowledge Base is also a good source of troubleshooting tips.

Configure Aerospike#

Installation establishes the server's default configuration.

An in-memory test namespace is configured by default.

Adding devices and more#

To add storage devices, configure a cluster, tune your configuration to your hardware, and other settings, see Configure Aerospike Database.

Install features.conf#

Enterprise Edition requires a feature-key file called features.conf that enables gated features, such as compression.

caution

Enterprise Edition server version >= 4.6 will not start without this file.

See Configure the Feature Key File.

Configure logging#

To configure logging for the Aerospike database, see Configure - Log.

Start Aerospike#

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 systemd Daemon Management.

Problems during startup#

If there are errors during start up, see Startup Problems. The Knowledge Base is also a good source of troubleshooting tips.

Verify Aerospike is running#

For details on getting the status of the Aerospike database with systemctl, see Aerospike systemd Daemon Management.