Skip to main content
Aerospike Vector is now live with LangChain integrationTell me more
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.