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