Install Tools on Red Hat Enterprise Linux

Follow these steps to install Aerospike Tools on Red Hat Enterprise Linux (RHEL), and on el8, and el9-compatible variants, such as CentOS, Rocky Linux, Amazon Linux, and Oracle Linux.

Prerequisites

Verify that your system satisfies the prerequisites that are described in Tools Requirements.

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__el8_x86_64.tgz
tar -xvf aerospike-tools.tgz
cd aerospike-tools-*
sudo ./asinstall

RPM Format

You can install the RPMs directly.

aerospike-tools-<version>-1.<RHEL>.<architecture>.rpm

version: 8.1.0 and later

RHEL: el7, el8, el9, amzn2023

architecture: x86_64, aarch64

sudo rpm -Uvh aerospike-tools-8.1.0-1.el7.aarch64.rpm

Relocating

The Aerospike tools package is installed by default in /opt/aerospike/bin, /usr/bin, and /etc/aerospike. The /opt, /usr, and /etc locations can be relocated when installing the tools rpm.

Here is an example of relocating the tools.

rpm -iv ./aerospike-tools-10.2.1-1.amzn2023.x86_64.rpm --relocate /opt=/aero/opt --relocate /etc=/aero/etc --relocate /usr=/aero/usr

After relocating, you can run aql with the following:

/aero/opt/aerospike/bin/aql

danger

Relocating the tools is not recommended and can cause the issues listed below.

The tool binaries are normally installed into /opt/aerospike/bin and symlinked into /usr/bin. Relocating these files will break the symlinks between them. After a relocated tools install, the tools should be used from wherever /opt/aerospike/bin was relocated.

Some tools, like asadm and asinfo, look for a default configuration file at /etc/aerospike/astools.conf. If that file is relocated, it will not be read. Instead, specify where to read the configuration file with the --config-file option.

The tools installation attempts to create a user called "aerospike" with its home directory set to /opt/aerospike. Relocating /opt/aerospike may break the creation of this user. The tools are still usable if this happens.

Verify

Verify the package installation:

rpm -qa | 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

Expected output:

Aerospike Administration Shell
Version 2.2.0

Verify aql

aql --version

Expected output:

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

Verify asinfo

asinfo --version

Expected output:

Aerospike Information Tool
Version 5.2.0

Verify asbackup

asbackup --version

Expected output:

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

Verify asrestore

asrestore --version

Expected output:

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