Skip to main content
Loading

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, and support for Debian 10 in general was removed in server 7.0.

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.

SubdirectoryDescription
./bin/aerospikeThe script to manage this instance.
./bin/asdThe Aerospike server daemon, asd.
./etc/aerospike.confThe 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

See the Aerospike Tools documentation to find installation instructions.

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.

note

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