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