Skip to main content
Loading

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.

PackageVersionFeatureUseDescription
argparse-Advanced command line options-If not available then the tools will run with the default Python option parser.
bcrypt-Aerospike securityGenerate password hashIf not available then the tools will not be able to connect to an Aerospike Cluster with security enabled.
pexpect>=3.0asadm collectinfoCollect remote system statisticsIf 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.
jsonschemacentos6: 2.5.1, other: >=2.5.1Tools configuration fileValidate configuration file schemaIf not available then the tools will ignore all configuration files and continue without them.
pyOpenSSL>=16.0.0SSL ConnectionMake SSL connection with serverIf not available then the tools will not be able to connect to an Aerospike Cluster using SSL.
pyasn1>=0.3.1SSL ConnectionValidate DNS name for SSL connectionIf not available then the tools will not be able to connect to an Aerospike Cluster using SSL.