Skip to main content
Aerospike 8 introduces a new era of real-time transaction processingLearn more

Install on Debian

Following are steps to install Aerospike on Debian operating systems.

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

  • To install, you must have root access or permission to run sudo.
  • For Aerospike Database 5.1 and later, be sure to install the proper version of libcurl. See libcurl Required.
  • Support for Debian 10 was removed in Database 7.0. Support for Debian 10 ARM64 was removed from Database 6.3.

Download the package​

See Download Aerospike Database for more details on manual or automated downloads of server versions.

# In Database 6.2 and later
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_debian11_x86_64.tgz
# In server versions prior to 6.2
wget -O aerospike.tgz https://download.aerospike.com/artifacts/aerospike-server-enterprise/5.7.0.17/aerospike-server-enterprise-5.7.0.17-debian10.tgz

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

wget -O aerospike.tgz https://download.aerospike.com/artifacts/aerospike-server-enterprise/4.5.3.22/aerospike-server-enterprise-4.5.3.22-debian8.tgz --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, where community_or_enterprise depends on the version of the server you downloaded:

The directory includes:

Install and Configure Aerospike​

Install Aerospike Database​

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 Debian packages directly.

Debian Format​

aerospike-server-<edition>_<version>-1<distro>_<architecture>.deb
aerospike-tools_<version>-<[commit]distro>_<architecture>.deb

edition: community, enterprise, federal

version: 6.2.0.0, and so on

distro: debian10, debian11

architecture: amd64, arm64 based on dpkg-architecture -qDEB_HOST_ARCH

sudo dpkg -i aerospike-server-enterprise_6.2.0.0-1debian11_arm64.deb
sudo dpkg -i aerospike-tools_8.1.0-debian11_arm64.deb

Troubleshoot the installation​

If there are errors during the installation, see Troubleshooting Install Problems. 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. 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.

Since Database 6.1 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, refer to Configuring Log Files.

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

Troubleshoot the 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 Daemon Management.

Last updated on