Install problems

For the complete documentation index see: llms.txt

All documentation pages available in markdown.

CentOS 8 package dependencies

If you are running a non-standard version of CentOS 8, make sure the following packages required by the Aerospike Enterprise Edition are installed. The version numbers for some packages are also shown.

/bin/sh
/usr/bin/env
config(aerospike-server-enterprise) = 4.8.0.5-1.el8
ld-linux-x86-64.so.2()(64bit)
ld-linux-x86-64.so.2(GLIBC_2.2.5)(64bit)
ld-linux-x86-64.so.2(GLIBC_2.3)(64bit)
libc.so.6()(64bit)
libc.so.6(GLIBC_2.14)(64bit)
libc.so.6(GLIBC_2.17)(64bit)
libc.so.6(GLIBC_2.2.5)(64bit)
libc.so.6(GLIBC_2.28)(64bit)
libc.so.6(GLIBC_2.3)(64bit)
libc.so.6(GLIBC_2.3.2)(64bit)
libc.so.6(GLIBC_2.3.4)(64bit)
libc.so.6(GLIBC_2.4)(64bit)
libc.so.6(GLIBC_2.6)(64bit)
libc.so.6(GLIBC_2.7)(64bit)
libc.so.6(GLIBC_2.8)(64bit)
libc.so.6(GLIBC_2.9)(64bit)
libcrypto.so.1.1()(64bit)
libcrypto.so.1.1(OPENSSL_1_1_0)(64bit)
libdl.so.2()(64bit)
libdl.so.2(GLIBC_2.2.5)(64bit)
libgcc_s.so.1()(64bit)
libgcc_s.so.1(GCC_3.0)(64bit)
libgcc_s.so.1(GCC_3.3)(64bit)
liblber-2.4.so.2()(64bit)
libldap-2.4.so.2()(64bit)
libm.so.6()(64bit)
libm.so.6(GLIBC_2.2.5)(64bit)
libpthread.so.0()(64bit)
libpthread.so.0(GLIBC_2.2.5)(64bit)
libpthread.so.0(GLIBC_2.3.2)(64bit)
libpthread.so.0(GLIBC_2.3.4)(64bit)
librt.so.1()(64bit)
librt.so.1(GLIBC_2.2.5)(64bit)
libssl.so.1.1()(64bit)
libssl.so.1.1(OPENSSL_1_1_0)(64bit)
libssl.so.1.1(OPENSSL_1_1_1)(64bit)
libstdc++.so.6()(64bit)
libstdc++.so.6(CXXABI_1.3)(64bit)
libstdc++.so.6(CXXABI_1.3.8)(64bit)
libstdc++.so.6(CXXABI_1.3.9)(64bit)
libstdc++.so.6(GLIBCXX_3.4)(64bit)
libstdc++.so.6(GLIBCXX_3.4.20)(64bit)
libstdc++.so.6(GLIBCXX_3.4.21)(64bit)
libstdc++.so.6(GLIBCXX_3.4.9)(64bit)
libz.so.1()(64bit)
libz.so.1(ZLIB_1.2.0)(64bit)
rpmlib(CompressedFileNames) <= 3.0.4-1
rpmlib(FileDigests) <= 4.6.0-1
rpmlib(PayloadFilesHavePrefix) <= 4.0-1
rpmlib(PayloadIsXz) <= 5.2-1
rtld(GNU_HASH)

Tools install prerequisites

For Docker users: Aerospike recommends using the official Docker tools image directly to install the tools package.
For other platforms: See the Aerospike tools requirements for a list of supported platforms and bundled dependencies.
Additional requirements for aql: See Aerospike tools requirements for libreadline details.

Troubleshooting Python dependencies

Tools packages 6.1.0 and later bundle Python, so environment errors are unlikely. If you are using an older Debian or Ubuntu package and see the No Python interpreter found! error, you must either:

Upgrade to the latest tools package (recommended), or
Manually install Python 3 in your environment.

Installing tools
dpkg -i aerospike-tools-6.0.3.ubuntu20.04.x86_64.deb
Selecting previously unselected package aerospike-tools.
(Reading database ... 30041 files and directories currently installed.)
Preparing to unpack .../aerospike-tools-6.0.3.ubuntu20.04.x86_64.deb ...
Unpacking aerospike-tools (6.0.3) ...
Setting up aerospike-tools (6.0.3) ...
Installing /opt/aerospike
No Python interpreter found!
dpkg: error processing package aerospike-tools (--configure):
 installed aerospike-tools package post-installation script subprocess returned error exit status 1
Errors were encountered while processing:
 aerospike-tools

/opt/aerospike directory conflict

If you get the following error during installation (versions up to 3.3.5):

Preparing packages...
    file /opt/aerospike conflicts between attempted installs of aerospike-server-community-3.3.5-1.el6.x86_64 and aerospike-tools-3.2.13-1.el6.x86_64
    file /opt/aerospike/data conflicts between attempted installs of aerospike-server-community-3.3.5-1.el6.x86_64 and aerospike-tools-3.2.13-1.el6.x86_64
    file /opt/aerospike/doc conflicts between attempted installs of aerospike-server-community-3.3.5-1.el6.x86_64 and aerospike-tools-3.2.13-1.el6.x86_64

Rerun the rpm command using the —force option:

sudo rpm -i aerospike-server-community-<version>.el6.x86_64.rpm --force

Directory and file conflicts require manual uninstall

If you have installed some previous versions of Aerospike or Citrusleaf, there may be conflicts.

For a clean installation, we recommend checking for and removing older versions of Aerospike and Citrusleaf. This is not necessary for recent versions of Aerospike, but may be required for some older versions of Aerospike or Citrusleaf.

In Debian and Ubuntu,

sudo dpkg -l | fgrep aerospike
sudo dpkg -l | fgrep citrusleaf
sudo dpkg -r < package name >

In Red Hat and CentOS,

sudo rpm -qa | fgrep aerospike
sudo rpm -qa | fgrep citrusleaf
sudo rpm -e < package name >

SELinux prevents adding user/group aerospike/aerospike

If you see the following error during installation:

Preparing packages...
Installing /opt/aerospike
Adding group aerospike
Adding user aerospike
useradd: cannot create directory /opt/aerospike
error: %pre(aerospike-tools-3.2.13-1.el6.x86_64) scriptlet failed, exit status 12
error: aerospike-tools-3.2.13-1.el6.x86_64: install failed
Adding group aerospike
groupadd: group 'aerospike' already exists
Adding user aerospike
useradd: cannot create directory /opt/aerospike
error: %pre(aerospike-server-community-3.3.5-1.el6.x86_64) scriptlet failed, exit status 12
error: aerospike-server-community-3.3.5-1.el6.x86_64: install failed

Use sestatus to determine the configuration for SELinux. If the mode is enforcing, disable it.

Disable SELinux during the installation process where the user and group are created. You can re-enable it later.

Some distributions support disabling SELinux temporarily:

sudo setenforce 0

To re-enable:

sudo setenforce 1

To quickly check:

getenforce

To disable SELinux permanently, edit the file /etc/selinux/config and reboot. Create the following directory and file if they do not exist.

sudo vi /etc/selinux/config

The contents of the file should set SELINUX to disabled instead of enforcing:

SELINUX=disabled
SELINUXTYPE=targeted