Install CE using a Precompiled Binary
Overview
Use this tutorial to install Aerospike Database Community Edition (CE) on Linux operating systems with glibc 2.24 or newer.
This package contains an Aerospike binary that can be run in a user directory without installing software, and does not require root privileges.
Prerequisites
- See the list of dependencies detailed in the aerospike/aerospike-server repository
- For Aerospike Database 5.1 and later, be sure to install the proper version of
libcurl. See libcurl Required. - Support for Debian 10 ARM64 was removed from server 6.3.
Download Aerospike CE
See Download Aerospike Database for more details on manual or automated downloads of server versions.
wget -O aerospike.tgz https://download.aerospike.com/artifacts/aerospike-server-community/6.1.0.3/aerospike-server-community-6.1.0.3.tar.gz
Install Aerospike CE
If you have already installed the server, you can skip directly to Start Aerospike.
Extract the contents of the package
To extract the contents of the package, run the following:
tar -xvf aerospike.tgz && cd aerospike-server
Initialize Aerospike Server
Next, we will need to initialize a directory to host an Aerospike instance:
./bin/aerospike init --help # to see the initialization options
./bin/aerospike init
After a directory is initialized to host an Aerospike instance, it contains the following files and subdirectories.
| Subdirectory | Description |
|---|---|
./bin/aerospike | The script to manage this instance. |
./bin/asd | The Aerospike server daemon, asd. |
./etc/aerospike.conf | The configuration file for this instance. |
./share/ | Read-only files used by this instance. |
./var/ | Runtime files created by asd, including logs and data files. |
Install Aerospike Tools
Superuser privileges (sudo) may be required to install Aerospike tools.
To install the tools, download one of the following packages:
# el7 Red Hat Variants:
wget -O aerospike-tools.tgz https://download.aerospike.com/download/tools/latest/artifact/el7
# el8 Red Hat Variants:
wget -O aerospike-tools.tgz https://download.aerospike.com/download/tools/latest/artifact/el8
# Debian 10:
wget -O aerospike-tools.tgz https://download.aerospike.com/download/tools/latest/artifact/debian10
# Debian 11:
wget -O aerospike-tools.tgz https://download.aerospike.com/download/tools/latest/artifact/debian11
# Ubuntu 18.04 LTS:
wget -O aerospike-tools.tgz https://download.aerospike.com/download/tools/latest/artifact/ubuntu18
# Ubuntu 20.04 LTS:
wget -O aerospike-tools.tgz https://download.aerospike.com/download/tools/latest/artifact/ubuntu20
Decompress the .tgz file and then install the tools package:
tar -xvf aerospike-tools.tgz && cd aerospike-tools*
# Red Hat Variants:
rpm -Uvh aerospike-tools*.rpm
# Ubuntu or Debian:
dpkg -i aerospike-tools*.deb
This installation adds tools under /opt/aerospike/bin and links them from /usr/bin.
Run Aerospike
Aerospike includes an init script for running the server, located in ./bin/aerospike. This script will manage the Aerospike Server Daemon (asd) located in ./bin.
The aerospike instance will store log files in ./var/log and system data in ./share. If you change the user for the Aerospike process, then you will need to ensure the user has permissions for ./var/log and ./share.
Start Aerospike
You can start asd by running:
sudo ./bin/aerospike start
Verify Aerospike is Running
You can verify whether asd had started successfully by checking the status:
./bin/aerospike status
# info: process running
You can also search the server log at ./var/log/aerospike.log for the
successful startup message:
grep cake /var/log/aerospike/aerospike.log
You should see:
Jun 22 2014 03:35:33 GMT: INFO (as): (as.c::376) service ready: soon there will be cake!
Problems during startup
If there are errors during start up, see Startup Problems. The Knowledge Base is also a good source of troubleshooting tips.
Aerospike systemd Daemon Management
For details on getting the status of the Aerospike database with systemctl, see Aerospike systemd Daemon Management.