Install tools on Linux

This page describes how to install Aerospike tools on supported Linux distributions. Refer to Aerospike tools requirements to learn about supported operating systems and other requirements.

Prerequisites

Verify that your system satisfies the prerequisites described in Aerospike tools requirements.

Requires a supported Debian release.
Verify that your system satisfies the prerequisites as described in Tools Requirements.
Verify that the package libreadline is installed on your Debian system.

Requires a supported Ubuntu release.
Verify that your system satisfies the prerequisites that are described in Tools Requirements.
Verify that the package libreadline is installed on your Ubuntu system.
Starting with Database 7.2, Aerospike gains compatibility with OpenSSL 3.0.13, to support Ubuntu 24.04 LTS.
Starting with Database 6.3, Aerospike is compatible with OpenSSL 3, supporting Ubuntu 22.04, RHEL 9/CentOS Stream 9, and other Linux distributions that support OpenSSL 3. The server and clients retain compatibility with OpenSSL 1.1.

Install with tarball

See Download Aerospike Tools for more details on manual or automated downloads of tools packages.

In the example below, replace VERSION with the tools version you want to download, or browse for available downloads in the latest directory.

wget -O aerospike-tools.tgz https://download.aerospike.com/artifacts/aerospike-tools/VERSION/aerospike-tools_VERSION_el8_x86_64.tgz
tar -xvf aerospike-tools.tgz
cd aerospike-tools-*
sudo ./asinstall

See Download Aerospike Tools for more details on manual or automated downloads of tools packages.

In the example below, replace VERSION with the tools version you want to download, or browse for available downloads in the latest directory.

wget -O aerospike-tools.tgz https://download.aerospike.com/artifacts/aerospike-tools/VERSION/aerospike-tools_VERSION_debian11_x86_64.tgz
tar -xvf aerospike-tools.tgz
cd aerospike-tools-*
sudo ./asinstall

See Download Aerospike Tools for more details on manual or automated downloads of tools packages.

In the example below, replace VERSION with the tools version you want to download, or browse for available downloads in the latest directory.

wget -O aerospike-tools.tgz https://download.aerospike.com/artifacts/aerospike-tools/VERSION/aerospike-tools_VERSION_ubuntu20.04_x86_64.tgz
tar -xvf aerospike-tools.tgz
cd aerospike-tools_*
sudo ./asinstall

Install with native package

You can install the RPMs directly.

aerospike-tools-<version>-1.<RHEL>.<architecture>.rpm

version: 8.1.0 and later

RHEL: el7, el8, el9, amzn2023

architecture: x86_64, aarch64

sudo rpm -Uvh aerospike-tools-8.1.0-1.el7.aarch64.rpm

You can install the Debian package directly.

Starting with Tools 8.1.0 the Debian package format is as follows:

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

version: 8.1.0, and so on

distro: debian10, debian11, debian12

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

sudo dpkg -i aerospike-tools_8.1.0-debian11_arm64.deb

You can install the Debian package directly.

Starting with Tools 8.0.3 the Debian package format is as follows:

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

version: 8.0.3, and so on

distro: ubuntu18.04, ubuntu20.04, ubuntu22.04, ubuntu24.04

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

sudo dpkg -i aerospike-tools_8.0.3-ubuntu20.04_amd64.deb

Verify tools installation

You can grep for aerospike-tools to verify the package installation:

rpm -qa | grep aerospike-tools

To verify the installation fora specific tool, run the tool with the --version flag:

asadm --version

You can grep for aerospike-tools to verify the package installation:

dpkg-query -l | grep aerospike-tools

To verify the installation for a specific tool, run the tool with the --version flag:

asadm --version

You can grep for aerospike-tools to verify the package installation:

dpkg-query -l | grep aerospike-tools

To verify the installation for a specific tool, run the tool with the --version flag:

asadm --version