Aerospike tools requirements

Overview

This page lists the requirements for the Aerospike tools package. Tools releases accompany database releases and have equivalent support windows. See server release notes.

New tools packages are also released independent of the server. As tools releases follow semantic versioning, breaking changes occur on major version number increases. Minor changes allow you to upgrade safely to a newer tools package, from tools 6.1.0 to tools 6.3.1, for example.

Current requirements

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

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](https://discuss.aerospike.com/t/python-package-dependency-for-debian-deb-based-aerospike-tools-installers/7939) 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

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.