Skip to main content

Install using Binary Package

Overview#

Use this tutorial to install Aerospike on any Linux system with glibc 2.11 or newer. glibc 2.11 was released in January, 2009 and most modern Linux distributions - Debian 6+, Centos 6+, OpenSUSE 12+, Ubuntu 10.04+ support this this version.

This package contains an Aerospike binary that can be run in a user directory without installing software, and does not require root privileges.

For Aerospike Server 5.1 and later, libcurl is required#

For Aerospike Server 5.1 and later, be sure to install the proper version of libcurl. For details, see Required - libcurl version for your Linux operating system.

Download Aerospike#

Download Aerospike Server Community Edition#

To download the latest stable release, run the following:

wget -O aerospike.tgz 'https://www.aerospike.com/download/server/latest/artifact/tgz'

For release notes and details on releases, visit the Download page.

Install 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#

Superuser privileges (sudo) may be required to install Aerospike tools.

To install the tools, download one of the following packages:

# Red Hat Variants (RHEL7):wget -O aerospike-tools.tgz 'https://www.aerospike.com/download/tools/latest/artifact/el7'# Debian 8:wget -O aerospike-tools.tgz 'https://www.aerospike.com/download/tools/latest/artifact/debian8'# Debian 9:wget -O aerospike-tools.tgz 'https://www.aerospike.com/download/tools/latest/artifact/debian9'# Debian 10:wget -O aerospike-tools.tgz 'https://www.aerospike.com/download/tools/latest/artifact/debian10'# Ubuntu 18.04 LTS:wget -O aerospike-tools.tgz 'https://www.aerospike.com/download/tools/latest/artifact/ubuntu18'# Ubuntu 20.04 LTS:wget -O aerospike-tools.tgz 'https://www.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 (RHEL7):    rpm -Uvh aerospike-tools-*.el7.x86_64.rpm    # Red Hat Variants (RHEL8):    rpm -Uvh aerospike-tools-*.el8.x86_64.rpm    # Debian 8:    dpkg -i aerospike-tools-*.debian8.x86_64.deb    # Debian 9:    dpkg -i aerospike-tools-*.debian9.x86_64.deb        # Debian 10:    dpkg -i aerospike-tools-*.debian10.x86_64.deb        # Ubuntu 18.04 LTS:    dpkg -i aerospike-tools-*.ubuntu18.04.x86_64.deb    # Ubuntu 20.04 LTS:    dpkg -i aerospike-tools-*.ubuntu20.04.x86_64.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.

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!

If there are errors during start up, consult the Troubleshooting guide.

Next Steps#

note

Make sure NTP is set up, especially if the node will be operating in a multi-node cluster. A guide to installing NTP can be found in this knowledge base article.

Verify the server was installed correctly.

Start developing!