Skip to main content
Loading

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 useable 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.