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
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
asasloglatency
- Tools prior to 7.1.1 must meet the same Python 3 requirement for
asinfo
asasloglatency
Requirements for older tools packages
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.
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. |