Aerospike Tools Requirements

This page describes the requirements for installing the Aerospike tools package. Tools releases accompany database releases and have equivalent support windows. See Aerospike Server CE Release Notes.

New Tools packages are also released independent of Aerospike Database. Tools releases follow semantic versioning, and breaking changes are introduced only in major version updates, such as 10.0.0 to 11.0.0. Minor updates allow you to upgrade safely to a newer package, such as 11.0.0 to 11.1.0.

Supported operating systems

Aerospike Tools are intended to run on 64-bit Linux distributions, including RHEL, CentOS, Ubuntu, Debian, and also on macOS.

Tools 11.1.1 supports the following operating systems:

x86 Linux	ARM Linux	macOS
Debian 11	Debian 11	macOS 13 x64
Debian 12	Debian 12	macOS 14 arm64
Ubuntu 20.04	Ubuntu 20.04	macOS 15 arm64
Ubuntu 22.04	Ubuntu 22.04
Ubuntu 24.04	Ubuntu 24.04
RHEL 8	RHEL 8
RHEL 9	RHEL 9
Amazon Linux 2023	Amazon Linux 2023
Alma Linux 8	Alma Linux 8
Alma Linux 9	Alma Linux 9

Note

Support for macOS 11 was removed in the Tools 11.1.0 release, and support for macOS 12 was removed in 11.1.1.

Python3 for asloglatency

The asloglatency tool requires Python 3 to be installed.

Python3 for other tools

Note

The Python dependency for asadm is removed in tools 7.0.0. Similarly, asinfo had its Python dependency removed in tools 7.1.1. Both include their own Python interpreter.

• Tools prior to 7.0.0 must meet the same Python 3 requirement for asadm as asloglatency
• Tools prior to 7.1.1 must meet the same Python 3 requirement for asinfo as asloglatency

Requirements for older tools packages

Note

Tools packages prior to version 6.1.0 (associated with Database 5.7) are out of support.

OpenSSL for tools 3.31.1 and earlier

Install OpenSSL for tools 3.31.1 and earlier.

Tools 4.0.0 and later have OpenSSL statically linked into aql, asbackup, and asrestore.

OpenSSL has been bundled with asadm since aerospike-tools-3.15.3.8.

Caution

There is an exception with tools package versions 3.27.1 to 3.31.0 supporting both Python 2 and Python 3. However, the Debian and Ubuntu installers for those versions still include a dependency on the “python” package (Python 2). This should have been removed with the release of Python 3 support.

Debian/Ubuntu users - if Python 2 is not installed, see the Python Package Dependency for .deb Installers article.

future for asloglatency in tools 3.27.x

pip install future

If you do not install the future package, you will see the following warning:

ImportError: No module named builtins

For more information, see future.

Packages for tools 3.15.3.6 and earlier

For tools 3.15.3.6 and earlier, the following packages are required to use the advanced features of asinfo and asadm. If you do not install these packages, you can still use these tools but won’t be able to use the more advanced features.

Package	Version	Feature	Use	Description
argparse	-	Advanced command line options	-	If not available then the tools will run with the default Python option parser.
bcrypt	-	Aerospike security	Generate password hash	If not available then the tools will not be able to connect to an Aerospike Cluster with security enabled.
pexpect	>=3.0	asadm collectinfo	Collect remote system statistics	If not available then asadm will collect system statistics for localhost only. It does not affect Aerospike-related data collection.
toml	-	Tools configuration file(s)	Load tools configuration file(s)	If not available then the tools will ignore all configuration files and continue without them.
jsonschema	centos6: 2.5.1, other: >=2.5.1	Tools configuration file	Validate configuration file schema	If not available then the tools will ignore all configuration files and continue without them.
pyOpenSSL	>=16.0.0	SSL Connection	Make SSL connection with server	If not available then the tools will not be able to connect to an Aerospike Cluster using SSL.
pyasn1	>=0.3.1	SSL Connection	Validate DNS name for SSL connection	If not available then the tools will not be able to connect to an Aerospike Cluster using SSL.