Skip to main content

Install on Debian

These are the details on installing the Aerospike database on debian systems. For precise details on supported OSes, see Enterprise Downloads.

  • To install, you must have root access or permission to run sudo. As an alternative to root access, you can install the binary distribution.

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.

Notational conventions

  • <aerospike_version>, is the version of the Aerospike database.
  • <debian_version>, is the version number of the OS. The value can be debian8, debian9, or debian10.

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/<debian_version>'

Example:

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

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/<debian_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>-<debian_version>/

The directory includes:

  • license.txt — licenses for Aerospike and other software included in the package.
  • aerospike-tools-<aerospike_version>.<debian_version>.x86_64.debAerospike command-line tools and utilities.
  • aerospike-server-enterprise-<aerospike_version>.<debian_version>.x86_64.deb — the Aerospike database package.

Release Notes

For release notes and details on releases, see Download.

Install and configure Aerospike#

Install Aerospike Database and Tools#

You must install via the command line. Clicking a .deb package is not supported.

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

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

If installing Aerospike Database release versions 5.1.0.X and 5.2.0.X, and python2 is not installed, see the Python Package Dependency for .deb Installers article.

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.

Configure Aerospike Database and default namespace#

Installation establishes the server's default configuration.

An in-memory namespace called test 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.

For Aerospike Enterprise Edition, 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 Database#

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

For later versions of debian, 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.

Verify Aerospike Database is running#

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