Skip to main content
Loading

Install Tools on Ubuntu

Use these steps to install Aerospike Tools on Ubuntu operating systems.

Prerequisites​

  • Requires a supported Ubuntu release.
  • Verify that your system satisfies the prerequisites that are described in Tools Requirements.
  • Verify that the package libreadline is installed on your Ubuntu system.
  • Starting with Database 7.2, Aerospike gains compatibility with OpenSSL 3.0.13, to support Ubuntu 24.04 LTS.
  • Starting with Database 6.3, Aerospike is compatible with OpenSSL 3, supporting Ubuntu 22.04, RHEL 9/CentOS Stream 9, and other Linux distributions that support OpenSSL 3. The server and clients retain compatibility with OpenSSL 1.1.

Installation​

See Download Aerospike Tools for more details on manual or automated downloads of Tools packages.

wget -O aerospike-tools.tgz https://download.aerospike.com/artifacts/aerospike-tools/latest/aerospike-tools__ubuntu20.04_x86_64.tgz
tar -xvf aerospike-tools.tgz
cd aerospike-tools_*
sudo ./asinstall

Debian Format​

You can install the Debian package directly.

Starting with Tools 8.0.3 the Debian package format is as follows:

aerospike-tools_<version>-<[commit]distro>_<architecture>.deb

version: 8.0.3, and so on

distro: ubuntu18.04, ubuntu20.04, ubuntu22.04, ubuntu24.04

architecture: amd64, arm64 based on dpkg-architecture -qDEB_HOST_ARCH

sudo dpkg -i aerospike-tools_8.0.3-ubuntu20.04_amd64.deb

Verify​

Verify the package installation:

dpkg-query -l | grep aerospike-tools

If security is enabled for your Aerospike cluster, provide the username and password each time you verify one of the tools.

Verify asadm​

asadm --version

The output looks like this:

Aerospike Administration Shell
Version 2.2.0

Verify aql​

aql --version

The output looks like this:

Aerospike Query Client
Version 5.2.0
C Client Version 5.2.0
Copyright 2012-2020 Aerospike. All rights reserved.

Verify asinfo​

asinfo --version

The output looks like this:

Aerospike Information Tool
Version 5.2.0

Verify asbackup​

asbackup --version

The output looks like this:

Aerospike Backup Utility
Version 3.7.2
C Client Version 5.2.0
Copyright 2015-2021 Aerospike. All rights reserved.

Verify asrestore​

asrestore --version

The output looks like this:

Aerospike Restore Utility
Version 3.7.2
C Client Version 5.2.0
Copyright 2015-2021 Aerospike. All rights reserved.