Install tools on Linux

For the complete documentation index see: llms.txt

All documentation pages available in markdown.

Install the Aerospike tools package on a supported Linux distribution using a tarball or native package manager. After the installation is complete, you can verify the installation and run tools like asadm and aql.

Prerequisites

Verify that your system satisfies the prerequisites described in Aerospike tools requirements.
If you plan to use AQL, verify that libreadline is installed. It is not required for the rest of the tools package.
See Download Aerospike tools to learn about manual and automated package downloads.

Install from tarball

The example commands in the following steps use tools version 13.0.0 for Ubuntu 24.04 on ARM (aerospike-tools_13.0.0_ubuntu24.04_aarch64.tgz).

Go to the tools download page and download the package for the tools version, architecture, and Linux distribution that you need.
Open a shell in the directory where you downloaded the .tgz file.

Extract the package and install with the included script:

tar -xvf aerospike-tools_13.0.0_ubuntu24.04_aarch64.tgz
cd aerospike-tools_13.0.0_ubuntu24.04_aarch64
sudo ./asinstall

Install with native package

The example commands in the following steps use tools version 13.0.0 for RHEL 10 on ARM (aerospike-tools_13.0.0_el10_aarch64.tgz).

Go to the tools download page and download the package for the tools version, architecture, and RHEL version that you need. The .rpm package is inside the archive.
Open a shell in the directory where you downloaded the .tgz file.

Extract the package and install with RPM:

tar -xvf aerospike-tools_13.0.0_el10_aarch64.tgz
cd aerospike-tools_13.0.0_el10_aarch64
sudo rpm -Uvh aerospike-tools-13.0.0-1.el10.aarch64.rpm

The example commands in the following steps use tools version 13.0.0 for Debian 13 on ARM (aerospike-tools_13.0.0_debian13_aarch64.tgz).

Go to the tools download page and download the package for the tools version, architecture, and Debian version that you need. The .deb package is inside the archive.
Open a shell in the directory where you downloaded the .tgz file.

Extract the package and install with dpkg:

tar -xvf aerospike-tools_13.0.0_debian13_aarch64.tgz
cd aerospike-tools_13.0.0_debian13_aarch64
sudo dpkg -i aerospike-tools_13.0.0-debian13_arm64.deb

The example commands in the following steps use tools version 13.0.0 for Ubuntu 24.04 on ARM (aerospike-tools_13.0.0_ubuntu24.04_aarch64.tgz).

Go to the tools download page and download the package for the tools version, architecture, and Ubuntu version that you need. The .deb package is inside the archive.
Open a shell in the directory where you downloaded the .tgz file.

Extract the package and install with dpkg:

tar -xvf aerospike-tools_13.0.0_ubuntu24.04_aarch64.tgz
cd aerospike-tools_13.0.0_ubuntu24.04_aarch64
sudo dpkg -i aerospike-tools_13.0.0-ubuntu24.04_arm64.deb

Verify tools installation

Confirm the package is registered with your package manager:

rpm -qa | grep aerospike-tools

dpkg-query -l | grep aerospike-tools

dpkg-query -l | grep aerospike-tools