Relocate tools on RHEL

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.

Danger

Relocating Aerospike tools is not recommended and can cause issues that are described below.

The following command illustrates relocating the tools to the /aero directory.

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

Potential issues with relocated tools

• 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, but the tools are still usable if this happens.