# 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 Release Notes](https://aerospike.com/docs/database/release/).

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, Ubuntu, Debian, and also on macOS.

Tools 12.1.0 is supported on the following operating systems:

**Linux (x86 and ARM)**

-   Debian 11, 12, 13
-   Ubuntu 20.04, 22.04, 24.04
-   RHEL 8, 9, 10
-   Amazon Linux 2023

**macOS (x86 & arm64)**

-   macOS 14, 15, 26

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

### 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.0) 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.

### `future` for `asloglatency` in tools 3.27.x

Terminal window

```bash
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`](https://pypi.org/project/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. |